<exception> 함수

  • 아티클

current_exception

현재 예외에 대한 스마트 포인터를 가져옵니다.

exception_ptr current_exception();

Return Value

현재 예외를 가리키는 exception_ptr 개체입니다.

설명

catch 블록에서 current_exception 함수를 호출합니다. 예외가 발생하고 catch 블록이 예외를 catch할 경우, current_exception 함수는 예외를 참조하는 exception_ptr 개체를 반환합니다. 그렇지 않으면 인수가 null exception_ptr 개체를 반환합니다.

current_exception 함수는 catch 문이 exception-declaration 문을 지정하는지 여부와 관계없이 발생 중인 예외를 캡처합니다.

예외를 다시 throw하지 않는 경우 catch의 끝에서 현재 예외의 소멸자가 호출되지 않습니다. 그러나 소멸자에 있는current_exception 함수를 호출하는 경우, 함수는 현재 예외를 참조하는 exception_ptr 개체를 반환합니다.

current_exception 수식에 대한 연속 호출은 현재 예외 건의 다른 복사본을 뜻하는 exception_ptr 개체를 반환합니다. 따라서 개체는 복사본에 같은 이진 값이 있더라도 다른 복사본을 참조하기 때문에 같지 않은 것으로 비교합니다.

make_exception_ptr

예외 복사본이 들어 있는 exception_ptr 개체를 생성합니다.

template <class E>
    exception_ptr make_exception_ptr(E Except);

매개 변수

제외한
복사할 예외가 있는 클래스입니다. 모든 클래스 개체를 인수로 사용할 수 있지만, 일반적으로 예외 클래스 개체를 make_exception_ptr 함수의 인수로 지정합니다.

Return Value

Except에 대한 현재 예외의 복사본을 가리키는 exception_ptr 개체입니다.

설명

make_exception_ptr 함수 호출은 C++ 예외를 throw하고 catch 블록에서 catch한 다음 current_exception 함수를 호출하여 예외를 참조하는 exception_ptr 개체를 반환하는 것과 동일합니다. make_exception_ptr 함수의 Microsoft 구현은 예외를 throw한 후 catch하는 것보다 더 효율적입니다.

애플리케이션에는 일반적으로 make_exception_ptr 함수가 필요하지 않으며 이 함수를 사용하지 않는 것이 좋습니다.

rethrow_exception

매개 변수로 전달되는 예외를 throw합니다.

void rethrow_exception(exception_ptr P);

매개 변수

P
다시 throw할 catch된 예외입니다. P가 null exception_ptr 경우 함수는 std::bad_exception throw합니다.

설명

exception_ptr 개체에서 catch된 예외를 저장한 후 기본 스레드에서 개체를 처리할 수 있습니다. 기본 스레드에서 rethrow_exception 개체와 함께 작동하는 exception_ptr 함수를 호출합니다. rethrow_exception 함수는 exception_ptr 개체에서 예외를 추출하고, 주 스레드의 컨텍스트에서 예외를 throw합니다.

get_terminate

현재 terminate_handler 함수를 가져옵니다.

terminate_handler get_terminate();

set_terminate

프로그램을 종료할 때 호출할 새 terminate_handler를 설정합니다.

terminate_handler set_terminate(terminate_handler fnew) throw();

매개 변수

fnew
종료 시 호출할 함수입니다.

Return Value

종료 시 호출에 사용된 이전 함수의 주소입니다.

설명

함수는 함수 * fnew로 새 terminate_handler 설정합니다. 따라서 fnew는 null 포인터가 아니어야 합니다. 함수는 이전 terminate 처리기의 주소를 반환합니다.

예시

// exception_set_terminate.cpp
// compile with: /EHsc
#include <exception>
#include <iostream>

using namespace std;

void termfunction()
{
    cout << "My terminate function called." << endl;
    abort();
}

int main()
{
    terminate_handler oldHandler = set_terminate(termfunction);

    // Throwing an unhandled exception would also terminate the program
    // or we could explicitly call terminate();

    //throw bad_alloc();
    terminate();
}

get_unexpected

현재 unexpected_handler 함수를 가져옵니다.

unexpected_handler get_unexpected();

rethrow_if_nested

template <class E>
    void rethrow_if_nested(const E& e);

설명

다형 클래스 형식이 아니거나 액세스할 수 없거나 모호한 경우 nested_exception 아무런 효과가 없습니다. 그렇지 않으면 동적 캐스트를 수행합니다.

set_unexpected

예기치 않은 예외가 발생할 경우를 위해 새 unexpected_handler를 설정합니다.

unexpected_handler set_unexpected(unexpected_handler fnew) throw();

매개 변수

fnew
예기치 않은 예외가 발생할 경우를 호출할 함수입니다.

Return Value

이전 unexpected_handler의 주소입니다.

설명

fnew 는 null 포인터가 아니어야 합니다.

C++ 표준의 경우 함수가 throw 목록에 없는 예외를 throw할 경우 unexpected가 호출되어야 합니다. 현재 구현은 이 기능을 지원하지 않습니다. 다음 예제에서는 unexpected를 직접 호출하고 나서 unexpected_handler를 호출합니다.

예시

// exception_set_unexpected.cpp
// compile with: /EHsc
#include <exception>
#include <iostream>

using namespace std;

void uefunction()
{
    cout << "My unhandled exception function called." << endl;
    terminate(); // this is what unexpected() calls by default
}

int main()
{
    unexpected_handler oldHandler = set_unexpected(uefunction);

    unexpected(); // library function to force calling the
                  // current unexpected handler
}

terminate

종료 처리기를 호출합니다.

void terminate();

설명

이 함수는 void 형식 함수인 terminate 처리기를 호출합니다. 프로그램에서 직접 호출하는 경우 terminate 종료 처리기는 set_terminate 호출에 의해 가장 최근에 설정된 처리기입니다. throw 식을 평가하는 동안 다른 여러 가지 이유로 호출되는 경우 terminate 종료 처리기는 throw 식을 계산한 직후에 적용됩니다.

terminate 처리기는 호출자로 반환되지 않을 수 있습니다. 프로그램 시작 시 종료 처리기는 .를 호출 abort하는 함수입니다.

예시

terminate 사용에 대한 예제는 set_unexpected를 참조하세요.

throw_with_nested

template <class T> [[noreturn]]
    void throw_with_nested(T&& t);

설명

중첩된 예외를 사용하여 예외를 throw합니다.

uncaught_exception

throw된 예외가 현재 처리 중인 경우에만 true를 반환합니다.

bool uncaught_exception();

Return Value

throw 식 평가를 완료한 후, 그리고 일치하는 처리기에서 예외 선언 초기화를 완료하거나 throw 식의 결과로 unexpected를 호출하기 전에 true를 반환합니다. 특히 uncaught_exception은 예외 해제 중에 호출되는 소멸자에서 호출된 경우 true를 반환합니다. 디바이스의 경우 uncaught_exception은 Windows Mobile 2005 플랫폼을 포함하여 Windows CE 5.00 이상 버전에서만 지원됩니다.

예시

// exception_uncaught_exception.cpp
// compile with: /EHsc
#include <exception>
#include <iostream>
#include <string>

class Test
{
public:
   Test( std::string msg ) : m_msg( msg )
   {
      std::cout << "In Test::Test(\"" << m_msg << "\")" << std::endl;
   }
   ~Test( )
   {
      std::cout << "In Test::~Test(\"" << m_msg << "\")" << std::endl
         << "        std::uncaught_exception( ) = "
         << std::uncaught_exception( )
         << std::endl;
   }
private:
    std::string m_msg;
};

// uncaught_exception will be true in the destructor
// for the object created inside the try block because
// the destructor is being called as part of the unwind.

int main( void )
   {
      Test t1( "outside try block" );
      try
      {
         Test t2( "inside try block" );
         throw 1;
      }
      catch (...) {
   }
}

In Test::Test("outside try block")
In Test::Test("inside try block")
In Test::~Test("inside try block")
        std::uncaught_exception( ) = 1
In Test::~Test("outside try block")
        std::uncaught_exception( ) = 0

unexpected

unexpected 처리기를 호출합니다.

void unexpected();

설명

C++ 표준의 경우 함수가 throw 목록에 없는 예외를 throw할 경우 unexpected가 호출되어야 합니다. 현재 구현은 이 기능을 지원하지 않습니다. 이 예제에서는 unexpected 처리기를 호출하는 unexpected를 직접 호출합니다.

이 함수는 void 형식 함수인 unexpected 처리기를 호출합니다. unexpected가 프로그램에 의해 직접 호출될 경우 set_unexpected에 대한 호출을 통해 가장 최근 설정된 unexpected 처리기가 호출됩니다.

unexpected 처리기는 호출자로 반환되지 않을 수 있습니다. 다음과 같은 경우 실행을 종료할 수 있습니다.

  • 예외 사양에 나열된 형식의 개체 또는 unexpected 처리기가 프로그램에서 직접 호출될 경우 모든 형식의 개체를 throw할 경우.

  • 형식 bad_exception의 개체를 throw할 경우.

  • 호출 종료abort 또는 exit.

프로그램 시작 시 terminate를 호출하는 함수가 unexpected 처리기입니다.

예시

unexpected 사용에 대한 예제는 set_unexpected를 참조하세요.