Q_IRAWMASK(3)

💅 Q_IRAWMASK(3) — the library-functions-manual girlypop edition 🎀

okay so bestie, we're in section 3 of the library functions manual and this page is literally about the fixed-point math functions that mess with the integer data bits. no cap. let's get into it 🦋

---

✨ NAME ✨

Q_IRAWMASK, Q_GIRAW, Q_GIABSVAL, Q_GIVAL, Q_SIVAL — fixed-point math functions which manipulate the integer data bits 🌸

like, they don't touch the fractional vibes at all, they're strictly here for the integer bits. main character energy tbh 👑

---

🌈 SYNOPSIS 🌈

#include <sys/qmath.h>

ITYPE
Q_IRAWMASK(QTYPE q);

ITYPE
Q_GIRAW(QTYPE q);

ITYPE
Q_GIABSVAL(QTYPE q);

ITYPE
Q_GIVAL(QTYPE q);

QTYPE
Q_SIVAL(QTYPE q, ITYPE iv);

yes the include is #include <sys/qmath.h>, write it down, don't @ me 🫶

---

💖 DESCRIPTION 💖

so here's the whole squad, one by one:

• Q_IRAWMASK() — returns a q-specific bit mask for q's integer data bits. it's giving "here's the mask that belongs to your q" ✨
• Q_GIRAW() — returns q's raw masked integer data bits. raw. masked. integer. bits. all four 🍓
• Q_GIABSVAL() and Q_GIVAL() — these two besties return the absolute and real values of q's integer data bits respectively 🙈 (yes, respectively — absolute first, real second, keep the order!)
• Q_SIVAL() — sets q's integer data bits to the value iv. the setter of the group 💅

and the tea on the types ☕: all of those functions operate on the following data types:

• s8q_t
• u8q_t
• s16q_t
• u16q_t
• s32q_t
• u32q_t
• s64q_t
• u64q_t

which are referred to generically as QTYPE. and ITYPE refers to the stdint(7) integer types. iykyk 🧚

for more details, see qmath(3). go read it, i'll wait 💜

---

⭐ RETURN VALUES ⭐

• Q_IRAWMASK(), Q_GIRAW(), Q_GIABSVAL() and Q_GIVAL() return their respective values as integers of the same underlying ITYPE as q. same underlying type, always — no sneaky conversions 🔥
• Q_SIVAL() returns the value of q post change. post! change! like after the glow-up 💖

---

🦋 SEE ALSO 🦋

errno(2), qmath(3), stdint(7)

(the friend group 👯‍♀️ go say hi)

---

🌸 HISTORY 🌸

the qmath(3) functions first appeared in FreeBSD 13.0. iconic debut, no notes 👑

---

🎀 AUTHORS 🎀

the qmath(3) functions and this manual page were written by Lawrence Stewart <lstewart@FreeBSD.org> and sponsored by Netflix, Inc. — yes that Netflix, we stan a sponsored manpage 🍿💅

---

ok that's the whole page fr fr — every flag, type, and reference accounted for, nothing skipped, nothing invented. vibe check: passed ✅

and that's the wrap bestie 💜 this lil beauty is from the Debian fam, dated July 8, 2018, filed right back under Q_IRAWMASK(3) — mwah, see u in the next manpage 😘🫶