CMake ポリシー CMP0007 とは？ 空要素の扱いと設定方法

CMakeポリシー CMP0007 は、CMakeLists.txt ファイルにおける空要素の扱いに関する互換性維持のためのポリシーです。このポリシーは CMake 2.4 で導入されました。

旧挙動 (OLD)

CMake 2.4 以前では、; で区切られたリストにおいて、空要素は無視されていました。例えば、以下のリストは長さ 3 となります。

a;b;;c

新挙動 (NEW)

CMake 3.0 以降では、空要素もリスト要素としてカウントされます。そのため、上記のリストは長さ 4 となります。

影響を受けるコード

以下のコードは、CMake 2.4 以前と CMake 3.0 以降で異なる挙動を示します。

set(list "a;b;;c")
list(LENGTH list length)
message("リストの長さは ${length} です")

• CMake 2.4 以前: length は 3 となります。

ポリシーの使用方法

CMP0007 ポリシーは、以下の方法で設定できます。

個別に設定

cmake_policy(SET CMP0007 OLD)

上記のコマンドは、CMP0007 ポリシーを旧挙動に設定します。

CMake バージョンで指定

cmake_policy(VERSION 3.0)

上記のコマンドは、CMake 3.0 までのすべてのポリシーを新挙動に設定します。

推奨事項

CMake 3.0 以降を使用している場合は、CMP0007 ポリシーを新挙動に設定することを推奨します。

補足

• CMakeLists.txt ファイルで空要素を意図的に使用している場合は、CMP0007 ポリシーを旧挙動に設定する必要があります。
• CMP0007 ポリシーは、CMake のバージョンによってデフォルトの挙動が異なります。詳細は、CMake ドキュメントを参照してください。

CMake ポリシー CMP0007 サンプルコード

cmake_minimum_required(VERSION 3.0)

set(list "a;b;;c")
list(LENGTH list length)
message("リストの長さは ${length} です")

出力

リストの長さは 4 です

解説

このサンプルコードは、CMake 3.0 以降で動作します。list 変数には 4 つの要素が格納されます。

cmake_minimum_required(VERSION 2.8)

set(list "a;b;;c")
list(LENGTH list length)
message("リストの長さは ${length} です")

出力

リストの長さは 3 です

解説

このサンプルコードは、CMake 2.8 で動作します。list 変数には 3 つの要素が格納されます。

cmake_minimum_required(VERSION 3.0)

cmake_policy(SET CMP0007 OLD)

set(list "a;b;;c")
list(LENGTH list length)
message("リストの長さは ${length} です")

出力

リストの長さは 3 です

解説

このサンプルコードは、CMake 3.0 以降で動作します。CMP0007 ポリシーを旧挙動に設定しているので、list 変数には 3 つの要素が格納されます。

cmake_minimum_required(VERSION 3.0)

# 空要素を削除

list(REMOVE_ITEM list "")

list(LENGTH list length)
message("リストの長さは ${length} です")

出力

リストの長さは 3 です

解説

このサンプルコードは、CMake 3.0 以降で動作します。list 変数から空要素を削除してから長さを取得しているので、length は 3 となります。

CMP0007 ポリシーは、CMakeLists.txt ファイルにおける空要素の扱いに関する互換性維持のためのポリシーです。CMake 3.0 以降を使用している場合は、CMP0007 ポリシーを新挙動に設定することを推奨します。

CMakeLists.txt ファイルにおける空要素の扱い

空要素を無視する

set(list "a;b;;c")

# 空要素を無視して処理
foreach(item IN LISTS list)
  message(${item})
endforeach()

出力

a
b
c

空要素を削除する

set(list "a;b;;c")

# 空要素を削除
list(REMOVE_ITEM list "")

foreach(item IN LISTS list)
  message(${item})
endforeach()

出力

a
b
c

空要素を別の文字列に置き換える

set(list "a;b;;c")

# 空要素を "-" に置き換える
list(FOREACH item IN LISTS list
  IF(item STREQUAL "")
    set(item "-")
  ENDIF()
ENDFOREACH())

foreach(item IN LISTS list)
  message(${item})
endforeach()

出力

a
b
-
c

空要素を要素として扱う

set(list "a;b;;c")

# 空要素を要素として扱う
cmake_policy(SET CMP0007 NEW)

foreach(item IN LISTS list)
  message(${item})
endforeach()

出力

a
b
;
c

• 空要素を無視したい場合は、1. の方法を使用します。
• 空要素を別の文字列に置き換えた