PCGETI(3NCARG)

💖 PCGETI — bestie edition 💖

okay so this is PCGETI from the NCAR GRAPHICS manual, section 3NCARG, and it's genuinely one of the most useful little gremlins in the whole Plotchar toolbox. she's here to hand you back a number. that's it. that's the job. but she does it SO well. 🎀

✨ NAME ✨

PCGETI — retrieves the integral value of an internal parameter of type INTEGER or REAL. 🫶

✨ SYNOPSIS ✨

CALL PCGETI (PNAM,IVAL)

✨ C-BINDING SYNOPSIS ✨

#include <ncarg/ncargC.h>

void c_pcgeti (char *pnam, int *ival)

✨ DESCRIPTION ✨

• PNAM — an input constant or variable of type CHARACTER, and she's the one who says which parameter you're getting. the name has to show up as the first two characters of the string, no cap. now, if the internal parameter happens to be one of the two that are arrays (´BC´ and ´CC´), then the index of the array element you want can go in columns 3 and following, wrapped in parentheses. and here's the cute part: you can put literally anything else after that to document what you're doing, she does not care. so instead of just ´MA´, you could write ´MA - MAPPING FLAG´, and instead of ´CC(10)´ you could write ´CC(10) - SPECIAL COLOR 10´. it's giving self-documenting code. we love her for that. 💅
• IVAL — an output variable of type INTEGER, aka the lil bucket where the value of the internal parameter named by PNAM lands. and here's the math, bestie: if the internal parameter is a value "i" of type INTEGER, then the value returned is "i". if the internal parameter is a value "r" of type REAL, then the value returned is INT(r). so either way you're walking away with an integer. periodt. 🌸

✨ C-BINDING DESCRIPTION ✨

the C-binding argument descriptions are the same as the FORTRAN argument descriptions. like, identical. same energy, different language. ✨

✨ USAGE ✨

this routine is your girl for pulling the current value of Plotchar parameters. and if you want the whole entire list of parameters that live in this utility, go read the plotchar_params man page. she's got the receipts. 📜

✨ EXAMPLES ✨

use the ncargex command to see the following relevant examples: cpexcc, vvexcc. go look at them, they're right there. 🦋

✨ ACCESS ✨

to use PCGETI or c_pcgeti, you gotta load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c — and preferably in that order, okay? order matters, bestie. don't do it out of order, that's not the vibe. 🔥

✨ SEE ALSO ✨

Online: plotchar, plotchar_params, pcdlsc, pcgetc, pcgetr, pchiqu, pcloqu, pcmequ, pcmpxy, pcpnwi, pcrset, pcsetc, pcseti, pcsetr, ncarg_cbind.

Hardcopy: NCAR Graphics Fundamentals, UNIX Version. yes, paper. iconic. 📚

✨ COPYRIGHT ✨

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

okay and for the lil sign-off moment 👑 — this page is a UNIX manual page, dated March 1993, and it lives at PCGETI(3NCARG). yes she's been serving since 1993 and she still eats. mwah. 💖✨🎀