CKTIS / C
strtold — преобразуване на текст в long double
strtold от <stdlib.h> прочита началното число от текст като long double. Чрез endptr можете да проверите къде е приключило преобразуването.
Версия: C23; repository compiler flag, production runtime not attested
Синтаксис
#include <stdlib.h>
long double strtold(const char *restrict nptr, char **restrict endptr);strtold пропуска началните празни знаци и разпознава десетични и шестнадесетични записи, както и записи за безкрайност. Записите за NaN се разпознават само ако типът на върнатата стойност поддържа тихи NaN стойности. В противен случай входният запис за NaN се счита за несъответстващ на очаквания формат и преобразуване не се извършва. Десетичният разделител зависи от локала.
nptr трябва да сочи към низ, завършващ с нулев знак. Ако endptr не е нулев указател, функцията записва там указател към първия непреобразуван знак; допустимо е да се подаде NULL. Ако не се извърши преобразуване, резултатът е нула и е изпълнено *endptr == nptr; само стойността нула не открива грешка.
Преди извикването задайте нула на errno. Ако възникне препълване при режим на закръгляване по подразбиране, функцията задава ERANGE на errno. При други режими на закръгляване това не е гарантирано. Ако при преобразуването възникне недопълване (underflow), от реализацията зависи дали функцията ще зададе errno на ERANGE. За да изисквате пълно преобразуване, подайте ненулев указател като endptr и след извикването проверете и **endptr == '\0'. Примерът умишлено оставя kg.
Примери
#include <errno.h>
#include <stdio.h>
#include <stdlib.h>
int main(void)
{
const char *text = "12.5kg";
char *end;
errno = 0;
long double value = strtold(text, &end);
if (end == text || errno == ERANGE) {
puts("conversion failed");
return EXIT_FAILURE;
}
printf("value=%.1Lf\nrest=%s\n", value, end);
return EXIT_SUCCESS;
}
Резултат
value=12.5 rest=kg
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.