WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen