Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C++

std::chars_format — formát konverzie čísel s pohyblivou rádovou čiarkou

std::chars_format vyberá zápis čísel s pohyblivou rádovou čiarkou pre std::to_chars a pravidlá čítania pre std::from_chars. Ponúka formáty general, fixed, scientific a hex; presnosť sám nenastavuje.

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

Syntax

#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 rozsahom a typ bitovej masky, ktorý používajú preťaženia pre čísla s pohyblivou rádovou čiarkou vo funkciách std::to_chars a std::from_chars. Číselné hodnoty scientific, fixed a hex nie sú špecifikované; general zodpovedá fixed | scientific. Pri konverzii odovzdajte jednu z pomenovaných hodnôt, nie ľubovoľnú kombináciu bitov.

Pre výstup vyberá std::chars_format::fixed desiatkový zápis bez exponentu, zatiaľ čo std::chars_format::scientific vyberá desiatkový zápis s exponentom. std::chars_format::general volí medzi týmito podobami. std::chars_format::hex vyberá šestnástkový zápis s exponentom mocniny dvoch označeným znakom p, bez predpony 0x.

Presnosť je samostatný argument funkcie std::to_chars: pre fixed a scientific určuje počet číslic za desatinným oddeľovačom, pre general presnosť v počte platných číslic. Nepovažujte ju pri všetkých formátoch za počet desatinných miest. Funkcia nepridáva záverečný nulový znak; skontrolujte ec a použite rozsah končiaci na ptr.

Pri vstupe cez std::from_chars vyžaduje scientific exponent, fixed ho nepovoľuje a predvolený formát general prijíma obe podoby. Formát hex nespracováva predponu 0x: pri 0x123 môže úspešne prečítať iba 0 a ponechať x123. Ak treba spracovať celý vstup, skontrolujte ec aj ptr == last.

Prí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ýsledok

12.500
1.250e+01
12.5

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje