1STGETC(3NCARG) NCAR GRAPHICS STGETC(3NCARG)
2
3
4
6 STGETC - Gets the current value of a Streamlines parameter of type
7 CHARACTER.
8
10 CALL STGETC (CNM,CVL)
11
13 #include <ncarg/ncargC.h>
14
15 void c_stgetc(char *cnm, char *cvl, int len)
16
18 CNM (CHARACTER, input) is the name of a parameter whose
19 character value is to be retrieved. Only the first three
20 characters of CNM are examined. The three characters may
21 either be entirely upper or entirely lower case; mixed case
22 is not recognized. It is recommended that the rest of the
23 character string be used to improve the readability of the
24 code. For example, instead of just ´ZFT´, use ´ZFT - Zero
25 Field Text String´.
26
27 CVL (CHARACTER, output) is a variable in which the value of the
28 parameter specified by CNM is to be returned.
29
31 The C-binding argument descriptions are the same as the FORTRAN
32 argument descriptions with the following exception:
33
34
35 len The size of cvl as dimensioned in the calling program.
36
38 This routine allows you to retrieve the current value of Streamlines
39 parameters of type CHARACTER. For a complete list of parameters
40 available in this utility, see the streamlines_params man page.
41
43 To use STGETC or c_stgetc, load the NCAR Graphics libraries ncarg,
44 ncarg_gks, and ncarg_c, preferably in that order.
45
47 See the streamlines man page for a description of all Streamlines error
48 messages and/or informational messages.
49
51 Online: stgeti, stgetr, stinit, stream, streamlines,
52 streamlines_params, strset, stsetc, stseti, stsetr, stuixy, stumsl,
53 stumta, stumxy, ncarg_cbind.
54
55 Hardcopy: NCAR Graphics Fundamentals, UNIX Version
56
58 Copyright (C) 1987-2007
59 University Corporation for Atmospheric Research
60
61 This documentation is free software; you can redistribute it and/or
62 modify it under the terms of the GNU General Public License as
63 published by the Free Software Foundation; either version 2 of the
64 License, or (at your option) any later version.
65
66 This software is distributed in the hope that it will be useful, but
67 WITHOUT ANY WARRANTY; without even the implied warranty of
68 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
69 General Public License for more details.
70
71 You should have received a copy of the GNU General Public License along
72 with this software; if not, write to the Free Software Foundation,
73 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
74
75
76
77UNIX April 1993 STGETC(3NCARG)