الصنف 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 المعطى ما موجودًا وخاويًا (صفر الحجم).

مصادر