MPFNME(3NCARG)

💖 MPFNME 💖

okay bestie, so this is an NCAR Graphics page, from the 3NCARG manual, and it's literally about one little function that gives you the full name of a map area. yes, the WHOLE name, parents included. slay.

---

✨ NAME ✨

MPFNME — give it 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, and it hands you back the full name of that area — including the prepended names of all containing (parent) areas, all the way up to and including a level you specify. iconic behaviour honestly.

---

✨ 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 — an input expression of type INTEGER, specifying the area identifier of a particular area of interest. like, WHICH area are we talking about, bestie.
• ILVL — an input expression of type INTEGER, specifying the highest level of containing (parent) name to be included in the returned full name. how far up the family tree do you want to go 🫶

🌸 C-BINDING DESCRIPTION 🌸

The C-binding argument description is the same as the FORTRAN argument description. no notes, it's giving copy-paste energy and we respect it.

---

✨ USAGE ✨

so you declare "CHARACTER*128 MPFNME,FNME", and then this 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. periodt.

wanna see it in action? say 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)'

see that dash with blanks on either side? that's the separator. note it. it's lowkey doing a lot of work here 💅

---

✨ EXAMPLES ✨

use the ncargex command to see the following relevant example: mpex12. go look, it's right there 🎀

---

✨ ACCESS ✨

To use MPFNME or c_mpfnme, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c — preferably in that order. in. that. order. don't be chaotic about it 🙈

---

✨ 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

like, that's the whole friend group right there 💜

---

✨ COPYRIGHT ✨

Copyright (C) 1987-2009 University Corporation for Atmospheric Research The use of this Software is governed by a License Agreement.

---

okay that's the whole page bestie, go forth and name your map areas 🌈💅

this one's from the UNIX manual, MPFNME(3NCARG), dated April 1998 — vintage, honestly. stay iconic ✨🦋