Microsoft.VisualStudio.TestTools.CppUnitTestFramework API 참조

아티클
06/19/2023

이 항목에서는 Microsoft::VisualStudio::CppUnitTestFramework 네임스페이스의 public 구성원 목록을 제공합니다. 이 API를 사용하여 Microsoft Native Unit Test Framework를 기반으로 C++ 단위 테스트를 작성합니다. 이 항목의 마지막에는 사용 예제가 있습니다.

헤더 및 lib 파일은 <Visual Studio 설치 폴더>\VC\Auxiliary\VS\UnitTest에 있습니다.

헤더 및 라이브러리 경로는 기본 테스트 프로젝트에서 자동으로 구성됩니다.

이 항목의 내용

CppUnitTest.h

테스트 클래스와 메서드 만들기
초기화 및 정리
테스트 특성 만들기

CppUnitTest.h

테스트 클래스와 메서드 만들기

TEST_CLASS(className)

테스트 메서드를 포함하는 각 클래스에 필요합니다. className을 테스트 클래스로 식별합니다. 네임스페이스 범위에서 TEST_CLASS를 선언해야 합니다.

TEST_METHOD(methodName)
{
    // test method body
}

methodName을 테스트 메서드로 정의합니다. 메서드의 클래스 범위에서 TEST_METHOD를 선언해야 합니다.

초기화 및 정리

테스트 방법

TEST_METHOD_INITIALIZE(methodName)
{
    // method initialization code
}

각 테스트 메서드를 실행하기 전에 실행되는 메서드로 methodName을 정의합니다. TEST_METHOD_INITIALIZE는 테스트 클래스에서 한 번만 정의할 수 있으며 테스트 클래스의 범위에서 정의해야 합니다.

TEST_METHOD_CLEANUP(methodName)
{
    // test method cleanup  code
}

각 테스트 메서드를 실행한 후에 실행되는 메서드로 methodName을 정의합니다. TEST_METHOD_CLEANUP는 테스트 클래스에서 한 번만 정의할 수 있으며 테스트 클래스의 범위에서 정의해야 합니다.

테스트 클래스

TEST_CLASS_INITIALIZE(methodName)
{
    // test class initialization  code
}

각 테스트 클래스를 만들기 전에 실행되는 메서드로 methodName을 정의합니다. TEST_CLASS_INITIALIZE는 테스트 클래스에서 한 번만 정의할 수 있으며 테스트 클래스의 범위에서 정의해야 합니다.

TEST_CLASS_CLEANUP(methodName)
{
    // test class cleanup  code
}

각 테스트 클래스를 만든 후에 실행되는 메서드로 methodName을 정의합니다. TEST_CLASS_CLEANUP는 테스트 클래스에서 한 번만 정의할 수 있으며 테스트 클래스의 범위에서 정의해야 합니다.

테스트 모듈

TEST_MODULE_INITIALIZE(methodName)
{
    // module initialization code
}

모듈을 로드할 때 실행되는 메서드 methodName을 정의합니다. TEST_MODULE_INITIALIZE는 테스트 모듈에서 한 번만 정의할 수 있으며 네임스페이스 범위에서 선언해야 합니다.

TEST_MODULE_CLEANUP(methodName)

모듈을 언로드할 때 실행되는 메서드 methodName을 정의합니다. TEST_MODULE_CLEANUP는 테스트 모듈에서 한 번만 정의할 수 있으며 네임스페이스 범위에서 선언해야 합니다.

테스트 특성 만들기

테스트 메서드 특성

BEGIN_TEST_METHOD_ATTRIBUTE(testMethodName)
    TEST_METHOD_ATTRIBUTE(attributeName, attributeValue)
    ...
END_TEST_METHOD_ATTRIBUTE()

하나 이상의 TEST_METHOD_ATTRIBUTE 매크로로 정의된 특성을 테스트 메서드 testMethodName에 추가합니다.

TEST_METHOD_ATTRIBUTE 매크로는 이름 attributeName 및 값 attributeValue를 사용하여 특성을 정의합니다.

테스트 클래스 특성

BEGIN_TEST_CLASS_ATTRIBUTE(testClassName)
    TEST_CLASS_ATTRIBUTE(attributeName, attributeValue)
    ...
END_TEST_CLASS_ATTRIBUTE()

하나 이상의 TEST_CLASS_ATTRIBUTE 매크로로 정의된 특성을 테스트 클래스 testClassName에 추가합니다.

TEST_CLASS_ATTRIBUTE 매크로는 이름 attributeName 및 값 attributeValue를 사용하여 특성을 정의합니다.

테스트 모듈 특성

BEGIN_TEST_MODULE_ATTRIBUTE(testModuleName)
    TEST_MODULE_ATTRIBUTE(attributeName, attributeValue)
    ...
END_TEST_MODULE_ATTRIBUTE()

하나 이상의 TEST_MODULE_ATTRIBUTE 매크로로 정의된 특성을 테스트 모듈 testModuleName에 추가합니다.

TEST_MODULE_ATTRIBUTE 매크로는 이름 attributeName 및 값 attributeValue를 사용하여 특성을 정의합니다.

미리 정의된 특성

미리 정의된 이러한 특성 매크로는 일반적인 경우에 간편하게 사용할 수 있도록 제공됩니다. 위에서 설명한 TEST_METHOD_ATTRIBUTE 매크로 대신 사용할 수 있습니다.

TEST_OWNER(ownerAlias)

이름 Owner 및 특성 값 ownerAlias를 사용하여 TEST_METHOD_ATTRIBUTE를 정의합니다.

TEST_DESCRIPTION(description)

이름 Description 및 특성 값 description을 사용하여 TEST_METHOD_ATTRIBUTE를 정의합니다.

TEST_PRIORITY(priority)

이름 Priority 및 특성 값 priority를 사용하여 TEST_METHOD_ATTRIBUTE를 정의합니다.

TEST_WORKITEM(workitem)

이름 WorkItem 및 특성 값 workItem을 사용하여 TEST_METHOD_ATTRIBUTE를 정의합니다.

TEST_IGNORE()

이름 Ignore 및 특성 값 true를 사용하여 TEST_METHOD_ATTRIBUTE를 정의합니다.

CppUnitTestAssert.h

일반 어설션

AreEqual

두 개체가 같은지 확인합니다.

template<typename T>
static void Assert::AreEqual(
    const T& expected,
    const T& actual,
    const wchar_t* message = NULL,
    const __LineInfo* pLineInfo = NULL)

두 double이 같은지 확인합니다.

static void Assert::AreEqual(
    double expected,
    double actual,
    double tolerance,
    const wchar_t* message = NULL,
    const __LineInfo* pLineInfo = NULL)

두 부동이 같은지 확인합니다.

static void Assert::AreEqual(
    float expected,
    float actual,
    float tolerance,
    const wchar_t* message = NULL,
    const __LineInfo* pLineInfo = NULL)

두 char* 문자열이 같은지 확인합니다.

static void Assert::AreEqual(
    const char* expected,
    const char* actual,
    bool ignoreCase = false,
    const wchar_t* message = NULL,
    const __LineInfo* pLineInfo = NULL)

두 w_char* 문자열이 같은지 확인합니다.

static void Assert::AreEqual(
    const wchar_t* expected,
    const wchar_t* actual,
    bool ignoreCase = false,
    const wchar_t* message = NULL,
    const __LineInfo* pLineInfo = NULL)

AreNotEqual

두 double이 같지 않은지 확인합니다.

static void Assert::AreNotEqual(
    double notExpected,
    double actual,
    double tolerance,
    const wchar_t* message = NULL,
    const __LineInfo* pLineInfo = NULL)

두 부동이 같지 않은지 확인합니다.

static void Assert::AreNotEqual(
    float notExpected,
    float actual,
    float tolerance,
    const wchar_t* message = NULL,
    const __LineInfo* pLineInfo = NULL)

두 char* 문자열이 같지 않은지 확인합니다.

static void Assert::AreNotEqual(
    const char* notExpected,
    const char* actual,
    bool ignoreCase = false,
    const wchar_t* message = NULL,
    const __LineInfo* pLineInfo = NULL)

두 w_char* 문자열이 같지 않은지 확인합니다.

static void Assert::AreNotEqual(
    const wchar_t* notExpected,
    const wchar_t* actual,
    bool ignoreCase = false,
    const wchar_t* message = NULL,
    const __LineInfo* pLineInfo = NULL)

operator==를 기준으로 하여 두 참조가 같지 않은지 확인합니다.

template<typename T>
static void Assert::AreNotEqual(
    const T& notExpected,
    const T& actual,
    const wchar_t* message = NULL,
    const __LineInfo* pLineInfo = NULL)

AreSame

두 참조가 같은 개체 인스턴스(ID)를 참조하는지 확인합니다.

template<typename T>
static void Assert::AreSame(
    const T& expected,
    const T& actual,
    const wchar_t* message = NULL,
    const __LineInfo* pLineInfo = NULL)

AreNotSame

두 참조가 같은 개체 인스턴스(ID)를 참조하지 않는지 확인합니다.

template<typename T>
static void Assert::AreNotSame (
    const T& notExpected,
    const T& actual,
    const wchar_t* message = NULL,
    const __LineInfo* pLineInfo = NULL)

IsNull

포인터가 NULL인지 확인합니다.

template<typename T>
static void Assert::IsNull(
    const T* actual,
    const wchar_t* message = NULL,
    const __LineInfo* pLineInfo = NULL)

IsNotNull

포인터가 NULL이 아닌지 확인합니다.

template<typename T>
static void Assert::IsNotNull(
    const T* actual,
    const wchar_t* message = NULL,
    const __LineInfo* pLineInfo = NULL)

IsTrue

조건이 true인지 확인합니다.

static void Assert::IsTrue(
    bool condition,
    const wchar_t* message = NULL,
    const __LineInfo* pLineInfo = NULL)

IsFalse

조건이 false인지 확인합니다.

static void Assert::IsFalse(
    bool condition,
    const wchar_t* message = NULL,
    const __LineInfo* pLineInfo = NULL)

실패

테스트 사례가 실패한 것으로 강제 지정합니다.

static void Assert::Fail(
    const wchar_t* message = NULL,
    const __LineInfo* pLineInfo = NULL)

Windows 런타임 어설션

AreEqual

두 Windows 런타임 포인터가 같은지 확인합니다.

template<typename T>
static void Assert::AreEqual(
    T^ expected,
    T^ actual,
    Platform::String^ message = nullptr,
    const __LineInfo* pLineInfo= nullptr)

두 Platform::String^ 문자열이 같은지 확인합니다.

template<typename T>
static void Assert::AreEqual(
    T^ expected,
    T^ actual,
    Platform::String^ message= nullptr,
    const __LineInfo* pLineInfo= nullptr)

AreSame

두 Windows 런타임 참조가 같은 개체를 참조하는지 확인합니다.

template<typename T>
static void Assert::AreSame(
    T% expected,
    T% actual,
    Platform::String^ message= nullptr,
    const __LineInfo* pLineInfo= nullptr)

AreNotEqual

두 Windows 런타임 포인터가 같지 않은지 확인합니다.

template<typename T>
static void Assert::AreNotEqual(
    T^ notExpected,
    T^ actual,
    Platform::String^ message = nullptr,
    const __LineInfo* pLineInfo= nullptr)

두 Platform::String^ 문자열이 같지 않은지 확인합니다.

static void Assert::AreNotEqual(
    Platform::String^ notExpected,
    Platform::String^ actual,
    bool ignoreCase = false,
    Platform::String^ message= nullptr,
    const __LineInfo* pLineInfo= nullptr)

AreNotSame

두 Windows 런타임 참조가 같은 개체를 참조하지 않는지 확인합니다.

template<typename T>
static void Assert::AreNotSame(
    T% notExpected,
    T% actual,
    Platform::String^ message= nullptr,
    const __LineInfo* pLineInfo= nullptr)

IsNull

Windows 런타임 포인터가 nullptr인지 확인합니다.

template<typename T>
static void Assert::IsNull(
    T^ actual,
    Platform::String^ message = nullptr,
    const __LineInfo* pLineInfo= nullptr)

IsNotNull

Windows 런타임 포인터가 nullptr이 아닌지 확인합니다.

template<typename T>
static void Assert::IsNotNull(
    T^ actual,
    Platform::String^ message= nullptr,
    const __LineInfo* pLineInfo= nullptr)

예외 어설션

EXPECTEXCEPTION

함수에서 예외가 발생하는지 확인합니다.

template<typename _EXPECTEDEXCEPTION, typename _FUNCTOR>
static void Assert::ExpectException(
    _FUNCTOR functor,
    const wchar_t* message= NULL,
    const __LineInfo* pLineInfo= NULL)

함수에서 예외가 발생하는지 확인합니다.

template<typename _EXPECTEDEXCEPTION, typename _RETURNTYPE>
    static void Assert::ExpectException(
    _RETURNTYPE (*func)(),
    const wchar_t* message= NULL,
    const __LineInfo* pLineInfo = NULL)

CppUnitTestLogger.h

로거

Logger 클래스는 출력 창에 작성하는 정적 메서드를 포함합니다.

메시지 작성

출력 창에 문자열 작성

static void Logger::WriteMessage(const wchar_t* message)

static void Logger::WriteMessage(const char* message)

예시

이 코드는 VSCppUnit 사용 예입니다. 여기에는 특성 메타데이터, 장치, 어셜션 포함 단위 테스트, 사용자 지정 로깅이 포함됩니다.

// USAGE EXAMPLE

#include <CppUnitTest.h>

using namespace Microsoft::VisualStudio::CppUnitTestFramework;

BEGIN_TEST_MODULE_ATTRIBUTE()
    TEST_MODULE_ATTRIBUTE(L"Date", L"2010/6/12")
END_TEST_MODULE_ATTRIBUTE()

TEST_MODULE_INITIALIZE(ModuleInitialize)
{
    Logger::WriteMessage("In Module Initialize");
}

TEST_MODULE_CLEANUP(ModuleCleanup)
{
    Logger::WriteMessage("In Module Cleanup");
}

TEST_CLASS(Class1)
{

public:

    Class1()
    {
        Logger::WriteMessage("In Class1");
    }

    ~Class1()
    {
        Logger::WriteMessage("In ~Class1");
    }

    TEST_CLASS_INITIALIZE(ClassInitialize)
    {
        Logger::WriteMessage("In Class Initialize");
    }

    TEST_CLASS_CLEANUP(ClassCleanup)
    {
        Logger::WriteMessage("In Class Cleanup");
    }

    BEGIN_TEST_METHOD_ATTRIBUTE(Method1)
        TEST_OWNER(L"OwnerName")
        TEST_PRIORITY(1)
    END_TEST_METHOD_ATTRIBUTE()

    TEST_METHOD(Method1)
    {
        Logger::WriteMessage("In Method1");
        Assert::AreEqual(0, 0);
    }

    TEST_METHOD(Method2)
    {
        Assert::Fail(L"Fail");
    }
};

Share via

Microsoft.VisualStudio.TestTools.CppUnitTestFramework API 참조

이 항목의 내용

CppUnitTest.h

테스트 클래스와 메서드 만들기

초기화 및 정리

테스트 방법

테스트 클래스

테스트 모듈

테스트 특성 만들기

테스트 메서드 특성

테스트 클래스 특성

테스트 모듈 특성

미리 정의된 특성

CppUnitTestAssert.h

일반 어설션

AreEqual

AreNotEqual

AreSame

AreNotSame

IsNull

IsNotNull

IsTrue

IsFalse

실패

Windows 런타임 어설션

AreEqual

AreSame

AreNotEqual

AreNotSame

IsNull

IsNotNull

예외 어설션

EXPECTEXCEPTION

CppUnitTestLogger.h

로거

메시지 작성

예시

참고 항목

피드백

피드백

추가 리소스