CKTIS / C++
std::errc — portable Fehlerbedingungen
std::errc ist eine enum-Klasse aus <system_error>. Sie unterscheidet benannte Fehlerbedingungen, darunter invalid_argument und result_out_of_range. Bei std::from_chars sollten Sie sowohl ec als auch ptr prüfen, wenn die gesamte Eingabe verarbeitet werden muss.
Version: C++23; repository compiler flag, production runtime not attested
Syntax
#include <system_error>
std::errc status{};
status = std::errc::invalid_argument;
status = std::errc::result_out_of_range;std::errc ist eine enum-Klasse, die in <system_error> deklariert ist. Ihre benannten Werte beschreiben portable Fehlerbedingungen. std::errc::invalid_argument entspricht EINVAL, und std::errc::result_out_of_range entspricht ERANGE. Vergleichen Sie die Namen, statt numerische Werte fest zu codieren. Die Zuweisung eines dieser Werte löst für sich genommen keine Ausnahme aus.
Die genaue Bedeutung hängt von der Funktion ab. Bei std::from_chars aus <charconv> bedeutet std::errc::invalid_argument, dass keine Zeichen dem Zahlenmuster entsprachen. std::errc::result_out_of_range bedeutet, dass die erkannte Zahl im Zieltyp nicht darstellbar ist. In beiden Fällen bleibt die Zielvariable unverändert.
Bei einer erfolgreichen Konvertierung wird ec auf std::errc{} gesetzt. Das garantiert jedoch nicht, dass die gesamte Eingabe verarbeitet wurde: Bei "42x" wird die Zahl gelesen und ptr zeigt auf x. Eine vollständige Konvertierung erfordert sowohl result.ec == std::errc{} als auch result.ptr == end. Das Beispiel erzeugt eine Eingabe außerhalb des Wertebereichs, indem es an den Dezimalwert des Maximums des Typs eine 0 anhängt, ohne eine bestimmte Breite von unsigned int vorauszusetzen.
Beispiele
#include <charconv>
#include <iostream>
#include <limits>
#include <string>
#include <system_error>
int main() {
const std::string inputs[] = {
"42",
"abc",
std::to_string(std::numeric_limits<unsigned int>::max()) + "0",
"42x"
};
for (const auto& text : inputs) {
unsigned int value = 7;
const char* end = text.data() + text.size();
const auto result = std::from_chars(text.data(), end, value);
if (result.ec == std::errc::invalid_argument) {
std::cout << "invalid_argument";
} else if (result.ec == std::errc::result_out_of_range) {
std::cout << "result_out_of_range";
} else if (result.ec == std::errc{} && result.ptr == end) {
std::cout << "complete";
} else {
std::cout << "partial";
}
std::cout << " value=" << value << '\n';
}
}
Ergebnis
complete value=42 invalid_argument value=7 result_out_of_range value=7 partial value=42
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.