CKTIS / C++
std::to_chars — zapisivanje broja u znakovni međuspremnik
std::to_chars zapisuje tekstualni prikaz broja u međuspremnik koji je osigurao pozivatelj. Rezultat sadrži pokazivač na kraj i kod pogreške; funkcija ne dodaje završni '\0'.
Verzija: 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 u <charconv>, zapisuje broj u valjani, zapisivi raspon [first, last). Ne dodaje '\0' i ne izbacuje iznimke. Dobivene podatke tretiraj kao raspon znakova, a ne automatski kao niz znakova završen nulom.
Vraćeni std::to_chars_result sadrži std::to_chars_result::ptr tipa char* i std::to_chars_result::ec tipa std::errc. Ako vrijedi ec == std::errc{}, pretvorba je uspjela: ptr pokazuje odmah iza posljednjeg zapisanog znaka, a ptr - first daje duljinu. Ako je međuspremnik premalen, vrijedi ec == std::errc::value_too_large i ptr == last; sadržaj raspona nije specificiran. Nemoj upotrebljavati taj međuspremnik kao djelomičan rezultat.
Za cijele brojeve base je zadano 10 i mora biti u rasponu od 2 do 36. Znamenke veće od 9 zapisuju se kao a–z; negativne vrijednosti dobivaju -. Preopterećenje za bool je uklonjeno. Preopterećenja za brojeve s pomičnim zarezom po izboru prihvaćaju std::chars_format i preciznost; primjenjuju pravila oblikovanja lokaliteta "C", neovisno o trenutačnim postavkama lokaliteta.
Primjer provjerava ec prije upotrebe ptr i stvara std::string_view s izričito zadanom duljinom. Namijenjen je prevođenju s -std=c++23; ne potvrđuje ponašanje pri izvođenju u produkcijskom okruženju. Izvori eel.is prikazuju radni nacrt koji se razvija, pa mogu sadržavati dodatke nastale nakon C++23.
Primjeri
#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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.
Izvori
- 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]