Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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::hex

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

Fontes