Bu nesne, yürütme aşamasında okunacak veya yazılacak bir dosyayı veya dizini temsil etmek için analiz aşamasında oluşturulur. Açık bir dosya imleci değildir ve dosya içeriğini doğrudan okumak veya yazmak için kullanılamaz. Bunun yerine, işlem oluşturma işlevlerine ileterek kural uygulama işlevinde işlem grafiğini oluşturmak için kullanırsınız. Daha fazla bilgi için Kurallar sayfasına göz atın.
File
, map_each
işlevi kullanılmadan Args
nesnesine iletildiğinde, path
alanının değeri alınıp 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ı. yol parametresinden alınır ve her zaman yürütme dizine görelidir.
uzantı
string File.extensionEn sağdaki noktanın ardından (dahil değil) gelen bu dosyanın 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. Dosya bir ikili programın çalışma 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ğru ise bu dosyanın, üst öğe ağacının köküne göre yolu.
tree_relative_path
yalnızca bir işlem komutunda (ör. Args.add_all()) dizinin genişletilmiş dosyaları için kullanılabilir. Diğer dosya türlerinde bu alana erişmek bir hatadır.