Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C

strtold — pretvorba teksta u long double

strtold iz <stdlib.h> čita početni broj iz teksta kao long double. Pomoću endptr možete provjeriti gdje je pretvorba stala.

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

Sintaksa

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

strtold preskače početne bjeline te prepoznaje decimalni i heksadekadski zapis, kao i zapise beskonačnosti. Zapise NaN prepoznaje samo ako povratni tip podržava tihe NaN vrijednosti. U suprotnom se zapis NaN ne smatra ulazom u očekivanom obliku i pretvorba se ne obavlja. Decimalni separator ovisi o lokalnim postavkama.

nptr mora pokazivati na niz znakova završen nul-znakom. Ako endptr nije null, funkcija u njega sprema pokazivač na prvi znak koji nije pretvoren; dopušteno je proslijediti NULL. Ako se ne dogodi pretvorba, rezultat je nula i vrijedi *endptr == nptr; sama nula ne otkriva pogrešku.

Prije poziva postavite errno na nulu. Ako dođe do prekoračenja dok je aktivan zadani način zaokruživanja, funkcija postavlja errno na ERANGE. U drugim načinima zaokruživanja to nije zajamčeno. Hoće li se pri podbačaju errno postaviti na ERANGE ovisi o implementaciji. Želite li zahtijevati potpunu pretvorbu, za endptr proslijedite pokazivač koji nije NULL i nakon poziva provjerite i **endptr == '\0'. Primjer namjerno ostavlja kg.

Primjeri

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

Rezultat

value=12.5
rest=kg

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori