當 File
傳遞至 Args
物件而不使用 map_each
函式時,系統會擷取其 path
欄位的值,將其轉換為字串。
成員
basename
string File.basename這個檔案的基本名稱。這是目錄中的檔案名稱。
dirname
string File.dirname包含這個檔案的目錄名稱。此範例是從 path 取得,而且一律會相對於執行目錄。
擴充功能
string File.extension這個檔案的副檔名,緊接在最右邊的 (不包含) 句號。如果檔案的 Basename 不包含半形句號,則為空白字串。
is_directory
bool File.is_directory如果這是目錄,則傳回 true。
is_source
bool File.is_source如果是來源檔案 (即未產生),則傳回 true。
擁有者
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()。存取這個欄位時,會導致系統發生錯誤。