Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

strtof — konwersja tekstu na float

strtof odczytuje początek napisu jako float. Wskaźnik endptr pozwala wykryć brak konwersji i pozostały tekst.

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

Składnia

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

strtof z <stdlib.h> pomija początkowe białe znaki i konwertuje prefiks napisu na float. Separator dziesiętny zależy od locale.

Gdy endptr != NULL, zapisuje wskaźnik pierwszego nieprzetworzonego znaku. end == text oznacza brak konwersji; samo zero nie rozstrzyga o błędzie. Pełne zużycie wymaga również *end == '\0'.

W N3096 sygnalizacja zakresu zależy od math_errhandling: przepełnienie ustawia ERANGE, jeśli włączono MATH_ERRNO; dla niedomiaru ustawienie jest zależne od implementacji. Wyzeruj errno przed jego sprawdzaniem.

Przykłady

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

int main(void)
{
    const char *text = "  12.5kg";
    char *end;
    float value = strtof(text, &end);

    if (end == text) {
        puts("no conversion");
        return 1;
    }

    printf("value=%.1f; rest=%s\n", (double)value, end);
    return 0;
}

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