NAME¶
MPFNME - Given the area identifier of one of the areas defined by whatever
database was last read by one of the EZMAPB routines MPLNAM, MPLNDM, MPLNDR,
and MPLNRI, this function returns the full name of the area, including the
prepended names of all containing (parent) areas, up to and including a
specified level.
SYNOPSIS¶
CHARACTER*128 MPFNME,FNME
FNME=MPFNME(IAIN,ILVL)
C-BINDING SYNOPSIS¶
#include <ncarg/ncargC.h>
char *c_mpfnme (int iain, int ilvl)
DESCRIPTION¶
- IAIN
- is an input expression of type INTEGER, specifying the area identifier of
a particular area of interest.
- ILVL
- is an input expression of type INTEGER, specifying the highest level of
containing (parent) name to be included in the returned full name.
C-BINDING DESCRIPTION¶
The C-binding argument description is the same as the FORTRAN argument
description.
USAGE¶
Given the declaraion "CHARACTER*128 MPFNME,FNME", the executable
statement "FNME=MPFNME(IAIN,ILVL)" will retrieve in FNME the full
name of the area with area identifier IAIN, including the prepended names of
containing (parent) areas, up to the level ILVL. For example, if IMAD is the
area identifier of the little island in Lake Superior called "Lake
Madeline", a level-4 area whose name in the database is actually
"Madeline Island (Lake Superior)" and whose parent (also at level 4)
is an area called "Wisconsin", then MPFNME(IMAD,4) = 'Wisconsin -
Madeline Island (Lake Superior)'. Note the use of a dash surrounded by blanks
as a separator.
EXAMPLES¶
Use the ncargex command to see the following relevant example: mpex12.
ACCESS¶
To use MPFNME or c_mpfnme, load the NCAR Graphics libraries ncarg, ncarg_gks,
and ncarg_c, preferably in that order.
SEE ALSO¶
Online: ezmap, ezmap_params, mapaci, mapbla, mapblm, mapdrw, mapeod, mapfst,
mapgci, mapgrd, mapgrm, mapgtc, mapgti, mapgtl, mapgtr, mapint, mapiq, mapiqa,
mapiqd, mapiqm, mapit, mapita, mapitd, mapitm, maplbl, maplmb, maplot, mappos,
maproj, maprs, maprst, mapsav, mapset, mapstc, mapsti, mapstl, mapstr, maptra,
maptri, maptrn, mapusr, mapvec, mpchln, mpgetc, mpgeti, mpgetl, mpgetr,
mpglty, mpiaty, mpifnb, mpilnb, mpiola, mpiosa, mpipai, mpipan, mpipar,
mpisci, mplnam, mplndm, mplndr, mplnri, mpname, mprset, mpsetc, mpseti,
mpsetl, mpsetr, supmap, supcon, ncarg_cbind
COPYRIGHT¶
Copyright (C) 1987-2009
University Corporation for Atmospheric Research
The use of this Software is governed by a License Agreement.