CKTIS / C
strtof — pretvorba teksta u float
strtof čita početak niza kao float. Pokazivač endptr omogućuje otkrivanje izostanka pretvorbe i preostalog teksta.
Verzija: C23; repository compiler flag, production runtime not attested
Sintaksa
#include <stdlib.h>
float strtof(const char *restrict nptr, char **restrict endptr);strtof iz <stdlib.h> preskače početne bjeline i pretvara prefiks niza u float. Decimalni razdjelnik ovisi o lokalnim postavkama.
Kada je endptr != NULL, funkcija sprema pokazivač na prvi neobrađeni znak. end == text znači da nije došlo do pretvorbe; sama nula ne dokazuje da postoji pogreška. Za potpunu obradu mora vrijediti i *end == '\0'.
Prema N3096, prijava pogrešaka raspona ovisi o math_errhandling: pri prekoračenju se postavlja ERANGE ako je omogućen MATH_ERRNO; postavljanje pri podbačaju ovisi o implementaciji. Prije provjere postavite errno na nulu.
Primjeri
#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;
}
Rezultat
value=12.5; rest=kg
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.