Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C++

std::chars_format — format pretvorbe števil s plavajočo vejico

std::chars_format izbere zapis števil s plavajočo vejico za std::to_chars in pravila branja za std::from_chars. Ponuja formate general, fixed, scientific in hex; natančnosti ne določa sam.

Različica: 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 v <charconv>, je omejena enumeracija in tip bitne maske, ki ga uporabljajo preobremenitve za števila s plavajočo vejico v std::to_chars in std::from_chars. Številske vrednosti scientific, fixed in hex niso določene; general je enak fixed | scientific. Pri pretvorbi podaj eno od poimenovanih vrednosti, ne poljubne kombinacije bitov.

Za izpis std::chars_format::fixed izbere decimalni zapis brez eksponenta, std::chars_format::scientific pa decimalni zapis z eksponentom. std::chars_format::general izbira med tema oblikama. std::chars_format::hex izbere šestnajstiški zapis z eksponentom potence števila dve, označenim s p, brez predpone 0x.

Natančnost je ločen argument funkcije std::to_chars: pri fixed in scientific določa število števk za decimalnim ločilom, pri general pa natančnost v številu pomembnih števk. Ne razumi je pri vseh formatih kot število decimalnih mest. Funkcija ne doda zaključnega ničelnega znaka; preveri ec in uporabi obseg, ki se konča pri ptr.

Pri vhodu prek std::from_chars scientific zahteva eksponent, fixed ga ne dovoljuje, privzeti general pa sprejme obe obliki. Format hex ne porabi predpone 0x: pri 0x123 lahko uspešno prebere samo 0 in pusti x123. Če mora biti porabljen celoten vhod, preveri tako ec kot ptr == last.

Primeri

#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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri