NAME

       MPIPAR - 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 area identifier of
       that area's containing (parent) area.

SYNOPSIS

       IPAR=MPIPAR(IAIN)

C-BINDING SYNOPSIS

       #include <ncarg/ncargC.h>

       int c_mpipar (int iain)

DESCRIPTION

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

C-BINDING DESCRIPTION

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

USAGE

       The statement "IPAR=MPIPAR(IAIN)" retrieves in IPAR the area identifier of the parent of  the  area  with
       area  identifier IAIN.  For example, if IMAD is the area identifier of the little island in Lake Superior
       called "Lake Madeline", then MPIPAR(IMAD) is the area identifier of the area called "Wisconsin".

EXAMPLES

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

ACCESS

       To use MPIPAR or c_mpipar, 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, mpfnme, mpgetc, mpgeti, mpgetl, mpgetr,  mpglty,  mpiaty,
       mpifnb,  mpilnb,  mpiola, mpiosa, mpipai, mpipan, 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.

UNIX                                               April 1998                                     MPIPAR(3NCARG)