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
Kaynak dosya ise (yani oluşturulmamışsa) doğru değerini döndürür.
sahibi
Label File.owner
Bu Dosya'yı oluşturan bir hedefin etiketi.
None döndürebilir.
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, bir ikili programın runfiles'ında yer alıyorsa dosyanın eşlendiği yol için
short_path ifadesini 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.
