CMD#28: file 文件操作命令
file(WRITE filename "message to write"... )
file(APPEND filename "message to write"... )
file(READ filename variable [LIMIT numBytes] [OFFSET offset] [HEX])
file(STRINGS filename variable [LIMIT_COUNT num]
[LIMIT_INPUT numBytes] [LIMIT_OUTPUT numBytes]
[LENGTH_MINIMUM numBytes] [LENGTH_MAXIMUM numBytes]
[NEWLINE_CONSUME] [REGEX regex]
[NO_HEX_CONVERSION])
file(GLOB variable [RELATIVE path] [globbing expressions]...)
file(GLOB_RECURSE variable [RELATIVE path]
[FOLLOW_SYMLINKS] [globbing expressions]...)
file(RENAME <oldname> <newname>)
file(REMOVE [file1 ...])
file(REMOVE_RECURSE [file1 ...])
file(MAKE_DIRECTORY [directory1 directory2 ...])
file(RELATIVE_PATH variable directory file)
file(TO_CMAKE_PATH path result)
file(TO_NATIVE_PATH path result)
file(DOWNLOAD url file [TIMEOUT timeout] [STATUS status] [LOG log]
[EXPECTED_MD5 sum] [SHOW_PROGRESS])
WRITE選項將會寫一條消息到名為filename的文件中。如果文件已經存在，該命令會覆蓋已有的文件；如果文件不存在，它將創建該文件。
APPEND選項和WRITE選項一樣，將會寫一條消息到名為filename的文件中，只是該消息會附加到文件末尾。
READ選項將會讀一個文件中的內容並將其存儲在變量里。讀文件的位置從offset開始，最多讀numBytes個字節。如果指定了HEX參數，二進制代碼將會轉換為十六進制表達方式，並存儲在變量里。
STRINGS將會從一個文件中將一個ASCII字符串的list解析出來，然后存儲在variable變量中。文件中的二進制數據會被忽略。回車換行符會被忽略。它也可以用在Intel的Hex和Motorola的S-記錄文件；讀取它們時，它們會被自動轉換為二進制格式。可以使用NO_HEX_CONVERSION選項禁止這項功能。LIMIT_COUNT選項設定了返回的字符串的最大數量。LIMIT_INPUT設置了從輸入文件中讀取的最大字節數。LIMIT_OUTPUT設置了在輸出變量中存儲的最大字節數。LENGTH_MINIMUM設置了要返回的字符串的最小長度；小於該長度的字符串會被忽略。LENGTH_MAXIMUM設置了返回字符串的最大長度；更長的字符串會被分割成不長於最大長度的字符串。NEWLINE_CONSUME選項允許新行被包含到字符串中，而不是終止它們。REGEX選項指定了一個待返回的字符串必須滿足的正則表達式。典型的使用方式是：
file(STRINGS myfile.txt myfile)
該命令在變量myfile中存儲了一個list，該list中每個項是輸入文件中的一行文本。
GLOB選項將會為所有匹配查詢表達式的文件生成一個文件list，並將該list存儲進變量variable里。文件名查詢表達式與正則表達式類似，只不過更加簡單。如果為一個表達式指定了RELATIVE標志，返回的結果將會是相對於給定路徑的相對路徑。文件名查詢表達式的例子有：
*.cxx - 匹配所有擴展名為cxx的文件。
*.vt? - 匹配所有擴展名是vta,...,vtz的文件。
f[3-5].txt - 匹配文件f3.txt, f4.txt, f5.txt。
GLOB_RECURSE選項將會生成一個類似於通常的GLOB選項的list，只是它會尋訪所有那些匹配目錄的子路徑並同時匹配查詢表達式的文件。作為符號鏈接的子路徑只有在給定FOLLOW_SYMLINKS選項或者cmake策略CMP0009被設置為NEW時，才會被尋訪到。參見cmake --help-policy CMP0009 查詢跟多有用的信息。
使用遞歸查詢的例子有：
/dir/*.py - 匹配所有在/dir及其子目錄下的python文件。
MAKE_DIRECTORY選項將會創建指定的目錄，如果它們的父目錄不存在時，同樣也會創建。（類似於mkdir命令——譯注）
RENAME選項對同一個文件系統下的一個文件或目錄重命名。（類似於mv命令——譯注）
REMOVE選項將會刪除指定的文件，包括在子路徑下的文件。（類似於rm命令——譯注）
REMOVE_RECURSE選項會刪除給定的文件以及目錄，包括非空目錄。（類似於rm -r 命令——譯注）
RELATIVE_PATH選項會確定從direcroty參數到指定文件的相對路徑。
TO_CMAKE_PATH選項會把path轉換為一個以unix的 / 開頭的cmake風格的路徑。輸入可以是一個單一的路徑，也可以是一個系統路徑，比如"$ENV{PATH}"。注意，在調用TO_CMAKE_PATH的ENV周圍的雙引號只能有一個參數(Note the double quotes around the ENV call TO_CMAKE_PATH only takes one argument. 原文如此。quotes和后面的takes讓人后糾結，這句話翻譯可能有誤。歡迎指正——譯注)。
TO_NATIVE_PATH選項與TO_CMAKE_PATH選項很相似，但是它會把cmake風格的路徑轉換為本地路徑風格：windows下用\，而unix下用/。
DOWNLOAD 將給定的URL下載到指定的文件中。如果指定了LOG var選項，下載日志將會被輸出到var中。如果指定了STATUS var選項，下載操作的狀態會被輸出到var中。該狀態返回值是一個長度為2的list。list的第一個元素是操作的數字返回值，第二個返回值是錯誤的字符串值。錯誤信息如果是數字0，操作中沒有發生錯誤。如果指定了TIMEOUT time選項，在time秒之后，操作會超時退出；time應該是整數。如果指定了EXPECTED_MD5 sum選項，下載操作會認證下載的文件的實際MD5和是否與期望值匹配。如果不匹配，操作將返回一個錯誤。如果指定了SHOW_PROGRESS選項，進度信息會以狀態信息的形式被打印出來，直到操作完成。
file命令還提供了COPY和INSTALL兩種格式：
file(<COPY|INSTALL> files... DESTINATION <dir>
[FILE_PERMISSIONS permissions...]
[DIRECTORY_PERMISSIONS permissions...]
[NO_SOURCE_PERMISSIONS] [USE_SOURCE_PERMISSIONS]
[FILES_MATCHING]
[[PATTERN <pattern> | REGEX <regex>]
[EXCLUDE] [PERMISSIONS permissions...]] [...])
COPY版本把文件、目錄以及符號連接拷貝到一個目標文件夾。相對輸入路徑的評估是基於當前的源代碼目錄進行的，相對目標路徑的評估是基於當前的構建目錄進行的。復制過程將保留輸入文件的時間戳；並且如果目標路徑處存在同名同時間戳的文件，復制命令會把它優化掉。賦值過程將保留輸入文件的訪問權限，除非顯式指定權限或指定NO_SOURCE_PERMISSIONS選項（默認是USE_SOURCE_PERMISSIONS）。參見install(DIRECTORY)命令中關於權限（permissions），PATTERN，REGEX和EXCLUDE選項的文檔。
INSTALL版本與COPY版本只有十分微小的差別：它會打印狀態信息，並且默認使用NO_SOURCE_PERMISSIONS選項。install命令生成的安裝腳本使用這個版本（它會使用一些沒有在文檔中涉及的內部使用的選項。）