CKTIS / C++
std::to_chars — zápis čísla do znakového buffera
std::to_chars zapisuje textovú reprezentáciu čísla do buffera poskytnutého volajúcim. Výsledok obsahuje ukazovateľ na koniec a chybový kód; funkcia nepridáva ukončovacie '\0'.
Verzia: C++23; repository compiler flag, production runtime not attested
Syntax
#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 zapisovateľného rozsahu [first, last). Nepridáva '\0' a nevyhadzuje výnimky. S výslednými údajmi zaobchádzaj ako s rozsahom znakov, nie automaticky ako s reťazcom ukončeným nulou.
Vrátený std::to_chars_result obsahuje std::to_chars_result::ptr typu char* a std::to_chars_result::ec typu std::errc. Ak platí ec == std::errc{}, konverzia prebehla úspešne: ptr ukazuje hneď za posledný zapísaný znak a ptr - first udáva dĺžku. Ak je buffer príliš malý, platí ec == std::errc::value_too_large a ptr == last; obsah rozsahu nie je špecifikovaný. Nepoužívaj tento buffer ako čiastočný výsledok.
Pri celých číslach je base predvolene 10 a musí byť v rozsahu 2–36. Číslice nad 9 sa zapisujú ako a–z; záporné hodnoty dostanú -. Preťaženie pre bool je odstránené. Preťaženia pre čísla s pohyblivou desatinnou čiarkou voliteľne prijímajú std::chars_format a presnosť; používajú pravidlá formátovania locale "C" bez ohľadu na aktuálne nastavenia locale.
Príklad kontroluje ec pred použitím ptr a vytvára std::string_view s výslovne určenou dĺžkou. Je určený na kompiláciu s -std=c++23; nepotvrdzuje správanie za behu v produkčnom prostredí. Zdroje eel.is predstavujú vyvíjajúci sa pracovný návrh, a preto môžu obsahovať dodatky novšie než C++23.
Prí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ýsledok
ff
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.
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]