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, 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ı. path öğesinden alınır ve her zaman yürütme diziniyle ilişkilidir.
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_directoryBu bir dizinse true değerini döndürür.
is_source
bool File.is_sourceBu bir kaynak dosyaysa (yani oluşturulmadıysa) true değerini döndürür.
sahibi
Label File.ownerBu dosyayı oluşturan hedefin etiketi.
None
sonucunu döndürebilir.
yol
string File.pathÇalışma alanının yürütme dizinine göre bu dosyanın yürütme yolu. Bu modül, root adlı isteğe bağlı birinci bölüm (ayrıca bkz. kök modülü) ve ikinci bölüm olan
short_path
olmak üzere iki bölümden oluşur. Kök boş olabilir. Bu durum, genellikle oluşturulmamış dosyalar için kullanılır. 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 kök, yani yolun yapılandırmaya özgü parçaları buna dahil 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.