Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

strtoull — tekst na unsigned long long

strtoull przekształca początek napisu na unsigned long long; endptr pozwala wykryć brak konwersji i pozostały tekst.

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

Składnia

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

strtoull z <stdlib.h> pomija początkowe białe znaki i akceptuje znak + lub -. base to 2–36 albo 0: automatyczne rozpoznawanie podstawy. C23 uwzględnia prefiksy 0b/0B; obsługa przez środowisko wykonawcze nie została potwierdzona.

Przy niepustym endptr, *endptr wskazuje pierwszy nieprzetworzony znak; brak konwersji daje 0 oraz *endptr == nptr. Wyzeruj errno przed wywołaniem: przekroczenie zakresu daje ULLONG_MAX i ERANGE. Sam wynik nie wystarcza do walidacji.

Minus nie jest odrzucany: "-1" daje ULLONG_MAX. Jeśli wartości ujemne są zabronione, sprawdzaj znak osobno. Pełna walidacja wymaga również sprawdzenia końca napisu.

Przykłady

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

int main(void)
{
    const char *text = "12345";
    char *end;
    errno = 0;
    unsigned long long value = strtoull(text, &end, 10);

    if (end == text || errno == ERANGE || *end != '\0') {
        puts("invalid");
        return 1;
    }
    printf("%llu\n", value);
    return 0;
}

Wynik

12345

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła