1MPNAME(3NCARG)                   NCAR GRAPHICS                  MPNAME(3NCARG)
2
3
4

NAME

6       MPNAME - Given the area identifier of one of the areas defined by
7       whatever database was last read by one of the EZMAPB routines MPLNAM,
8       MPLNDM, MPLNDR, and MPLNRI, this function returns the name of the area.
9

SYNOPSIS

11       CHARACTER*64 MPNAME,NAME
12
13       NAME=MPNAME(IAIN)
14

C-BINDING SYNOPSIS

16       #include <ncarg/ncargC.h>
17
18       char *c_mpname (int iain)
19

DESCRIPTION

21       IAIN        is an input expression of type INTEGER, specifying the area
22                   identifier of a particular area of interest.
23

C-BINDING DESCRIPTION

25       The C-binding argument description is the same as the FORTRAN argument
26       description.
27

USAGE

29       Given the declaration "CHARACTER*64 MPNAME,NAME", the executable
30       statement "NAME=MPNAME(IAIN)" will retrieve in NAME the name of the
31       area with area identifier IAIN.  For example, if IMAD is the area
32       identifier of the little island in Lake Superior called "Lake
33       Madeline", then MPNAME(IMAD) = 'Madeline Island (Lake Superior)'.
34
35       To get the name of the area, at a specified level, that contains an
36       area with a specified area identifier, use MPNAME in combination with
37       MPIOAR.  For example, MPNAME(MPIOAR(IMAD,3)) = 'Conterminous US', and
38       MPNAME(MPIOAR(IMAD,2)) = 'North America'.
39

EXAMPLES

41       Use the ncargex command to see the following relevant examples: mpex11,
42       mpex12.
43

ACCESS

45       To use MPNAME or c_mpname, load the NCAR Graphics libraries ncarg,
46       ncarg_gks, and ncarg_c, preferably in that order.
47

SEE ALSO

49       Online: ezmap, ezmap_params, mapaci, mapbla, mapblm, mapdrw, mapeod,
50       mapfst, mapgci, mapgrd, mapgrm, mapgtc, mapgti, mapgtl, mapgtr, mapint,
51       mapiq, mapiqa, mapiqd, mapiqm, mapit, mapita, mapitd, mapitm, maplbl,
52       maplmb, maplot, mappos, maproj, maprs, maprst, mapsav, mapset, mapstc,
53       mapsti, mapstl, mapstr, maptra, maptri, maptrn, mapusr, mapvec, mpchln,
54       mpfnme, mpgetc, mpgeti, mpgetl, mpgetr, mpglty, mpiaty, mpifnb, mpilnb,
55       mpiola, mpiosa, mpipai, mpipan, mpipar, mpisci, mplnam, mplndm, mplndr,
56       mplnri, mprset, mpsetc, mpseti, mpsetl, mpsetr, supmap, supcon,
57       ncarg_cbind
58

60       Copyright (C) 1987-2007
61       University Corporation for Atmospheric Research
62
63       This documentation is free software; you can redistribute it and/or
64       modify it under the terms of the GNU General Public License as
65       published by the Free Software Foundation; either version 2 of the
66       License, or (at your option) any later version.
67
68       This software is distributed in the hope that it will be useful, but
69       WITHOUT ANY WARRANTY; without even the implied warranty of
70       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
71       General Public License for more details.
72
73       You should have received a copy of the GNU General Public License along
74       with this software; if not, write to the Free Software Foundation,
75       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
76
77
78
79UNIX                              April 1998                    MPNAME(3NCARG)
Impressum