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.