div(3)

💅 div(3) — the girlies are dividing integers

okay bestie, welcome to the div(3) page from your Library Functions Manual 💖 this one is short, sweet, and honestly kind of iconic — it's the "I need my quotient AND my remainder at the same time, in one cute lil struct" page.

---

✨ NAME ✨

div, ldiv, lldiv, imaxdiv — compute quotient and remainder of an integer division 🎀 like literally both at once, no doing it twice.

---

📚 LIBRARY 📚

Standard C library (libc, -lc) 🫶

---

🌸 SYNOPSIS 🌸

#include <stdlib.h>

div_t div(int numerator, int denominator);
ldiv_t ldiv(long numerator, long denominator);
lldiv_t lldiv(long long numerator, long long denominator);

#include <inttypes.h>

imaxdiv_t imaxdiv(intmax_t numerator, intmax_t denominator);

🧚 Feature Test Macro Requirements for glibc 🧚

(peep feature_test_macros(7) for the whole lore)

lldiv():

_ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L

---

💖 DESCRIPTION 💖

So div() computes the value numerator/denominator and hands you back the quotient AND the remainder, both packed into a structure called div_t that has two integer members — and their order is unspecified, so don't go assuming, bestie — named quot and rem. The quotient is rounded toward zero. And the result satisfies this iconic little equation:

quot*denominator+rem = numerator

The ldiv(), lldiv(), and imaxdiv() functions do the exact same thing, just dividing numbers of the indicated type and returning the result in a structure of the indicated name. In every single case, the fields quot and rem have the same type as the function arguments. consistent queen 💅

---

👑 RETURN VALUE 👑

The div_t (etc.) structure. that's it. that's the whole thing. periodt 💜

---

🔥 ATTRIBUTES 🔥

For an explanation of the terms used in this section, see attributes(7).

• div(), ldiv(), lldiv(), imaxdiv() — Thread safety: MT-Safe ✅

---

⭐ STANDARDS ⭐

C11, POSIX.1-2008. certified. validated. no cap.

---

🌈 HISTORY 🌈

POSIX.1-2001, C89, C99, SVr4, 4.3BSD.

and then — the glow-up era — lldiv() and imaxdiv() were added in C99 ✨

---

🍓 EXAMPLES 🍓

after this:

div_t q = div(-5, 3);

the values q.quot and q.rem are -1 and -2, respectively. yeah — negative numbers round toward zero, so -1 and -2, not whatever your vibes were expecting 😭 the math said what it said.

---

🦋 SEE ALSO 🦋

abs(3), remainder(3)

---

ngl bestie if you catch yourself doing / and % right next to each other on the same numbers, just call div() instead and save yourself the second division. the struct is right there. take it. 🫶

---

okay that's the page!! mwah 💜 this was written against Linux man-pages 6.20, dated 2026-02-08, and yes the manual name is div(3) — go divide something and slay ✨🎀