CKTIS / C++
std::to_chars — zapis liczby do bufora znaków
std::to_chars zapisuje tekstową reprezentację liczby w buforze przekazanym przez wywołującego. Wynik zawiera wskaźnik końca zapisu i kod błędu; funkcja nie dopisuje znaku kończącego '\0'.
Wersja: C++23; repository compiler flag, production runtime not attested
Składnia
#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 z nagłówka <charconv> zapisuje liczbę w poprawnym, zapisywalnym zakresie [first, last). Nie dopisuje '\0' i nie zgłasza wyjątków. Otrzymane dane należy traktować jako zakres znaków, a nie automatycznie jako łańcuch zakończony zerem.
Zwracany std::to_chars_result zawiera std::to_chars_result::ptr typu char* oraz std::to_chars_result::ec typu std::errc. Gdy ec == std::errc{}, konwersja się powiodła: ptr wskazuje tuż za ostatni zapisany znak, a ptr - first określa długość. Przy zbyt małym buforze ec == std::errc::value_too_large, ptr == last, a zawartość zakresu jest nieokreślona. Nie wykorzystuj wtedy bufora jako częściowego wyniku.
Dla liczb całkowitych base wynosi domyślnie 10 i musi należeć do zakresu 2–36. Cyfry powyżej 9 zapisuje się jako a–z; liczba ujemna otrzymuje -. Przeciążenie dla bool jest usunięte. Przeciążenia zmiennoprzecinkowe przyjmują opcjonalnie std::chars_format i precyzję; stosują reguły formatowania lokalizacji "C", niezależnie od bieżących ustawień lokalnych.
Przykład sprawdza ec przed użyciem ptr i buduje std::string_view o jawnej długości. Jest przeznaczony do kompilacji z -std=c++23; nie potwierdza działania w środowisku produkcyjnym. Źródła eel.is przedstawiają rozwijany projekt standardu, więc mogą zawierać dodatki późniejsze niż C++23.
Przykłady
#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';
}
Wynik
ff
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.
Źródła
- 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]