Objek ini dibuat selama fase analisis untuk mewakili file atau direktori yang akan dibaca atau ditulis selama fase eksekusi. Objek ini bukan handle file terbuka, dan tidak dapat digunakan untuk membaca atau menulis konten file secara langsung. 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 tersebut akan dikonversi menjadi string dengan mengambil nilai kolom path.
Anggota
basename
string File.basename
Nama dasar file ini. Ini adalah nama file di dalam direktori.
dirname
string File.dirname
Nama direktori yang berisi file ini. Nama ini diambil dari
jalur dan selalu relatif terhadap direktori eksekusi.
extension
string File.extension
Ekstensi file ini, mengikuti (tidak termasuk) titik paling kanan. String kosong jika nama dasar file tidak menyertakan titik.
is_directory
bool File.is_directory
Menampilkan nilai benar jika ini adalah direktori.
is_source
bool File.is_source
Menampilkan nilai benar jika ini adalah file sumber, yaitu tidak dibuat.
owner
Label File.owner
Label target yang menghasilkan File ini.
Dapat menampilkan
None.
path
string File.path
Jalur eksekusi file ini, relatif terhadap direktori eksekusi ruang kerja. Jalur ini terdiri dari dua bagian, bagian pertama opsional yang disebut
root (lihat juga modul
root), dan bagian kedua yang merupakan
short_path. Root dapat kosong, yang biasanya untuk file yang tidak dibuat. Untuk file yang dibuat, biasanya berisi fragmen jalur khusus konfigurasi yang mengenkode hal-hal seperti arsitektur CPU target yang digunakan saat membuat file tersebut. Gunakan
short_path untuk jalur tempat file dipetakan jika berada di runfile biner.
root
root File.root
Root tempat file ini berada.
short_path
string File.short_path
Jalur file ini relatif terhadap root-nya. Jalur ini tidak menyertakan
root yang disebutkan di atas, yaitu fragmen jalur khusus konfigurasi. Jalur ini juga merupakan jalur tempat file dipetakan jika berada di runfile biner.
tree_relative_path
string File.tree_relative_path
Jalur file ini relatif terhadap root pohon ancestor, jika kolom ancestor
is_directory bernilai benar.
tree_relative_path hanya tersedia untuk file yang diperluas dari direktori dalam perintah tindakan, yaitu
Args.add_all(). Untuk jenis file lainnya, mengakses kolom ini akan menyebabkan error.
