DPGETI(3NCARG)

πŸ“¦ version 6.6.2, in epel 9, fedora 43, fedora 44

πŸ’… DPGETI β€” it's giving "get that internal parameter value" ✨

okay bestie, so this one is from NCAR GRAPHICS (yes, the NCAR Graphics of it all) and it's a Fortran-callable routine. DPGETI is your girl for pulling the integral value of an internal parameter β€” meaning a parameter of type INTEGER or REAL. she does both, she's versatile πŸ’–


πŸŽ€ NAME πŸŽ€

DPGETI β€” Retrieves the integral value of an internal parameter of type INTEGER or REAL.

like, literally that's her whole job. iconic behavior honestly.


✨ SYNOPSIS ✨

CALL DPGETI (PNAM,IVAL)

that's it. two args. we love a low-effort queen 🫢


🌈 C-BINDING SYNOPSIS 🌈

for my C girlies, she's bilingual:

#include <ncarg/ncargC.h>

void c_dpgeti (char *pnam, int *ival)

πŸ’– DESCRIPTION πŸ’–

okay so let's meet the two arguments, because they're the whole plot:

  • PNAM β€” an input constant or variable of type CHARACTER, and she specifies the name of the parameter to get. here's the tea though: the name must appear as the first three characters of the string. the rest of the string is basically free real estate β€” other characters may be used to document the use of the parameter being retrieved. for example, instead of just Β΄DPLΒ΄, one can use Β΄DPL - DASH PATTERN LENGTHΒ΄. self-documenting code? she invented it πŸ’…
  • IVAL β€” an output variable of type INTEGER, and it's the name of the variable into which the value of the internal parameter specified by PNAM is to be retrieved. now for the mechanics, no cap: if the internal parameter is a value "i" of type INTEGER, the value returned is "i". and if the internal parameter is a value "r" of type REAL, the value returned is "INT(r)". yes she truncates. that's the vibe check. πŸ”₯

🌸 C-BINDING DESCRIPTION 🌸

The C-binding argument descriptions are the same as the FORTRAN argument descriptions.

(translation: same energy, different syntax. nothing new to learn bestie, you already know this πŸ’œ)


πŸ‘‘ USAGE πŸ‘‘

This routine allows you to retrieve the current value of Dashpack parameters. that's the whole point of her existence and she's serving it.

for a complete list of parameters available in this utility, see the dashpack_params man page. go read it. seriously. she's not gonna list them all here, that's a different girl's job πŸ“–


🧚 ACCESS 🧚

To use DPGETI or c_dpgeti, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order.

the order thing is not a suggestion bestie, do it in that order or she will simply not load. periodt.

πŸ”₯ SEE ALSO πŸ”₯

Online: dashpack, dashpack_params, dpcurv, dpdraw, dpfrst, dpgetc, dpgetr, dplast, dpline, dpsetc, dpseti, dpsetr, dpsmth, dpvect, ncarg_cbind.

Hardcopy: None.

(ngl, that online list is a whole friend group. dpgetc and dpgetr are literally her siblings β€” one gets CHARACTER, one gets REAL, and she gets the INTEGRAL one. main character energy fr fr πŸ‘‘)


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 one shipped as part of UNIX, dated March 1995, under the name DPGETI(3NCARG) β€” so yeah, she's vintage, she's been slaying since before you were born, and she still works. go get those parameters πŸ’…βœ¨πŸŽ€

πŸ“¦ where this page comes from