Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::length_error — przekroczenie dopuszczalnej długości

std::length_error z nagłówka <stdexcept> zgłasza próbę utworzenia obiektu o długości przekraczającej dopuszczalny limit. Poznaj jego dziedziczenie, konstruktory komunikatu oraz obsługę przez stałą referencję.

Wersja: C++23; repository compiler flag, production runtime not attested

Składnia

#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, zadeklarowany w <stdexcept>, jest typem wyjątku sygnalizującym próbę utworzenia obiektu o długości przekraczającej maksymalny dopuszczalny rozmiar. Dziedziczy publicznie po std::logic_error, a pośrednio po std::exception. Nie należy mylić go z std::out_of_range, który zgłasza argument spoza oczekiwanego zakresu.

Konstruktory przyjmują komunikat jako const std::string& lub const char*. Metoda what() udostępnia ten komunikat. Przechwytuj wyjątek przez const std::length_error&; jeśli dodajesz także obsługę klas bazowych, umieść bardziej szczegółowy handler wcześniej.

Przykład celowo sprawdza własny limit i wykonuje throw std::length_error, zamiast wymuszać ogromną alokację. Dla 9 > 8 wypisuje podany komunikat. To demonstracja jawnego zgłaszania wyjątku, nie automatycznej kontroli rozmiaru przez bibliotekę.

Zakres wpisu to C++23. Podane źródło jest aktualizowanym szkicem standardu i pokazuje również deklaracje constexpr, których nie należy traktować jako gwarancji dla C++23. Przykład nie wymaga takich konstruktorów.

Przykłady

#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';
    }
}

Wynik

length limit exceeded

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła