CKTIS / C++
std::to_chars — записване на число в символен буфер
std::to_chars записва текстовото представяне на число в буфер, предоставен от извикващия. Резултатът съдържа указател към края и код за грешка; функцията не добавя завършващ '\0'.
Версия: C++23; repository compiler flag, production runtime not attested
Синтаксис
#include <charconv>
std::to_chars(first, last, value);
std::to_chars(first, last, integer_value, base);
std::to_chars(first, last, floating_value, fmt);
std::to_chars(first, last, floating_value, fmt, precision);std::to_chars, декларирана в <charconv>, записва число във валидния, записваем диапазон [first, last). Не добавя '\0' и не хвърля изключения. Третирайте получените данни като диапазон от символи, а не автоматично като низ, завършващ с нулев символ.
Върнатият std::to_chars_result съдържа std::to_chars_result::ptr от тип char* и std::to_chars_result::ec от тип std::errc. Когато ec == std::errc{}, преобразуването е успешно: ptr сочи непосредствено след последния записан символ, а ptr - first дава дължината. Ако буферът е твърде малък, ec == std::errc::value_too_large и ptr == last; съдържанието на диапазона не е специфицирано. Не използвайте този буфер като частичен резултат.
За целите числа base по подразбиране е 10 и трябва да е в диапазона 2–36. Цифрите над 9 се записват като a–z; отрицателните стойности получават -. Претоварването за bool е премахнато. Претоварванията за числа с плаваща запетая приемат по избор std::chars_format и точност; използват правилата за форматиране на локал "C", независимо от текущите настройки за локал.
Примерът проверява ec, преди да използва ptr, и създава std::string_view с изрично зададена дължина. Предназначен е за компилиране с -std=c++23; не удостоверява поведението при изпълнение в производствена среда. Източниците eel.is представят развиващ се работен проект, затова може да съдържат допълнения, появили се след C++23.
Примери
#include <charconv>
#include <cstddef>
#include <iostream>
#include <string_view>
#include <system_error>
int main() {
char buffer[16];
const std::to_chars_result result =
std::to_chars(buffer, buffer + sizeof buffer, 255, 16);
if (result.ec != std::errc{}) {
std::cerr << "conversion failed\n";
return 1;
}
const std::string_view text(
buffer, static_cast<std::size_t>(result.ptr - buffer));
std::cout << text << '\n';
}
Резултат
ff
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.
Източници
- C++ working draft — Input/output library [input.output]
- C++ working draft — Primitive numeric conversions [charconv]
- C++ working draft — Header <charconv> synopsis [charconv.syn]
- C++ working draft — Primitive numeric output conversion [charconv.to.chars]
- C++ working draft (HTML rendering on eel.is) — Primitive numeric output conversion [charconv.to.chars]