Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::chars_format — formato di conversione in virgola mobile

std::chars_format seleziona la notazione in virgola mobile per std::to_chars e le regole di lettura per std::from_chars. Offre i formati general, fixed, scientific e hex; non imposta la precisione autonomamente.

Versione: C++23; repository compiler flag, production runtime not attested

Sintassi

#include <charconv>
std::chars_format::general
std::chars_format::fixed
std::chars_format::scientific
std::chars_format::hex

std::chars_format, dichiarato in <charconv>, è un’enumerazione con ambito e un tipo maschera di bit usato dagli overload in virgola mobile di std::to_chars e std::from_chars. I valori numerici di scientific, fixed e hex non sono specificati; general equivale a fixed | scientific. Per una conversione, passa uno dei valori denominati, non una combinazione arbitraria di bit.

In uscita, std::chars_format::fixed seleziona la notazione decimale senza esponente, mentre std::chars_format::scientific seleziona la notazione decimale con esponente. std::chars_format::general sceglie tra queste forme. std::chars_format::hex seleziona la notazione esadecimale con un esponente di potenza di due indicato da p, senza prefisso 0x.

La precisione è un argomento separato di std::to_chars: per fixed e scientific specifica le cifre dopo il separatore decimale; per general specifica la precisione in cifre significative. Non interpretarla come il numero di cifre decimali per tutti i formati. La funzione non aggiunge un terminatore nullo; controlla ec e usa l’intervallo che termina in ptr.

Per l’input tramite std::from_chars, scientific richiede un esponente, fixed non lo ammette e il formato predefinito general accetta entrambe le forme. Il formato hex non consuma un prefisso 0x: con 0x123, può analizzare correttamente solo 0, lasciando x123. Se è necessario consumare tutto l’input, controlla sia ec sia ptr == last.

Esempi

#include <charconv>
#include <iostream>
#include <system_error>

int main() {
    const std::chars_format formats[] = {
        std::chars_format::fixed,
        std::chars_format::scientific,
        std::chars_format::general
    };

    for (auto fmt : formats) {
        char buffer[64];
        const auto result = std::to_chars(
            buffer, buffer + sizeof buffer, 12.5, fmt, 3);
        if (result.ec != std::errc{}) {
            std::cerr << "conversion failed\n";
            return 1;
        }
        std::cout.write(buffer, result.ptr - buffer);
        std::cout << '\n';
    }
}

Risultato

12.500
1.250e+01
12.5

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