ustrtod(3alleg4)

📦 version 4.4.3.1, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 ustrtod — the "string goes in, float comes out" glow-up 💖

okay bestie, so this one lives in the Allegro game programming library manual, and it's literally just here to turn your text into a double. no cap. 🦋

✨ SYNOPSIS ✨

#include <allegro.h>

double ustrtod(const char *s, char **endp);

like, that's it. that's the whole vibe. 🎀

🌸 DESCRIPTION 🌸

so here's the tea ☕ — ustrtod grabs as many characters of s as look like a floating point number, mushes them into one actual floating point number, and then (if endp is not a NULL pointer) it sets *endp to point at the first character it didn't use. like it's telling you "okay girl, everything after this is all yours." 💅

here's the little example they gave us, and honestly it eats:

char *endp, *string = "456.203 askdfg";
double number = ustrtod(string, &endp);

see how "456.203" gets slurped up and the " askdfg" part is just left there chilling? yeah. that. ✨

🫶 RETURN VALUE 🫶

it hands you back the string converted as a value of type double. slay. 🎉

but listen — if nothing got converted, it returns zero, and *endp points right back to the beginning of s. so like, it's not gonna pretend it did something it didn't. it's giving honest queen energy. 👑

ngl, if you're not checking endp, you will not know the difference between a real 0 and a "bestie I literally couldn't read that" 0. just saying. 💀

👀 SEE ALSO 👀

and that's the whole page, periodt. 💖 this was ustrtod(3alleg4) from the Allegro manual, sittin' pretty at version 4.4.3. mwah, go convert something. 🌈⭐🎀

📦 where this page comes from