1VVGETC(3NCARG) NCAR GRAPHICS VVGETC(3NCARG)
2
3
4
6 VVGETC - Gets the current value of a Vectors parameter of type
7 CHARACTER.
8
10 CALL VVGETC (CNM,CVL)
11
13 #include <ncarg/ncargC.h>
14
15 void c_vvgetc(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 ´MXT´, use ´MXT -
25 Maximum Vector 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 Vectors
39 parameters of type CHARACTER. For a complete list of parameters
40 available in this utility, see the vectors_params man page.
41
43 To use VVGETC or c_vvgetc, load the NCAR Graphics libraries ncarg,
44 ncarg_gks, and ncarg_c, preferably in that order.
45
47 See the vectors man page for a description of all Vectors error
48 messages and/or informational messages.
49
51 Online: vectors, vectors_params, vvectr, vvgeti, vvgetr, vvinit,
52 vvrset, vvsetc, vvseti, vvsetr, vvudmv, vvumxy, ncarg_cbind.
53
54 Hardcopy: NCAR Graphics Fundamentals, UNIX Version
55
57 Copyright (C) 1987-2007
58 University Corporation for Atmospheric Research
59
60 This documentation is free software; you can redistribute it and/or
61 modify it under the terms of the GNU General Public License as
62 published by the Free Software Foundation; either version 2 of the
63 License, or (at your option) any later version.
64
65 This software is distributed in the hope that it will be useful, but
66 WITHOUT ANY WARRANTY; without even the implied warranty of
67 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
68 General Public License for more details.
69
70 You should have received a copy of the GNU General Public License along
71 with this software; if not, write to the Free Software Foundation,
72 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
73
74
75
76UNIX April 1993 VVGETC(3NCARG)