База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C

strtoul — преобразуване на текст в unsigned long

Обяснява преобразуването на текст в unsigned long и проверката на резултата. Примерът показва проверка на диапазона и отхвърляне на непреобразуван суфикс.

Версия: C23; repository compiler flag, production runtime not attested

Синтаксис

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

strtoul преобразува началото на низа nptr в unsigned long. Пропуска водещите интервали и приема + или -.

base: 2–36 или 0 (автоматично разпознаване: 0 — осмично, 0x/0X — шестнадесетично, 0b/0B — двоично в C23, иначе десетично). C23 приема двоичния префикс и когато base == 2.

При подаване на &end функцията записва в end адреса на първия непреобразуван знак. При подаване на NULL този адрес не се записва. Ако не се извърши преобразуване, резултатът е 0 и end == nptr. При препълване резултатът е ULONG_MAX и errno == ERANGE: първо задайте errno = 0. За пълно преобразуване е необходимо *end == '\0'.

Минусът не е автоматично грешка: "-1" дава ULONG_MAX. За да забраните отрицателните числа, отхвърлете минуса след водещите интервали. Флагът на компилатора за C23 не удостоверява поддръжката на C23 от изпълнителната библиотека.

Примери

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

Резултат

value=42

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници