這個物件是在分析階段建立,用來代表在執行階段讀取或寫入的檔案或目錄。這不是開啟的檔案句柄,無法用於直接讀取或寫入檔案內容。而是將其傳遞至動作建立函式,以便在規則實作函式中建構動作圖表。詳情請參閱規則頁面。
如果 File
是透過 map_each
函式傳遞至 Args
物件,系統會將其轉換為字串,並取得其 path
欄位的值。
成員
- basename
- dirname
- 擴充功能
- is_directory
- is_source
- is_symlink
- owner
- path
- root
- short_path
- tree_relative_path
basename
string File.basename
目錄名稱
string File.dirname
擴充功能
string File.extension
is_directory
bool File.is_directory
is_source
bool File.is_source
is_symlink
bool File.is_symlink
擁有者
Label File.owner
None
。
路徑
string File.path
short_path
。根目錄可能為空白,這通常是針對非產生的檔案。對於產生的檔案,它通常會包含設定檔專屬的路徑片段,用於編碼建構該檔案時使用的目標 CPU 架構等內容。如果檔案位於二進位檔的執行檔中,請使用 short_path
做為檔案對應的路徑。root
root File.root
short_path
string File.short_path
tree_relative_path
string File.tree_relative_path
tree_relative_path
僅適用於動作指令中目錄的展開檔案,例如 Args.add_all()。如果是其他類型的檔案,則存取此欄位會發生錯誤。