CKTIS / C++
std::to_chars — zápis čísla do znakového bufferu
std::to_chars zapisuje textovou reprezentaci čísla do bufferu poskytnutého volajícím. Výsledek obsahuje ukazatel na konec a chybový kód; funkce nepřidává ukončovací '\0'.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#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 deklarované v <charconv> zapisuje číslo do platného zapisovatelného rozsahu [first, last). Nepřidává '\0' a nevyhazuje výjimky. S výslednými daty zacházej jako s rozsahem znaků, nikoli automaticky jako s řetězcem ukončeným nulou.
Vrácený std::to_chars_result obsahuje std::to_chars_result::ptr typu char* a std::to_chars_result::ec typu std::errc. Pokud platí ec == std::errc{}, převod proběhl úspěšně: ptr ukazuje hned za poslední zapsaný znak a ptr - first udává délku. Je-li buffer příliš malý, platí ec == std::errc::value_too_large a ptr == last; obsah rozsahu není specifikován. Nepoužívej tento buffer jako částečný výsledek.
U celých čísel je base ve výchozím stavu 10 a musí být v rozsahu 2–36. Číslice vyšší než 9 se zapisují jako a–z; záporné hodnoty dostanou -. Přetížení pro bool je odstraněno. Přetížení pro čísla s plovoucí desetinnou čárkou volitelně přijímají std::chars_format a přesnost; používají pravidla formátování locale "C" bez ohledu na aktuální nastavení locale.
Příklad kontroluje ec před použitím ptr a vytváří std::string_view s výslovně uvedenou délkou. Je určen ke kompilaci s -std=c++23; nepotvrzuje chování za běhu v produkčním prostředí. Zdroje eel.is představují vyvíjející se pracovní návrh, takže mohou obsahovat doplňky novější než C++23.
Příklady
#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';
}
Výsledek
ff
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.
Zdroje
- 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]