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

CKTIS / C

strtoul — převod textu na unsigned long

Vysvětluje převod textu na unsigned long a kontrolu výsledku. Příklad ukazuje kontrolu rozsahu a odmítnutí nezpracované koncové části.

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

Syntaxe

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

strtoul převádí začátek řetězce nptr na unsigned long. Počáteční bílé znaky přeskočí a přijímá + nebo -.

base: 2–36 nebo 0 (automatické rozpoznání: 0 — osmičková, 0x/0X — šestnáctková, 0b/0B — binární v C23, jinak desítková). C23 přijímá binární předponu také při base == 2.

Při předání &end funkce uloží do end adresu prvního nezpracovaného znaku. Při předání NULL se tato adresa neuloží. Pokud se nepřevede nic, výsledkem je 0 a platí end == nptr. Při překročení rozsahu je výsledkem ULONG_MAX a errno == ERANGE: nejprve nastavte errno = 0. Úplný převod vyžaduje *end == '\0'.

Znaménko minus není automaticky chyba: "-1" dává ULONG_MAX. Pokud chcete záporná čísla zakázat, odmítněte minus po počátečních bílých znacích. Příznak kompilátoru C23 nepotvrzuje podporu C23 v běhové knihovně.

Příklady

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

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

    if (end == text || errno == ERANGE || *end != '\0') {
        puts("invalid");
        return EXIT_FAILURE;
    }

    printf("value=%lu\n", value);
    return EXIT_SUCCESS;
}

Výsledek

value=42

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