fmt_8long(3)

💅 fmt_8long(3) — Library Functions Manual ✨

okay so bestie, lemme put you on to something. this is fmt_8long, from the library functions manual, and she's literally the moment. no cap.

🎀 NAME 🎀

fmt_8long — write an octal ASCII representation of an unsigned long integer 🌈

like... she takes your number and spells it out in octal. that's the whole gig. iconic behavior honestly.

✨ SYNTAX ✨

#include <libowfat/fmt.h>

size_t fmt_8long(char *dest,size_t source);

that's it. two params, one header, zero drama. 💖

🦋 DESCRIPTION 🦋

okay so here's the tea. fmt_8long writes an ASCII representation of source to dest, using the digits '0' to '7' — that's base 8, babes — and then it returns the number of bytes it wrote. slay. 🎀

one thing though: fmt_8long does not append \0. nope. not even a little one. it's giving "you're on your own for the terminator" energy and honestly? valid. 🙈

but wait, there's more. if dest equals FMT_LEN — which, jsyk, means it is zero — then fmt_8long returns the number of bytes it would have written. so you can literally vibe check how much space you need before committing. main character foresight fr fr. 👑

and for convenience?? fmt.h defines the integer FMT_8LONG to be big enough to contain every possible fmt_8long output plus \0. every single one. so if you're allocating, that's your girl. 💖

lowkey important: no \0, so don't be out here treating it like a C string unless you add one yourself. iykyk. 💀

🌸 SEE ALSO 🌸

• scan_8long(3) — the other half of the duo, she reads what this one writes 🫶

k that's the whole page bestie, go forth and format your octal numbers like the icon you are 💜🌟

this has been fmt_8long(3) from the Library Functions Manual, out here in these streets doing octal things, brought to you by the manual itself — mwah, ily, bye!! 🎀✨💅