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 dosya tutma yeri değildir ve dosya içeriklerini doğrudan okumak ya da yazmak için kullanılamaz. Bunun yerine, bu grafiği işlem grafiğini işlem oluşturan işlevlere ileterek bir kural uygulama işlevinde oluşturmak için kullanırsınız. Daha fazla bilgi için Kurallar sayfasına bakın.
Bir File
, map_each
işlevi kullanılmadan bir Args
nesnesine iletildiğinde path
alanının değeri alınarak dizeye dönüştürülür.
Üyeler
basename
string File.basenameBu dosyanın temel adı. Bu, dizindeki dosyanın adıdır.
dirname
string File.dirnameBu dosyayı içeren dizinin adı. path öğesinden alınır ve her zaman yürütme diziniyle ilişkilidir.
uzantı
string File.extensionBu dosyanın, en sağdaki dönemi takip eden (hariç) dosya uzantısı. Dosyanın temel adı nokta içermiyorsa boş dize.
is_directory
bool File.is_directoryDizine aitse doğru değerini döndürür.
is_source
bool File.is_sourceKaynak dosyaysa (yani oluşturulmamışsa) doğru değerini döndürür.
sahibi
Label File.ownerBu Dosyayı oluşturan bir hedefin etiketi.
None
sonucunu döndürebilir.
yol
string File.pathBu dosyanın, çalışma alanının yürütme dizine göre yürütme yolu. İki bölümden oluşur: root adlı isteğe bağlı bir ilk bölüm (root modülüne de bakın) ve
short_path
olan ikinci bölüm. Kök boş olabilir. Bu durum, genellikle oluşturulmamış dosyalar için geçerlidir. 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. Bir ikili dosyanın çalıştırma dosyalarındaysa dosyanın eşlendiği yol için short_path
kullanın.
kök
root File.rootBu dosyanın bulunduğu kök.
short_path
string File.short_pathBu dosyanın köküne göre yolu. Yukarıda belirtilen root (yani yolun yapılandırmaya özgü parçaları) bu kapsamda değildir. Bu, bir ikili programın çalışma dosyalarında yer alan dosyanı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 (ör. Args.add_all()) bir dizinin genişletilmiş dosyaları için kullanılabilir. Diğer dosya türlerinde bu alana erişmek hata verir.