檔案

回報問題 查看來源 Nightly

這個物件會在分析階段建立，用來代表會在執行階段讀取或寫入的檔案或目錄。這並非開放的檔案控制代碼，無法用來直接讀取或寫入檔案內容。您會將這個註解傳送至建立動作的函式，藉此在規則實作函式中建構動作圖。詳情請參閱規則頁面。

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

成員

• basename
• dirname
• 擴充功能
• is_directory
• is_source
• owner
• path
• root
• short_path
• tree_relative_path

basename

string File.basename

這個檔案的基礎名稱。這是目錄中的檔案名稱。

dirname

string File.dirname

包含這個檔案的目錄名稱。這個 ID 取自 path，且一律相對於執行目錄。

擴充功能

string File.extension

此檔案的副檔名，接在最右側點後（不含）。如果檔案的基礎名稱不含半形句號，則為空白字串。

is_directory

bool File.is_directory

如果這是目錄，則傳回 true。

is_source

bool File.is_source

如果這是來源檔案 (也就是未產生)，則傳回 true。

owner

Label File.owner

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

path

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

如果祖系的 is_directory 欄位為 true，則這個檔案的相對路徑即為祖系樹狀結構的根層級。tree_relative_path 僅適用於動作指令中目錄的展開檔案 (即 Args.add_all())。對於其他類型的檔案，存取此欄位時會發生錯誤。