VVGETR(3NCARG)

✨ VVGETR ✨ — the NCAR Graphics girlies' guide 💅

okay so bestie, we're in the NCAR GRAPHICS section of the manual, VVGETR(3NCARG), and this one is genuinely a little icon. she does exactly one thing and she does it flawlessly. no cap.

---

🌸 NAME 🌸

VVGETR — gets the current value of a Vectors parameter of type REAL. that's it. that's the whole job. and she ATE. 🔥

---

🎀 SYNOPSIS 🎀

CALL VVGETR (CNM,RVL)

like... two arguments. two. we love a low-maintenance queen. 🫶

---

🦋 C-BINDING SYNOPSIS 🦋

for the C girlies, yes, she has a C binding too, she contains multitudes:

#include <ncarg/ncargC.h>

void c_vvgetr(char *cnm, float *rvl)

---

💖 DESCRIPTION 💖

okay so let's talk about our two arguments, because they're both main characters:

• CNM — (CHARACTER, input) this is the name of the parameter whose real value you want to retrieve. important detail: only the first three characters of CNM are examined. the three characters can be entirely upper case or entirely lower case — mixed case is NOT recognized, so don't try to be cute with it, she will not understand you. 🙈 and honestly? it's recommended that you use the rest of the character string to make your code more readable. like, instead of just DMX, use DMX - Device Maximum Vector Size. see how much nicer that is? iykyk.
• RVL — (REAL, output) a variable where the value of the parameter specified by CNM gets returned. she's the output bestie, she receives the goods. 💌

---

🌈 C-BINDING DESCRIPTION 🌈

the C-binding argument descriptions are literally the same as the FORTRAN argument descriptions. same facts, different font. periodt. 💅

---

⭐ USAGE ⭐

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

and if you want a complete list of parameters available in this utility, go check the vectors_params man page. she has the full menu. 🍓

---

🧚 EXAMPLES 🧚

use the ncargex command to see these relevant examples: ffex02, ffex05, vvex01, vvex02.

not me telling you to actually run them instead of just reading about them... do it. the examples are the moment. 👑

---

👑 ACCESS 👑

to use VVGETR or c_vvgetr, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c — preferably in that order. order matters bestie, don't freestyle it. 🌟

---

💜 MESSAGES 💜

see the vectors man page for a description of all Vectors error messages and/or informational messages. if she's yelling at you, that's where the translation lives. 😭

---

💀 SEE ALSO 💀

Online: vectors, vectors_params, vvectr, vvgetc, vvgeti, 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.

---

and that's the whole page bestie!! 🫶 this was VVGETR(3NCARG) from the UNIX manual, dated April 1993 — yes she's a vintage queen and she's still serving. 💖✨ mwah, go get those real values. 🌈