CKTIS / C
atoi — C23-Bibliotheksfunktion
`atoi(const char *nptr)` aus `<stdlib.h>` wandelt eine anfängliche dezimale Ganzzahl einer Zeichenkette um und liefert `int`. Die Funktion überspringt führenden Leerraum, erkennt ein optionales Vorzeichen und endet am ersten unpassenden Zeichen.
Version: C23
Syntax
int atoi(const char *nptr);atoi(const char *nptr) aus <stdlib.h> wandelt eine anfängliche dezimale Ganzzahl einer Zeichenkette um und liefert int. Die Funktion überspringt führenden Leerraum, erkennt ein optionales Vorzeichen und endet am ersten unpassenden Zeichen.
Sie eignet sich nur für kleine, bereits geprüfte Konfigurationswerte. Das Beispiel übergibt tatsächlich " -42items", erhält daher -42 und ignoriert das Suffix items.
Ohne Ziffern entsteht 0, nicht unterscheidbar von einer gültigen Null. Passt das Ergebnis nicht in int, ist das Verhalten nach C23 undefiniert; nptr darf nicht NULL sein. Für nicht vertrauenswürdigen Text dient strtol mit Prüfung von Endzeiger, errno und INT_MIN..INT_MAX.
Beispiele
#include <stdio.h>
#include <stdlib.h>
int main(void) {
int count = atoi(" -42items");
printf("%d\n", count);
return 0;
}
Ergebnis
-42
Sie eignet sich nur für kleine, bereits geprüfte Konfigurationswerte. Das Beispiel übergibt tatsächlich `" -42items"`, erhält daher `-42` und ignoriert das Suffix `items`.