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

CKTIS / C

strtoul — prevod textu na unsigned long

Vysvetľuje prevod textu na unsigned long a kontrolu výsledku. Príklad ukazuje kontrolu rozsahu a odmietnutie nespracovanej koncovej časti.

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

Syntax

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

strtoul prevádza začiatok reťazca nptr na unsigned long. Počiatočné biele znaky preskočí a prijíma + alebo -.

base: 2–36 alebo 0 (automatické rozpoznanie: 0 — osmičková, 0x/0X — šestnástková, 0b/0B — binárna v C23, inak desiatková). C23 prijíma binárnu predponu aj pri base == 2.

Pri odovzdaní &end funkcia uloží do end adresu prvého nespracovaného znaku. Pri odovzdaní NULL sa táto adresa neuloží. Ak sa nič neprevedie, výsledkom je 0 a platí end == nptr. Pri prekročení rozsahu je výsledkom ULONG_MAX a errno == ERANGE: najprv nastavte errno = 0. Úplný prevod vyžaduje *end == '\0'.

Znamienko mínus nie je automaticky chyba: "-1" dáva ULONG_MAX. Ak chcete zakázať záporné čísla, odmietnite mínus po počiatočných bielych znakoch. Príznak kompilátora C23 nepotvrdzuje podporu C23 v runtime knižnici.

Prí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ýsledok

value=42

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

Zdroje