File

Laporkan masalah Lihat sumber

Objek ini dibuat selama fase analisis untuk mewakili file atau direktori yang akan dibaca atau ditulis selama fase eksekusi. Kunci ini bukan handle file terbuka, dan tidak dapat digunakan untuk membaca atau menulis konten file secara langsung. Sebaliknya, 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, objek tersebut akan dikonversi menjadi string dengan mengambil nilai kolom path-nya.

Anggota

namadasar

string File.basename

Nama dasar file ini. Ini adalah nama file di dalam direktori.

nama direktori

string File.dirname

Nama direktori yang berisi file ini. Kode ini diambil dari path dan selalu bersifat relatif terhadap direktori eksekusi.

ekstensi

string File.extension

Ekstensi file ini, setelah (tidak termasuk) jangka waktu paling kanan. String kosong jika nama dasar file tidak menyertakan titik.

direktori_adalah

bool File.is_directory

Menampilkan true jika ini adalah direktori.

adalah_sumber

bool File.is_source

Menampilkan true jika ini adalah file sumber, yaitu tidak dibuat.

owner

Label File.owner

Label target yang menghasilkan File ini. Dapat menampilkan None.

jalur

string File.path

Jalur eksekusi file ini, relatif terhadap direktori eksekusi ruang kerja. 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 dihasilkan. Untuk file yang dihasilkan biasanya file 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 berada di runfile biner.

root

root File.root

Akar tempat file ini berada.

short_path

string File.short_path

Jalur file ini relatif terhadap root-nya. Ini tidak termasuk root yang disebutkan di atas, yaitu fragmen khusus konfigurasi jalur. Ini juga merupakan jalur tempat file dipetakan jika berada di runfile biner.

hierarki_relasi_pohon

string File.tree_relative_path

Jalur dari file ini relatif terhadap root pohon ancestor, jika kolom is_directory ancestor adalah benar. tree_relative_path hanya tersedia untuk file direktori yang diperluas dalam perintah tindakan, yaitu Args.add_all(). Untuk jenis file lainnya, akses ke kolom ini merupakan error.