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