SKIP_RETURN_CODE

用於將測試標記為跳過的返回碼。

有時只有測試本身才能確定是否滿足測試的所有要求。如果這種情況不應被視為嚴重失敗，則可以指定一個進程的返回碼，如果遇到該返回碼，則會將測試標記為 Not Run。有效值範圍為 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 屬性。