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

CKTIS / C

strtod — convertir el comienzo de una cadena a double

strtod convierte el comienzo de una cadena a double. endptr permite detectar si no hubo conversión y examinar el texto restante.

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

Sintaxis

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

strtod omite los espacios en blanco iniciales y convierte un prefijo de una cadena terminada en nulo. El carácter separador decimal depende de la configuración regional.

Si endptr no es nulo, *endptr apunta al texto restante. end == text significa que no se realizó ninguna conversión; el cero por sí solo no indica un error. Para consumir toda la cadena, también debe cumplirse *end == '\0'.

Restablece errno antes de comprobar los errores de rango. La notificación del desbordamiento mediante ERANGE depende de math_errhandling & MATH_ERRNO; la notificación del subdesbordamiento está definida por la implementación.

Ejemplos

#include <stdio.h>
#include <stdlib.h>

int main(void)
{
    const char *text = "12.5kg";
    char *end;
    double value = strtod(text, &end);

    if (end == text) {
        puts("no conversion");
        return EXIT_FAILURE;
    }
    printf("value=%.1f; suffix=%s\n", value, end);
    return EXIT_SUCCESS;
}

Resultado

value=12.5; suffix=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