Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::chars_format — formát převodu čísel s plovoucí desetinnou čárkou

std::chars_format vybírá zápis čísel s plovoucí desetinnou čárkou pro std::to_chars a pravidla čtení pro std::from_chars. Nabízí formáty general, fixed, scientific a hex; přesnost sám nenastavuje.

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

Syntaxe

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

std::chars_format deklarovaný v <charconv> je výčtový typ s rozsahem a typ bitové masky, který používají přetížení pro čísla s plovoucí desetinnou čárkou ve funkcích std::to_chars a std::from_chars. Číselné hodnoty scientific, fixed a hex nejsou specifikovány; general odpovídá fixed | scientific. Při převodu předejte jednu z pojmenovaných hodnot, nikoli libovolnou kombinaci bitů.

Pro výstup vybírá std::chars_format::fixed desetinný zápis bez exponentu, zatímco std::chars_format::scientific vybírá desetinný zápis s exponentem. std::chars_format::general volí mezi těmito podobami. std::chars_format::hex vybírá šestnáctkový zápis s exponentem mocniny dvou označeným znakem p, bez předpony 0x.

Přesnost je samostatný argument funkce std::to_chars: pro fixed a scientific určuje počet číslic za desetinným oddělovačem, pro general přesnost v počtu platných číslic. Nevykládejte ji u všech formátů jako počet desetinných míst. Funkce nepřidává závěrečný nulový znak; zkontrolujte ec a použijte rozsah končící na ptr.

Při vstupu přes std::from_chars vyžaduje scientific exponent, fixed jej nepovoluje a výchozí general přijímá obě podoby. Formát hex nezpracovává předponu 0x: u 0x123 může úspěšně přečíst pouze 0 a ponechat x123. Pokud je nutné zpracovat celý vstup, zkontrolujte ec i ptr == last.

Příklady

#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';
    }
}

Výsledek

12.500
1.250e+01
12.5

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje