KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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

Bronnen