CKTIS / C++
std::from_chars: allokationsfreie Zeichenkonvertierung
std::from_chars analysiert eine Zahl in [first, last) und liefert ohne Ausnahmen Ende und Fehlercode.
Version: 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) aus <charconv> analysiert eine Ganzzahl aus einem explizit begrenzten Zeichenbereich; ein anderer Overload verarbeitet Gleitkommazahlen und std::chars_format. Das zurückgegebene std::from_chars_result enthält std::from_chars_result::ptr zum ersten nicht passenden Zeichen und den Fehlercode std::from_chars_result::ec. Es wird nicht alloziert, keine Locale verwendet und kein Nullabschluss benötigt.
Das Beispiel liest den Anfang von "2a rest" zur Basis 16. value wird 42, ptr steht nach zwei Zeichen und std::errc bleibt leer; ausgegeben wird 42 2 1. Führender Leerraum wird nicht übersprungen. Ganzzahlen erlauben kein führendes +, - nur bei einem vorzeichenbehafteten Ziel und auch bei Basis 16 kein Präfix 0x.
Ohne passendes Zeichen gelten ptr == first, errc::invalid_argument und ein unverändertes value. Außerhalb des Zielbereichs gilt errc::result_out_of_range, ebenfalls ohne Wertänderung, während ptr das Ende der erkannten Folge markiert. Die Basis muss 2..36 sein. Gleitkomma folgt chars_format: etwa Exponentpflicht bei scientific, Exponentverbot bei fixed; auch Hex-Modus erkennt kein 0x.
Beispiele
#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';
}
Ergebnis
42 2 1
std::from_chars → 42 2 1