PCGETC(3NCARG)

✨ PCGETC ✨

okay bestie, gather round 💖 this one lives in the NCAR GRAPHICS manual (that's the 3NCARG section, iykyk) and it's called PCGETC — short for "Plotchar GET Character", which is giving exactly what it sounds like. She retrieves the current character value of an internal parameter. Like, she's the one you text when you need to know what a parameter is currently set to. 🎀

---

NAME 💅

PCGETC — retrieves the current character value of an internal parameter.

---

SYNOPSIS 🦋

CALL PCGETC (PNAM,CVAL)

---

C-BINDING SYNOPSIS 🌸

#include <ncarg/ncargC.h>

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

---

DESCRIPTION 👑

• PNAM — an input constant or variable of type CHARACTER, and it's the name of the parameter you're trying to get. Heads up: the name has to sit in the first two characters of the string. No cap. And if the internal parameter you're after is one of the two that are arrays — those would be ´BC´ and ´CC´ — then the index of the array element you want can go right there, wrapped in parentheses, starting in columns 3 and following. The rest of the characters are free real estate, bestie — you can use them to document what the parameter is even for. Like, instead of just ´MA´ you could write ´MA - MAPPING FLAG´, and instead of ´CC(10)´ you could write ´CC(10) - SPECIAL COLOR 10´. Cute, right? 🫶
• CVAL — an output variable of type CHARACTER. It's the name of the variable where the value of the internal parameter specified by PNAM gets retrieved into. That's her whole job. 💖

---

C-BINDING DESCRIPTION 🧚

The C-binding argument descriptions are literally the same as the FORTRAN argument descriptions, with one exception:

• len — the size of cval as dimensioned in the calling program.

---

USAGE 🌈

This routine lets you retrieve the current value of Plotchar parameters. And if you want the complete list of parameters available in this utility? Go read the plotchar_params man page, bestie, she has everything. ⭐

---

ACCESS 💜

To use PCGETC or c_pcgetc, you gotta load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c — and preferably in that exact order. Order matters, don't fight it. 🔥

---

MESSAGES 😭

See the plotchar man page for a description of all the Plotchar error messages and/or informational messages. She's got the receipts.

---

SEE ALSO 🎀

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

Hardcopy: NCAR Graphics Fundamentals, UNIX Version

---

COPYRIGHT 🫶

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

---

ngl the legal girlies ate with that license line, so we're keeping it exactly as is 💀

okay that's the whole page!! this one's from the UNIX manual, dated March 1993 (yes, she's an elder icon and she still slays), filed under PCGETC(3NCARG). go get those parameter values, bestie 💖✨🦋