Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

strtod — konwersja początku napisu na double

strtod przekształca początek napisu w double. endptr umożliwia wykrycie braku konwersji oraz odczyt pozostałego tekstu.

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

Składnia

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

strtod pomija początkowe białe znaki i konwertuje prefiks napisu zakończonego znakiem zerowym. Separator dziesiętny zależy od locale.

Przy niepustym endptr, *endptr wskazuje pozostały tekst. end == text oznacza brak konwersji; samo zero nie oznacza błędu. Pełne zużycie wymaga również *end == '\0'.

Wyzeruj errno przed kontrolą zakresu. Raportowanie przepełnienia przez ERANGE zależy od math_errhandling & MATH_ERRNO; raportowanie niedomiaru jest zależne od implementacji.

Przykłady

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

Wynik

value=12.5; suffix=kg

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła