std:: from_chars

Analysiert die Zeichensequenz [ first , last ) nach einem unten beschriebenen Muster. Wenn keine Zeichen dem Muster entsprechen oder wenn der durch Parsen der übereinstimmenden Zeichen erhaltene Wert nicht im Typ von value darstellbar ist, wird value unverändert gelassen, andernfalls werden die dem Muster entsprechenden Zeichen als Textdarstellung eines arithmetischen Werts interpretiert, der in value gespeichert wird.

Parameter

Rückgabewert

Bei Erfolg gibt einen Wert vom Typ std::from_chars_result zurück, sodass ptr auf das erste Zeichen zeigt, das nicht zum Muster passt, oder den Wert gleich last hat, wenn alle Zeichen übereinstimmen und ec wertinitialisiert ist.

Wenn keine Übereinstimmung mit dem Muster vorliegt, wird ein Wert vom Typ std::from_chars_result zurückgegeben, sodass ptr gleich first ist und ec gleich std::errc::invalid_argument ist. value bleibt unverändert.

Wenn das Muster übereinstimmte, aber der geparste Wert nicht im darstellbaren Bereich des Typs von value liegt, wird ein Wert vom Typ std::from_chars_result zurückgegeben, sodass ec gleich std::errc::result_out_of_range ist und ptr auf das erste Zeichen zeigt, das nicht mit dem Muster übereinstimmt. value bleibt unverändert.

Exceptions

Wirft nichts.

Hinweise

Im Gegensatz zu anderen Parsing-Funktionen in C++- und C-Bibliotheken ist std::from_chars lokaleunabhängig, nicht-allozierend und nicht-werfend. Nur eine kleine Teilmenge der Parsing-Richtlinien, die von anderen Bibliotheken verwendet werden (wie std::sscanf ), wird bereitgestellt. Dies soll die schnellstmögliche Implementierung ermöglichen, die in gängigen Hochdurchsatz-Kontexten nützlich ist, wie z.B. textbasierter Austausch ( JSON oder XML ).

Die Garantie, dass std::from_chars jeden Gleitkommawert, der von std::to_chars formatiert wurde, exakt wiederherstellen kann, gilt nur, wenn beide Funktionen aus derselben Implementierung stammen.

Ein Muster, das aus einem Zeichen ohne nachfolgende Ziffern besteht, wird als Muster behandelt, das nichts Übereinstimmendes gefunden hat.

Beispiel

#include <cassert>
#include <charconv>
#include <iomanip>
#include <iostream>
#include <optional>
#include <string_view>
#include <system_error>
int main()
{
    for (std::string_view const str : {"1234", "15 foo", "bar", " 42", "5000000000"})
    {
        std::cout << "String: " << std::quoted(str) << ". ";
        int result{};
        auto [ptr, ec] = std::from_chars(str.data(), str.data() + str.size(), result);
        if (ec == std::errc())
            std::cout << "Result: " << result << ", ptr -> " << std::quoted(ptr) << '\n';
        else if (ec == std::errc::invalid_argument)
            std::cout << "This is not a number.\n";
        else if (ec == std::errc::result_out_of_range)
            std::cout << "This number is larger than an int.\n";
    }
    // C++23's constexpr from_char demo / C++26's operator bool() demo:
    auto to_int = [](std::string_view s) -> std::optional<int>
    {
        int value{};
#if __cpp_lib_to_chars >= 202306L
        if (std::from_chars(s.data(), s.data() + s.size(), value))
#else
        if (std::from_chars(s.data(), s.data() + s.size(), value).ec == std::errc{})
#endif
            return value;
        else
            return std::nullopt;
    };
    assert(to_int("42") == 42);
    assert(to_int("foo") == std::nullopt);
#if __cpp_lib_constexpr_charconv and __cpp_lib_optional >= 202106
    static_assert(to_int("42") == 42);
    static_assert(to_int("foo") == std::nullopt);
#endif
}

String: "1234". Result: 1234, ptr -> ""
String: "15 foo". Result: 15, ptr -> " foo"
String: "bar". This is not a number.
String: " 42". This is not a number.
String: "5000000000". This number is larger than an int.

Fehlerberichte

Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

Siehe auch