LOOKUP(3PVM)

💖 LOOKUP — pvm_lookup 💖

okay bestie, we're doing PVM Version 3.4 today and this one is literally a little time capsule 🎀

✨ NAME ✨

pvm_lookup — retrieve data from pvmd database

In Version 3.4: Relaced by pvm_getinfo. (yes bestie, "relaced" — that's what the original says, and honestly? she's an icon for that 💅 the actual tea is that pvm_getinfo is the one you want now, this one is old-school)

---

🌸 SYNOPSIS 🌸

C

int cc = pvm_lookup( char *name, int index, int *data )

Fortran

Not available. sorry Fortran girlies, she's C-only 🫶

---

🦋 PARAMETERS 🦋

• name — the class name, and it's a null-terminated string, so no funny business ✨
• index — the class index. it's >= 0, OR you can pass -1 to mean "just give me the first available one" 👑
• data — this is where the data stored in the <name, index> entry gets handed back to you 💜

---

🌈 DESCRIPTION 🌈

So for the whole lowdown on this database, go read pvm_insert(3PVM) — she explains the lore, not me 😌

pvm_lookup does exactly one thing and she does it well: she retrieves the data stored at the location given by <name, index>.

And if you pass index as -1? Then you get the data stored at the first existing index in the named class. like, "idk just give me whatever's there first" energy, and honestly same 💀

---

💀 ERRORS 💀

vibe check time 🧚 if it works, pvm_lookup returns the index at which the data was stored, and that's >= 0. anything negative means something went wrong:

• PvmBadParam — you gave an invalid argument value. ma'am. 😭
• PvmNoEntry — the <name, index> pair you asked for does not exist. it's giving empty shelf 🍓

---

🎀 SEE ALSO 🎀

• pvm_delete(3PVM)
• pvm_insert(3PVM)

---

mwah 💋 that's the whole page — pvm_lookup from PVM Version 3.4, dated 27 June, 1994, and yes she's still slaying in the archives. go read pvm_getinfo if you're on 3.4 tho fr fr 🫶✨