ncl_stgetc man page

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) is the name of a parameter whose character value is to be retrieved. Only the first three characters of CNM are examined. The three characters may either be entirely upper or entirely lower case; mixed case is not recognized. 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´.
CVL
(CHARACTER, output) is a variable in which the value of the parameter specified by CNM is to be returned.

C-Binding Description

The C-binding argument descriptions are the same as the FORTRAN argument descriptions with the following exception:

len
The size of cvl as dimensioned in the calling program.

Usage

This routine allows you to retrieve the current value of Streamlines parameters of type CHARACTER. For a complete list of parameters available in this utility, see the streamlines_params man page.

Access

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

Messages

See the streamlines man page for a description of all Streamlines error messages and/or informational messages.

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

Info

April 1993 UNIX NCAR GRAPHICS