Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C

strtof — convertir texto a float

strtof lee el comienzo de una cadena como float. El puntero endptr permite detectar si no hubo conversión y si queda texto.

Versión: C23; repository compiler flag, production runtime not attested

Sintaxis

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

strtof, de <stdlib.h>, omite los espacios en blanco iniciales y convierte un prefijo de la cadena a float. El separador decimal depende de la configuración regional.

Cuando endptr != NULL, guarda un puntero al primer carácter que no se haya consumido. end == text significa que no se realizó ninguna conversión; el valor cero por sí solo no demuestra que haya un error. Para consumir toda la cadena, también debe cumplirse *end == '\0'.

Según N3096, la notificación de errores de rango depende de math_errhandling: un desbordamiento establece ERANGE si está habilitado MATH_ERRNO; que se establezca en caso de subdesbordamiento depende de la implementación. Ponga errno a cero antes de comprobarlo.

Ejemplos

#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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes