Code-Based test macros

CT 2025.06 supports GTest (Google Test) style test macros through the Code-Based test feature.
This page provides the types of macros available for Code-Based test, along with their descriptions and examples.

The test code editor provides auto-completion feature. Press Ctrl + Space to view the list of available macros.

Test Definition Macro

These macros define the structure and execution unit of a test function.

Example :

// 1. CTEST: Basic test case.
CTEST(Math, Addition) {
    CTEST_ASSERT_EQ(5, Add(2, 3));
}
// 2. CTEST_F: Test using a common fixture.
class CalculatorFixture : public ::ctest::Fixture {
public:
    void SetUpTest() override {
        calculator.reset();
        initial_value = 100;
    }
    void TearDownTest() override {
    }
protected:
    Calculator calculator;
    int initial_value;
};
CTEST_F(CalculatorFixture, WithInitialValue) {
    calculator.setValue(initial_value);
    CTEST_ASSERT_EQ(105, calculator.add(5));
}
// 3. CTEST_P: Parameterized test.
class EvenNumberTest : public ::ctest::TestWithParam<int> {
public:
    void SetUpTest() override {
    }
    void TearDownTest() override {
    }
};
CTEST_P(EvenNumberTest, CheckIfEven) {
    int value = GetParam();
    CTEST_EXPECT(value % 2 == 0);
}
INSTANTIATE_CTEST_SUITE_P(EvenNumbers,
                         EvenNumberTest,
                         ::ctest::Values(0, 2, 4, 6, 8));

Basic condition check macro

Checks whether a single condition is true or false.

Value comparison macro

Checks the result of comparing integers or other general values.

String comparison macro

Checks whether strings are equal, with options for case-sensitive or case-insensitive comparison.

Floating-point comparison macro

Performs an approximate comparison of floating-point values. Values are compared within a specified tolerance range due to the inherent difficulty of exact comparison.

Exception check macro

Checks whether an exception is thrown during code execution.

Log macro

Outputs log messages during test execution for debugging or informational purposes.

Mock-related macros

Use mock objects to control dependencies and verify the results of function calls.

Example :

class MockFoo : public Foo {
    CMOCK_METHOD(int, Add, (int a, int b), const override);
};
CTEST(MockTest, AddCalled) {
    MockFoo mock;
    mock.SetReturn_Add(42);
    CTEST_ASSERT_EQ(42, mock.Add(2, 3));
}