Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::chars_format — format konwersji liczb zmiennoprzecinkowych

std::chars_format wybiera zapis liczb zmiennoprzecinkowych dla std::to_chars i reguły odczytu dla std::from_chars. Udostępnia formaty general, fixed, scientific i hex; nie ustala samodzielnie precyzji.

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

Składnia

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

std::chars_format z nagłówka <charconv> jest wyliczeniem zakresowym i typem maski bitowej używanym przez zmiennoprzecinkowe przeciążenia std::to_chars oraz std::from_chars. Wartości liczbowe elementów scientific, fixed i hex nie są określone; general jest równe fixed | scientific. Do konwersji przekazuj jedną z nazwanych wartości, nie dowolną kombinację bitów.

Przy zapisie std::chars_format::fixed wybiera zapis dziesiętny bez wykładnika, a std::chars_format::scientific — zapis dziesiętny z wykładnikiem. std::chars_format::general wybiera między tymi postaciami. std::chars_format::hex wybiera zapis szesnastkowy z wykładnikiem potęgi dwójki oznaczonym przez p, bez prefiksu 0x.

Precyzja jest osobnym argumentem std::to_chars: dla fixed i scientific określa liczbę cyfr po separatorze dziesiętnym, a dla general — precyzję cyfr znaczących. Nie należy jej utożsamiać z liczbą cyfr po kropce we wszystkich formatach. Funkcja nie dodaje końcowego znaku zerowego; sprawdź ec i korzystaj z zakresu kończącego się na ptr.

Przy odczycie przez std::from_chars format scientific wymaga wykładnika, fixed go nie dopuszcza, a domyślny general pozwala na obie postacie. Format hex nie odczytuje prefiksu 0x: dla tekstu 0x123 może poprawnie odczytać samo 0, pozostawiając x123. Jeśli wymagane jest zużycie całego wejścia, sprawdź zarówno ec, jak i ptr == last.

Przykłady

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

Wynik

12.500
1.250e+01
12.5

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła