Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C

strtof — pretvorba besedila v float

strtof prebere začetek niza kot float. Kazalec endptr omogoča zaznavanje, da pretvorbe ni bilo, in preostalega besedila.

Različica: C23; repository compiler flag, production runtime not attested

Sintaksa

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

strtof iz <stdlib.h> preskoči začetne presledke in pretvori predpono niza v float. Decimalno ločilo je odvisno od področne nastavitve.

Če velja endptr != NULL, shrani kazalec na prvi neporabljeni znak. end == text pomeni, da do pretvorbe ni prišlo; sama ničla ne dokazuje, da je prišlo do napake. Za porabo celotnega niza mora veljati tudi *end == '\0'.

Po N3096 je poročanje o napakah območja odvisno od math_errhandling: pri prekoračitvi se nastavi ERANGE, če je omogočen MATH_ERRNO; nastavitev pri podteku je odvisna od izvedbe. Pred preverjanjem nastavite errno na nič.

Primeri

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

Rezultat

value=12.5; rest=kg

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri