Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C

strtof — converter texto em float

strtof lê o início de uma cadeia como float. O ponteiro endptr permite detetar a ausência de conversão e o texto restante.

Versão: C23; repository compiler flag, production runtime not attested

Sintaxe

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

strtof, de <stdlib.h>, ignora os espaços em branco iniciais e converte um prefixo da cadeia em float. O separador decimal depende da localização regional.

Quando endptr != NULL, a função guarda um ponteiro para o primeiro carácter não consumido. end == text significa que não ocorreu qualquer conversão; o valor zero, por si só, não comprova a existência de um erro. Para consumir a cadeia por completo, também é necessário que *end == '\0'.

Segundo N3096, a indicação de erros de gama depende de math_errhandling: em caso de overflow, é definido ERANGE se MATH_ERRNO estiver ativo; a definição em caso de underflow depende da implementação. Coloque errno a zero antes de o verificar.

Exemplos

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

Resultado

value=12.5; rest=kg

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes