Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

strtoul — konwersja tekstu na unsigned long

Opis konwersji tekstu na unsigned long oraz kontroli wyniku. Przykład pokazuje sprawdzanie zakresu i odrzucanie nieprzetworzonej końcówki.

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

Składnia

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

strtoul konwertuje początek łańcucha nptr na unsigned long, pomijając początkowe białe znaki i dopuszczając znak + lub -.

base: 2–36 albo 0 (wykrywanie podstawy: 0 — ósemkowa, 0x/0X — szesnastkowa, 0b/0B — binarna w C23, pozostałe — dziesiętna). C23 dopuszcza prefiks binarny także dla base == 2.

Po przekazaniu &end funkcja zapisuje w end adres pierwszego nieprzetworzonego znaku. Jeśli przekażesz NULL, funkcja nie zapisze tego adresu. Brak konwersji oznacza wynik 0 i end == nptr. Przekroczenie zakresu daje ULONG_MAX i errno == ERANGE: wcześniej ustaw errno = 0. Pełna konwersja wymaga *end == '\0'.

Minus nie jest automatycznie błędem: "-1" daje ULONG_MAX. Jeśli zabraniasz liczb ujemnych, odrzuć minus po początkowych białych znakach. Flaga kompilatora C23 nie potwierdza obsługi C23 przez bibliotekę wykonawczą.

Przykłady

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

Wynik

value=42

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła