CKTIS / C++
std::from_chars: allocatievrije omzetting uit tekens
std::from_chars ontleedt een getal in [first, last) en retourneert zonder excepties einde en foutcode.
Versie: C++23
Syntax
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) uit <charconv> ontleedt een geheel getal uit een expliciet begrensd tekenbereik; een andere overload behandelt floating point en std::chars_format. De teruggegeven std::from_chars_result bevat std::from_chars_result::ptr naar het eerste niet-passende teken en de foutcode std::from_chars_result::ec. Er is geen allocatie, locale-afhankelijkheid of nulterminator nodig.
Het voorbeeld leest het begin van "2a rest" in basis 16. value wordt 42, ptr staat na twee tekens en std::errc is leeg; het print 42 2 1. Voorloopspaties worden niet overgeslagen. De gehele vorm accepteert geen +, alleen - voor een signed doel en geen 0x-prefix, ook niet bij basis 16.
Zonder passend teken zijn het resultaat ptr == first, errc::invalid_argument en een ongewijzigde value. Buiten het typebereik volgt errc::result_out_of_range, eveneens zonder waardewijziging, terwijl ptr het herkenningseinde markeert. De basis moet 2..36 zijn. Floating parsing volgt chars_format: exponent verplicht bij scientific, verboden bij fixed, en geen 0x in hexmodus.
Voorbeelden
#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';
}
Resultaat
42 2 1
std::from_chars → 42 2 1