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

CKTIS / C

strtof — převod textu na float

strtof čte začátek řetězce jako float. Ukazatel endptr umožňuje zjistit, že nedošlo k převodu, a odhalit zbývající text.

Verze: C23; repository compiler flag, production runtime not attested

Syntaxe

#include <stdlib.h>
float strtof(const char *restrict nptr, char **restrict endptr);

strtof z <stdlib.h> přeskočí úvodní bílé znaky a převede prefix řetězce na float. Desetinný oddělovač závisí na locale.

Pokud endptr != NULL, uloží ukazatel na první nespotřebovaný znak. end == text znamená, že k převodu nedošlo; samotná nula nedokazuje, že nastala chyba. Pro úplné zpracování musí platit také *end == '\0'.

Podle N3096 závisí hlášení chyb rozsahu na math_errhandling: při přetečení se nastaví ERANGE, pokud je povoleno MATH_ERRNO; nastavení při podtečení závisí na implementaci. Před kontrolou nastavte errno na nulu.

Příklady

#include <stdio.h>
#include <stdlib.h>

int main(void)
{
    const char *text = "  12.5kg";
    char *end;
    float value = strtof(text, &end);

    if (end == text) {
        puts("no conversion");
        return 1;
    }

    printf("value=%.1f; rest=%s\n", (double)value, end);
    return 0;
}

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