CKTIS / C
strtold — pretvorba besedila v long double
strtold iz <stdlib.h> prebere začetno število iz besedila kot long double. Z endptr lahko preverite, kje se je pretvorba končala.
Različica: C23; repository compiler flag, production runtime not attested
Sintaksa
#include <stdlib.h>
long double strtold(const char *restrict nptr, char **restrict endptr);strtold preskoči začetne bele znake in prepozna decimalne ter šestnajstiške zapise, pa tudi zapise neskončnosti. Zapise NaN prepozna le, če tip vrnjene vrednosti podpira tihe vrednosti NaN. Sicer se šteje, da vhod v obliki NaN ni v pričakovani obliki, in pretvorba se ne izvede. Decimalno ločilo je odvisno od locale.
nptr mora kazati na niz, zaključen z ničelnim znakom. Če endptr ni ničeln, funkcija vanj shrani kazalec na prvi nepretvorjeni znak; dovoljeno je podati NULL. Če do pretvorbe ne pride, je rezultat nič in velja *endptr == nptr; samo ničelna vrednost ne zazna napake.
Pred klicem nastavite errno na nič. Če pri privzetem načinu zaokroževanja pride do prekoračitve, funkcija nastavi errno na ERANGE. Pri drugih načinih zaokroževanja to ni zagotovljeno. Ali se errno ob podteku nastavi na ERANGE, je odvisno od implementacije. Če želite zahtevati popolno pretvorbo, kot endptr podajte neničelni kazalec in po klicu preverite tudi **endptr == '\0'. Primer namenoma pusti kg.
Primeri
#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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.