CKTIS / C
strtof — tekst omzetten naar float
strtof leest het begin van een tekenreeks als float. Met de endptr-aanwijzer kunt u detecteren dat er niets is omgezet en dat er tekst overblijft.
Versie: C23; repository compiler flag, production runtime not attested
Syntax
#include <stdlib.h>
float strtof(const char *restrict nptr, char **restrict endptr);strtof uit <stdlib.h> slaat voorloopspaties over en zet een prefix van de tekenreeks om naar float. Het decimaalteken hangt af van de locale.
Als endptr != NULL, slaat de functie een aanwijzer op naar het eerste niet-verwerkte teken. end == text betekent dat er niets is omgezet; alleen de waarde nul bewijst niet dat er een fout is. Voor volledige verwerking moet ook *end == '\0' gelden.
Volgens N3096 hangt de melding van bereikfouten af van math_errhandling: bij overflow wordt ERANGE ingesteld als MATH_ERRNO is ingeschakeld; of dit bij underflow gebeurt, is implementatiegedefinieerd. Zet errno op nul voordat u het controleert.
Voorbeelden
#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;
}
Resultaat
value=12.5; rest=kg
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.