將 File
傳遞至 Args
物件時,如未使用 map_each
函式,系統會擷取 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())。對於其他類型的檔案,存取此欄位時會發生錯誤。