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

CKTIS / C

strtod — converter o início de uma cadeia para double

strtod converte o início de uma cadeia para double. endptr permite detetar a ausência de conversão e examinar o texto restante.

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

Sintaxe

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

strtod ignora os espaços em branco iniciais e converte um prefixo de uma cadeia terminada em nulo. O carácter separador decimal depende da localidade.

Se endptr não for nulo, *endptr aponta para o texto restante. end == text significa que não ocorreu qualquer conversão; o zero, por si só, não indica uma falha. Para consumir todo o texto, também tem de se verificar *end == '\0'.

Limpe errno antes de verificar erros de intervalo. A indicação de overflow através de ERANGE depende de math_errhandling & MATH_ERRNO; a indicação de underflow é definida pela implementação.

Exemplos

#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

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