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