scan_base64url(3)

✨ scan_base64url(3) — the manual, but make it cute ✨

okay bestie, buckle up, because we're decoding base64url and honestly? it's giving main character energy. this one lives in section 3 of the Library Functions Manual, so if you ever need to cite her, she's scan_base64url(3). 💅

🌸 NAME 🌸

scan_base64url — decode base64url encoded data

🎀 SYNTAX 🎀

#include <libowfat/textcode.h>

size_t scan_base64url(const char *src,char *dest,size_t* destlen);

like, that's the whole vibe. one include, one function, no notes. 🫶

💖 DESCRIPTION 💖

so first of all, what even is base64url? it's a variant of base64 built for URLs, and the tea is this: standard base64 uses / and +, which can cause problems in URLs. so base64url uses - and _ instead. also, base64url does not use = padding at the end. periodt.

scan_base64url decodes base64url encoded data from src into dest. she will stop when she encounters any non-valid input characters — like, she's not gonna fight it, she just stops. then she writes the number of decoded bytes in dest into *destlen, and returns the number of bytes decoded from src. iconic behavior, honestly. ✨

okay so real talk about padding, because this trips people up: many base64 variants demand padding in the last block. some don't. this implementation will consume padding if it is there, but will not complain if it is not. she's chill like that. 💜

and the flexibility?? bestie:

• dest can be NULL.
• destlen can be NULL.
• dest can be src.

yes you read that right, all three. lowkey obsessed. 🦋

⭐ RETURN VALUE ⭐

scan_base64url returns the number of bytes successfully scanned and processed from src. that's it, that's the number. no cap. 🍓

🌈 EXAMPLES 🌈

here's the moment you've been waiting for:

scan_base64url("Zm5vcmQ",buf,&i) -> return 7, i=5, buf="fnord"

return 7, i=5, and buf comes out as "fnord". ate. no crumbs. 👑

🔥 SEE ALSO 🔥

• scan_base64(3)
• scan_xlong(3)
• scan_8long(3)
• fmt_ulong(3)

and that's the page, bestie 🧚 this was scan_base64url(3) from the Library Functions Manual, section 3 — go forth and decode responsibly, mwah 💖🎀✨