KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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.

Bronnen