fmt_ulong0(3)

✨ fmt_ulong0(3) ✨ — the libowfat glow-up 💅

okay bestie, gather round, because today we're talking about fmt_ulong0, a little function from the Library Functions Manual corner of libowfat and honestly? she's giving zero-padded unsigned long realness and I'm obsessed 🎀

🌸 NAME 🌸

fmt_ulong0 — write a zero-padded ASCII representation of an unsigned long integer 💖

🦋 SYNTAX 🦋

like, here's how you pull up on her:

#include <libowfat/fmt.h>

size_t fmt_ulong0(char *dest, unsigned long source,
                        size_t n);

✨ DESCRIPTION ✨

so fmt_ulong0 writes an ASCII representation (that's '0' through '9', base 10, no cap) of source into dest, and then it hands you back the number of bytes it actually wrote. simple. iconic. 💅

the output gets padded with '0'-bytes until it covers at least n bytes. and the way that she will not truncate if it doesn't fit?? she just lets it overflow, respectfully. no shrinking, no cutting corners, periodt.

🫶 also she does not append \0. so don't be out here expecting a null terminator, bestie, that's not her job.

and if dest equals FMT_LEN (aka it's zero), then fmt_ulong0 just returns the number of bytes it would have written. it's like a lil preview, a vibe check before the main character moment 🌈

for convenience — because libowfat loves us — fmt.h defines the integer FMT_ULONG to be big enough to hold every possible fmt_ulong output plus \0. so like, sized correctly, always 🧚

👑 SEE ALSO 👑

• scan_ulong(3)
• fmt_ulong(3)

and that's the whole thing, bestie!! slay 💜 this lil baddie is from the Library Functions Manual and the footer's giving fmt_ulong0(3) energy — same name, same date, same everything, fr fr. go forth and zero-pad responsibly ✨🎀🌸