Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

atol - Zeichenkette in ganze Zahl (long) umwandeln

&pagelevel(4)&pagelevel

Definition

#include <stdlib.h>

long int atol(const char *str);

Beschreibung

atol() wandelt die EBCDIC-Zeichenkette, auf die str zeigt, in eine ganze Zahl vom Typ long um. Die umzuwandelnde Zeichenkette kann wie folgt aufgebaut sein:

[ tab ...][+|-] digit ...

Für tab sind alle Steuerzeichen für "Zwischenraum" zulässig (siehe isspace()).

Die Funktion atol(str) unterscheidet sich von strtol(str,(char**)NULL,10) nur durch die Fehlerbehandlung.

Returnwert

Ganzzahliger Wert vom Typ long

 


für Zeichenketten, die eine wie oben beschriebene Struktur haben und einen Zahlenwert darstellen.

 

0     

für Zeichenketten, die nicht der oben beschriebenen Syntax entsprechen.

 

LONG_MAX bzw. LONG_MIN

 


bei Überlauf, abhängig vom Vorzeichen.

Hinweise

atol() ist vollständig enthalten in strtol(). Die Funktion wird jedoch weiterhin angeboten, da sie in vielen existierenden Anwendungen eingesetzt ist.

atol() erkennt auch Zeichenketten, die mit Ziffern beginnen, dann aber mit beliebigen Zeichen enden. atol() schneidet den Ziffernteil ab, wandelt ihn gemäß obiger Beschreibung um und ignoriert den Rest.

Siehe auch

atof(), atoi(), strtod(), strtol(), strtoul(), stdlib.h.