block

新增於 3.25 版本。

評估一組具有專用變數和/或策略範圍的命令。

block([SCOPE_FOR [POLICIES] [VARIABLES] ] [PROPAGATE <var-name>...])
  <commands>
endblock()

block() 和配對的 endblock() 之間的所有命令都會被記錄下來，而不會被調用。一旦評估了 endblock()，記錄的命令列表將在請求的範圍內調用，然後移除 block() 命令建立的範圍。

SCOPE_FOR

指定必須建立哪些範圍。

POLICIES

建立新的策略範圍。這等同於 cmake_policy(PUSH)，並在離開 block 範圍時自動執行 cmake_policy(POP)。

VARIABLES

建立新的變數範圍。

如果未指定 SCOPE_FOR，則這等同於

block(SCOPE_FOR VARIABLES POLICIES)

PROPAGATE

當 block() 命令建立變數範圍時，此選項會在父範圍中設定或取消設定指定的變數。這等同於 set(PARENT_SCOPE) 或 unset(PARENT_SCOPE) 命令。

set(var1 "INIT1")
set(var2 "INIT2")

block(PROPAGATE var1 var2)
  set(var1 "VALUE1")
  unset(var2)
endblock()

# Now var1 holds VALUE1, and var2 is unset

僅當建立變數範圍時才允許此選項。在其他情況下會引發錯誤。

當 block() 在 foreach() 或 while() 命令內時，可以在 block 內使用 break() 和 continue() 命令。

while(TRUE)
  block()
     ...
     # the break() command will terminate the while() command
     break()
  endblock()
endwhile()

參見

• endblock()

• return()

• cmake_policy()