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

CKTIS / C

strtoull — text na unsigned long long

strtoull převádí počáteční část řetězce na unsigned long long; pomocí endptr lze zjistit, zda převod neproběhl a zda zbyl text.

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

Syntaxe

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

strtoull z <stdlib.h> přeskočí počáteční bílé znaky a přijímá + nebo -. base je 2–36 nebo 0 pro automatické rozpoznání základu. C23 zahrnuje předpony 0b/0B; podpora v běhovém prostředí není potvrzena.

Pokud endptr není null, *endptr ukazuje na první nezpracovaný znak. Pokud k převodu nedojde, vrátí se 0 a platí *endptr == nptr. Před voláním nastavte errno na 0: při přetečení se vrátí ULLONG_MAX a nastaví se ERANGE. Samotný výsledek k ověření vstupu nestačí.

Záporné znaménko se neodmítá: "-1" dává ULLONG_MAX. Pokud jsou záporné hodnoty zakázané, zkontrolujte znaménko samostatně. Úplné ověření vyžaduje také kontrolu konce řetězce.

Příklady

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

Výsledek

12345

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