CKTIS / C++
std::length_error — prekročenie povolenej dĺžky
std::length_error, deklarovaný v <stdexcept>, oznamuje pokus vytvoriť objekt, ktorého dĺžka prekračuje povolený limit. Zistite viac o jeho dedení, konštruktoroch prijímajúcich správu a zachytení pomocou referencie const.
Verzia: 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, deklarovaný v <stdexcept>, je typ výnimky, ktorý oznamuje pokus vytvoriť objekt, ktorého dĺžka prekračuje maximálnu povolenú veľkosť. Verejne dedí z std::logic_error a nepriamo z std::exception. Nezamieňajte si ho s std::out_of_range, ktorý oznamuje argument mimo očakávaného rozsahu.
Jeho konštruktory prijímajú správu ako const std::string& alebo const char*. Metóda what() túto správu sprístupňuje. Výnimku zachyťte pomocou const std::length_error&; ak obsluhujete aj základné triedy, umiestnite konkrétnejšiu obslužnú vetvu ako prvú.
Príklad zámerne kontroluje vlastný limit a vykoná throw std::length_error namiesto vynútenia obrovskej alokácie. Pri 9 > 8 vypíše zadanú správu. Ide o ukážku explicitného vyvolania výnimky, nie automatickej kontroly veľkosti knižnicou.
Tento záznam sa vzťahuje na C++23. Dodaný zdroj je aktuálny návrh štandardu a uvádza aj deklarácie constexpr, ktoré nemožno považovať za záruku pre C++23. Príklad takéto konštruktory nepotrebuje.
Prí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ýsledok
length limit exceeded
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.