Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C

strtol — prevod textu na long

strtol načíta celé číslo typu long od začiatku textu. Kontrolujte endptr a errno, aby ste zistili chyby a prípadný nespracovaný zvyšok.

Verzia: 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 z <stdlib.h> preskočí úvodné biele znaky, prijíma voliteľné znamienko + alebo - a prevádza číslice na long.

base musí byť 0 alebo v rozsahu 2–36. Hodnota 0 rozpozná desiatkový, osmičkový (0), šestnástkový (0x) a v C23 aj binárny zápis (0b). Výslovne zadané základy 16 a 2 umožňujú príslušné predpony. Príznak kompilátora C23 nepotvrdzuje podporu v runtime knižnici.

Ak endptr != NULL, *endptr ukazuje na prvý nespracovaný znak. Ak nedôjde k žiadnemu prevodu, vráti sa 0 a platí *endptr == nptr; samotná hodnota 0 neznamená chybu.

Pred volaním nastavte errno = 0. Hodnota mimo rozsahu vracia LONG_MIN alebo LONG_MAX a nastavuje ERANGE. Ak endptr != NULL a požadujete spracovanie celého textu, skontrolujte aj **endptr == '\0': s ukončovacím znakom reťazca porovnajte znak, na ktorý ukazuje *endptr, nie samotný ukazovateľ. Pri miestnych nastaveniach C zostávajú koncové biele znaky nespracované. Pri iných miestnych nastaveniach môže funkcia prijímať aj ďalšie formy zápisu špecifické pre dané nastavenia. Dosiahnutie ukončovacieho znaku potvrdzuje, že sa spracoval celý reťazec, nie že vstup zodpovedá pravidlám zápisu miestnych nastavení C.

Príklady

#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;
}

Výsledok

value=123

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje