Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C

strtod — prevod začiatku reťazca na double

strtod prevádza začiatok reťazca na double. Pomocou endptr možno zistiť, že ku konverzii nedošlo, a prezrieť si zostávajúci text.

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

Syntax

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

strtod preskočí úvodné biele znaky a prevedie prefix reťazca ukončeného nulovým znakom. Znak desatinnej bodky závisí od locale.

Ak endptr nie je nulový ukazovateľ, *endptr ukazuje na zostávajúci text. end == text znamená, že sa neuskutočnila žiadna konverzia; samotná nula neznamená chybu. Na úplné spracovanie musí navyše platiť *end == '\0'.

Pred kontrolou chýb rozsahu vynulujte errno. Hlásenie pretečenia pomocou ERANGE závisí od math_errhandling & MATH_ERRNO; hlásenie podtečenia je definované implementáciou.

Prí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ýsledok

value=12.5; suffix=kg

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje