Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources