Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C

strtoul — pretvorba besedila v unsigned long

Pojasnjuje pretvorbo besedila v unsigned long in preverjanje rezultata. Primer prikazuje preverjanje obsega in zavrnitev neobdelane končnice.

Različica: 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 pretvori začetek niza nptr v unsigned long. Začetne presledke prezre ter sprejme + ali -.

base: 2–36 ali 0 (samodejno zaznavanje: 0 — osmiško, 0x/0X — šestnajstiško, 0b/0B — dvojiško v C23, sicer desetiško). C23 sprejema dvojiško predpono tudi pri base == 2.

Če podaš &end, funkcija v end shrani naslov prvega neobdelanega znaka. Če podaš NULL, se ta naslov ne shrani. Če do pretvorbe ne pride, je rezultat 0 in velja end == nptr. Ob prekoračitvi obsega je rezultat ULONG_MAX in errno == ERANGE: najprej nastavi errno = 0. Za popolno pretvorbo mora veljati *end == '\0'.

Znak minus ni samodejno napaka: "-1" da ULONG_MAX. Če želiš prepovedati negativna števila, zavrni minus za začetnimi presledki. Zastavica prevajalnika za C23 ne potrjuje podpore C23 v izvajalni knjižnici.

Primeri

#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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri