mplist_push(3m17n)

💖 mplist_push — the m17n Library's lil "new property, front of the line" icon ✨

okay bestie, gather round, because we are learning about mplist_push from the m17n Library manual (that's the manual name, mwah 💅) and honestly? she's serving convenience.

---

🌸 NAME 🌸

mplist_push — the function that slides a brand-new property in at the very front of your property list 🎀

---

✨ SYNOPSIS ✨

MPlist* mplist_push (MPlist * plist, MSymbol key, void * val)

---

🦋 DESCRIPTION 🦋

So like. You know how sometimes you want to add something and you want it to be first? Main character energy. Front of the queue. That's her.

The mplist_push() function inserts, at the beginning of the property list plist, a property whose key is key and whose value is val. 💖

🌟 Now listen carefully because this is the important part: if key is a managing key, then val must be a managed object. And when that's the case, the reference count of val gets incremented by one. No cap. That's just how it is. 🫶

---

🎀 RETURN VALUE 🎀

• If the operation was successful, this function returns plist. slay, she's back, holding your list ✅
• Otherwise, it returns NULL. sad girl hours 😭

---

👑 COPYRIGHT 👑

Copyright (C) 2001 Information-technology Promotion Agency (IPA)

Copyright (C) 2001-2011 National Institute of Advanced Industrial Science and Technology (AIST)

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License <http://www.gnu.org/licenses/fdl.html>.

---

and that's the whole vibe check bestie 💜 this was Version 1.8.4, dated Mon Sep 25 2023, and it lives under mplist_push(3m17n). go forth and push your properties, queen 👑✨🌸