الصنف `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 المعطى.

`zero?‎`

يتحقق إن الملف الذي يشير إليه الكائن File::Stat المعطى ما موجودًا وخاويًا (صفر الحجم).

مصادر

صفحة الصنف File::Stat في توثيق روبي الرسمي.