MRMCLOSEHIERARCHY(3)

💖 MRMCLOSEHIERARCHY 💖

okay bestie, welcome to the library call section of the manual, and today's main character is MrmCloseHierarchy — she closes a UID hierarchy, and honestly? she's the cleanup queen we all need. 🧹✨

✨ NAME ✨

MrmCloseHierarchy — closes a UID hierarchy 🎀

🌸 SYNOPSIS 🌸

#include <Mrm/MrmPublic.h>
Cardinal MrmCloseHierarchy(
MrmHierarchy hierarchy_id);

🦋 DESCRIPTION 🦋

so, the MrmCloseHierarchy function does the reverse of opening — she closes a UID hierarchy that was previously opened by MrmOpenHierarchyPerDisplay. and no cap, she's thorough: all files associated with the hierarchy get closed by the Motif Resource Manager (MRM), and all associated memory is returned. giving full cleanup, zero leftovers, immaculate vibes. 💅

• hierarchy_id — specifies the ID of a previously opened UID hierarchy. this hierarchy_id was returned in a previous call to MrmOpenHierarchyPerDisplay. so like, you don't make it up yourself bestie, you get it handed to you. 🫶

🔥 RETURN 🔥

she returns one of the following status return constants, and you're gonna want to actually check which one:

• MrmSUCCESS — the function executed successfully. slay. 🎉
• MrmBAD_HIERARCHY — the hierarchy ID was invalid. the vibe check failed. 💀
• MrmFAILURE — the function failed. 😭

💜 RELATED 💜

MrmOpenHierarchyPerDisplay(3) — the one who opened it in the first place, iykyk.

and that's the whole page, bestie!! this was MrmCloseHierarchy, a library call straight from the Motif manual pages, and yes the footer literally just says her name again: MrmCloseHierarchy(library call). iconic behaviour, no notes. now go close that hierarchy and free that memory, you gorgeous legend 👑🌈💖