PCGETR(3NCARG)

📦 version 6.6.2.dfsg.1, in debian bookworm, debian trixie, ubuntu jammy, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 PCGETR — it's giving "grab the real value" energy 💖

okay bestie, so this is a page from NCAR GRAPHICS, and it's all about PCGETR, a little routine that goes and fetches the real value of an internal parameter. lowkey essential, no cap. 🎀

✨ NAME ✨

PCGETR — she retrieves the real value of an internal parameter of type REAL or INTEGER. that's it, that's the whole job, and she does it flawlessly. 💅

✨ SYNOPSIS ✨

CALL PCGETR (PNAM,RVAL)

✨ C-BINDING SYNOPSIS ✨

#include <ncarg/ncargC.h>

void c_pcgetr (char *pnam, float *rval)

🌸 DESCRIPTION 🌸

  • PNAM — an input expression of type CHARACTER, and she specifies the name of the parameter you wanna get. the name has to show up as the first two characters of the string, periodt. and here's the cute part: if the internal parameter is one of the two that are arrays — those would be 'BC' and 'CC' — then the index of the array element you want can appear, wrapped in parentheses, starting in columns 3 and following. also you can totally use extra characters to document what the parameter is for, iykyk. like, instead of just 'MA', you can write 'MA - MAPPING FLAG', and instead of 'CC(10)', you can write 'CC(10) - SPECIAL COLOR 10'. cute, self-documenting, we love to see it. 🦋
  • RVAL — an output variable of type REAL. this is the name of the variable where the value of the internal parameter specified by PNAM gets dropped off. and here's the tea: if the internal parameter is a value "r" of type REAL, then the value returned is "r". but if the internal parameter is a value "i" of type INTEGER, then the value returned is "REAL(i)". yes, she converts. icon behavior. ✨

💜 C-BINDING DESCRIPTION 💜

the C-binding argument descriptions are the same as the FORTRAN argument descriptions. no notes, they just match. 💖

👑 USAGE 👑

this routine lets you retrieve the current value of Plotchar parameters. that's the whole vibe.

for a complete list of parameters available in this utility, go see the plotchar_params man page. seriously, go look, she has the full menu. 🍓

🌈 EXAMPLES 🌈

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

  • cpexcc
  • epltch
  • vvexcc
  • fpchiqu

⭐ ACCESS ⭐

to use PCGETR or c_pcgetr, you gotta load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c — and preferably in that order. don't fight the order, she knows what she's doing. 💅

😭 MESSAGES 😭

see the plotchar man page for a description of all Plotchar error messages and/or informational messages. every single one. go read. 🫶

🧚 SEE ALSO 🧚

Online:

  • plotchar
  • plotchar_params
  • pcdlsc
  • pcgetc
  • pcgeti
  • pchiqu
  • pcloqu
  • pcmequ
  • pcmpxy
  • pcpnwi
  • pcrset
  • pcsetc
  • pcseti
  • pcsetr
  • ncarg_cbind

Hardcopy:

  • NCAR Graphics Fundamentals, UNIX Version

Copyright (C) 1987-2009 University Corporation for Atmospheric Research

The use of this Software is governed by a License Agreement.

fr fr, that license line is not a joke — the use of this Software is governed by a License Agreement. read it, bestie. 🙈

okay that's the whole page, and ngl she ate. this came straight out of the UNIX manual, dated March 1993, filed under PCGETR(3NCARG) in the NCAR GRAPHICS collection. mwah. 💖🎀✨

📦 where this page comes from