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

CKTIS / C

strtof — prevod textu na float

strtof číta začiatok reťazca ako float. Ukazovateľ endptr umožňuje zistiť, že k prevodu nedošlo, a odhaliť zostávajúci text.

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

Syntax

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

strtof z <stdlib.h> preskočí úvodné biele znaky a prevedie prefix reťazca na float. Desatinný oddeľovač závisí od locale.

Ak endptr != NULL, uloží ukazovateľ na prvý nespotrebovaný znak. end == text znamená, že k prevodu nedošlo; samotná nula nedokazuje, že nastala chyba. Na úplné spracovanie musí platiť aj *end == '\0'.

Podľa N3096 závisí hlásenie chýb rozsahu od math_errhandling: pri pretečení sa nastaví ERANGE, ak je povolené MATH_ERRNO; nastavenie pri podtečení závisí od implementácie. Pred kontrolou nastavte errno na nulu.

Príklady

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

Výsledok

value=12.5; rest=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