CKTIS / C
strtol — Text in long umwandeln
strtol liest am Anfang eines Textes eine long-Ganzzahl. Prüfen Sie endptr und errno, um Fehler und nicht verarbeitete Zeichen am Ende zu erkennen.
Version: C23; repository compiler flag, production runtime not attested
Syntax
#include <stdlib.h>
long int strtol(const char *restrict nptr, char **restrict endptr, int base);strtol aus <stdlib.h> überspringt führende Leerzeichen, akzeptiert ein optionales + oder - und wandelt Ziffern in long um.
base muss 0 oder 2–36 sein. Bei 0 wird zwischen Dezimal-, Oktal- (0), Hexadezimal- (0x) und in C23 auch Binärschreibweise (0b) unterschieden. Bei den expliziten Basen 16 und 2 sind die entsprechenden Präfixe zulässig. Ein C23-Compiler-Flag bestätigt nicht, dass die Laufzeitbibliothek diese Funktion unterstützt.
Wenn endptr != NULL gilt, zeigt *endptr auf das erste nicht verarbeitete Zeichen. Findet keine Konvertierung statt, gibt die Funktion 0 zurück und es gilt *endptr == nptr; 0 allein weist nicht auf einen Fehler hin.
Setzen Sie vor dem Aufruf errno = 0. Bei einem Wert außerhalb des darstellbaren Bereichs wird LONG_MIN oder LONG_MAX zurückgegeben und ERANGE gesetzt. Wenn endptr != NULL gilt und der gesamte Text verarbeitet werden muss, prüfen Sie zusätzlich **endptr == '\0': Vergleichen Sie das Zeichen, auf das *endptr zeigt, mit dem Endezeichen der Zeichenkette, nicht den Zeiger selbst. In der Locale C bleiben nachfolgende Leerraumzeichen unverarbeitet. In anderen Locales können zusätzliche, für die jeweilige Locale spezifische Eingabeformen zulässig sein. Wird das Endezeichen erreicht, ist die gesamte Zeichenkette verarbeitet; das bedeutet nicht, dass die Eingabe den Syntaxregeln der Locale C entspricht.
Beispiele
#include <errno.h>
#include <stdio.h>
#include <stdlib.h>
int main(void)
{
const char *text = "123";
char *end;
errno = 0;
long value = strtol(text, &end, 10);
if (end == text) {
puts("no digits");
return EXIT_FAILURE;
}
if (errno == ERANGE) {
puts("out of range");
return EXIT_FAILURE;
}
if (*end != '\0') {
puts("trailing characters");
return EXIT_FAILURE;
}
printf("value=%ld\n", value);
return EXIT_SUCCESS;
}Ergebnis
value=123
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.