CKTIS / C++
std::length_error — superamento di una lunghezza consentita
std::length_error, dichiarato in <stdexcept>, segnala il tentativo di produrre un oggetto la cui lunghezza supera il limite consentito. Scopri la sua gerarchia, i costruttori che accettano un messaggio e come gestirlo tramite un riferimento const.
Versione: C++23; repository compiler flag, production runtime not attested
Sintassi
#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, dichiarato in <stdexcept>, è un tipo di eccezione che segnala il tentativo di produrre un oggetto la cui lunghezza supera la dimensione massima consentita. Deriva pubblicamente da std::logic_error e indirettamente da std::exception. Non confonderlo con std::out_of_range, che segnala un argomento al di fuori dell’intervallo previsto.
I suoi costruttori accettano un messaggio come const std::string& oppure const char*. Il metodo what() rende disponibile il messaggio. Intercetta l’eccezione tramite const std::length_error&; se gestisci anche le classi base, inserisci prima il gestore più specifico.
L’esempio verifica intenzionalmente un limite personalizzato ed esegue throw std::length_error, invece di forzare un’allocazione enorme. Con 9 > 8, stampa il messaggio fornito. Dimostra il lancio esplicito di un’eccezione, non un controllo automatico della dimensione da parte della libreria.
Questa voce si riferisce a C++23. La fonte fornita è una bozza aggiornata dello standard e mostra anche dichiarazioni constexpr, che non vanno considerate una garanzia per C++23. L’esempio non richiede costruttori di questo tipo.
Esempi
#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';
}
}
Risultato
length limit exceeded
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.