WMGETC(3NCARG)

💖 WMGETC — bestie, come get your character 💖

okay so this is WMGETC, a lil NCAR Graphics routine from the 3NCARG manual, and honestly? it's giving "quiet support character who does one job perfectly." it grabs the current value of an internal Wmap parameter that happens to be of type character. that's it. that's the whole gig. and she ate. 💅

✨ SYNOPSIS ✨

CALL WMGETC (PNAM,CVAL)

🌈 C-BINDING SYNOPSIS 🌈

#include <ncarg/ncargC.h>

void c_wmgetc (char *pnam, char *cval, int len)

🎀 DESCRIPTION 🎀

• PNAM — an input constant or variable of type CHARACTER, and she's the one telling us which parameter we're getting. lowkey important detail: the name has to show up as the first three characters of the string. like, the first three. not somewhere in the middle. fr fr. 👑
• CVAL — an output variable of type CHARACTER. this is the name of the variable where the value of the internal parameter you named in PNAM gets retrieved into. she's the lil bucket catching the answer. 🪣✨

🦋 C-BINDING DESCRIPTION 🦋

the C-binding argument descriptions are the same as the FORTRAN argument descriptions, with exactly one exception, and here she is:

• len — the size of cval as dimensioned in the calling program. that's it. that's the plot twist. 🫶

💜 USAGE 💜

this routine lets you retrieve the current value of Wmap parameters. so if you're wondering what a Wmap parameter is set to right now, this is your girl. 💁‍♀️

for a complete list of parameters available in this utility, go read the wmap_params man page. she has the receipts. 📜

🔥 ACCESS 🔥

to use WMGETC or c_wmgetc, you gotta load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c — preferably in that order. not me stressing the order, but also yes me stressing the order. 👀

🌸 SEE ALSO 🌸

Online: wmap, wmdflt, wmgetr, wmgeti, wmlabs, wmsetc, wmseti, wmsetr, wmap_params

Hardcopy: WMAP - A Package for Producing Daily Weather Maps and Plotting Station Model Data

like the whole squad is here. wmgetr and wmgeti are her siblings for real and integer values, wmsetc is the setter bestie, and wmdflt resets the defaults. iykyk. 🧚

👑 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 page, bestie!! 💖 this one came straight out of the NCAR GRAPHICS manual, WMGETC(3NCARG), and the version/date stamp on the original footer was UNIX, January 1995 — so yeah, she's been iconic since way before you were born. periodt. 🎀💅🌈