CKTIS / C++
std::from_chars: pretvorba iz znakov brez dodeljevanja
std::from_chars razčleni število v [first, last) ter brez izjem vrne konec in kodo napake.
Različica: C++23
Sintaksa
struct std::from_chars_result {
const char* ptr;
std::errc ec;
};
constexpr std::from_chars_result std::from_chars(
const char* first, const char* last, /* integer type */& value, int base = 10);
std::from_chars_result std::from_chars(
const char* first, const char* last, /* floating type */& value,
std::chars_format fmt = std::chars_format::general);std::from_chars(first, last, value, base) iz <charconv> razčleni celo število iz izrecno omejenega območja znakov; druga preobremenitev obravnava plavajoča števila in std::chars_format. Vrnjeni std::from_chars_result vsebuje std::from_chars_result::ptr do prvega neujemajočega znaka in kodo napake std::from_chars_result::ec. Ne dodeljuje, ni odvisen od locale in ne potrebuje ničelnega zaključka.
Primer bere začetek "2a rest" v osnovi 16. value nastavi na 42, ptr pusti za dvema znakoma in vrne prazen std::errc, zato izpiše 42 2 1. Začetnih presledkov ne preskoči. Cela oblika ne sprejme +, - le za signed cilj, in niti pri osnovi 16 ne prizna predpone 0x.
Brez ujemajočega znaka so rezultat ptr == first, errc::invalid_argument in nespremenjen value. Zunaj obsega tipa sledi errc::result_out_of_range, vrednost ostane, ptr pa označi konec prepoznanega zaporedja. Osnova mora biti 2..36. Plavajoča oblika sledi chars_format: eksponent zahtevan pri scientific, prepovedan pri fixed, brez 0x v hex načinu.
Primeri
#include <charconv>
#include <iostream>
#include <string_view>
#include <system_error>
int main() {
const std::string_view text = "2a rest";
int value = -1;
const auto result = std::from_chars(text.data(), text.data() + text.size(), value, 16);
std::cout << value << ' ' << (result.ptr - text.data()) << ' '
<< (result.ec == std::errc{}) << '\n';
}
Rezultat
42 2 1
std::from_chars → 42 2 1