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

CKTIS / C

atof — função de biblioteca C23

`atof(const char *nptr)` de `<stdlib.h>` converte a parte inicial de uma string em `double`; comporta-se como `strtod(nptr, NULL)`, mas não fornece ponteiro final útil nem diagnóstico fiável de erro.

Versão: C23

Sintaxe

double atof(const char *nptr);

atof(const char *nptr) de <stdlib.h> converte a parte inicial de uma string em double; comporta-se como strtod(nptr, NULL), mas não fornece ponteiro final útil nem diagnóstico fiável de erro.

Usa-a apenas para texto de confiança cuja validade já esteja estabelecida. O exemplo passa realmente " -12.5e1tail": espaços, sinal e expoente são consumidos e a conversão termina antes de tail.

Sem conversão devolve 0.0, indistinguível de um zero válido. Em C23 o comportamento é indefinido se o resultado não for representável e nptr não pode ser NULL. Usa strtod para validar, detetar intervalo via errno e localizar o primeiro caráter não consumido.

Exemplos

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

int main(void) {
    double value = atof("  -12.5e1tail");
    printf("%.1f\n", value);
    return 0;
}

Resultado

-125.0

Usa-a apenas para texto de confiança cuja validade já esteja estabelecida. O exemplo passa realmente `" -12.5e1tail"`: espaços, sinal e expoente são consumidos e a conversão termina antes de `tail`.

Fontes