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