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

NAME

6       MPFNME - 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 full name of the
9       area, including the prepended names of all containing (parent) areas,
10       up to and including a specified level.
11

SYNOPSIS

13       CHARACTER*128 MPFNME,FNME
14
15       FNME=MPFNME(IAIN,ILVL)
16

C-BINDING SYNOPSIS

18       #include <ncarg/ncargC.h>
19
20       char *c_mpfnme (int iain, int ilvl)
21

DESCRIPTION

23       IAIN        is an input expression of type INTEGER, specifying the area
24                   identifier of a particular area of interest.
25
26       ILVL        is an input expression of type INTEGER, specifying the
27                   highest level of containing (parent) name to be included in
28                   the returned full name.
29

C-BINDING DESCRIPTION

31       The C-binding argument description is the same as the FORTRAN argument
32       description.
33

USAGE

35       Given the declaraion "CHARACTER*128 MPFNME,FNME", the executable
36       statement "FNME=MPFNME(IAIN,ILVL)" will retrieve in FNME the full name
37       of the area with area identifier IAIN, including the prepended names of
38       containing (parent) areas, up to the level ILVL.  For example, if IMAD
39       is the area identifier of the little island in Lake Superior called
40       "Lake Madeline", a level-4 area whose name in the database is actually
41       "Madeline Island (Lake Superior)" and whose parent (also at level 4) is
42       an area called "Wisconsin", then MPFNME(IMAD,4) = 'Wisconsin - Madeline
43       Island (Lake Superior)'.  Note the use of a dash surrounded by blanks
44       as a separator.
45

EXAMPLES

47       Use the ncargex command to see the following relevant example: mpex12.
48

ACCESS

50       To use MPFNME or c_mpfnme, load the NCAR Graphics libraries ncarg,
51       ncarg_gks, and ncarg_c, preferably in that order.
52

SEE ALSO

54       Online: ezmap, ezmap_params, mapaci, mapbla, mapblm, mapdrw, mapeod,
55       mapfst, mapgci, mapgrd, mapgrm, mapgtc, mapgti, mapgtl, mapgtr, mapint,
56       mapiq, mapiqa, mapiqd, mapiqm, mapit, mapita, mapitd, mapitm, maplbl,
57       maplmb, maplot, mappos, maproj, maprs, maprst, mapsav, mapset, mapstc,
58       mapsti, mapstl, mapstr, maptra, maptri, maptrn, mapusr, mapvec, mpchln,
59       mpgetc, mpgeti, mpgetl, mpgetr, mpglty, mpiaty, mpifnb, mpilnb, mpiola,
60       mpiosa, mpipai, mpipan, mpipar, mpisci, mplnam, mplndm, mplndr, mplnri,
61       mpname, mprset, mpsetc, mpseti, mpsetl, mpsetr, supmap, supcon,
62       ncarg_cbind
63
65       Copyright (C) 1987-2009
66       University Corporation for Atmospheric Research
67       The use of this Software is governed by a License Agreement.
68
69
70
71UNIX                              April 1998                    MPFNME(3NCARG)
Impressum