檔案
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
回報問題open_in_new
查看原始碼open_in_new
Nightly
·
8.0
·
7.5
·
7.4
·
7.3
·
7.2
這個物件是在分析階段建立,用來代表在執行階段讀取或寫入的檔案或目錄。這不是開啟的檔案句柄,無法用於直接讀取或寫入檔案內容。而是在規則實作函式中,將其傳遞至動作建立函式,以便建構動作圖表。詳情請參閱「規則」頁面。
如果 File
是透過 map_each
函式傳遞至 Args
物件,系統會將其轉換為字串,並取得其 path
欄位的值。
成員
basename
string File.basename
這個檔案的基礎名稱。這是目錄內的檔案名稱。
目錄名稱
string File.dirname
包含此檔案的目錄名稱。這個值取自
path,一律以執行目錄為基準。
擴充功能
string File.extension
這個檔案的副檔名,緊接在最右邊的句號之後 (不包含)。如果檔案的底層名稱不含句點,則為空字串。
is_directory
bool File.is_directory
如果是目錄,則傳回 true。
is_source
bool File.is_source
如果這是來源檔案,也就是並非系統產生的檔案,則傳回 true。
擁有者
Label File.owner
產生此檔案的目標標籤。可能會傳回
None
。
路徑
string File.path
相對於工作區執行目錄的此檔案執行路徑。這個值由兩個部分組成,第一個部分稱為
root (亦請參閱
root 模組),第二個部分則是
short_path
。根目錄可能為空白,這通常是針對非產生的檔案。對於產生的檔案,它通常會包含設定檔專屬的路徑片段,用於編碼目標 CPU 架構等資訊,這些資訊是在建構該檔案時使用。如果檔案位於二進位檔的執行檔中,請使用
short_path
做為檔案對應的路徑。
root
root File.root
這個檔案所在的根目錄。
short_path
string File.short_path
相對於根目錄的檔案路徑。這會排除上述的「根」
,也就是路徑的設定專屬片段。如果檔案位於二進位檔的執行檔中,這也是檔案對應的路徑。
tree_relative_path
string File.tree_relative_path
如果祖系的「is_directory」
is_directory欄位為 true,則此檔案的路徑相對於祖系樹狀結構的根目錄。
tree_relative_path
僅適用於動作指令中目錄的展開檔案,例如
Args.add_all()。如果是其他類型的檔案,則存取此欄位會發生錯誤。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-02-04 (世界標準時間)。
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2025-02-04 (世界標準時間)。"],[],[]]