STGETC(3NCARG)

💖 STGETC 💖

okay bestie, welcome to STGETC, a lil function from NCAR GRAPHICS (that's the manual this page lives in, mwah) and it's here to do one (1) extremely specific thing: grab the current value of a Streamlines parameter that happens to be of type CHARACTER. that's it. that's the gig. she's focused, she's iconic, she serves. ✨

---

🌸 NAME 🌸

STGETC — gets the current value of a Streamlines parameter of type CHARACTER. 🎀

---

✨ SYNOPSIS ✨

CALL STGETC (CNM,CVL)

---

🦋 C-BINDING SYNOPSIS 🦋

#include <ncarg/ncargC.h>

void c_stgetc(char *cnm, char *cvl, int len)

---

💅 DESCRIPTION 💅

• CNM — (CHARACTER, input) bestie this is the name of the parameter whose character value you wanna retrieve. and listen, only the first three characters of CNM get examined. like, that's all she reads. and those three characters have to be entirely upper or entirely lower case — mixed case is not recognized, periodt. 💀 pro tip from the manpage itself: it is recommended that the rest of the character string be used to improve the readability of the code. for example, instead of just ZFT, use ZFT - Zero Field Text String. do it for your future self, she'll thank you. 🫶
• CVL — (CHARACTER, output) the variable where the value of the parameter you named in CNM gets returned. it's giving "drop the answer here please." 💌

---

🌈 C-BINDING DESCRIPTION 🌈

the C-binding argument descriptions are the same as the FORTRAN argument descriptions, with exactly one glow-up exception:

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

---

👑 USAGE 👑

this routine lets you retrieve the current value of Streamlines parameters of type CHARACTER. and if you want the complete list of parameters available in this utility, go look at the streamlines_params man page. she has the whole menu, no cap. 🔥

---

⭐ ACCESS ⭐

to use STGETC or c_stgetc, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c — preferably in that order. in that order fr fr, don't fight the order. 🧚

---

💜 MESSAGES 💜

see the streamlines man page for a description of all Streamlines error messages and/or informational messages. if something's acting up, that's where the drama lives. 😭

---

🍓 SEE ALSO 🍓

Online: stgeti, stgetr, stinit, stream, streamlines, streamlines_params, strset, stsetc, stseti, stsetr, stuixy, stumsl, stumta, stumxy, 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.

---

and that's the whole page bestie!! 💖 this lil legend is a UNIX manual page, stamped April 1993, and yes it's the STGETC(3NCARG) one — go get those character values, you absolute main character. slay, stay cased correctly (upper OR lower, never mixed!!), and hydrate. 💅✨🌸