Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

strtod — convertire l’inizio di una stringa in double

strtod converte l’inizio di una stringa in double. endptr permette di rilevare una mancata conversione e di esaminare il testo rimanente.

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

Sintassi

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

strtod ignora gli spazi iniziali e converte un prefisso di una stringa terminata da un carattere nullo. Il carattere separatore decimale dipende dalle impostazioni locali.

Se endptr non è nullo, *endptr punta al testo rimanente. end == text significa che non è avvenuta alcuna conversione; il solo zero non indica un errore. Per consumare tutto il testo deve essere vero anche *end == '\0'.

Azzera errno prima di controllare gli errori di intervallo. La segnalazione di un overflow tramite ERANGE dipende da math_errhandling & MATH_ERRNO; la segnalazione di un underflow è definita dall’implementazione.

Esempi

#include <stdio.h>
#include <stdlib.h>

int main(void)
{
    const char *text = "12.5kg";
    char *end;
    double value = strtod(text, &end);

    if (end == text) {
        puts("no conversion");
        return EXIT_FAILURE;
    }
    printf("value=%.1f; suffix=%s\n", value, end);
    return EXIT_SUCCESS;
}

Risultato

value=12.5; suffix=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