m17n_object_unref(3m17n)

✨ NAME ✨

m17n_object_unref — bestie, it's the un-reference function from the m17n library 💖

---

🎀 SYNOPSIS 🎀

int m17n_object_unref (void * object)

---

🦋 DESCRIPTION 🦋

Okay so listen. Managed objects in m17n keep a little reference count, right? Like a group chat where everyone's counting who's still in it.

The m17n_object_unref() function decrements the reference count of the managed object pointed to by object.

And the moment that count hits zero? The object gets freed by its freer function. That's it. That's the whole vibe. It's giving "last one out turns off the lights" 💅

---

🌸 RETURN VALUE 🌸

This function returns the resulting reference count — but only if it fits in a 16-bit unsigned integer (aka, less than 0x10000). If it doesn't fit? You get -1, no cap.

So the way that a return value of zero means the object is freed. Literally zero = gone, bestie 🫶

---

🌈 ERRORS 🌈

Not a single thing. This function never fails. Iconic behaviour, honestly. Periodt. 👑

---

👑 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>.

---

okay that's the whole page, you ate it 💖 this was Version 1.8.4, dated Mon Sep 25 2023, and it's m17n_object_unref(3m17n) — go forth and unref responsibly, bestie, and remember: only unref what you own 🦋✨