檔案

回報問題 查看來源

系統會在分析階段建立這個物件，來代表要在執行階段中讀取或寫入的檔案或目錄。這並非開啟的檔案帳號，也無法直接讀取或寫入檔案內容。而是將規則圖表傳遞至動作建立函式，藉此在規則實作函式中建構動作圖表。詳情請參閱規則頁面。

將 File 傳遞至 Args 物件時，如果不使用 map_each 函式，系統會將其 path 欄位的值轉換為字串。

成員

• basename
• dirname
• 擴充功能
• is_directory
• is_source
• 擁有者
• 路徑
• 根
• short_path
• tree_ative_path

基本名稱

string File.basename

這個檔案的基本資訊名稱。這會是目錄中的檔案名稱。

目錄名稱

string File.dirname

包含這個檔案的目錄名稱。系統會從路徑取得，並且一律與執行目錄相對。

擴充功能

string File.extension

這個檔案的副檔名，但後面加上 (且不包含) 最長的時間範圍。如果檔案的基準名稱不含半形句號，則留空。

目錄

bool File.is_directory

如果這是目錄，則傳回「是」。

來源

bool File.is_source

如果是來源檔案，即未產生，則傳回「是」。

擁有者

Label File.owner

產生這個檔案的目標標籤。 可能傳回 None。

路徑

string File.path

此檔案的執行路徑相對於工作區的執行目錄。這個過程由兩個部分組成，第一個選用部分稱為根層級 (另請參閱根模組)，另一部分則是 short_path。根目錄可能會是空的，通常用於非產生的檔案。針對產生的檔案，通常會包含設定專用的路徑片段，用於編碼建構建構檔案時使用的目標 CPU 架構等項目。如果檔案位於二進位檔的執行檔案中，請為檔案對應的路徑使用 short_path。

root

root File.root

這個檔案所在的根目錄。

簡短路徑

string File.short_path

此檔案的路徑與其根目錄。上述範圍不含上述的根，即路徑的路徑專屬片段。如果檔案位於二進位檔的執行檔案中，此檔案也會對應至這個路徑。

樹狀結構相對路徑

string File.tree_relative_path

這個檔案的路徑與祖系樹狀結構的根層級 (如果祖系的 is_directory 欄位為 true)。tree_relative_path 僅適用於動作指令所含的擴充檔案，例如 Args.add_all()。如果是其他類型的檔案，存取這個欄位會發生錯誤。