EXPAND_NUMBER(3)

💅 EXPAND_NUMBER(3) — the libutil glow-up

okay bestie, so this is a page from the Library Functions Manual, and the function at the center of it all is expand_number — she takes a cute little human-readable string and turns it into a real actual number. main character energy fr fr.

---

✨ NAME ✨

expand_number — format a number from human readable form 🎀

📚 LIBRARY 📚

System Utilities Library (libutil, -lutil) 💖

🌸 SYNOPSIS 🌸

#include <libutil.h>

int
expand_number(const char *buf, uint64_t *num);

💫 DESCRIPTION 💫

so the expand_number() function parses the buf string and stores an unsigned 64-bit quantity at *num. that's it, that's the vibe. ✨

expand_number() is case-insensitive (she does not care about your capitalization choices, live your truth) and she follows the SI power of two convention. iykyk.

the suffixes are, and i cannot stress this enough, iconic:

• K — kilo — 1024
• M — mega — 1048576
• G — giga — 1073741824
• T — tera — 1099511627776
• P — peta — 1125899906842624
• E — exa — 1152921504606846976

look at those numbers. enormous. so blessed. 🔥

🫶 RETURN VALUES 🫶

upon successful completion, the value 0 is returned — slay 💅

otherwise, the value -1 is returned and the global variable errno is set to indicate the error. not the vibe, but she's honest about it. 😭

💀 ERRORS 💀

expand_number() will fail if:

• [EINVAL] — the given string contains no digits. literally nothing to work with bestie, where are the numbers 🥲
• [EINVAL] — an unrecognized suffix was given. she does not know her, she does not recognize her 🚫
• [ERANGE] — result doesn't fit into 64 bits. too much woman for this container, the number simply outgrew the format 💀

👀 SEE ALSO 👀

• humanize_number(3) — the reverse bestie, the other half of the duo 🌈

🦋 HISTORY 🦋

the expand_number() function first appeared in FreeBSD 6.3. a humble queen rising. 👑

---

and that's the whole page bestie!! this one came to you from Debian, dated July 20, 2019 — periodt, mwah 💋💖✨