Exceções: obtendo e excluindo exceções

As instruções e os exemplos a seguir mostram como capturar e excluir exceções. Para obter mais informações sobre as palavras-chave try, catch e throw, consulte Melhores práticas do C++ moderno para tratamento de erros e exceções.

Os manipuladores de exceção devem excluir objetos de exceção que eles manipulam, pois a falha ao excluir a exceção causa um vazamento de memória sempre que esse código captura uma exceção.

Seu bloco catch deve excluir uma exceção quando:

  • O bloco catch gera uma nova exceção.

    É claro que você não deve excluir a exceção se lançar a mesma exceção novamente:

    catch (CException* e)
    {
       if (m_bThrowExceptionAgain)
          throw; // Do not delete e
       else
          e->Delete();
    }
    
  • A execução retorna de dentro do bloco catch.

Observação

Ao excluir um CException, use a função membro Delete para excluir a exceção. Não use a palavra-chave delete, pois ela poderá falhar se a exceção não estiver no heap.

Adicionar e excluir exceções

  1. Use a palavra-chave try para configurar um bloco try. Execute qualquer instrução de programa que possa gerar uma exceção dentro de um bloco try.

    Use a palavra-chave catch para configurar um bloco catch. Coloque o código de tratamento de exceção em um bloco catch. O código no bloco catch será executado somente se o código dentro do bloco try gerar uma exceção do tipo especificado na instrução catch.

    O esqueleto a seguir mostra como os blocos try e catch são organizados normalmente:

    try
    {
       // Execute some code that might throw an exception.
       AfxThrowUserException();
    }
    catch (CException* e)
    {
       // Handle the exception here.
       // "e" contains information about the exception.
       e->Delete();
    }
    

    Quando uma exceção é lançada, o controle passa para o primeiro bloco catch cuja declaração de exceção corresponde ao tipo da exceção. Você pode lidar seletivamente com diferentes tipos de exceções com blocos catch sequenciais, conforme listado abaixo:

    try
    {
       // Execute some code that might throw an exception.
       AfxThrowUserException();
    }
    catch (CMemoryException* e)
    {
       // Handle the out-of-memory exception here.
       e->Delete();
    }
    catch (CFileException* e)
    {
       // Handle the file exceptions here.
       e->Delete();
    }
    catch (CException* e)
    {
       // Handle all other types of exceptions here.
       e->Delete();
    }
    

Para obter mais informações, consulte Exceções: convertendo de macros de exceção MFC.

Confira também

Tratamento de exceção