SKIP_RETURN_CODE

将测试标记为跳过的返回代码。

有时只有测试本身才能确定测试的所有要求是否都已满足。如果这种情况不应被视为硬性失败，则可以指定一个进程的返回代码，在遇到该代码时会将测试标记为未运行。有效值为 0 到 255（含）。

超过 TIMEOUT 指定的超时的测试，无论 SKIP_RETURN_CODE 如何，仍然会失败。系统级测试失败（包括段错误、信号中止或堆错误）即使返回代码匹配也可能导致测试失败。

# cmake (1) defines this to return code 1
add_test(NAME r1 COMMAND ${CMAKE_COMMAND} -E false)

set_tests_properties(r1 PROPERTIES SKIP_RETURN_CODE 1)

要运行一个可能发生系统级故障但仍会根据 SKIP_RETURN_CODE 进行跳过的测试，请使用 CMake 命令包装可执行文件运行。请注意，这将阻止自动处理 CROSSCOMPILING_EMULATOR 和 TEST_LAUNCHER 目标属性。

add_executable(main main.c)

# cmake -E env <command> returns 1 if the command fails in any way
add_test(NAME sigabrt COMMAND ${CMAKE_COMMAND} -E env $<TARGET_FILE:main>)

set_property(TEST sigabrt PROPERTY SKIP_RETURN_CODE 1)

#include <signal.h>

int main(void){ raise(SIGABRT); return 0; }

要处理多种可能需要跳过的场景，请考虑 SKIP_REGULAR_EXPRESSION 属性。