CKTIS / C++
std::to_chars — zapis števila v znakovni medpomnilnik
std::to_chars zapiše besedilno predstavitev števila v medpomnilnik, ki ga zagotovi klicatelj. Rezultat vsebuje kazalec na konec in kodo napake; funkcija ne doda zaključnega '\0'.
Različica: C++23; repository compiler flag, production runtime not attested
Sintaksa
#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, deklariran v <charconv>, zapiše število v veljavno zapisljivo območje [first, last). Ne doda '\0' in ne sproži izjem. Dobljene podatke obravnavaj kot območje znakov, ne samodejno kot ničelno zaključeni niz.
Vrnjeni std::to_chars_result vsebuje std::to_chars_result::ptr tipa char* in std::to_chars_result::ec tipa std::errc. Če velja ec == std::errc{}, je pretvorba uspela: ptr kaže takoj za zadnjim zapisanim znakom, ptr - first pa določa dolžino. Če je medpomnilnik premajhen, velja ec == std::errc::value_too_large in ptr == last; vsebina območja ni določena. Tega medpomnilnika ne uporabi kot delni rezultat.
Pri celih številih je base privzeto 10 in mora biti v območju 2–36. Števke nad 9 se zapišejo kot a–z; negativne vrednosti dobijo -. Preobremenitev za bool je odstranjena. Preobremenitve za števila s plavajočo vejico neobvezno sprejmejo std::chars_format in natančnost; uporabljajo pravila oblikovanja področne nastavitve "C", ne glede na trenutne področne nastavitve.
Primer preveri ec, preden uporabi ptr, in ustvari std::string_view z izrecno določeno dolžino. Namenjen je prevajanju z -std=c++23; ne potrjuje izvajanja v produkcijskem okolju. Viri eel.is prikazujejo razvijajoči se delovni osnutek, zato lahko vsebujejo dodatke, ki so nastali po C++23.
Primeri
#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';
}
Rezultat
ff
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.
Viri
- 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]