Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C++

std::chars_format — format pretvorbe brojeva s pomičnim zarezom

std::chars_format odabire zapis brojeva s pomičnim zarezom za std::to_chars i pravila čitanja za std::from_chars. Nudi formate general, fixed, scientific i hex; sam ne određuje preciznost.

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

Sintaksa

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

std::chars_format, deklariran u <charconv>, enumeracija je s opsegom i tip bitne maske koji upotrebljavaju preopterećenja za brojeve s pomičnim zarezom u std::to_chars i std::from_chars. Brojčane vrijednosti scientific, fixed i hex nisu specificirane; general je jednak fixed | scientific. Pri pretvorbi proslijedi jednu od imenovanih vrijednosti, a ne proizvoljnu kombinaciju bitova.

Za izlaz std::chars_format::fixed odabire decimalni zapis bez eksponenta, dok std::chars_format::scientific odabire decimalni zapis s eksponentom. std::chars_format::general bira između tih oblika. std::chars_format::hex odabire heksadekadski zapis s eksponentom potencije broja dva označenim znakom p, bez prefiksa 0x.

Preciznost je zaseban argument funkcije std::to_chars: za fixed i scientific određuje broj znamenaka nakon decimalnog razdjelnika, a za general preciznost u značajnim znamenkama. Nemoj je u svim formatima tumačiti kao broj decimalnih mjesta. Funkcija ne dodaje završni nul-znak; provjeri ec i upotrijebi raspon koji završava na ptr.

Pri unosu putem std::from_chars, scientific zahtijeva eksponent, fixed ga ne dopušta, a zadani general prihvaća oba oblika. Format hex ne obrađuje prefiks 0x: za 0x123 može uspješno pročitati samo 0, ostavljajući x123. Ako treba obraditi cijeli unos, provjeri i ec i ptr == last.

Primjeri

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

Rezultat

12.500
1.250e+01
12.5

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori