SKIP_RETURN_CODE

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

有时只有测试本身可以确定是否满足测试的所有要求。如果这种情况不应被视为硬性故障，则可以指定进程的返回代码，如果遇到该代码，则会将测试标记为 未运行。有效值范围为 0 到 255，包括 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 属性。