將 File
傳遞至 Args
物件時,如果不使用 map_each
函式,系統會將其 path
欄位的值轉換為字串。
成員
基本名稱
string File.basename這個檔案的基本資訊名稱。這會是目錄中的檔案名稱。
目錄名稱
string File.dirname包含這個檔案的目錄名稱。系統會從路徑取得,並且一律與執行目錄相對。
擴充功能
string File.extension這個檔案的副檔名,但後面加上 (且不包含) 最長的時間範圍。如果檔案的基準名稱不含半形句號,則留空。
目錄
bool File.is_directory如果這是目錄,則傳回「是」。
來源
bool File.is_source如果是來源檔案,即未產生,則傳回「是」。
擁有者
Label File.owner產生這個檔案的目標標籤。 可能傳回
None
。路徑
string File.path此檔案的執行路徑相對於工作區的執行目錄。這個過程由兩個部分組成,第一個選用部分稱為根層級 (另請參閱根模組),另一部分則是
short_path
。根目錄可能會是空的,通常用於非產生的檔案。針對產生的檔案,通常會包含設定專用的路徑片段,用於編碼建構建構檔案時使用的目標 CPU 架構等項目。如果檔案位於二進位檔的執行檔案中,請為檔案對應的路徑使用 short_path
。root
root File.root這個檔案所在的根目錄。
簡短路徑
string File.short_path此檔案的路徑與其根目錄。上述範圍不含上述的根,即路徑的路徑專屬片段。如果檔案位於二進位檔的執行檔案中,此檔案也會對應至這個路徑。
樹狀結構相對路徑
string File.tree_relative_path這個檔案的路徑與祖系樹狀結構的根層級 (如果祖系的 is_directory 欄位為 true)。
tree_relative_path
僅適用於動作指令所含的擴充檔案,例如 Args.add_all()。如果是其他類型的檔案,存取這個欄位會發生錯誤。