Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

strtold — konwersja tekstu na long double

strtold z <stdlib.h> odczytuje początkową liczbę z tekstu jako long double. endptr pozwala sprawdzić, gdzie zakończyła się konwersja.

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

Składnia

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

strtold pomija początkowe białe znaki i rozpoznaje zapis dziesiętny, szesnastkowy oraz zapis nieskończoności. Zapis NaN jest rozpoznawany tylko wtedy, gdy typ zwracany obsługuje ciche NaN. W przeciwnym razie taki zapis nie jest uznawany za zgodny z oczekiwanym formatem i konwersja nie następuje. Separator dziesiętny zależy od locale.

nptr musi wskazywać napis zakończony znakiem zerowym. Dla niepustego endptr funkcja zapisuje tam wskaźnik pierwszego nieprzetworzonego znaku; można przekazać NULL. Brak konwersji oznacza wynik zero i *endptr == nptr; samo zero nie wykrywa błędu.

Przed wywołaniem wyzeruj errno. Przy przepełnieniu i domyślnym trybie zaokrąglania funkcja ustawia errno na ERANGE. Przy innych trybach zaokrąglania nie ma takiej gwarancji. To, czy errno zostanie ustawione na ERANGE przy niedomiarze, zależy od implementacji. Aby wymagać pełnej konwersji, przekaż niezerowy wskaźnik jako endptr i po wywołaniu sprawdź także **endptr == '\0'. Przykład celowo pozostawia kg.

Przykłady

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

int main(void)
{
    const char *text = "12.5kg";
    char *end;
    errno = 0;
    long double value = strtold(text, &end);

    if (end == text || errno == ERANGE) {
        puts("conversion failed");
        return EXIT_FAILURE;
    }

    printf("value=%.1Lf\nrest=%s\n", value, end);
    return EXIT_SUCCESS;
}

Wynik

value=12.5
rest=kg

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

Źródła