الصنف File::Stat في روبي
تتضمن كائنات الصنف File::Stat معلومات حول حالة الكائنات File. تُسجَل هذه المعلومات في الوقت الذي يُنشَأ فيه الكائن File::Stat؛ لذا، لن يُحدَّث هذا الكائن بالحالة الجديدة إن أجري أي تعديل على الملف بعد هذه النقطة من الزمن. تعاد الكائنات File::Stat باستدعاء IO.stat، و File.stat، و File.lstat، و File::stat، و File::lstat. تعيد أغلب هذه التوابع قيمًا تتعلق بالمنصة المستعملة، وليست جميع القيم ذات معنًى في كل أنظمة التشغيل. اطلع على التابع Kernel.test.
توابع الصنف العامة
new
ينشئ كائنًا جديدًا من النوع File::Stat لاسم الملف المعطى.
توابع النسخة العامة
<=>
يوازن بين الكائنات File::Stat من ناحية أوقات تعديل كل منها.
atime
يعيد زمن آخر وصول إلى الملف الذي استدعي معه.
birthtime
يعيد وقت إنشاء الملف الذي استدعي معه.
blksize
يعيد حجم كتلة نظام الملفات الأساسي.
blockdev?
يتحقق إن كان ملفٌ ما هو جهاز كتلي (block device).
blocks
يعيد عدد كتل نظام الملفات المحجوزة للملف الذي استدعي معه.
chardev?
يتحقق إن كان ملفٌ ما هو جهاز محرفي (character device).
ctime
يعيد وقت آخر تغيير أجري على الملف الذي استدعي معه.
dev
يعيد عددًا صحيحًا يمثِّل الجهاز الذي يتواجد فيه الكائن File::Stat الذي استدعي معه.
dev_major
يعيد عددًا صحيحًا يمثِّل الجزء الكبير (major part) من dev، أو يعيد القيمة nil.
dev_minor
يعيد عددًا صحيحًا يمثِّل الجزء الصغير (minor part) من dev، أو يعيد القيمة nil.
directory?
يتحقق إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ.
executable?
يتحقق إن كان الملف الذي يشير إليه الكائن File::Stat الذي استدعي معه قابلًا للتنفيذ أو إن كان نظام التشغيل لا يفرِّق بين الملفات القابلة للتنفيذ من الملفات الغير قابلة للتنفيذ.
executable_real?
يشبه التابع executable? تمامًا باستثناء أنه يجري عملية التحقق باستعمال المعرِّف الحقيقي لمالك العملية.
file?
يتحقق إن كان الملف الذي يشير إليه الكائن File::Stat المعطى موجودًا وكان ملفًا طبيعيًّا (وليس جهازًا أو أنبوبًا أو مقبسًا ...إلخ.).
ftype
يعرِّف نوع الملف الذي يشير إليه الكائن File::Stat المعطى.
gid
يعيد المعرِّف الرقمي للمجموعة المالكة للملف الذي يشير إليه الكائن File::Stat المعطى.
grpowned?
يتحقق إن كان معرِّف المجموعة المالكة الفعلي للعملية التي استدعت التابع هو نفس معرِّف المجموعة المالكة للملف الذي يشير إليه الكائن File::Stat المعطى.
ino
يعيد رقم مؤشر الفهرسة (inode) للملف الذي يشير إليه الكائن File::Stat المعطى.
inspect
يولد وصفًا منسقًا بطريقة سهلة القراءة للملف الذي يشير إليه الكائن File::Stat المعطى.
mode
يعيد عددًا صحيحًا يمثِّل بتات الأذونات للملف الذي يشير إليه الكائن File::Stat المعطى.
mtime
يعيد وقت التعديل للملف الذي يشير إليه الكائن File::Stat المعطى.
nlink
يعيد عدد الوصلات الصلبة للملف الذي يشير إليه الكائن File::Stat المعطى.
owned?
يتحقق إن كان معرِّف مالك الملف الذي يشير إليه الكائن File::Stat المعطى هو نفسه المعرِّف الفعلي للمستخدم المالك للعملية التي استدعته.
pipe?
يتحقق إن كان يدعم نظام التشغيل الحالي الأنابيب وكان الملف الذي يشير إليه الكائن File::Stat المعطى أنبوبًا.
rdev
يعيد عددًا صحيحًا يمثِّل نوع الجهاز الذي يتواجد فيه الكائن File::Stat الذي استدعي معه.
rdev_major
يعيد عددًا صحيحًا يمثِّل الجزء الكبير (major part) من rdev، أو يعيد القيمة nil.
rdev_minor
يعيد عددًا صحيحًا يمثِّل الجزء الصغير (minor part) من rdev، أو يعيد القيمة nil.
readable?
يتحقق إن كان الملف الذي يشير إليه الكائن File::Stat المعطى قابلًا للقراءة من طرف مُعرِّف المستخدم الفعلي للعملية الحالية.
readable_real?
يتحقق إن كان الملف الذي يشير إليه الكائن File::Stat المعطى قابلًا للقراءة من طرف مُعرِّف المستخدم الحقيقي للعملية الحالية.
setgid?
يتحقق إن كان البت gid (بت معرِّف المجموعة المالكة) مضبوطًا للملف الذي يشير إليه الكائن File::Stat المعطى.
setuid?
يتحقق إن كان البت uid (بت معرِّف المستخدم المالك) مضبوطًا للملف الذي يشير إليه الكائن File::Stat المعطى.
size
يعيد حجم الملف الذي يشير إليه الكائن File::Stat المعطى.
size?
يتحقق إن كان الملف الذي يشير إليه الكائن File::Stat المعطى غير موجود أو معدوم الحجم.
socket?
يتحقق إن كان الملف الذي يشير إليه الكائن File::Stat المعطى مقبسًا.
sticky?
يتحقق إن كان الملف الذي يشير إليه الكائن File::Stat المعطى قد ضُبِط فيه البت اللاصق (sticky bit).
symlink?
يتحقق إن كان الملف الذي يشير إليه الكائن File::Stat المعطى وصلةً رمزيًّةً.
uid
يعيد المعرِّف الرقمي للمستخدم المالك للملف الذي يشير إليه الكائن File::Stat المعطى.
world_readable?
يتحقق إن كان الملف الذي يشير إليه الكائن File::Stat المعطى قابلًا للقراءة من طرف الآخرين.
world_writable?
يتحقق إن كان الملف الذي يشير إليه الكائن File::Stat المعطى قابلًا للكتابة من طرف الآخرين.
writable?
يتحقق إن كان الملف الذي يشير إليه الكائن File::Stat المعطى قابلًا للكتابة من طرف مُعرِّف المستخدم الفعلي للعملية الحالية.
writable_real?
يتحقق إن كان الملف الذي يشير إليه الكائن File::Stat المعطى قابلًا للكتابة من طرف مُعرِّف المستخدم الحقيقي للعملية الحالية.
zero?
يتحقق إن الملف الذي يشير إليه الكائن File::Stat المعطى ما موجودًا وخاويًا (صفر الحجم).