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

CKTIS / C

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

strtol прочита цяло число от тип long от началото на текст. Проверявайте endptr и errno, за да откривате грешки и евентуален непреобразуван остатък.

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

Синтаксис

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

strtol от <stdlib.h> пропуска началните интервали, приема незадължителен знак + или - и преобразува цифрите в long.

base трябва да бъде 0 или между 2 и 36. Стойността 0 разпознава десетичен, осмичен (0), шестнадесетичен (0x) и в C23 двоичен запис (0b). Изрично зададените основи 16 и 2 позволяват съответните префикси. Флаг за компилатора C23 не удостоверява поддръжка от библиотеката за изпълнение.

Ако endptr != NULL, *endptr сочи към първия непреобразуван знак. Ако не се извърши преобразуване, се връща 0 и е изпълнено *endptr == nptr; само стойността 0 не означава грешка.

Преди извикването задайте errno = 0. Стойност извън диапазона връща LONG_MIN или LONG_MAX и задава ERANGE. Ако endptr != NULL и трябва да се обработи целият текст, проверете и **endptr == '\0': сравнете със завършващия знак на низа знака, към който сочи *endptr, а не самия указател. При регионални настройки C празните знаци в края остават необработени. При други регионални настройки функцията може да приема допълнителни форми на запис, специфични за съответните настройки. Достигането до завършващия знак потвърждава, че целият низ е обработен, но не и че входът отговаря на правилата за запис при регионални настройки C.

Примери

#include <errno.h>
#include <stdio.h>
#include <stdlib.h>

int main(void)
{
    const char *text = "123";
    char *end;
    errno = 0;
    long value = strtol(text, &end, 10);

    if (end == text) {
        puts("no digits");
        return EXIT_FAILURE;
    }
    if (errno == ERANGE) {
        puts("out of range");
        return EXIT_FAILURE;
    }
    if (*end != '\0') {
        puts("trailing characters");
        return EXIT_FAILURE;
    }
    printf("value=%ld\n", value);
    return EXIT_SUCCESS;
}

Резултат

value=123

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

Източници