Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje