CKTIS / C
atol — C23-Bibliotheksfunktion
`atol(const char *nptr)` aus `<stdlib.h>` liest eine anfängliche dezimale Ganzzahl und liefert `long int`. Führender Leerraum wird übersprungen, ein Vorzeichen akzeptiert und am ersten fremden Zeichen angehalten.
Version: C23
Syntax
long int atol(const char *nptr);atol(const char *nptr) aus <stdlib.h> liest eine anfängliche dezimale Ganzzahl und liefert long int. Führender Leerraum wird übersprungen, ein Vorzeichen akzeptiert und am ersten fremden Zeichen angehalten.
Die Funktion passt zu bereits geprüften Zählern für Schnittstellen mit Typ long. Das Beispiel wandelt "+123456ms" tatsächlich in 123456 um und gibt das Ergebnis mit dem richtigen Format %ld aus.
Die Breite von long ist plattformabhängig und kann nur 32 Bit betragen. Ohne Ziffern entsteht ein mehrdeutiges 0; außerhalb LONG_MIN..LONG_MAX ist das Verhalten in C23 undefiniert, und nptr darf nicht NULL sein. strtol erlaubt End- und Bereichsprüfung.
Beispiele
#include <stdio.h>
#include <stdlib.h>
int main(void) {
long count = atol("+123456ms");
printf("%ld\n", count);
return 0;
}
Ergebnis
123456
Die Funktion passt zu bereits geprüften Zählern für Schnittstellen mit Typ `long`. Das Beispiel wandelt `"+123456ms"` tatsächlich in `123456` um und gibt das Ergebnis mit dem richtigen Format `%ld` aus.