CKTIS / C++
std::from_chars: pretvorba iz znakova bez alokacije
std::from_chars analizira broj u [first, last) i bez iznimki vraća kraj i kod pogreške.
Verzija: 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> analizira cijeli broj iz izričito omeđenog raspona znakova; drugo preopterećenje obrađuje floating point i std::chars_format. Vraćeni std::from_chars_result sadrži std::from_chars_result::ptr na prvi nepodudarni znak i kod pogreške std::from_chars_result::ec. Ne alocira, ne ovisi o locale i ne treba nulti završetak.
Primjer čita početak "2a rest" u bazi 16. Postavlja value na 42, ostavlja ptr iza dva znaka i vraća prazan std::errc, pa ispisuje 42 2 1. Početne razmake ne preskače. Cjelobrojna forma ne prihvaća +, - samo za signed cilj i ni u bazi 16 ne prepoznaje prefiks 0x.
Bez podudarnog znaka vrijede ptr == first, errc::invalid_argument i nepromijenjen value. Izvan raspona tipa slijedi errc::result_out_of_range, vrijednost opet ostaje, a ptr označava kraj prepoznatog niza. Baza mora biti 2..36. Floating forma slijedi chars_format: eksponent obvezan za scientific, zabranjen za fixed, bez prefiksa 0x u hex načinu.
Primjeri
#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