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 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 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
- dirname
- extension
- is_directory
- is_source
- is_symlink
- owner
- path
- kök
- short_path
- tree_relative_path
basename
string File.basenameBu dosyanın temel adı. Bu, dizin içindeki 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. Bu, dosyanın beyan edildiği türü (ör.ctx. actions.declare_directory) yansıtır, dosya sisteminin türünü yansıtmaz.Dosya sistemi türü farklı olabilir.
is_source
bool File.is_sourceKaynak dosyaysa (yani oluşturulmamışsa) doğru değerini döndürür.
is_symlink
bool File.is_symlinkDizine aitse doğru değerini döndürür. Bu, dosyanın beyan edildiği türü (ör.ctx. actions.declare_symlink) yansıtır, dosya sisteminin türünü yansıtmaz.Dosya sistemi türü farklı olabilir.
sahibi
Label File.ownerBu dosyayı oluşturan bir hedefin etiketi.
None
değerini 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 özel 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.