CKTIS / C
strtof — convertir du texte en float
strtof lit le début d’une chaîne comme un float. Le pointeur endptr permet de détecter l’absence de conversion et le texte restant.
Version : C23; repository compiler flag, production runtime not attested
Syntaxe
#include <stdlib.h>
float strtof(const char *restrict nptr, char **restrict endptr);strtof, déclaré dans <stdlib.h>, ignore les espaces blancs initiaux et convertit un préfixe de la chaîne en float. Le séparateur décimal dépend de la locale.
Lorsque endptr != NULL, la fonction y stocke un pointeur vers le premier caractère non consommé. end == text signifie qu’aucune conversion n’a eu lieu ; la valeur zéro ne suffit pas à établir qu’il y a une erreur. Pour que la chaîne soit entièrement consommée, il faut aussi que *end == '\0'.
Selon N3096, le signalement des erreurs de plage dépend de math_errhandling : en cas de dépassement de capacité, la fonction donne à errno la valeur ERANGE lorsque MATH_ERRNO est activé ; en cas de sous-dépassement, l’attribution de cette valeur dépend de l’implémentation. Remettez errno à zéro avant de le vérifier.
Exemples
#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;
}
Résultat
value=12.5; rest=kg
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.