Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti