m17n_object_ref(3m17n)

💖 m17n_object_ref — the m17n Library's little refcount glow-up 💖

okay so bestie, welcome to the m17n_object_ref(3m17n) page from The m17n Library ✨ this one is short, sweet, and honestly kind of iconic for how unbothered it is.

---

🌸 NAME 🌸

m17n_object_ref — (yeah the original just leaves this blank, so like… it's the function that bumps a refcount. we move 💅)

---

✨ SYNOPSIS ✨

int m17n_object_ref (void * object)

---

🦋 DESCRIPTION 🦋

okay so here's the tea: m17n_object_ref() increments the reference count of a managed object. that's it, that's the whole vibe.

specifically, it increments the reference count of the managed object pointed to by object. one (1) object, one (1) increment. slay 🫶

---

🎀 RETURN VALUE 🎀

so like, what do you get back?

• if the resulting reference count fits in a 16-bit unsigned integer — meaning it's less than 0x10000 — the function returns that resulting reference count. ✨
• otherwise (aka it overflowed the 16-bit situation 😭) it returns -1.

that's it. that's the contract. no cap.</purl> (ok that was a typo but the energy stands, purple stays 💜)

---

🌈 ERRORS 🌈

this function never fails. not ever. not once. it's got main character energy and zero drama. 💅✨

ngl that's the whole error section. no errno, no drama, no nothing. obsessed. 👑

---

👑 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 page bestie!! 🎀 one function, one refcount, zero failures — literally the most low-maintenance thing in the whole library 🌸 this was Version 1.8.4, dated Mon Sep 25 2023, and honestly it ate. periodt. 🦋💖