VVGETC(3NCARG)

✨ VVGETC ✨ (aka VVGETC(3NCARG) from the NCAR GRAPHICS manual, bestie)

okay so real talk, this is a lil routine that pulls a character value out of a Vectors parameter. she's small. she's mighty. she's giving librarian energy but for strings. let's GO 💖

---

🌸 NAME 🌸

VVGETC — gets the current value of a Vectors parameter of type CHARACTER. that's it. that's the whole job. iconic behavior honestly 💅

---

🎀 SYNOPSIS 🎀

CALL VVGETC (CNM,CVL)

---

🦋 C-BINDING SYNOPSIS 🦋

#include <ncarg/ncargC.h>

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

---

💜 DESCRIPTION 💜

• CNM — (CHARACTER, input) the name of the parameter whose character value you wanna retrieve. heads up: only the first three characters of CNM are examined, so like, don't go wild in the first three slots. those three characters can be entirely upper case or entirely lower case — mixed case is NOT recognized 😭 so MxT will simply not slay. it is recommended that you use the rest of the character string to make your code more readable, because future-you deserves nice things. for example, instead of just ´MXT´, use ´MXT - Maximum Vector Text String´. yes bestie, write a whole sentence in there. it's fine. it's encouraged. 🫶
• CVL — (CHARACTER, output) the variable where the value of the parameter specified by CNM gets returned. this is where the good stuff lands. 💖

---

🌈 C-BINDING DESCRIPTION 🌈

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

• len — the size of cvl as dimensioned in the calling program. that's it, that's the whole diff. she's just here to keep your buffer safe. a queen. 👑

---

⭐ USAGE ⭐

this routine lets you retrieve the current value of Vectors parameters of type CHARACTER. if you want the complete list of parameters available in this utility, go read the vectors_params man page. iykyk. 📚

---

🔥 ACCESS 🔥

to use VVGETC or c_vvgetc, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c — and do it preferably in that order, okay? order matters here, no cap. ✨

---

💀 MESSAGES 💀

see the vectors man page for a description of all Vectors error messages and/or informational messages. everything that can yell at you lives over there. 🙈

---

🌸 SEE ALSO 🌸

Online: vectors, vectors_params, vvectr, vvgeti, vvgetr, vvinit, vvrset, vvsetc, vvseti, vvsetr, vvudmv, vvumxy, 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.

---

ok that's the whole page bestie, go get those character values, stay case-consistent, and remember: three characters only, no mixed case, periodt. 💅

mwah! this was the UNIX manual page for VVGETC(3NCARG) from the NCAR GRAPHICS collection, dated April 1993, and it's yours forever now 🦋✨