ASTOI(3)

💖 astoi(3) — ASCII to integer, bestie 💖

okay so this is ASTOI(3), straight out of Schily´s LIBRARY FUNCTIONS — and it's giving “turn text digits into a real integer” energy. ✨

🎀 NAME 🎀

• astoi() — converts ASCII to integer. periodt.

✨ SYNOPSIS ✨

#include <schily/schily.h>

char *astoi(string,result)
     char *string; /* the string to convert */
     int *result; /* where to store the result */

🦋 DESCRIPTION 🦋

astoi() converts the characters pointed to by string into an integer stored at result. It returns a pointer to the first character in the string that was not used for the conversion. If the entire string is to be used, it should point to a NULL character ('\0'). Leading spaces and tabs are skipped. 🫶

The ASCII string accepts a leading '+' or '-'. A leading zero in the string makes the number octal, and a leading 0x makes the number hexadecimal. And yeah — leading spaces and tabs are skipped. Again. Skipped. 💅

🔥 RETURNS 🔥

Returns a pointer to the first unused character. That's the whole vibe check. 👑

🌸 EXAMPLES 🌸

if (*astoi(string, &i) != '\0')
     error("Not a number %s\n", string);

🌈 SEE ALSO 🌈

• astol(3)

💀 NOTES 💀

Range errors are not checked. Not even a little. 😭 Conversion stops — and a pointer is returned — at the first non-numeric character other than the leading sign or 0x, as described above.

---

mwah 💋 — Joerg Schilling, 2022/09/09, source/version: Schily´s LIBRARY FUNCTIONS, page ASTOI(3). bye bestie 🎀