WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen