TDGETR(3NCARG)

💖 TDGETR — bestie's guide to snagging a real Tdpack value 💖

okay so welcome to the NCAR Graphics corner of the universe, specifically the TDGETR page. this is a FORTRAN-callable routine from the Tdpack crew, and yes she has a C-binding twin. let's get into it, no cap. 🎀

---

✨ NAME ✨

TDGETR</purgle> — Retrieves the real value of a Tdpack parameter.

like... it goes and gets the number for you. that's the whole job. and she does it flawlessly. 💅

---

✨ SYNOPSIS ✨

CALL TDGETR (PNAM,RVAL)

that's it. that's the call. two args, one vibe. 🦋

---

✨ C-BINDING SYNOPSIS ✨

for my C girlies:

#include <ncarg/ncargC.h>

void c_tdgetr (char *pnam, float *rval)

---

✨ DESCRIPTION ✨

so the arguments of TDGETR are literally these two, and here's the tea on each:

• PNAM — an input constant or variable of type CHARACTER. it's the name of the parameter you wanna retrieve. the character string can be any length, but — and this is important — only the first three characters of it get examined. so like, don't come in with a whole essay, she's reading the first three letters and moving on. periodt.
• RVAL — an output variable of type REAL. this is the lil container that receives the parameter value you asked for. if the internal parameter is of type REAL and has the value "r", then RVAL gets the value "r". and if the internal parameter is of type INTEGER and has the value "i", then RVAL gets the value "REAL(i)". so she'll convert for you, she's flexible like that. 💖

---

✨ C-BINDING DESCRIPTION ✨

ngl this part is short and sweet: the C-binding argument descriptions are the same as the FORTRAN argument descriptions. same energy, different language. 🌈

---

✨ USAGE ✨

this routine is your girl for retrieving the current value of Tdpack parameters. that's the whole point of her existence and she's obsessed with it.

if you want the complete list of parameters available in this utility, go read the tdpack_params man page. it's giving encyclopedia but make it useful. 📚

---

✨ ACCESS ✨

to use TDGETR or c_tdgetr, you gotta load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c — and preferably in that order. yes, order matters, don't fight it, just link them correctly bestie. 🔗

---

✨ MESSAGES ✨

curious about what she's yelling when things go sideways? see the tdpack man page for a description of all Tdpack error messages and/or informational messages. she's communicative, she's not gonna ghost you. 😭

---

✨ SEE ALSO ✨

the whole friend group, online: tdclrs, tdctri, tddtri, tdgeti, tdgrds, tdgrid, tdgtrs, tdinit, tditri, tdlbla, tdlbls, tdline, tdlnpa, tdmtri, tdotri, tdpack, tdpack_params, tdpara, tdplch, tdprpa, tdprpi, tdprpt, tdseti, tdsetr, tdsort, tdstri, tdstrs. it's giving squad goals. 👑

---

✨ 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. slay ✨🫶

this was the TDGETR(3NCARG) page, served up fresh from the UNIX manual, dated July 1997. iconic since forever, fr fr. 💜🌸