CKTIS / C++
std::from_chars: conversione senza allocazione da caratteri
std::from_chars analizza un numero in [first, last) e restituisce fine e codice errore senza eccezioni.
Versione: C++23
Sintassi
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) di <charconv> analizza un intero da un intervallo di caratteri delimitato; un altro overload gestisce floating point e std::chars_format. Lo std::from_chars_result restituito contiene std::from_chars_result::ptr, che indica il primo carattere non corrispondente, e il codice di errore std::from_chars_result::ec. Non alloca, non dipende dalla locale e non richiede terminatore nullo.
L’esempio legge l’inizio di "2a rest" in base 16. Imposta value a 42, lascia ptr dopo due caratteri e produce std::errc vuoto, quindi stampa 42 2 1. Non salta spazi iniziali. La forma intera non accetta +, accetta - solo per destinazione signed e non considera 0x un prefisso neppure in base 16.
Se nessun carattere corrisponde, si hanno ptr == first, errc::invalid_argument e value invariato. Fuori dall’intervallo del tipo si ha errc::result_out_of_range, ancora senza modificare value, mentre ptr segna la fine riconosciuta. La base deve essere 2..36. Il floating segue chars_format: esponente richiesto per scientific, vietato per fixed, e nessun prefisso 0x in modalità hex.
Esempi
#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';
}
Risultato
42 2 1
std::from_chars → 42 2 1