CKTIS / C++
std::length_error — Überschreitung einer zulässigen Länge
std::length_error aus <stdexcept> meldet den Versuch, ein Objekt mit einer Länge zu erzeugen, die den zulässigen Grenzwert überschreitet. Erfahre mehr über die Vererbung, die Konstruktoren für Meldungen und das Abfangen per const-Referenz.
Version: C++23; repository compiler flag, production runtime not attested
Syntax
#include <stdexcept>
// C++23 message constructor declarations inside class std::length_error:
// explicit length_error(const std::string& what_arg);
// explicit length_error(const char* what_arg);
throw std::length_error("length limit exceeded");
// Handle with: catch (const std::length_error& e)std::length_error, deklariert in <stdexcept>, ist ein Ausnahmetyp, der den Versuch meldet, ein Objekt zu erzeugen, dessen Länge die maximal zulässige Größe überschreitet. Er leitet sich öffentlich von std::logic_error und mittelbar von std::exception ab. Nicht mit std::out_of_range verwechseln: Dieser Typ meldet ein Argument außerhalb seines erwarteten Bereichs.
Die Konstruktoren akzeptieren eine Meldung als const std::string& oder const char*. Die Methode what() stellt diese Meldung bereit. Fange die Ausnahme mit const std::length_error& ab; wenn du auch Basisklassen behandelst, muss der spezifischere Handler zuerst stehen.
Das Beispiel prüft absichtlich einen eigenen Grenzwert und führt throw std::length_error aus, statt eine riesige Speicherreservierung zu erzwingen. Bei 9 > 8 gibt es die angegebene Meldung aus. Dies demonstriert das explizite Auslösen einer Ausnahme, keine automatische Größenprüfung durch die Bibliothek.
Dieser Eintrag bezieht sich auf C++23. Die bereitgestellte Quelle ist ein aktueller Standardentwurf und zeigt auch constexpr-Deklarationen, die nicht als Garantie für C++23 zu verstehen sind. Das Beispiel benötigt solche Konstruktoren nicht.
Beispiele
#include <cstddef>
#include <iostream>
#include <stdexcept>
void check_length(std::size_t requested) {
constexpr std::size_t limit = 8;
if (requested > limit) {
throw std::length_error("length limit exceeded");
}
}
int main() {
try {
check_length(9);
} catch (const std::length_error& e) {
std::cout << e.what() << '\n';
}
}
Ergebnis
length limit exceeded
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.