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.