MPIPAN(3NCARG)

💖 MPIPAN 💖 (that's MPIPAN(3NCARG), NCAR GRAPHICS, and yes bestie we're doing this)

okay so real talk: this is the MPIPAN page from the NCAR Graphics manual, and it's lowkey one of the most useful little gremlins in the whole EZMAPB lineup. it answers exactly one question, but it answers it flawlessly: is this area part of that named area or not. let's get into it. 🦋

---

✨ NAME ✨

MPIPAN — given the area identifier of one of the areas defined by whatever database was last read by the EZMAPB routines MPLNAM, MPLNDM, MPLNDR, and MPLNRI, plus a name, this function has a non-zero value if and only if the area with the specified area identifier is part of some area with the specified name.

like. that's it. that's the whole personality. it's giving "are you my people" but for map regions. 👑

---

✨ SYNOPSIS ✨

IPRT=MPIPAN(IAIN,ANME)

🌈 C-BINDING SYNOPSIS 🌈

#include <ncarg/ncargC.h>

int c_mpipan (int iain, char *anme)

---

✨ DESCRIPTION ✨

• IAIN — an input expression of type INTEGER, specifying the area identifier of a particular area of interest. basically: which lil map blob are we asking about 🗺️
• ANME — an input expression of type CHARACTER, specifying a name of interest. basically: which big name are we checking it against 💬

🌈 C-BINDING DESCRIPTION 🌈

the C-binding argument description is the same as the FORTRAN argument description. no notes. same vibes, different language, periodt. 💅

---

✨ USAGE ✨

so the statement

IPRT=MPIPAN(IAIN,ANME)

sets IPRT non-zero if and only if the area having area identifier IAIN is a part of some area having the name ANME.

for example — and this is my favorite example in the whole manual, no cap — if IMAD is the area identifier of the little island in Lake Superior called "Lake Madeline", then

MPIPAN(IMAD,'Conterminous US')

has a non-zero value, but

MPIPAN(IMAD,'Russia')

does not. 😭 the little island said "I'm American today" and honestly? iconic. 🇺🇸✨

---

✨ EXAMPLES ✨

None. 😭 bestie there are literally no examples here. the example above in USAGE is all we get and we're gonna be grateful for it. 🙈

---

✨ ACCESS ✨

to use MPIPAN or c_mpipan, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order. do not freestyle the order, the linker will simply not slay. 🫶

---

✨ 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, mpipar, mpisci, mplnam, mplndm, mplndr, mplnri, mpname, mprset, mpsetc, mpseti, mpsetl, mpsetr, supmap, supcon, ncarg_cbind

^ that's the whole friend group. go say hi. they're all part of the EZMAP cinematic universe. 🌈⭐

---

✨ COPYRIGHT ✨

Copyright (C) 1987-2009 University Corporation for Atmospheric Research

the use of this Software is governed by a License Agreement. (yes, read it. it's the rules, bestie. 📜)

---

k bye!! this page dropped way back in April 1998 under the UNIX manual, and it's still out here answering "is this area part of that area" like the queen it is — MPIPAN(3NCARG), that's the one, mwah 💅💖🎀