База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C++

std::chars_format — формат за преобразуване на числа с плаваща запетая

std::chars_format избира записа на числата с плаваща запетая за std::to_chars и правилата за прочитане за std::from_chars. Предлага форматите general, fixed, scientific и hex; самостоятелно не задава точността.

Версия: C++23; repository compiler flag, production runtime not attested

Синтаксис

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

std::chars_format, деклариран в <charconv>, е scoped изброим тип и тип битова маска, използван от претоварените функции за числа с плаваща запетая на std::to_chars и std::from_chars. Числовите стойности на scientific, fixed и hex не са специфицирани; general е равен на fixed | scientific. При преобразуване подайте една от именуваните стойности, а не произволна комбинация от битове.

При извеждане std::chars_format::fixed избира десетичен запис без експонента, а std::chars_format::scientific избира десетичен запис с експонента. std::chars_format::general избира между тези форми. std::chars_format::hex избира шестнадесетичен запис с експонента за степен на две, означена с p, без префикс 0x.

Точността е отделен аргумент на std::to_chars: за fixed и scientific тя задава броя на цифрите след десетичния разделител, а за general задава точността в значещи цифри. Не я тълкувайте като броя на десетичните знаци за всички формати. Функцията не добавя завършващ нулев знак; проверете ec и използвайте диапазона, завършващ при ptr.

При вход чрез std::from_chars scientific изисква експонента, fixed не допуска такава, а форматът по подразбиране general приема и двете форми. Форматът hex не обработва префикс 0x: при 0x123 може успешно да прочете само 0, като остави x123. Ако трябва да се обработи целият вход, проверете както ec, така и ptr == last.

Примери

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

Резултат

12.500
1.250e+01
12.5

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници