CKTIS / C
strtold — převod textu na long double
strtold z <stdlib.h> načte počáteční číslo z textu jako long double. Pomocí endptr lze zjistit, kde se převod zastavil.
Verze: C23; repository compiler flag, production runtime not attested
Syntaxe
#include <stdlib.h>
long double strtold(const char *restrict nptr, char **restrict endptr);strtold přeskočí počáteční bílé znaky a rozpoznává desetinný i šestnáctkový zápis a zápis nekonečna. Zápis NaN rozpoznává pouze tehdy, pokud návratový typ podporuje tiché hodnoty NaN. V opačném případě se zápis NaN nepovažuje za vstup v očekávaném formátu a k převodu nedojde. Desetinný oddělovač závisí na locale.
nptr musí ukazovat na řetězec ukončený nulovým znakem. Pokud endptr není null, funkce do něj uloží ukazatel na první nepřevedený znak; lze předat NULL. Pokud k převodu nedojde, výsledkem je nula a platí *endptr == nptr; samotná nula chybu neodhalí.
Před voláním nastavte errno na nulu. Pokud při výchozím režimu zaokrouhlování dojde k přetečení, funkce nastaví errno na ERANGE. V jiných režimech zaokrouhlování to není zaručeno. Zda se při podtečení nastaví errno na ERANGE, závisí na implementaci. Chcete-li vyžadovat úplný převod, předejte jako endptr nenulový ukazatel a po volání zkontrolujte také **endptr == '\0'. Příklad záměrně ponechává kg.
Pří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ýsledek
value=12.5 rest=kg
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.