CKTIS / C
strtold — convertire il testo in long double
strtold, dichiarata in <stdlib.h>, legge il numero iniziale di un testo come long double. endptr permette di controllare dove termina la conversione.
Versione: C23; repository compiler flag, production runtime not attested
Sintassi
#include <stdlib.h>
long double strtold(const char *restrict nptr, char **restrict endptr);strtold ignora gli spazi bianchi iniziali e riconosce le rappresentazioni decimali ed esadecimali, oltre a quelle dell’infinito. Riconosce le forme NaN solo se il tipo restituito supporta i NaN silenziosi. In caso contrario, un input in forma NaN è considerato non conforme al formato atteso e non viene effettuata alcuna conversione. Il separatore decimale dipende dalle impostazioni locali.
nptr deve puntare a una stringa terminata da un carattere nullo. Se endptr non è nullo, la funzione vi memorizza un puntatore al primo carattere non convertito; è consentito passare NULL. Se non avviene alcuna conversione, il risultato è zero e *endptr == nptr; il solo valore zero non permette di rilevare un errore.
Imposta errno a zero prima della chiamata. Se si verifica un overflow mentre è attiva la modalità di arrotondamento predefinita, la funzione imposta errno a ERANGE. Con altre modalità di arrotondamento, questo comportamento non è garantito. In caso di underflow, l’impostazione di errno a ERANGE dipende dall’implementazione. Per richiedere una conversione completa, passa un puntatore non nullo come endptr e dopo la chiamata controlla anche **endptr == '\0'. L’esempio lascia intenzionalmente kg.
Esempi
#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;
}
Risultato
value=12.5 rest=kg
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.