Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes