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::hexstd::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.