CKTIS / C++
std::length_error — een toegestane lengte overschrijden
std::length_error, gedeclareerd in <stdexcept>, meldt een poging om een object te maken waarvan de lengte de toegestane limiet overschrijdt. Lees meer over de overerving, de berichtconstructors en het afhandelen via een const-referentie.
Versie: 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, gedeclareerd in <stdexcept>, is een uitzonderingstype dat meldt dat geprobeerd wordt een object te maken waarvan de lengte de maximaal toegestane grootte overschrijdt. Het is publiek afgeleid van std::logic_error en indirect van std::exception. Verwar het niet met std::out_of_range, dat een argument buiten het verwachte bereik meldt.
De constructors accepteren een bericht als const std::string& of const char*. De methode what() geeft dat bericht beschikbaar. Vang de uitzondering op via const std::length_error&; als je ook basisklassen afhandelt, plaats dan de specifiekere handler eerst.
Het voorbeeld controleert bewust een eigen limiet en voert throw std::length_error uit, in plaats van een enorme allocatie af te dwingen. Bij 9 > 8 drukt het de opgegeven melding af. Dit demonstreert het expliciet gooien van een uitzondering, niet een automatische groottecontrole door de bibliotheek.
Dit artikel richt zich op C++23. De opgegeven bron is een actuele standaarddraft en toont ook constexpr-declaraties, die niet als garantie voor C++23 mogen worden beschouwd. Het voorbeeld heeft zulke constructors niet nodig.
Voorbeelden
#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';
}
}
Resultaat
length limit exceeded
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.