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

CKTIS / C++

std::bad_alloc — exceção por falha de alocação

std::bad_alloc, declarado em <new>, indica que não foi possível alocar memória. Saiba como capturá-lo por referência constante, porque what() não tem um texto fixo portável e em que difere a alocação que lança exceções de std::nothrow.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

#include <new>

try {
    // Operation that may fail to allocate storage.
} catch (const std::bad_alloc& e) {
    // Handle allocation failure.
}

// C++23 member signature:
// const char* what() const noexcept override;

std::bad_alloc, declarado em <new>, é uma classe de exceção derivada publicamente de std::exception. A implementação utiliza-a para indicar uma falha na alocação de memória. Após uma tentativa sem sucesso, o operator new padrão que lança exceções chama o new_handler instalado; se não existir nenhum, lança std::bad_alloc. Se o gestor regressar, é feita outra tentativa.

Capture a exceção como const std::bad_alloc&. O membro what() devolve uma descrição terminada em nulo e definida pela implementação, pelo que não a deve comparar com um texto fixo nos testes. Um gestor deve evitar alocações desnecessárias: a tentativa seguinte também pode falhar.

A função de alocação padrão selecionada por new (std::nothrow) T devolve nullptr em caso de falha, em vez de indicar a falha de alocação através de uma exceção. Isto não torna toda a expressão incapaz de lançar exceções: o construtor de T ainda pode lançar uma.

O exemplo executa deliberadamente throw std::bad_alloc{} em vez de tentar esgotar a memória. Testa o tratamento de exceções, não uma falha real do alocador. Esta entrada destina-se a C++23; o projeto de norma atual pode conter adições posteriores, incluindo constexpr para what(), que não devem ser pressupostas em C++23.

Exemplos

#include <cstdio>
#include <new>

int main() {
    try {
        throw std::bad_alloc{};
    } catch (const std::bad_alloc&) {
        std::puts("Allocation failure caught");
    }
}

Resultado

Allocation failure caught

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