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

CKTIS / C

strtod — převod začátku řetězce na double

strtod převádí začátek řetězce na double. Pomocí endptr lze zjistit, že ke konverzi nedošlo, a prohlédnout si zbývající text.

Verze: C23; repository compiler flag, production runtime not attested

Syntaxe

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

strtod přeskočí počáteční bílé znaky a převede prefix řetězce ukončeného nulovým znakem. Znak desetinné tečky závisí na locale.

Pokud endptr není nulový ukazatel, *endptr ukazuje na zbývající text. end == text znamená, že neproběhla žádná konverze; samotná nula neznamená chybu. Pro úplné zpracování musí navíc platit *end == '\0'.

Před kontrolou chyb rozsahu vynulujte errno. Hlášení přetečení pomocí ERANGE závisí na math_errhandling & MATH_ERRNO; hlášení podtečení je definováno implementací.

Příklady

#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;
}

Výsledek

value=12.5; suffix=kg

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje