Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C

atof — knihovní funkce C23

`atof(const char *nptr)` z `<stdlib.h>` převede počáteční část řetězce na `double`; chová se jako `strtod(nptr, NULL)`, ale neposkytuje užitečný koncový ukazatel ani spolehlivou diagnostiku chyby.

Verze: C23

Syntaxe

double atof(const char *nptr);

atof(const char *nptr) z <stdlib.h> převede počáteční část řetězce na double; chová se jako strtod(nptr, NULL), ale neposkytuje užitečný koncový ukazatel ani spolehlivou diagnostiku chyby.

Hodí se jen pro důvěryhodný text, jehož platnost je již ověřena. Příklad skutečně předá " -12.5e1tail": mezery, znaménko a exponent se načtou a převod skončí před tail.

Bez převodu vrátí 0.0, což nelze odlišit od platné nuly. V C23 je chování nedefinované, pokud výsledek nelze reprezentovat, a nptr nesmí být NULL. Pro validaci, zjištění rozsahu přes errno a nalezení prvního nespotřebovaného znaku použij strtod.

Příklady

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

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

Výsledek

-125.0

Hodí se jen pro důvěryhodný text, jehož platnost je již ověřena. Příklad skutečně předá `" -12.5e1tail"`: mezery, znaménko a exponent se načtou a převod skončí před `tail`.

Zdroje