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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.