RETSR(3NCARG)

💖 RETSR — the NCAR Graphics glow-up return 💖

okay bestie, listen up: this is a page from the NCAR Graphics manual (that's the 3NCARG section, iykyk), and honestly? it's giving "undo button but make it retro FORTRAN." let's get into it. ✨

✨ NAME ✨

RETSR — you call it when you wanna return to a saved state of the recovery mode in NCAR Graphics. it's the little time machine for your error-handling vibe. 🕰️💫

---

🌸 SYNOPSIS 🌸

CALL RETSR(IROLD)

🦋 C-BINDING SYNOPSIS 🦋

#include <ncarg/ncargC.h>

void c_entsr(int irold)

(yes, the header says c_entsr — we are not editing that, bestie, we report what's on the page 💅)

---

🎀 DESCRIPTION 🎀

so the FORTRAN statement

CALL RETSR(IROLD)

is normally the move when you wanna take the internal error flag of SETER — you know, the one that says whether or not recovery mode is currently in effect — and put it back to the state it was in before some past call to ENTSR. it's literally restoring the vibe to a previous save point. 🧚

🚨 okay real talk, this part matters: if recovery mode gets turned off by a call to RETSR at a time when the internal error flag is non-zero, that is treated as a fatal error. the error message gets printed, the dump routine FDUM is called, and a STOP is executed. like, full dramatic exit. no cap. 💀

and here's the argument, queen of input expressions:

• IROLD — an input expression of type INTEGER. it specifies the desired value for that internal flag that says whether recovery mode is in effect or not. the value 1 turns recovery mode on 🌈, and the value 2 turns it off 🚫. normally you'd use a value of IROLD that was previously returned by a call to ENTSR. (basically: let ENTSR hand you the receipts, then hand them back. 🧾)

💜 C-BINDING DESCRIPTION 💜

the C-binding argument descriptions are the same as the FORTRAN argument descriptions. same energy, different font. 🫶

---

🔥 EXAMPLES 🔥

use the ncargex command to see these relevant examples, bestie:

• tseter
• arex02

go look, they ate. 👑

---

⭐ ACCESS ⭐

to use RETSR or c_retsr, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c — preferably in that order. (the order is the whole point, don't be chaotic. 😌)

---

🌈 SEE ALSO 🌈

online, go peek at: entsr, eprin, errof, error_handling, fdum, icfell, icloem, nerro, semess, seter, ncarg_cbind

---

👑 COPYRIGHT 👑

Copyright (C) 1987-2009 University Corporation for Atmospheric Research The use of this Software is governed by a License Agreement.

---

and that's the whole page, bestie!! 🥹💖 this one came from the UNIX manual, March 1994, filed under RETSR(3NCARG) — vintage but make it iconic. mwah, study safe, and remember: check that error flag before you turn recovery mode off. love u, bye!! 🎀✨🦋