Microsoft.VisualStudio.TestTools.CppUnitTestFramework API リファレンス

[アーティクル]
06/19/2023

このトピックでは Microsoft::VisualStudio::CppUnitTestFramework の名前空間のパブリックメンバーの一覧を示します。 Microsoft ネイティブ単体テストフレームワークに基づいて C++ の単体テストを作成するには、これらの API を使います。トピックの最後には「使用例」があります。

ヘッダーと lib のファイルは <Visual Studio インストールフォルダー>\VC\Auxiliary\VS\UnitTest にあります。

ヘッダーと lib のパスは、ネイティブテストプロジェクトで自動的に構成されます。

このトピックの内容

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()

テストメソッド testMethodName に、1 つ以上の TEST_METHOD_ATTRIBUTE マクロで定義された属性を追加します。

TEST_METHOD_ATTRIBUTE マクロは名前 attributeName と値 attributeValue を持つ属性を定義します。

テストクラス属性

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

テストクラス testClassName に、TEST_CLASS_ATTRIBUTE の 1 つ以上のマクロで定義された属性を追加します。

TEST_CLASS_ATTRIBUTE マクロは名前 attributeName と値 attributeValue を持つ属性を定義します。

テストモジュール属性

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

テストモジュール testModuleName に、TEST_MODULE_ATTRIBUTE の 1 つ以上のマクロで定義された属性を追加します。

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

一般的なアサート

等しい

2 つのオブジェクトが等しいことを確認します

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

2 つの倍精度小数点数が等しいことを確認します

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

2 つの浮動小数点数が等しいことを確認します

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

2 つの char* 文字列が等しいことを確認します

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

2 つの 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)

等しくない

2 つの倍精度小数点数が等しくないことを確認します

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

2 つの浮動小数点数が等しくないことを確認します

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

2 つの char* 文字列が等しくないことを確認します

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

2 つの 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)

演算子 == に基づいて、2 つの参照が等しくないことを確認します

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

同じである

2 つの参照が同じオブジェクトインスタンス (ID) を参照していることを確認します。

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

同じではない

2 つの参照が同じオブジェクトインスタンス (ID) を参照していないことを確認します。

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

Null である

ポインターが NULL であることを確認します。

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

Null ではない

ポインターが NULL ではないことを確認します

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

True である

条件が true であることを確認します

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

False である

条件が 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 ランタイムアサート

等しい

2 つの Windows ランタイムポインターが等しいことを確認します。

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

2 つの Platform::String^ 文字列が等しいことを確認します。

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

同じである

2 つの Windows ランタイム参照が同じオブジェクトを参照していることを確認します。

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

等しくない

2 つの Windows ランタイムポインターが等しくないことを確認します。

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

2 つの Platform::String^ 文字列が等しくないことを確認します。

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

同じではない

2 つの Windows ランタイム参照が同じオブジェクトを参照していないことを確認します。

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

Null である

Windows ランタイムポインターが nullptr であることを確認します。

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

Null ではない

Windows ランタイムポインターが nullptr ではないことを確認します。

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

例外アサート

例外を想定する

関数が例外を発生させることを確認します。

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

ロガー

ロガークラスには、出力ウィンドウに書き込むための静的メソッドが含まれます。

メッセージの書き込み

出力ウィンドウに文字列を書き込む

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");
    }
};

Microsoft.VisualStudio.TestTools.CppUnitTestFramework API リファレンス

このトピックの内容

CppUnitTest.h

テスト クラスとメソッドを作成する

初期化とクリーンアップ

テスト メソッド

テスト クラス

テスト モジュール

テスト属性を作成する

テスト メソッド属性

テスト クラス属性

テスト モジュール属性

定義済みの属性

CppUnitTestAssert.h

一般的なアサート

等しい

等しくない

同じである

同じではない

Null である

Null ではない

True である

False である

失敗

Windows ランタイム アサート

等しい

同じである

等しくない

同じではない

Null である

Null ではない

例外アサート

例外を想定する

CppUnitTestLogger.h

ロガー

メッセージの書き込み

例

関連項目

フィードバック

フィードバック

その他のリソース

テストクラスとメソッドを作成する

テストメソッド

テストクラス

テストモジュール

テストメソッド属性

テストクラス属性

テストモジュール属性

Windows ランタイムアサート