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 属性。