Objek ini dibuat selama fase analisis untuk merepresentasikan file atau direktori yang akan dibaca atau ditulis selama fase eksekusi. Ini bukan handle file terbuka, dan tidak dapat digunakan untuk langsung membaca atau menulis konten file. Sebagai gantinya, Anda menggunakannya untuk membuat grafik tindakan dalam fungsi penerapan aturan dengan meneruskannya ke fungsi pembuatan tindakan. Lihat halaman Aturan untuk mengetahui informasi selengkapnya.
Saat File
diteruskan ke objek Args
tanpa menggunakan fungsi map_each
, File
akan dikonversi menjadi string dengan mengambil nilai kolom path
-nya.
Anggota
basename
string File.basenameNama dasar file ini. Ini adalah nama file di dalam direktori.
dirname
string File.dirnameNama direktori yang berisi file ini. Ini diambil dari path dan selalu relatif terhadap direktori eksekusi.
ekstensi
string File.extensionEkstensi file untuk file ini, mengikuti (tidak termasuk) titik paling kanan. String kosong jika nama dasar file tidak menyertakan titik.
is_directory
bool File.is_directoryMenampilkan true (benar) jika ini adalah direktori.
is_source
bool File.is_sourceMenampilkan true jika ini adalah file sumber, yaitu tidak dibuat.
pemilik
Label File.ownerLabel target yang menghasilkan File ini. Mungkin menampilkan
None
.
jalur
string File.pathJalur eksekusi file ini, relatif terhadap direktori eksekusi ruang kerja. Modul ini terdiri dari dua bagian, bagian pertama opsional yang disebut root (lihat juga modul root), dan bagian kedua yang merupakan
short_path
. Root mungkin kosong, yang biasanya untuk file yang tidak dibuat. Untuk file yang dihasilkan, biasanya berisi fragmen jalur khusus konfigurasi yang mengenkode hal-hal seperti arsitektur CPU target yang digunakan saat mem-build file tersebut. Gunakan short_path
untuk jalur tempat file dipetakan jika file tersebut berada dalam runfile biner.
root
root File.rootRoot tempat file ini berada.
short_path
string File.short_pathJalur file ini relatif terhadap root-nya. Hal ini mengecualikan root yang disebutkan di atas, yaitu fragmen jalur khusus konfigurasi. Ini juga merupakan jalur tempat file dipetakan jika berada dalam runfile biner.
tree_relative_path
string File.tree_relative_pathJalur file ini relatif terhadap root hierarki ancestor, jika kolom is_directory ancestor bernilai benar.
tree_relative_path
hanya tersedia untuk file yang diperluas dari direktori dalam perintah tindakan, yaitu Args.add_all(). Untuk jenis file lainnya, akses ke kolom ini akan menghasilkan error.