Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C

strtoll — převod textu na long long

strtoll přečte ze začátku textu celé číslo s volitelným znaménkem jako long long. Výsledek převodu lze ověřit pomocí endptr a errno.

Verze: C23; repository compiler flag, production runtime not attested

Syntaxe

#include <stdlib.h>
long long int strtoll(const char *restrict nptr, char **restrict endptr, int base);

strtoll přeskočí počáteční bílé znaky a přijímá nepovinné + nebo -. base musí být 0 nebo v rozsahu 2–36. Při hodnotě 0 funkce rozpozná základ: desítkový, osmičkový (0), šestnáctkový (0x) nebo dvojkový (0b). C23 připouští také 0b při základu 2; podpora v produkčních běhových prostředích není potvrzena.

Pokud endptr není NULL, funkce uloží do *endptr adresu prvního nepřevedeného znaku. Pokud k převodu nedojde, funkce vrátí 0, a není-li endptr rovno NULL, platí *endptr == nptr. Při hodnotě mimo rozsah funkce vrátí LLONG_MIN nebo LLONG_MAX a platí errno == ERANGE. Před voláním nastavte errno = 0.

Samotný výsledek 0 neznamená chybu. Chcete-li odmítnout všechny znaky za celým číslem, předejte v endptr ukazatel různý od NULL a postupně ověřte, že k převodu došlo, že převod neskončil chybou rozsahu (errno != ERANGE) a že platí **endptr == '\0'. Poslední kontrola odmítne i koncové bílé znaky, které zůstaly nepřevedené. C23 dovoluje oddělovače číslic (') v celočíselných konstantách ve zdrojovém kódu, ale strtoll se řídí samostatnými pravidly převodu. Při místním nastavení C a hodnotě base rovné 0 tato pravidla výslovně vylučují přípony a oddělovače číslic ze zápisu ve tvaru celočíselné konstanty. Pro základy 2 až 36 posloupnost číslic neobsahuje oddělovače a zápis nemá samostatnou příponu. Jiná místní nastavení mohou připouštět další tvary, které jsou pro ně specifické. Nelze tedy předpokládat, že oddělovače skupin číslic budou vždy odmítnuty.

Příklady

#include <errno.h>
#include <stdio.h>
#include <stdlib.h>

int main(void)
{
    const char *text = "-4200";
    char *end;
    errno = 0;
    long long value = strtoll(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("%lld\n", value);
    return EXIT_SUCCESS;
}

Výsledek

-4200

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje