DIV(3P)

👑 DIV(3P) — the POSIX Programmer's Manual, bestie edition 💅

Okay so real talk, this page lives in the POSIX Programmer's Manual, and it's called div — and yes she's serving quotient-and-remainder realness, we love her for that.

🌸 PROLOG

So this manual page is part of the POSIX Programmer's Manual, okay? And here's the thing — the Linux implementation of this interface may differ, so like, go check the corresponding Linux manual page for the details of Linux behavior if that's your situation. Or... the interface might not even be implemented on Linux at all. 🙈 Which is a vibe, honestly.

---

✨ NAME

div — compute the quotient and remainder of an integer division 💖

---

🎀 SYNOPSIS

#include <stdlib.h>

div_t div(int numer, int denom);

That's it, that's the whole girl. Short, sweet, iconic. ✨

---

🦋 DESCRIPTION

So first things first, bestie: everything described on this reference page is aligned with the ISO C standard. If there's any conflict between what's written here and what the ISO C standard says, that conflict is unintentional — no cap, nobody's trying to start drama. This volume of POSIX.1‐2017 simply defers to the ISO C standard. Periodt.

Now, the actual tea 🍓: the div() function shall compute the quotient and remainder of the division of the numerator numer by the denominator denom.

And here's the little detail that's lowkey important: if the division is inexact, the resulting quotient is the integer of lesser magnitude that is the nearest to the algebraic quotient. (Read that twice, it matters. 👀)

And if the result cannot be represented, the behavior is undefined — like, genuinely undefined, don't come crying to me, that's just the rules. Otherwise, though? Otherwise it's all good and:

quot*denom+rem shall equal numer

Math girlies stay winning. 🔥

---

💜 RETURN VALUE

The div() function shall return a structure of type div_t, and that structure is carrying both the quotient and the remainder, because why would she make you do two calls when one will do. Slay.

The structure includes the following members, in any order:

int  quot;  /* quotient */
int  rem;   /* remainder */

Two little ints, doing the most. 🫶

---

🌈 ERRORS

No errors are defined.

The following sections are informative. (Yes, that's it, that's the whole error section. She's unbothered. She's thriving. ✨)

---

🧚 EXAMPLES

None.

---

⭐ APPLICATION USAGE

None.

---

💀 RATIONALE

None.

---

🌸 FUTURE DIRECTIONS

None.

---

🔥 SEE ALSO

• ldiv()

And from the Base Definitions volume of POSIX.1‐2017: <stdlib.h>

---

📜 COPYRIGHT

Okay so legal time, gotta give credit where credit is due, because these girlies earned it:

Portions of this text are reprinted and reproduced in electronic form from IEEE Std 1003.1-2017, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 7, 2018 Edition, Copyright (C) 2018 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group.

And here's the important bit, so listen up: in the event of any discrepancy between this version and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. Like, that's the final boss, that's who you listen to. 👑

The original Standard can be obtained online at http://www.opengroup.org/unix/online.html .

Also: any typographical or formatting errors that appear in this page are most likely to have been introduced during the conversion of the source files to man page format. So if you spot one, that's probably why. To report such errors, see https://www.kernel.org/doc/man-pages/reporting_bugs.html .

---

ngl that copyright section is giving lawyer main character energy, but we respect it 💅

---

And that's a wrap, bestie! This whole page came to you from IEEE/The Open Group, dated 2017, under the name DIV(3P). Go forth and divide responsibly, mwah 🎀💖✨