ASTOL(3)

✨ ASTOL(3) ✨

okay so bestie, welcome to ASTOL(3) — one of the little gems from Schily´s LIBRARY FUNCTIONS. she's a converter girlie, and honestly? she ate. let's get into it 💅

---

💖 NAME 💖

astol() — converts ASCII to long 🎀

🦋 SYNOPSIS 🦋

astol(string,l)
char *string;
int *l;

🌸 DESCRIPTION 🌸

so astol() takes the characters that string points at and converts them into a long, which gets stored at l. no cap, that's the whole job ✨

then it returns a pointer to the first character in the string that was not used for the conversion — like, she used what she needed and left the rest for you, generous queen 🫶

if the entire string is meant to be used, it should point to a NULL character ('\0'). that's the vibe check: end it properly or she'll stop early and you'll be confused 😭

also, leading spaces and tabs are skipped. she's not gonna fight you over whitespace, she's chill like that 💜

🧚 EXAMPLES 🧚

extern char *astol();
if (*astod(string, &l) != '\0')
     error("Not a number %s\n", string);

literally the cutest little number-checker: if whatever comes back isn't '\0', you did not pass a number and error() gets to yell about it 💀

🔥 SEE ALSO 🔥

• astod(3)
• astof(3)
• astoi(3)

her sisters!! go say hi, they're all iconic in their own way 👑

⭐ RETURNS ⭐

Returns a pointer to first unused character. periodt 💫

---

brought to you by Joerg Schilling, dated 2022/09/09, from Schily´s LIBRARY FUNCTIONS — mwah, stan a legend 🌈💖🎀