Bu nesne, yürütme aşamasında okunacak veya yazılacak bir dosyayı ya da dizini temsil etmek için analiz aşamasında oluşturulur. Açık bir dosya tanıtıcısı değildir ve dosya içeriklerini doğrudan okumak veya yazmak için kullanılamaz. Bunun yerine, işlem oluşturma işlevlerine ileterek bir kural uygulama işlevinde işlem grafiğini oluşturmak için kullanırsınız. Daha fazla bilgi için
Kurallar sayfası'na bakın.
File işlevi kullanılmadan bir Args nesnesine File iletildiğinde, path alanının değeri alınarak dizeye dönüştürülür.map_each
Üyeler
basename
string File.basename
Bu dosyanın temel adı. Bu, dizinin içindeki dosyanın adıdır.
dirname
string File.dirname
Bu dosyayı içeren dizinin adı.
Yol değerinden alınır ve her zaman yürütme dizinine göre belirlenir.
süresini uzatma
string File.extension
Bu dosyanın, en sağdaki noktadan sonraki (nokta hariç) dosya uzantısı. Dosyanın temel adında nokta yoksa boş dize.
is_directory
bool File.is_directory
Bu bir dizinse true değerini döndürür.
is_source
bool File.is_source
Bu bir kaynak dosyaysa (yani oluşturulmamışsa) doğru değerini döndürür.
sahibi
Label File.owner
Bu dosyayı oluşturan bir hedefin etiketi.
İade edilebilir
None.
yol
string File.path
Bu dosyanın, çalışma alanının yürütme dizinine göre yürütme yolu. İki bölümden oluşur:
kök adı verilen isteğe bağlı ilk bölüm (
kök modülüne de bakın) ve
short_path olan ikinci bölüm. Kök boş olabilir (genellikle oluşturulmamış dosyalar için boş olur). Oluşturulan dosyalar için genellikle, söz konusu dosya oluşturulurken kullanılan hedef CPU mimarisi gibi öğeleri kodlayan yapılandırmaya özgü bir yol parçası içerir. Dosya, ikili dosyanın runfiles'ındaysa dosyanın eşlendiği yol için
short_path kullanın.
kök
root File.root
Bu dosyanın bulunduğu kök.
short_path
string File.short_path
Bu dosyanın köküne göre yolu. Bu, yukarıda bahsedilen
kökü (yani yola ait yapılandırmaya özgü parçalar) hariç tutar. Bu, ikili programın çalıştırılabilir dosyalarında bulunan dosyaların eşlendiği yoldur.
tree_relative_path
string File.tree_relative_path
Üst öğenin
is_directory alanı doğruysa bu dosyanın, üst öğenin ağacının köküne göre yolu.
tree_relative_path yalnızca bir işlem komutundaki dizinin genişletilmiş dosyaları için kullanılabilir (ör.
Args.add_all()). Diğer dosya türleri için bu alana erişmek hataya neden olur.
