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