CKTIS / C
strtoll — преобразуване на текст в long long
strtoll прочита цяло число с незадължителен знак от началото на текста и го преобразува в long long. Резултатът може да се провери чрез endptr и errno.
Версия: C23; repository compiler flag, production runtime not attested
Синтаксис
#include <stdlib.h>
long long int strtoll(const char *restrict nptr, char **restrict endptr, int base);strtoll пропуска началните празни знаци и приема незадължителен + или -. base трябва да бъде 0 или в диапазона 2–36. При стойност 0 функцията разпознава основата: десетична, осмична (0), шестнадесетична (0x) или двоична (0b). C23 допуска и 0b при основа 2; поддръжката в производствени среди за изпълнение не е потвърдена.
Ако endptr не е NULL, функцията записва в *endptr адреса на първия непреобразуван знак. Ако не се извърши преобразуване, функцията връща 0, а когато endptr не е NULL, е изпълнено *endptr == nptr. При стойност извън диапазона функцията връща LLONG_MIN или LLONG_MAX и е изпълнено errno == ERANGE. Преди извикването задайте errno = 0.
Резултат 0 сам по себе си не означава грешка. За да отхвърлите всички знаци след цялото число, подайте endptr, различен от NULL, и проверете последователно дали е извършено преобразуване, дали при преобразуването не е отчетена грешка за стойност извън допустимия диапазон (errno != ERANGE) и дали е изпълнено **endptr == '\0'. Последната проверка отхвърля и крайните празни знаци, които са останали непреобразувани. C23 допуска разделители между цифрите (') в целочислените константи в изходния код, но strtoll прилага отделни правила за преобразуване. При регионални настройки C, когато base е 0, тези правила изрично изключват суфиксите и разделителите между цифрите от записа във вид на целочислена константа. При основи от 2 до 36 поредицата от цифри не съдържа разделители и записът не предвижда отделен суфикс. При други регионални настройки може да се приемат допълнителни форми, специфични за тях, затова не разчитайте, че разделителите между групи цифри винаги ще бъдат отхвърляни.
Примери
#include <errno.h>
#include <stdio.h>
#include <stdlib.h>
int main(void)
{
const char *text = "-4200";
char *end;
errno = 0;
long long value = strtoll(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("%lld\n", value);
return EXIT_SUCCESS;
}Резултат
-4200
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.