Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

atof — funkcja biblioteki C23

`atof(const char *nptr)` z `<stdlib.h>` konwertuje początkową część napisu na `double`; działa jak `strtod(nptr, NULL)`, ale nie zapewnia użytecznego wskaźnika końca ani niezawodnej diagnostyki błędu.

Wersja: C23

Składnia

double atof(const char *nptr);

atof(const char *nptr) z <stdlib.h> konwertuje początkową część napisu na double; działa jak strtod(nptr, NULL), ale nie zapewnia użytecznego wskaźnika końca ani niezawodnej diagnostyki błędu.

Nadaje się tylko do zaufanego tekstu, gdy poprawność wejścia została już ustalona. Przykład rzeczywiście przekazuje " -12.5e1tail": białe znaki, znak i wykładnik są odczytane, a konwersja kończy się przed tail.

Brak konwersji zwraca 0.0, co jest nieodróżnialne od poprawnego zera. W C23, jeśli wartość wyniku nie jest reprezentowalna, zachowanie jest niezdefiniowane; nptr nie może być NULL. Do walidacji, wykrywania zakresu przez errno i poznania pierwszego niezużytego znaku użyj strtod.

Przykłady

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

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

Wynik

-125.0

Nadaje się tylko do zaufanego tekstu, gdy poprawność wejścia została już ustalona. Przykład rzeczywiście przekazuje `" -12.5e1tail"`: białe znaki, znak i wykładnik są odczytane, a konwersja kończy się przed `tail`.

Źródła