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

CKTIS / C

strtod — pretvorba začetka niza v double

strtod pretvori začetek niza v double. Z endptr lahko zaznate, da do pretvorbe ni prišlo, in pregledate preostalo besedilo.

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

Sintaksa

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

strtod preskoči začetne presledke in pretvori predpono niza, zaključenega z ničelnim znakom. Znak decimalnega ločila je odvisen od področne nastavitve.

Če endptr ni ničelni kazalec, *endptr kaže na preostalo besedilo. end == text pomeni, da ni prišlo do pretvorbe; sama ničla ne pomeni napake. Za popolno porabo mora veljati tudi *end == '\0'.

Pred preverjanjem napak obsega ponastavite errno na nič. Sporočanje prekoračitve z ERANGE je odvisno od math_errhandling & MATH_ERRNO; sporočanje podkoračitve določa implementacija.

Primeri

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

Rezultat

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