CKTIS / C
strtold — prevod textu na long double
strtold z <stdlib.h> načíta počiatočné číslo z textu ako long double. Pomocou endptr možno zistiť, kde sa prevod zastavil.
Verzia: C23; repository compiler flag, production runtime not attested
Syntax
#include <stdlib.h>
long double strtold(const char *restrict nptr, char **restrict endptr);strtold preskočí počiatočné biele znaky a rozpoznáva desiatkový aj šestnástkový zápis a zápis nekonečna. Zápis NaN rozpoznáva iba vtedy, keď návratový typ podporuje tiché hodnoty NaN. V opačnom prípade sa zápis NaN nepovažuje za vstup v očakávanom formáte a prevod sa neuskutoční. Desatinný oddeľovač závisí od locale.
nptr musí ukazovať na reťazec ukončený nulovým znakom. Ak endptr nie je null, funkcia doň uloží ukazovateľ na prvý neprevedený znak; možno odovzdať NULL. Ak sa prevod neuskutoční, výsledkom je nula a platí *endptr == nptr; samotná nula chybu neodhalí.
Pred volaním nastavte errno na nulu. Ak pri predvolenom režime zaokrúhľovania dôjde k pretečeniu, funkcia nastaví errno na ERANGE. V iných režimoch zaokrúhľovania to nie je zaručené. To, či sa pri podtečení nastaví errno na ERANGE, závisí od implementácie. Ak chcete vyžadovať úplný prevod, odovzdajte ako endptr nenulový ukazovateľ a po volaní skontrolujte aj **endptr == '\0'. Príklad zámerne ponecháva kg.
Príklady
#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;
}
Výsledok
value=12.5 rest=kg
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.