DPGETC(3NCARG)

✨ DPGETC ✨ (a lil page from the NCAR Graphics manual, section 3NCARG, bestie πŸ’…)

okay so picture this: you're deep in Dashpack land, you set some parameter, and now you're like… "wait, what did I actually set it to??" DPGETC is the girl who tells you. She retrieves the current character value of an internal parameter. No cap. πŸŽ€


🌸 NAME 🌸

DPGETC β€” retrieves the current character value of an internal parameter. periodt.


✨ SYNOPSIS ✨

CALL DPGETC (PNAM,CVAL)

πŸ’œ C-BINDING SYNOPSIS πŸ’œ

#include <ncarg/ncargC.h>

void c_dpgetc (char *pnam, char *cval, int len)

πŸ¦‹ DESCRIPTION πŸ¦‹

  • PNAM β€” an input constant or variable of type CHARACTER, and she specifies the name of the parameter you wanna get. πŸ‘‘ Only the first three characters of the string matter, so the rest of the string is literally just free real estate β€” use it to document what the parameter is for. Like instead of just 'CRB', you can write 'CRB - CHARACTER REPRESENTING BREAK'. iconic behavior honestly. πŸ’–
  • CVAL β€” an output variable of type CHARACTER, and she's the variable that the value of the internal parameter specified by PNAM gets retrieved into. so like, that's where the answer lands. 🫢

🌈 C-BINDING DESCRIPTION 🌈

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

  • len β€” the size of cval as dimensioned in the calling program. ✨

πŸ’… USAGE πŸ’…

this routine lets you retrieve the current value of Dashpack parameters. and bestie, if you want the complete list of parameters available in this utility, go read the dashpack_params man page. iykyk. πŸ”₯


πŸŽ€ ACCESS πŸŽ€

to use DPGETC or c_dpgetc, you gotta load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c β€” and preferably in that order, okay? don't be chaotic about it. ⭐


πŸ’€ MESSAGES πŸ’€

for a description of all Dashpack error messages and/or informational messages, see the dashpack man page. (she's got the receipts. πŸ“œ)


🧚 SEE ALSO 🧚

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

Hardcopy: None. πŸ’€ (not a single one, we're digital girlies only)


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

The use of this Software is governed by a License Agreement. πŸ“œβœ¨


okay that's the whole page!! πŸ¦‹ this one's from the UNIX manual, dated March 1995, and it lives under the name DPGETC(3NCARG) β€” so if you ever need to cite her, that's the glow-up signature. bye bestie, go retrieve some character values πŸ’–πŸŒΈπŸŽ€