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.