CKTIS / C++
std::chars_format — formato de conversão de vírgula flutuante
std::chars_format seleciona a notação de vírgula flutuante para std::to_chars e as regras de leitura para std::from_chars. Disponibiliza os formatos general, fixed, scientific e hex; não define a precisão por si só.
Versão: C++23; repository compiler flag, production runtime not attested
Sintaxe
#include <charconv>
std::chars_format::general
std::chars_format::fixed
std::chars_format::scientific
std::chars_format::hexstd::chars_format, declarado em <charconv>, é uma enumeração com âmbito e um tipo máscara de bits utilizado pelas sobrecargas de vírgula flutuante de std::to_chars e std::from_chars. Os valores numéricos de scientific, fixed e hex não são especificados; general equivale a fixed | scientific. Numa conversão, passe um dos valores com nome, não uma combinação arbitrária de bits.
Na saída, std::chars_format::fixed seleciona a notação decimal sem expoente, enquanto std::chars_format::scientific seleciona a notação decimal com expoente. std::chars_format::general escolhe entre estas formas. std::chars_format::hex seleciona a notação hexadecimal com um expoente de potência de dois assinalado por p, sem o prefixo 0x.
A precisão é um argumento separado de std::to_chars: para fixed e scientific, especifica os algarismos após o separador decimal; para general, especifica a precisão em algarismos significativos. Não a interprete como o número de casas decimais em todos os formatos. A função não acrescenta um terminador nulo; verifique ec e utilize o intervalo que termina em ptr.
Na leitura com std::from_chars, scientific exige um expoente, fixed não permite um, e o formato predefinido general aceita ambas as formas. O formato hex não consome um prefixo 0x: perante 0x123, pode analisar corretamente apenas 0, deixando x123. Se for necessário consumir toda a entrada, verifique ec e ptr == last.
Exemplos
#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';
}
}
Resultado
12.500 1.250e+01 12.5
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.