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.