Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::length_error — překročení povolené délky

std::length_error, deklarovaný v <stdexcept>, oznamuje pokus vytvořit objekt, jehož délka překračuje povolený limit. Seznamte se s jeho děděním, konstruktory přijímajícími zprávu a zachycením pomocí reference const.

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

Syntaxe

#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, deklarovaný v <stdexcept>, je typ výjimky, který oznamuje pokus vytvořit objekt, jehož délka překračuje maximální povolenou velikost. Veřejně dědí z std::logic_error a nepřímo z std::exception. Nezaměňujte jej za std::out_of_range, který oznamuje argument mimo očekávaný rozsah.

Jeho konstruktory přijímají zprávu jako const std::string& nebo const char*. Metoda what() tuto zprávu zpřístupňuje. Výjimku zachyťte pomocí const std::length_error&; pokud obsluhujete také základní třídy, umístěte konkrétnější obslužnou větev jako první.

Příklad záměrně kontroluje vlastní limit a provede throw std::length_error místo vynucení obrovské alokace. Pro 9 > 8 vypíše zadanou zprávu. Jde o ukázku explicitního vyvolání výjimky, nikoli automatické kontroly velikosti knihovnou.

Tento záznam se vztahuje k C++23. Dodaný zdroj je aktuální návrh standardu a uvádí také deklarace constexpr, které nelze považovat za záruku pro C++23. Příklad takové konstruktory nepotřebuje.

Příklady

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

Výsledek

length limit exceeded

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje