Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C

strtoul — pretvorba teksta u unsigned long

Objašnjava pretvorbu teksta u unsigned long i provjeru rezultata. Primjer prikazuje provjeru raspona i odbacivanje neobrađenog završnog dijela.

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

Sintaksa

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

strtoul pretvara početak niza nptr u unsigned long. Preskače početne bjeline i prihvaća + ili -.

base: 2–36 ili 0 (automatsko prepoznavanje: 0 — oktalno, 0x/0X — heksadekadski, 0b/0B — binarno u C23, inače decimalno). C23 prihvaća binarni prefiks i kada je base == 2.

Ako proslijediš &end, funkcija u end sprema adresu prvog neobrađenog znaka. Ako proslijediš NULL, ta se adresa ne sprema. Ako nema pretvorbe, rezultat je 0 i vrijedi end == nptr. Prekoračenje raspona daje ULONG_MAX i errno == ERANGE: najprije postavi errno = 0. Potpuna pretvorba zahtijeva *end == '\0'.

Minus nije automatski pogreška: "-1" daje ULONG_MAX. Ako želiš zabraniti negativne brojeve, odbaci minus nakon početnih bjelina. Oznaka prevoditelja za C23 ne potvrđuje podršku za C23 u runtime biblioteci.

Primjeri

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

Rezultat

value=42

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori