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::hexstd::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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.