Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

strtof — convertire testo in float

strtof legge l’inizio di una stringa come float. Il puntatore endptr permette di rilevare una mancata conversione e il testo rimanente.

Versione: C23; repository compiler flag, production runtime not attested

Sintassi

#include <stdlib.h>
float strtof(const char *restrict nptr, char **restrict endptr);

strtof di <stdlib.h> salta gli spazi bianchi iniziali e converte un prefisso della stringa in float. Il separatore decimale dipende dalle impostazioni locali.

Quando endptr != NULL, la funzione memorizza un puntatore al primo carattere non consumato. end == text significa che non è avvenuta alcuna conversione; il solo valore zero non dimostra la presenza di un errore. Per consumare l’intera stringa deve valere anche *end == '\0'.

Secondo N3096, la segnalazione degli errori di intervallo dipende da math_errhandling: in caso di overflow viene impostato ERANGE se è abilitato MATH_ERRNO; l’impostazione in caso di underflow dipende dall’implementazione. Azzera errno prima di controllarlo.

Esempi

#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;
}

Risultato

value=12.5; rest=kg

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti