CKTIS / C++
std::length_error — ultrapassagem de um comprimento permitido
std::length_error, declarado em <stdexcept>, assinala uma tentativa de produzir um objeto cujo comprimento ultrapassa o limite permitido. Saiba mais sobre a sua herança, os construtores de mensagens e o seu tratamento através de uma referência const.
Versão: C++23; repository compiler flag, production runtime not attested
Sintaxe
#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, declarado em <stdexcept>, é um tipo de exceção que assinala uma tentativa de produzir um objeto cujo comprimento ultrapassa o tamanho máximo permitido. Deriva publicamente de std::logic_error e, indiretamente, de std::exception. Não o confunda com std::out_of_range, que assinala um argumento fora do intervalo esperado.
Os seus construtores aceitam uma mensagem como const std::string& ou const char*. O método what() disponibiliza essa mensagem. Capture a exceção através de const std::length_error&; se também tratar classes-base, coloque primeiro o handler mais específico.
O exemplo verifica deliberadamente um limite personalizado e executa throw std::length_error, em vez de forçar uma alocação enorme. Como 9 > 8, imprime a mensagem fornecida. Isto demonstra o lançamento explícito de uma exceção, não uma verificação automática do tamanho pela biblioteca.
Esta entrada destina-se a C++23. A fonte fornecida é um projeto de norma em evolução e também apresenta declarações constexpr, que não devem ser consideradas uma garantia de C++23. O exemplo não necessita desses construtores.
Exemplos
#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';
}
}
Resultado
length limit exceeded
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.