نتائج البحث

تتضمن كائنات الصنف File::Stat معلومات حول حالة الكائنات File. تُسجَل هذه المعلومات في الوقت الذي يُنشَأ فيه الكائن File::Stat؛ لذا، لن يُحدَّث هذا الكائن بالحالة الجديدة إن أجري أي تعديل على الملف بعد هذه النقطة من الزمن. تعاد الكائنات File::Stat باستدعاء IO.stat، و File.stat، و File.lstat، و File::stat، و File::lstat. تعيد أغلب هذه التوابع قيمًا تتعلق بالمنصة المستعملة، وليست جميع القيم ذات معنًى في كل أنظمة التشغيل. اطلع على التابع Kernel.test. توابع الصنف العامة new ينشئ كائنًا جديدًا من النوع ...

ينشئ التابع new كائنًا جديدًا من النوع File::Stat لاسم الملف المعطى. سيُرمَى استثناءٌ إلى لم يكن ذلك الملف المعطى موجودًا. البنية العامة File::Stat.new(file_name) → stat المعاملات file_name اسم الملف المراد إنشاء كائن الحالة File::Stat له. القيمة المعادة يعاد كائن جديد من النوع File::Stat للملف file_name. انظر أيضا المعامل <=>: يوازن بين الكائنات File::Stat من ناحية أوقات تعديل كل منها. التابع atime: يعيد زمن آخر وصول إلى الملف الذي استدعي معه. التابع birthtime: يعيد وقت إنشاء الملف الذي استدعي معه. مصادر قسم ...

يتحقق التابع symlink?‎ إن كان الملف الذي يشير إليه الكائن File::Stat المعطى وصلةً رمزيًّةً. لمَّا كان الكائن File::Stat يتبع الوصلات الرمزية تلقائيًّا، فسيعيد التابع symlink?‎ القيمة false دومًا للكائن المعاد من طرف File::Stat. البنية العامة symlink? → true or false القيمة المعادة تعاد القيمة true إن كان الملف الذي يشير إليه الكائن File::Stat المعطى وصلةً رمزيًّةً، أو تعاد القيمة false إن لم يكن الملف وصلةً رمزيةً أو لم يكن نظام التشغيل يدعم هذه الميزة. أمثلة مثال على استعمال التابع symlink?‎: File.symlink("testfile", ...

يعيد التابع nlink عدد الوصلات الصلبة للملف الذي يشير إليه الكائن File::Stat المعطى. البنية العامة nlink → integer القيمة المعادة يعاد عدد صحيح يمثِّل عدد الوصلات الصلبة للملف الذي يشير إليه الكائن File::Stat المعطى. أمثلة مثال على استعمال التابع nlink: File.stat("testfile").nlink #=> 1 File.link("testfile", "testfile.bak") #=> 0 File.stat("testfile").nlink #=> 2 انظر أيضًا التابع ftype: يعرِّف نوع الملف ...

يعيد التابع uid المعرِّف الرقمي للمستخدم المالك للملف الذي يشير إليه الكائن File::Stat المعطى. البنية العامة uid → integer القيمة المعادة يعاد عدد صحيح يمثِّل المعرِّف الرقمي للمستخدم المالك للملف الذي يشير إليه الكائن File::Stat المعطى. أمثلة مثال على استعمال التابع uid: File.stat("/dev/fd1").rdev_minor #=> 1 File.stat("/dev/tty").rdev_minor #=> 0 انظر أيضًا التابع gid: يعيد المعرِّف الرقمي للمجموعة المالكة للملف الذي يشير إليه الكائن File::Stat المعطى. التابع ino: يعيد رقم مؤشر الفهرسة (inode) للملف الذي يشير إليه الكائن File::Stat المعطى. التابع ...

يتحقق التابع writable?‎ إن كان الملف الذي يشير إليه الكائن File::Stat المعطى قابلًا للكتابة من طرف مُعرِّف المستخدم الفعلي للعملية الحالية. البنية العامة writable? → true or false القيمة المعادة تعاد القيمة true إن كان الملف الذي يشير إليه الكائن File::Stat المعطى قابلًا للكتابة من طرف مُعرِّف المستخدم الفعلي للعملية الحالية. خلا ذلك، تعاد القيمة false. أمثلة مثال على استعمال التابع writable?‎: انظر أيضًا التابع readable?‎: يتحقق إن كان الملف الذي يشير إليه الكائن File::Stat المعطى قابلًا للقراءة من طرف ...

يتحقق التابع sticky?‎ إن كان الملف الذي يشير إليه الكائن File::Stat المعطى قد ضُبِط فيه البت اللاصق (sticky bit). البنية العامة sticky? → true or false القيمة المعادة تعاد القيمة true إن كان الملف الذي يشير إليه الكائن File::Stat المعطى قد ضُبِط فيه البت اللاصق (sticky bit)، أو تعاد القيمة false إن لم يكن البت مضبوطًا أو لم يكن نظام التشغيل يدعم هذه الميزة. أمثلة مثال على استعمال التابع sticky?‎: File.stat("testfile").sticky? #=> false انظر أيضًا التابع owned?‎: يتحقق إن ...

يتحقق التابع writable_real?‎ إن كان الملف الذي يشير إليه الكائن File::Stat المعطى قابلًا للكتابة من طرف مُعرِّف المستخدم الحقيقي للعملية الحالية. البنية العامة writable_real? → true or false القيمة المعادة تعاد القيمة true إن كان الملف الذي يشير إليه الكائن File::Stat المعطى قابلًا للكتابة من طرف مُعرِّف المستخدم الحقيقي للعملية الحالية. خلا ذلك، تعاد القيمة false. أمثلة مثال على استعمال التابع chardev?‎: File.stat("testfile").writable_real? #=> true انظر أيضًا التابع readable_real?‎: يتحقق إن كان الملف الذي يشير إليه الكائن File::Stat المعطى ...

يعيد التابع size حجم الملف الذي يشير إليه الكائن File::Stat المعطى. البنية العامة size → integer القيمة المعادة يعاد عدد صحيح يمثِّل حجم الملف الذي يشير إليه الكائن File::Stat المعطى بالبايت. أمثلة مثال على استعمال التابع size: File.stat("testfile").size #=> 66 انظر أيضًا التابع size?‎: يتحقق إن كان الملف الذي يشير إليه الكائن File::Stat المعطى غير موجود أو معدوم الحجم. التابع zero?‎: يتحقق إن الملف الذي يشير إليه الكائن File::Stat المعطى ما موجودًا وخاويًا (صفر الحجم). مصادر قسم التابع size ...

يتحقق التابع zero?‎ إن الملف الذي يشير إليه الكائن File::Stat المعطى ما موجودًا وخاويًا (صفر الحجم). البنية العامة zero? → true or false القيمة المعادة تعاد القيمة true إن الملف الذي يشير إليه الكائن File::Stat المعطى ما موجودًا وخاويًا (صفر الحجم). خلا ذلك، تعاد القيمة false. أمثلة مثال على استعمال التابع zero?‎: File.stat("testfile").zero? #=> false انظر أيضًا التابع size: يعيد حجم الملف الذي يشير إليه الكائن File::Stat المعطى. التابع size?‎: يتحقق إن كان الملف الذي يشير إليه الكائن File::Stat ...

يتحقق التابع setuid?‎ إن كان البت uid (بت معرِّف المستخدم المالك) مضبوطًا للملف الذي يشير إليه الكائن File::Stat المعطى. البنية العامة setuid? → true or false القيمة المعادة تعاد القيمة true إن كان البت uid (بت معرِّف المستخدم المالك) مضبوطًا للملف الذي يشير إليه الكائن File::Stat، أو تعاد القيمة false إن لم يكن ذلك البت مضبوطًا أو لم يكن نظام التشغيل يدعم هذه الميزة. أمثلة مثال على استعمال التابع setuid?‎: File.stat("/bin/su").setuid? #=> true انظر أيضًا التابع executable?‎: يتحقق إن كان الملف الذي يشير إليه ...

يتحقق التابع world_writable?‎ إن كان الملف الذي يشير إليه الكائن File::Stat المعطى  قابلًا للكتابة من طرف الآخرين. البنية العامة world_writable? → integer or nil القيمة المعادة يعاد عدد صحيح يمثِّل بتات أذونات الملف الذي يشير إليه الكائن File::Stat المعطى إن كان قابلًا للكتابة من طرف الآخرين. خلا ذلك، تعاد القيمة nil. تعتمد بتات الأذونات المعادة على المنصة المستعملة. اطلع على الدالةstat(2)‎ في المنصات الشبيهة بيونكس. أمثلة مثال على استعمال التابع world_writable?‎: m = File.stat("/tmp").world_writable? #=> 511 sprintf("%o", m) ...

يتحقق التابع world_readable?‎ إن كان الملف الذي يشير إليه الكائن File::Stat المعطى  قابلًا للقراءة من طرف الآخرين. البنية العامة world_readable? → integer or nil القيمة المعادة يعاد عدد صحيح يمثِّل بتات أذونات الملف الذي يشير إليه الكائن File::Stat المعطى إن كان قابلًا للقراءة من طرف الآخرين. خلا ذلك، تعاد القيمة nil. تعتمد بتات الأذونات المعادة على المنصة المستعملة. اطلع على الدالةstat(2)‎ في المنصات الشبيهة بيونكس. أمثلة مثال على استعمال التابع world_readable?‎: m = File.stat("/etc/passwd").world_readable? #=> 420 sprintf("%o", m) ...

يتحقق التابع size?‎ إن كان الملف الذي يشير إليه الكائن File::Stat المعطى غير موجود أو معدوم الحجم. إن كان الملف موجودًا وله حجم ما، فسيعيد التابع حجم هذا الملف. البنية العامة size? → Integer or nil القيمة المعادة تعاد القيمة nil إن كان الملف الذي يشير إليه الكائن File::Stat المعطى غير موجود أو معدوم الحجم. إن كان الملف موجودًا وله حجم ما، فسيعاد عدد صحيح يمثِّل حجم هذا الملف. انظر أيضًا التابع size: يعيد حجم الملف الذي يشير إليه الكائن File::Stat المعطى. ...

يعيد التابع ino رقم مؤشر الفهرسة (inode) للملف الذي يشير إليه الكائن File::Stat المعطى. البنية العامة ino → integer القيمة المعادة يعاد عدد صحيح يمثِّل رقم مؤشر الفهرسة (inode) للملف الذي يشير إليه الكائن File::Stat المعطى. أمثلة مثال على استعمال التابع ino: File.stat("testfile").ino #=> 1083669 انظر أيضا التابع blksize: يعيد حجم كتلة نظام الملفات الأساسي. التابع ftype: يعرِّف نوع الملف الذي يشير إليه الكائن File::Stat المعطى. التابع gid: يعيد المعرِّف الرقمي للمجموعة المالكة للملف الذي يشير إليه الكائن File::Stat المعطى. ...

يتحقق التابع readable_real?‎ إن كان الملف الذي يشير إليه الكائن File::Stat المعطى قابلًا للقراءة من طرف مُعرِّف المستخدم الحقيقي للعملية الحالية. البنية العامة readable_real? → true or false القيمة المعادة تعاد القيمة true إن كان الملف الذي يشير إليه الكائن File::Stat المعطى قابلًا للقراءة من طرف مُعرِّف المستخدم الحقيقي للعملية الحالية. خلا ذلك، تعاد القيمة false. أمثلة مثال على استعمال التابع readable_real?‎: File.stat("testfile").readable_real? #=> true انظر أيضًا التابع executable_real?‎: يشبه التابع executable?‎ تمامًا باستثناء أنه يجري عملية التحقق باستعمال المعرِّف ...

يعيد التابع gid المعرِّف الرقمي للمجموعة المالكة للملف الذي يشير إليه الكائن File::Stat المعطى. البنية العامة gid → integer القيمة المعادة يعاد عدد صحيح يمثِّل المعرِّف الرقمي للمجموعة المالكة للملف الذي يشير إليه الكائن File::Stat المعطى. أمثلة مثال على استعمال المعامل gid: File.stat("testfile").gid #=> 500 انظر أيضا التابع uid: يعيد المعرِّف الرقمي للمستخدم المالك للملف الذي يشير إليه الكائن File::Stat المعطى. التابع birthtime: يعيد وقت إنشاء الملف الذي استدعي معه. التابع blocks: يعيد عدد كتل نظام الملفات المحجوزة للملف ...

يعيد التابع mode عددًا صحيحًا يمثِّل بتات الأذونات للملف الذي يشير إليه الكائن File::Stat المعطى. البنية العامة mode → integer القيمة المعادة يعاد عدد صحيح يمثِّل بتات الأذونات للملف الذي يشير إليه الكائن File::Stat المعطى. أمثلة مثال على استعمال التابع mode: File.chmod(0644, "testfile") #=> 1 s = File.stat("testfile") sprintf("%o", s.mode) #=> "100644" انظر أيضًا التابع ctime: يعيد وقت آخر تغيير أجري على الملف الذي استدعي معه. التابع gid: يعيد المعرِّف الرقمي للمجموعة ...

يتحقق التابع readable?‎ إن كان الملف الذي يشير إليه الكائن File::Stat المعطى قابلًا للقراءة من طرف مُعرِّف المستخدم الفعلي للعملية الحالية. البنية العامة readable? → true or false القيمة المعادة تعاد القيمة true إن كان الملف الذي يشير إليه الكائن File::Stat المعطى قابلًا للقراءة من طرف مُعرِّف المستخدم الفعلي للعملية الحالية. خلا ذلك، تعاد القيمة false. أمثلة مثال على استعمال التابع readable?‎: File.stat("testfile").readable? #=> true انظر أيضًا التابع chardev?‎: يتحقق إن كان ملفٌ ما هو جهاز محرفي (character device). ...

يتحقق التابع setgid?‎ إن كان البت gid (بت معرِّف المجموعة المالكة) مضبوطًا للملف الذي يشير إليه الكائن File::Stat المعطى. البنية العامة setgid? → true or false القيمة المعادة تعاد القيمة true إن كان البت gid (بت معرِّف المجموعة المالكة) مضبوطًا للملف الذي يشير إليه الكائن File::Stat، أو تعاد القيمة false إن لم يكن ذلك البت مضبوطًا أو لم يكن نظام التشغيل يدعم هذه الميزة. أمثلة مثال على استعمال التابع setgid?‎: File.stat("/usr/sbin/lpc").setgid? #=> true انظر أيضًا التابع chardev?‎: يتحقق إن كان ملفٌ ما هو جهاز ...

يتحقق التابع owned?‎ إن كان معرِّف مالك الملف الذي يشير إليه الكائن File::Stat المعطى هو نفسه المعرِّف الفعلي للمستخدم المالك للعملية التي استدعته. البنية العامة owned? → true or false القيمة المعادة تعاد القيمة true إن كان معرِّف مالك الملف الذي يشير إليه الكائن File::Stat المعطى هو نفسه المعرِّف الفعلي للمستخدم المالك للعملية التي استدعته. خلا ذلك، تعاد القيمة false. أمثلة مثال على استعمال التابع owned?‎: File.stat("testfile").owned? #=> true File.stat("/etc/passwd").owned? #=> false انظر أيضًا التابع blockdev?‎: ...

يتحقق التابع pipe?‎ إن كان يدعم نظام التشغيل الحالي الأنابيب وكان الملف الذي يشير إليه الكائن File::Stat المعطى أنبوبًا. البنية العامة pipe? → true or false القيمة المعادة تعاد القيمة true إن كان يدعم نظام التشغيل الحالي الأنابيب وكان الملف الذي يشير إليه الكائن File::Stat المعطى أنبوبًا. خلا ذلك، تعاد القيمة false. انظر أيضًا التابع chardev?‎: يتحقق إن كان ملفٌ ما هو جهاز محرفي (character device). التابع directory?‎: يتحقق إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ. التابع ...

يتحقق التابع socket?‎ إن كان الملف الذي يشير إليه الكائن File::Stat المعطى مقبسًا. البنية العامة socket? → true or false القيمة المعادة تعاد القيمة true إن كان الملف الذي يشير إليه الكائن File::Stat المعطى مقبسًا، أو تعاد القيمة false إن لم يكن الملف مقبسًا أو لم يكن نظام التشغيل يدعم هذه الميزة. أمثلة مثال على استعمال التابع socket?‎: File.stat("testfile").socket? #=> false انظر أيضًا التابع directory?‎: يتحقق إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ. التابع symlink?‎: يتحقق ...

يعيد التابع dev عددًا صحيحًا يمثِّل الجهاز الذي يتواجد فيه الكائن File::Stat الذي استدعي معه. البنية العامة dev → integer القيمة المعادة يعاد عدد صحيح يمثِّل الجهاز الذي يتواجد فيه الكائن File::Stat المعطى. أمثلة مثال على استعمال التابع dev: File.stat("testfile").dev #=> 774 انظر أيضًا التابع dev_major: يعيد عددًا صحيحًا يمثِّل الجزء الكبير (major part) من dev، أو يعيد القيمة nil. التابع dev_minor: يعيد عددًا صحيحًا يمثِّل الجزء الصغير (minor part) من dev، أو يعيد القيمة nil. التابع rdev: يعيد ...

يولد التابع inspect وصفًا منسقًا بطريقة سهلة القراءة للملف الذي يشير إليه الكائن File::Stat المعطى. البنية العامة inspect → string القيمة المعادة تعاد سلسلة نصية تحوي وصفًا منسقًا بطريقة سهلة القراءة للملف الذي يشير إليه الكائن File::Stat المعطى. أمثلة مثال على استعمال التابع inspect: File.stat("/etc/passwd").inspect #=> "#<File::Stat dev=0xe000005, ino=1078078, mode=0100644, # nlink=1, uid=0, gid=0, rdev=0x0, size=1374, blksize=4096, # blocks=8, atime=Wed Dec 10 10:16:12 CST 2003, # ...

يعيد التابع mtime وقت التعديل للملف الذي يشير إليه الكائن File::Stat المعطى. البنية العامة mtime → aTime القيمة المعادة يعاد كائن من النوع Time يمثِّل وقت تعديل للملف الذي يشير إليه الكائن File::Stat المعطى. أمثلة مثال على استعمال التابع mtime: File.stat("testfile").mtime #=> Wed Apr 09 08:53:14 CDT 2003 انظر أيضًا التابع atime: يعيد زمن آخر وصول إلى الملف الذي استدعي معه. التابع ctime: يعيد وقت آخر تغيير أجري على الملف الذي استدعي معه. التابع inspect: يولد وصفًا منسقًا بطريقة سهلة القراءة للملف ...

يشبه التابع executable_real?‎ التابع executable?‎ تمامًا باستثناء أنه يجري عملية التحقق باستعمال المعرِّف الحقيقي لمالك العملية. البنية العامة executable_real? → true or false القيمة المعادة تعاد القيمة true إن كان الملف الذي يشير إليه الكائن File::Stat المعطى قابلًا للتنفيذ أو إن كان نظام التشغيل لا يفرِّق بين الملفات القابلة للتنفيذ من الملفات الغير قابلة للتنفيذ. خلا ذلك، تعاد القيمة false. انظر أيضا التابع executable?‎: يتحقق إن كان الملف الذي يشير إليه الكائن File::Stat الذي استدعي معه قابلًا للتنفيذ أو إن كان نظام ...

يتحقق التابع file?‎ إن كان الملف الذي يشير إليه الكائن File::Stat المعطى موجودًا وكان ملفًا طبيعيًّا (وليس جهازًا أو أنبوبًا أو مقبسًا ...إلخ.). البنية العامة file? → true or false القيمة المعادة تعاد القيمة true إن كان الملف الذي يشير إليه الكائن File::Stat المعطى موجودًا وكان ملفًا طبيعيًّا (وليس جهازًا أو أنبوبًا أو مقبسًا ...إلخ.). خلا ذلك، تعاد القيمة false. أمثلة مثال على استعمال التابع file?‎: File.stat("testfile").file? #=> true انظر أيضا التابع blockdev?‎: يتحقق إن كان ملفٌ ما هو جهاز ...

يعيد التابع rdev عددًا صحيحًا يمثِّل نوع الجهاز الذي يتواجد فيه الكائن File::Stat الذي استدعي معه. البنية العامة rdev → integer or nil القيمة المعادة يعاد عدد صحيح يمثِّل نوع الجهاز الذي يتواجد فيه الكائن File::Stat الذي استدعي معه، أو تعاد القيمة nil إن كان نظام التشغيل لا يدعم هذه الميزة آنذاك. أمثلة مثال على استعمال التابع rdev: File.stat("/dev/fd1").rdev #=> 513 File.stat("/dev/tty").rdev #=> 1280 انظر أيضًا التابع dev: يعيد عددًا صحيحًا يمثِّل الجهاز الذي يتواجد فيه الكائن File::Stat ...

يعرِّف التابع ftype نوع الملف الذي يشير إليه الكائن File::Stat المعطى. البنية العامة ftype → string القيمة المعادة تعاد سلسلة نصية تحدَّد نوع الملف الذي يشير إليه الكائن File::Stat المعطى. تكون هذه السلسلة النصية المعادة إحدى السلاسل النصية التالية: "file''، أو "directory''، أو "characterSpecial''، أو "blockSpecial''، أو "fifo''، أو "link''، أو "socket''، أو "unknown''. أمثلة مثال على استعمال التابع ftype: File.stat("/dev/tty").ftype #=> "characterSpecial" انظر أيضا التابع blockdev?‎: يتحقق إن كان ملفٌ ما هو جهاز كتلي (block device). التابع chardev?‎: يتحقق إن ...

يتحقق التابع grpowned?‎ إن كان معرِّف المجموعة المالكة الفعلي للعملية التي استدعت التابع هو نفس معرِّف المجموعة المالكة للملف الذي يشير إليه الكائن File::Stat المعطى. البنية العامة grpowned? → true or false القيمة المعادة تعاد القيمة true إن كان معرِّف المجموعة المالكة الفعلي للعملية التي استدعت التابع هو نفس معرِّف المجموعة المالكة للملف الذي يشير إليه الكائن File::Stat المعطى. خلا ذلك، تعاد القيمة false. تعاد القيمة false دومًا على أنظمة ويندوز. أمثلة مثال على استعمال التابع grpowned?‎: File.stat("testfile").grpowned? #=> true File.stat("/etc/passwd").grpowned? ...

يتحقق التابع executable?‎ إن كان الملف الذي يشير إليه الكائن File::Stat الذي استدعي معه قابلًا للتنفيذ أو إن كان نظام التشغيل لا يفرِّق بين الملفات القابلة للتنفيذ من الملفات الغير قابلة للتنفيذ. تُجرَى عملية التحقق هذه باستعمال المعرِّف الفعلي لمالك العملية. البنية العامة executable? → true or false القيمة المعادة تعاد القيمة true إن كان الملف الذي يشير إليه الكائن File::Stat المعطى قابلًا للتنفيذ أو إن كان نظام التشغيل لا يفرِّق بين الملفات القابلة للتنفيذ من الملفات الغير قابلة للتنفيذ. خلا ...

يعيد التابع atime زمن آخر وصول إلى الملف الذي استدعي معه. البنية العامة atime → time القيمة المعادة يعاد كائن من النوع Time يمثِّل زمن آخر وصول للملف المعطى. أمثلة مثال على استعمال التابع atime: File.stat("testfile").atime #=> Wed Dec 31 18:00:00 CST 1969 انظر أيضًا التابع ctime: يعيد وقت آخر تغيير أجري على الملف الذي استدعي معه. التابع mtime: يعيد وقت التعديل للملف الذي يشير إليه الكائن File::Stat المعطى. التابع ino: يعيد رقم مؤشر الفهرسة (inode) للملف الذي يشير إليه الكائن File::Stat المعطى. ...

يتحقق التابع directory?‎ إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ. البنية العامة directory?(file_name) → true or false المعاملات file_name اسم الملف المراد التحقق منه. يمكن أن يكون كائنًا من النوع IO. القيمة المعادة تعاد القيمة true إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ. خلا ذلك، تعاد القيمة false. أمثلة مثال على استعمال التابع directory?‎: File.directory?(".") انظر أيضا التابع blockdev?‎: يتحقق إن كان ملفٌ ما هو جهاز كتلي (block device). التابع chardev?‎: يتحقق إن كان ملفٌ ما هو جهاز ...

يعيد التابع ctime وقت آخر تغيير أجري على الملف الذي استدعي معه. يشير وقت التغيير هذا إلى الزمن الذي تغيرت فيه معلومات المجلد حول الملف وليس الملف نفسه. البنية العامة ctime → aTime القيمة المعادة يعاد كائن من النوع Time يمثِّل وقت آخر تغيير جرى للمعلومات حول الملف المعطى. في أنظمة ويندوز (أي أنظمة الملفات NTFS)، يعاد وقت إنشاء الملف وليس وقت التغيير. أمثلة مثال على استعمال التابع ctime: File.stat("testfile").ctime #=> Wed Apr 09 08:53:14 CDT 2003 انظر أيضًا التابع atime: يعيد زمن ...

الصنف File هو اختصار لأي كائن ملفٍ قابل للوصول عبر البرنامج ومرتبط عن كثب بالصنف IO. يتضمن الصنف File توابع الوحدة FileTest كتوابع صنفٍ مما يسمح لك باستعمال File.exist?("foo")‎ مثلًا. في شرح توابع الصنف File التالية، تكون بتات الأذونات (permission bits) مجموعة من البتات التي تعتمد على المنصة المستعملة والتي تشير إلى أذونات الملف. في الأنظمة الشبيهة بيونكس، تُعرض الأذونات على شكل مجموعة من ثلاثة ثمانيات (octets)؛ الأولى من أجل المالك، والثانية من أجل المجموعة المالكة، والثالثة تخص الأشخاص الآخرين. ...

يوازن المعامل <=> بين الكائنات File::Stat من ناحية أوقات تعديل كل منها. البنية العامة stat <=> other_stat → -1, 0, 1, nil القيمة المعادة تعاد القيم 1-، أو 0، أو 1 إن كان الكائن stat أصغر من أو يساوي أو أكبر من الكائن other_stat. تعاد القيمة nil إن لم يكن الكائن other_stat من النوع File::Stat. أمثلة مثال على استعمال المعامل <=>: f1 = File.new("f1", "w") sleep 1 f2 = File.new("f2", "w") f1.stat <=> f2.stat #=> -1 انظر أيضا التابع new: ينشئ ...

يعيد التابع rdev_major عددًا صحيحًا يمثِّل الجزء الكبير (major part) من rdev، أو يعيد القيمة nil. البنية العامة rdev_major → integer القيمة المعادة يعاد عدد صحيح يمثِّل الجزء الكبير (major part) من rdev، أو تعاد القيمة nil. أمثلة مثال على استعمال التابع rdev_major: File.stat("/dev/fd1").rdev_major #=> 2 File.stat("/dev/tty").rdev_major #=> 5 انظر أيضًا التابع dev_major: يعيد عددًا صحيحًا يمثِّل الجزء الكبير (major part) من dev، أو يعيد القيمة nil. التابع rdev: يعيد عددًا صحيحًا يمثِّل نوع الجهاز الذي يتواجد فيه ...

يعيد التابع dev_major عددًا صحيحًا يمثِّل الجزء الكبير (major part) من dev، أو يعيد القيمة nil. البنية العامة dev_major → integer القيمة المعادة يعاد عدد صحيح يمثِّل الجزء الكبير (major part) من dev، أو تعاد القيمة nil. أمثلة مثال على استعمال التابع dev_major: File.stat("/dev/fd1").dev_major #=> 2 File.stat("/dev/tty").dev_major #=> 5 انظر أيضًا التابع dev: يعيد عددًا صحيحًا يمثِّل الجهاز الذي يتواجد فيه الكائن File::Stat الذي استدعي معه. التابع dev_minor: يعيد عددًا صحيحًا يمثِّل الجزء الصغير (minor part) من dev، ...

يعيد التابع dev_minor عددًا صحيحًا يمثِّل الجزء الصغير (minor part) من dev، أو يعيد القيمة nil. البنية العامة dev_minor → integer القيمة المعادة يعاد عدد صحيح يمثِّل الجزء الصغير (minor part) من dev، أو تعاد القيمة nil. أمثلة مثال على استعمال التابع dev_minor: File.stat("/dev/fd1").dev_minor #=> 1 File.stat("/dev/tty").dev_minor #=> 0 انظر أيضا التابع dev: يعيد عددًا صحيحًا يمثِّل الجهاز الذي يتواجد فيه الكائن File::Stat الذي استدعي معه. التابع dev_major: يعيد عددًا صحيحًا يمثِّل الجزء الكبير (major part) من dev، ...

يعيد التابع rdev_minor عددًا صحيحًا يمثِّل الجزء الصغير (minor part) من rdev، أو يعيد القيمة nil. البنية العامة rdev_minor → integer القيمة المعادة يعاد عدد صحيح يمثِّل الجزء الصغير (minor part) من rdev، أو تعاد القيمة nil. أمثلة مثال على استعمال التابع rdev_minor: File.stat("/dev/fd1").rdev_minor #=> 1 File.stat("/dev/tty").rdev_minor #=> 0 انظر أيضًا التابع dev_minor: يعيد عددًا صحيحًا يمثِّل الجزء الصغير (minor part) من dev، أو يعيد القيمة nil. التابع rdev: يعيد عددًا صحيحًا يمثِّل نوع الجهاز الذي يتواجد فيه ...

يعيد التابع birthtime وقت إنشاء الملف الذي استدعي معه. إن لم تكن المنصة المستعملة تدعم تسجيل وقت الإنشاء، فسيُرمَى الاستثناء NotImplementedError. البنية العامة birthtime → aTime القيمة المعادة يعاد كائن من النوع Time يمثِّل الزمن الذي أُنشئ فيه الملف المعطى.  أمثلة مثال على استعمال التابع birthtime: File.write("testfile", "foo") sleep 10 File.write("testfile", "bar") sleep 10 File.chmod(0644, "testfile") sleep 10 File.read("testfile") File.stat("testfile").birthtime #=> 2014-02-24 11:19:17 +0900 File.stat("testfile").mtime #=> 2014-02-24 11:19:27 +0900 File.stat("testfile").ctime #=> 2014-02-24 11:19:37 +0900 File.stat("testfile").atime ...

يتحقق التابع chardev?‎ إن كان ملفٌ ما هو جهاز محرفي (character device). البنية العامة chardev? → true or false القيمة المعادة تعاد القيمة true إن كان الملف المعطى هو جهاز محرفي (character device)، أو تعاد القيمة false إن لم يكن الملف جهازًا كتليًّا أو لم تكن منصة التشغيل تدعم هذه الميزة. أمثلة مثال على استعمال التابع chardev?‎: File.stat("/dev/tty").chardev? #=> true انظر أيضا التابع blockdev?‎: يتحقق إن كان ملفٌ ما هو جهاز كتلي (block device). مصادر قسم التابع chardev?‎ في الصنف File::Stat في توثيق روبي ...

يتحقق التابع blockdev?‎ إن كان ملفٌ ما هو جهاز كتلي (block device). البنية العامة blockdev? → true or false القيمة المعادة تعاد القيمة true إن كان الملف المعطى هو جهاز كتلي (block device)، أو تعاد القيمة false إن لم يكن الملف جهازًا كتليًّا أو لم تكن منصة التشغيل تدعم هذه الميزة. أمثلة مثال على استعمال التابع blockdev?‎: File.stat("testfile").blockdev? #=> false File.stat("/dev/hda1").blockdev? #=> true انظر أيضا التابع chardev?‎: يتحقق إن كان ملفٌ ما هو جهاز محرفي (character device). مصادر قسم التابع blockdev?‎ في ...

يعيد التابع blocks عدد كتل نظام الملفات المحجوزة للملف الذي استدعي معه. البنية العامة blocks → integer or nil القيمة المعادة يعاد عدد صحيح يمثِّل عدد كتل نظام الملفات المحجوزة للملف المعطى، أو تعاد القيمة nil إن لم يكن نظام التشغيل يدعم هذه الميزة. أمثلة مثال على استعمال التابع blocks: File.stat("testfile").blocks #=> 2 انظر أيضا التابع birthtime: يعيد وقت إنشاء الملف الذي استدعي معه. التابع blksize: يعيد حجم كتلة نظام الملفات الأساسي. مصادر قسم التابع blocks في الصنف File::Stat ...

يعيد التابع blksize حجم كتلة نظام الملفات الأساسي. البنية العامة blksize → integer or nil القيمة المعادة يعاد عدد صحيح يمثِّل حجم كتلة نظام الملفات الأساسي، أو تعاد القيمة nil إن لم تكن منصة التشغيل تدعم توريد هذه المعلومات. أمثلة مثال على استعمال التابع blksize: File.stat("testfile").blksize #=> 4096 انظر أيضا التابع atime: يعيد زمن آخر وصول إلى الملف الذي استدعي معه. التابع blocks: يعيد عدد كتل نظام الملفات المحجوزة للملف الذي استدعي معه. مصادر قسم التابع blksize في الصنف ...

يُعرّف الصنف stat ثوابت وتوابع لمعالجة نتيجة استدعاء التوابع os.stat()‎وos.fstat‎‎()‎  وos.lstat()‎ وكذلك بطبيعة الحال فهو يعالج نتائج التابع Path.stat‎()‎، ولا يتم إنشاء كائنات منه، فجميع التوابع والثوابت يمكن الوصول إليها مباشرة من الصنف. توابع الصنف stat لكشف نوع الملفات التابع stat.S_ISDIR للكشف عن كون النمط مشيرًا إلى مجلد. التابع stat.S_ISCHR للكشف عن كون النمط مشيرًا إلى ملف character special device. التابع stat.S_ISBLK للكشف عن كون النمط مشيرًا إلى ملف block special device. التابع stat.S_ISREG للكشف عن كون النمط مشيرًا إلى ...

التابع Path.is_fileفي بايثون يحدد هذا التابع فيما إذا كان المسار يشير إلى مجلد أو إلى غيره، وذلك باستخدامه للتابع stat ثم تمرير العنصر st_mode إلى التابع S_ISDIR من الوحدة stat، ويمكن رؤية ذلك ضمنالشيفرة المصدرية للمكتبة في السطر التالي: return S_ISREG(self.stat().st_mode) البنية العامة is_file() المعاملات بدون معاملات القيمة المعادة يعيد هذا التابع القيمة المنطقية True إذا كان المسار يشير إلى ملف نظامي(أو إلى اختصار يشير إلى ملف نظامي)، بينما يعيد False في حال كان المسار يشير إلى أي نوع آخر من الملفات. كما أنه يعيد False إذا كان ...

أمثلة يوضح المثال التالي الطريقة المُثلى للاستفادة من توابع الكشف في الصنف stat: import os, sys from stat import * def walktree(top, callback): '''recursively descend the directory tree rooted at top, calling the callback function for each regular file''' for f in os.listdir(top): pathname = os.path.join(top, f) mode = os.stat(pathname).st_mode ...

يعيد التابع stat كائنًا من النوع File::Stat للملف المحدَّد. اطلع على توثيق الصنف File::Stat لمزيد من المعلومات. البنية العامة stat(file_name) → stat المعاملات file_name سلسلة نصية أو كائن من النوع IO يمثِّل اسم الملف الذي ستُطبَّق عليه العملية. القيمة المعادة يعاد كائنٌ من النوع File::Stat للملف file_name. أمثلة مثال على استعمال التابع stat: File.stat("testfile").mtime #=> Tue Apr 08 12:58:04 CDT 2003 انظر أيضا التابع lstat: يشبه التابع stat باستثناء أنَّه لا يتبع الوصلات الرمزية (أي أنَّه يعيد كائنًا من ...

يشبه التابع lstat التابع stat باستثناء أنَّه لا يتبع الوصلات الرمزية (أي أنَّه يعيد كائنًا من النوع File::Stat للوصلة نفسها وليس للملف الذي تشير إليه). البنية العامة lstat(file_name) → stat المعاملات file_name سلسلة نصية أو كائن من النوع IO يمثِّل اسم الملف الذي ستُطبَّق عليه العملية. القيمة المعادة يعاد كائنٌ من النوع File::Stat للملف file_name نفسه سواءً أكان ملفًا أو وصلةً رمزيةً. أمثلة مثال على استعمال التابع lstat: File.symlink("testfile", "link2test") #=> 0 File.stat("testfile").size ...

يشبه التابع lstat التابع IO.stat باستثناء أنَّه لا يتبع الوصلات الرمزية (أي أنَّه يعيد كائنًا من النوع File::Stat للوصلة نفسها وليس للملف الذي تشير إليه). البنية العامة lstat → stat القيمة المعادة يعاد كائنٌ من النوع File::Stat للملف file_name نفسه سواءً أكان ملفًا أو وصلةً رمزيةً. أمثلة مثال على استعمال التابع lstat: File.symlink("testfile", "link2test") #=> 0 File.stat("testfile").size #=> 66 f = File.new("link2test") f.lstat.size ...

يُعيد التابع stat معلومات حالة المجرى الذي استُدعي معه على هيئة كائن من النوع File::Stat. البنية العامة stat → stat‎ القيمة المعادة يعاد كائن File::Stat يصف حالة المجرى المعطى. أمثلة مثال على استخدام التابع stat‎: f = File.new("testfile") s = f.stat "%o" % s.mode #=> "100644" s.blksize #=> 4096 s.atime #=> Wed Apr 09 08:53:54 CDT 2003‎ انظر أيضًا التابع inspect: يُعيد سلسلة نصية تصف المجرى الذي استُدعي معه. ...

يقفل التابع flock الملف الذي استدعي معه أو يلغي القفل الذي طُبِّق عليه لحماية الملف أثناء إجراء عمليَّة عليه (مثل القراءة منه أو الكتابة عليه) إشارةً إلى أنَّ هذا الملف يُستعمل الآن. هذا التابع غير متاح على جميع المنصات. البنية العامة flock(locking_constant) → 0 or false المعاملات locking_constant قيمة هذا المعامل هي أحد العمليات التالية: العمليَّة الوصف LOCK_SH طلب الحصول على قفل مشاركة (shared lock، عند القراءة). تستطيع أكثر من عملية تطبيق هذا القفل على الملف المعطى في الوقت نفسه. LOCK_EX ...

(PHP 4, PHP 5, PHP 7) تعيد الدالة stat()‎ معلومات عن ملف محدَّد. الوصف array stat ( string $filename ) تجمع هذه الدالة بعض المعلومات الإحصائيَّة عن الملف filename. إن كان الملف filename وصلة رمزيَّة، فستعاد معلومات إحصائيَّة عن الملف ذاته الذي تشير إليه الوصلة وليست عن الوصلة الرمزيَّة تلك. الدالة lstat()‎ مطابقة تمامًا للدالة stat()‎ باستثناء أنَّها تعيد معلومات إحصائيَّة عن الوصلات الرمزيَّة أيضًا. المعاملات filename مسار الملف المراد جلب معلومات عنه. القيم المعادة يوضِّح الجدول التالي تنسيق المصفوفة التي ...

يُعيد التابع sync قيمة راية وضع المزامنة (sync mode) للمجرى الذي استدعي معه. عندما تساوي قيمة وضع المزامنة القيمة true، فسيتم إرسال كل المخرجات مباشرةً إلى نظام التشغيل، ولن يُخزّن مؤقتًا في ذاكرة التخزين المؤقتة الداخلية لروبي. البنية العامة sync → true or false‎ القيمة المعادة تعاد قيمة منطقية تمثِّل قيمة راية وضع المزامنة للمجرى المعطى. أمثلة مثال على استخدام التابع sync‎: f = File.new("testfile") f.sync #=> false‎ انظر أيضًا التابع fsync: يكتب مباشرةً جميع البيانات المخزنة في المجرى الذي استدعي معه ...

يتحقق التابع world_writable?‎ إن كان ملفٌ ما قابلًا للكتابة من طرف الآخرين. البنية العامة world_writable?(file_name) → integer or nil المعاملات file_name اسم الملف المراد التحقق منه. يمكن أن يكون هذا المعامل كائنًا من النوع IO. القيمة المعادة يعاد عدد صحيح يمثِّل بتات أذونات الملف file_name إن كان قابلًا للكتابة من طرف الآخرين. خلا ذلك، تعاد القيمة nil. تعتمد بتات الأذونات المعادة على المنصة المستعملة. اطلع على الدالة stat(2)‎ في المنصات الشبيهة بيونكس.  أمثلة مثال على استعمال التابع world_writable?‎: File.world_writable?("/tmp") ...

يتحقق التابع exist?‎ إن كان ملفٌ ما موجودًا. "الملف موجود" يعني أنه نجح استدعاء دالتي النظام stat()‎ و fstat()‎. البنية العامة exist?(file_name) → true or false المعاملات file_name سلسلة نصية أو كائن من النوع IO يحدِّد اسم الملف المراد التحقق منه. القيمة المعادة تعاد القيمة true إن كان الملف file_name موجودًا. خلا ذلك، تعاد القيمة false. انظر أيضا التابع directory?‎: يتحقق إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ. التابع zero?‎: يتحقق إن كان ملفٌ ما موجودًا وخاويًا ...

يتحقق التابع world_writable?‎ إن كان ملفٌ ما قابلًا للكتابة من طرف الآخرين. البنية العامة world_writable?(file_name) → integer or nil المعاملات file_name اسم الملف المراد التحقق منه. يمكن أن يكون هذا المعامل كائنًا من النوع IO. القيمة المعادة يعاد عدد صحيح يمثِّل بتات أذونات الملف file_name إن كان قابلًا للكتابة من طرف الآخرين. خلا ذلك، تعاد القيمة nil. تعتمد بتات الأذونات المعادة على المنصة المستعملة. اطلع على الدالة stat(2)‎ في المنصات الشبيهة بيونكس. أمثلة مثال على استعمال التابع world_writable?‎: File.world_writable?("/tmp") ...

يتحقق التابع exist?‎ إن كان ملفٌ ما موجودًا. "الملف موجود" يعني أنه نجح استدعاء دالتي النظام stat()‎ و fstat()‎. البنية العامة exist?(file_name) → true or false المعاملات file_name سلسلة نصية أو كائن من النوع IO يمثِّل الملف المراد التحقق منه. القيمة المعادة تعاد القيمة true إن كان الملف file_name موجودًا. خلا ذلك، تعاد القيمة false. انظر أيضًا التابع directory?‎: يتحقق إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ. التابع executable?‎: يتحقق إن كان ملفٌ ما قابلًا للتنفيذ من طرف المعرِّف الفعلي للمستخدم المالك والمجموعة المالكة للعملية الحالية. التابع executable_real?‎: يتحقق إن كان ...

عناصر <input> ذات النوع file تسمح للمستخدم باختيار ملف أو أكثر لرفعها إلى الخادوم أو تعديلها باستخدام الواجهة البرمجية File. الخاصية value تحتوي الخاصية value في الحقل file على سلسلة نصية (DOMString) التي تُمثِّل المسار إلى الملف (أو الملفات) المختارة. بعض الأمور التي عليك أن تضعها بالحسبان: إذا تم اختيار عدِّة ملفات، فقيمة الخاصية value ستُمثِّل أوّل ملف مختار، لكن يمكن الوصول إلى الملفات الأخرى عبر الخاصية FileList في DOM التابعة للعنصر <input>. إذا لم يتم اختيار ملف بعد، فستكون ...

يتحقق التابع world_readable?‎ إن كان ملفٌ ما قابلًا للقراءة من طرف الآخرين. البنية العامة world_readable?(file_name) → integer or nil المعاملات file_name اسم الملف المراد التحقق منه. يمكن أن يكون هذا المعامل كائنًا من النوع IO. القيمة المعادة يعاد عدد صحيح يمثِّل بتات أذونات الملف file_name إن كان قابلًا للقراءة من طرف الآخرين. خلا ذلك، تعاد القيمة nil. تعتمد بتات الأذونات المعادة على المنصة المستعملة. اطلع على الدالة stat(2)‎ في المنصات الشبيهة بيونكس. أمثلة مثال على استعمال التابع world_readable?‎: File.world_readable?("/etc/passwd") ...

يستخرج من النمط (mode) القسم القابل للتعديل باستخدام التابع os.chmod وهذه الخصائص هي: البتّات الخاصة بصلاحيات استخدام الملف وفي حال وجودها في نظام التشغيل المعمول عليه: البت اللاصق sticky bit البت الخاص set-group-id البت الخاص set-user-id

يدل هذا الثابت على معانٍ مختلفة، تعتمد على نوع الملف. فهو يمثل حجم الملف بالبيات للملفات العادية. أما بالنسبة لFIFO و sockets في معظم أنواع أنظمة يونكس (وخصوصًا في لينوكس)، فتمثل قيمة هذا الثابت عدد البايتات التي تنتظر القراءة في لحظة استدعاء التابع os.stat أو أشباهه. يُمكن لهذه القيمة أن تكون مفيدةً عند الحاجة إلى السحب من أحد هذه الملفات الخاصة بعد أن يتم فتح "non-blocking". ويختلف معنى هذا المتغير أيضًا بالنسبة لأجهزة block و character حسب نظام التشغيل الذي ...

عند وضع قيمة هذا البت لمجلد فهو يعني بأن الملفات ضمن هذا المجلد يُسمح بحذفها أو إعادة تسميتها فقط لمالكها أو مالك المجلد أو لعملية لها صلاحيات.

 التابع Path.stat يعيد معلومات عن المسار ، ويتم حساب المعلومات في كل مرة يتم فيها استدعاء التابع. وتجدر الإشارة إلى أن التابع هو نسخة طبق الأصل عن التابع os.stat حيث نجد الإسناد التالي stat = os.stat ضمن الشيفرة المصدرية للصنف pathlib. البنية العامة stat() المعاملات بدون معاملات القيمة المعادة يعيد معلومات عن المسار (مماثل للتابع os.stat) ، ويتم حساب المعلومات في كل مرة يتم فيها استدعاء التابع أمثلة يبين المثال التالي طريقة استخدام التابع: >>> Path.home()#سنستخدم المسار الرئيسي كمثال WindowsPath('D:/Downloads/WinPython/settings') >>> Path.home().stat() os.stat_result(st_mode=16895, ...

لهذا البت العديد من الاستخدامات الخاصة، بالنسبة للمجلدات، فهو يشير إلى أن دلالات BSD ستُستخدم لهذا المجلد، حيث ترث الملفات المنشأة فيه معرف المجموعة الخاص بها من هذا المجلد وليس من معرف المجموعة الفعال الخاص بالعملية التي أنشأت الملف، وكذلك تأخذ المجلدات المنشأة بداخله نفس قيمة البت S_ISGID الخاصة به. بالنسبة لملف لم يتم وضع قيمة بت تنفيذ المجموعة S_IXGRP له فإن بت set-group-ID فيه يدل على قفل إجباري للملف أو السجل (انظر أيضًا S_ENFMT).

يمثل هذا المتغير في بعض الأنظمة ( مثل يونكس) الوقت الذي عُدلت فيه البيانات الإضافية metadata، بينما يمثل في أنظمة أخرى (مثل ويندوز) وقت إنشاء الملف، ويجب مراجعة وثائق المنصة لللمزيد من التفاصيل.

يشترك هذا البت مع البت S_ISGID: يُقفل الملف/السجل إجباريًّا إن لم يكن قد تم وضع بت تنفيذ المجموعة S_IXGRP له.

توفر الوحدة File::Constants ثوابت متعلقة بالملفات في روبي. جميع ثوابت الملفات المحتملة موثَّقة هنا ولكن ليس بالضرورة أن تكون كلها متاحة على منصتك. إن كانت المنصة الأساسية لا تعرِّف ثابتًا ما، فلن يُعرَّف ثابت روبي المقابل له. قد تجد بعض المعلومات المفيدة في توثيقات المنصة التي تعمل عليها (مثل الدليل man للدالة open(2)‎). الثوابت APPEND الإضافة عند كل عملية كتابة. BINARY تعطيل تحويل الشيفرة السطري. CREAT إنشاء ملف إن لم يكن موجودًا. DIRECT محاولة تصغير ثأتيرات الذاكرة المخبَّأة (cache) للدخل ...

تجري الوحدة FileTest عمليات تحقق على الملف بشكل مشابه لتلك الموجودة في الوحدة File::Stat. هذه الوحدة موجودة على أنَّها وحدةٌ مستقلةٌ، وتوبعها تُعدُّ مرجعًا إلى الصنف File. (انتبه إلى أنَّ هذا لا ينفَّذ عبر التضمين [inclusion]، إذ هي إحدى خدع المفسِّر.) توابع النسخة العامة blockdev?‎ يتحقق إن كان ملفٌ ما هو جهاز كتلي (block device). chardev?‎ يتحقق إن كان ملفٌ ما هو جهاز محرفي (character device). directory?‎ يتحقق إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ. executable?‎ ...

يعيد التابع stat كائنًا من النوع Hash يحوي عدادات مُخصصة (implementation-dependent counters) داخل الآلة الافتراضية (VM). يتضمن الكائن Hash معلومات حول تسلسلات ذاكرة التخزين المؤقت (cache serials) الخاصة بالتوابع والثوابت مثل: { :global_method_state=>251, :global_constant_state=>481, :class_serial=>9029 }‎ تقديم (implementation) محتويات الكائن Hash مخصوصة، ويمكن أن تتغير مع مرور الوقت. لا يُتوقّع أن يعمل هذا التابع إلا على على C Ruby. البنية العامة stat → Hash stat(hsh) → hsh stat(Symbol) → Numeric‎ القيمة المعادة يعاد كائن من النوع Hash يحوي عدادات مُخصصة داخل ...

يجري المعامل & العملية AND المنطقية لبِتَّات الحالة stat مع قيمة محدَّدة. البنية العامة stat & num → integer المعاملات stat عددٌ صحيح يمثِّل حالة العمليَّة stat. num القيمة المراد تطبيق العملية AND عليها مع المعامل stat. القيم المعادة يُعاد عددٌ صحيحٌ ناتج عن تطبيق عملية الجمع المنطقي بين المعاملين stat و num. أمثلة مثالٌ عن استخدام المعامل &: fork { exit 0x37 } Process.wait sprintf('%04x', $?.to_i) #=> "3700" sprintf('%04x', $? & 0x1e00) #=> "1600" ...

يجري المعامل & العملية AND المنطقية لبِتَّات الحالة stat مع قيمة محدَّدة. البنية العامة stat & num → integer المعاملات stat عددٌ صحيح يمثِّل حالة العمليَّة stat. num القيمة المراد تطبيق العملية AND عليها مع المعامل stat. القيم المعادة يُعاد عددٌ صحيحٌ ناتج عن تطبيق عملية الجمع المنطقي بين المعاملين stat و num. أمثلة مثالٌ عن استخدام المعامل &: fork { exit 0x37 } Process.wait sprintf('%04x', $?.to_i) #=> "3700" sprintf('%04x', $? & 0x1e00) #=> "1600" ...

تُغلِّف الوحدة Process::Status معلومات عن حالة عملية النظام النشطة أو المنتهية. يكون المتغيِّر ‎$?‎ المُضمَّن إمّا مساويًا للقيمة nil أو يكون كائنًا للوحدة Process::Status. fork { exit 99 } #=> 26557 Process.wait #=> 26557 $?.class #=> Process::Status $?.to_i #=> 25344 $? >> 8 #=> ...

تُغلِّف الوحدة Process::Status معلومات عن حالة عملية النظام النشطة أو المنتهية. يكون المتغيِّر ‎$?‎ المُضمَّن إمّا مساويًا للقيمة nil أو يكون كائنًا للوحدة Process::Status. fork { exit 99 } #=> 26557 Process.wait #=> 26557 $?.class #=> Process::Status $?.to_i #=> 25344 $? >> 8 #=> ...

يعيد التابع stat جدول Hash يحتوي على معلومات حول GC. ومن المتوقع أن يعمل هذا التابع فقط علي روبي C. البنية العامة stat → Hash stat(hash) → hash stat(:key) → Numeric القيمة المعادة يعاد جدول Hash يحوي معلومات حول GC. يتضمن الجدول معلومات حول الإحصائيات الداخلية حول GC مثل: { :count=>0, :heap_allocated_pages=>24, :heap_sorted_length=>24, :heap_allocatable_pages=>0, :heap_available_slots=>9783, :heap_live_slots=>7713, :heap_free_slots=>2070, :heap_final_slots=>0, ...

يزيح المعامل << بِتَّات قيمة الحالة stat إلى اليمين عددًا محدَّدًا من المنازل. البنية العامة stat >> num → integer المعاملات stat عدد صحيح يمثِّل الحالة stat. num عدد مواضع إزاحة بتات القيمة stat إلى اليمين. القيم المعادة يعاد عدد صحيح ناتجٌ عن إزاحة بتات المعامل stat إلى اليمين بمقدار num من المنازل. أمثلة مثالٌ عن استخدام التابع <<: fork { exit 99 } #=> 26563 Process.wait #=> 26563 $?.to_i ...

يزيح المعامل << بِتَّات قيمة الحالة stat إلى اليمين عددًا محدَّدًا من المنازل. البنية العامة stat >> num → integer المعاملات stat عدد صحيح يمثِّل الحالة stat. num عدد مواضع إزاحة بتات القيمة stat إلى اليمين. القيم المعادة يعاد عدد صحيح ناتجٌ عن إزاحة بتات المعامل stat إلى اليمين بمقدار num من المنازل. أمثلة مثالٌ عن استخدام التابع <<: fork { exit 99 } #=> 26563 Process.wait #=> 26563 $?.to_i ...

يتحقَّق المعامل == إذا كان قيمة الحالة stat مساويةً لقيمة عددية محدَّدة. البنية العامة stat == other → true or false المعاملات stat عددٌ صحيحٌ يمثل حالة العمليَّة الأولى. other عددٌ صحيحٌ يمثل حالة العمليَّة الأخرى المراد التحقق من تساويها مع العمليَّة الأولى. القيم المعادة تُعاد القيمة true إذا تساوت قيمتي الحالتين stat و other؛ خلاف ذلك، تُعاد القيمة false. انظر أيضًا المعامل &: يجري العملية AND المنطقية لبِتَّات الحالة stat مع قيمة محدَّدة. المعامل <<: يزيح بِتَّات قيمة الحالة ...

يتحقَّق المعامل == إذا كان قيمة الحالة stat مساويةً لقيمة عددية محدَّدة. البنية العامة stat == other → true or false المعاملات stat عددٌ صحيحٌ يمثل حالة العمليَّة الأولى. other عددٌ صحيحٌ يمثل حالة العمليَّة الأخرى المراد التحقق من تساويها مع العمليَّة الأولى. القيم المعادة تُعاد القيمة true إذا تساوت قيمتي الحالتين stat و other؛ خلاف ذلك، تُعاد القيمة false. انظر أيضًا المعامل &: يجري العملية AND المنطقية لبِتَّات الحالة stat مع قيمة محدَّدة. المعامل <<: يزيح بِتَّات قيمة الحالة ...

يتحقَّق التابع ?signaled إذا كانت الحالة stat للعملية تشير إلى أنَّها أُنهيت بسبب إشارةٍ غير ملتقطة (uncaught signal). البنية العامة signaled? → true or false القيم المعادة تُعاد القيمة true إذا كانت الحالة stat للعملية المعطاة تشير إلى أنَّها قد أُنهيت بسبب إشارةٍ غير ملتقطة؛ خلاف ذلك، تُعاد القيمة false. انظر أيضًا التابع ?coredump: يتحقَّق إذا كانت حالة العمليَّة قد ولَّدت تفريغًا للذاكرة عندما أُنهيت. التابع ?exited: يتحقَّق إذا كانت حالة العمليَّة stat قد أُنهيَت بشكلٍ طبيعي. التابع ?stopped: يتحقَّق ...

يتحقَّق التابع ?exited إذا كانت حالة العمليَّة stat قد أُنهيَت بشكلٍ طبيعي (مثل استخدام الاستدعاء ()exit لإنهاء البرنامج). البنية العامة exited? → true or false القيم المعادة تُعاد القيمة true إذا أُنهيَت الحالة stat  للعملية بشكلٍ طبيعي، خلاف ذلك تُعاد القيمة false. انظر أيضًا التابع ?coredump: يتحقَّق إذا كانت حالة العمليَّة قد ولَّدت تفريغًا للذاكرة عندما أُنهيت. التابع ?signaled: يتحقَّق إذا كانت الحالة stat للعملية تشير إلى أنَّها أُنهيت بسبب إشارةٍ غير ملتقطة. التابع ?stopped: يتحقَّق إذا كانت العمليَّة قد ...

يتحقَّق التابع ?signaled إذا كانت الحالة stat للعملية تشير إلى أنَّها أُنهيت بسبب إشارةٍ غير ملتقطة (uncaught signal). البنية العامة signaled? → true or false القيم المعادة تُعاد القيمة true إذا كانت الحالة stat للعملية المعطاة تشير إلى أنَّها قد أُنهيت بسبب إشارةٍ غير ملتقطة؛ خلاف ذلك، تُعاد القيمة false. انظر أيضًا التابع ?coredump: يتحقَّق إذا كانت حالة العمليَّة قد ولَّدت تفريغًا للذاكرة عندما أُنهيت. التابع ?exited: يتحقَّق إذا كانت حالة العمليَّة stat قد أُنهيَت بشكلٍ طبيعي. التابع ?stopped: يتحقَّق ...

يتحقَّق التابع ?exited إذا كانت حالة العمليَّة stat قد أُنهيَت بشكلٍ طبيعي (مثل استخدام الاستدعاء ()exit لإنهاء البرنامج). البنية العامة exited? → true or false القيم المعادة تُعاد القيمة true إذا أُنهيَت الحالة stat  للعملية بشكلٍ طبيعي، خلاف ذلك تُعاد القيمة false. انظر أيضًا التابع ?coredump: يتحقَّق إذا كانت حالة العمليَّة قد ولَّدت تفريغًا للذاكرة عندما أُنهيت. التابع ?signaled: يتحقَّق إذا كانت الحالة stat للعملية تشير إلى أنَّها أُنهيت بسبب إشارةٍ غير ملتقطة. التابع ?stopped: يتحقَّق إذا كانت العمليَّة قد ...

(PHP 4, PHP 5, PHP 7) تقرأ الدالة file()‎ الملف ثمَّ تضع كلَّ محتوياته في مصفوفة. الوصف array file ( string $filename [, int $flags = 0 [, resource $context]] ) تعيد هذه الدالة مصفوفة تضم كلَّ محتويات الملف filename. ملاحظة: يمكنك استعمال الدالة file_get_contents()‎ لجلب كلِّ محتويات الملف ووضعها في سلسلة نصيَّة عوضًا عن مصفوفة. المعاملات filename اسم الملف المراد جلب محتوياته. فائدة: يمكن استعمال عنوان URL عوضًا عن اسم الملف مع المعامل filename شرط أن يُفعَّل الضبط "fopen wrapper". ...

يتحقَّق التابع ?coredump إذا كانت حالة العمليَّة قد ولَّدت تفريغًا للذاكرة (core dump أو memory dump) عندما أُنهيت. هذا التابع غيرُ متاحٍ على جميع المنصَّات. البنية العامة coredump? → true or false القيم المعادة تُعاد القيمة true إذا ولَّدت حالة العملية stat تفريغًا للذاكرة عند إنهاء أو مقاطعة العمليَّة؛ خلاف ذلك، تُعاد القيمة false. انظر أيضًا التابع ?exited: يتحقَّق إذا كانت حالة العمليَّة stat قد أُنهيَت بشكلٍ طبيعي. التابع ?signaled: يتحقَّق إذا كانت الحالة stat للعملية تشير إلى أنَّها أُنهيت ...

يتحقَّق التابع ?coredump إذا كانت حالة العمليَّة قد ولَّدت تفريغًا للذاكرة (core dump أو memory dump) عندما أُنهيت. هذا التابع غيرُ متاحٍ على جميع المنصَّات. البنية العامة coredump? → true or false القيم المعادة تُعاد القيمة true إذا ولَّدت حالة العملية stat تفريغًا للذاكرة عند إنهاء أو مقاطعة العمليَّة؛ خلاف ذلك، تُعاد القيمة false. انظر أيضًا التابع ?exited: يتحقَّق إذا كانت حالة العمليَّة stat قد أُنهيَت بشكلٍ طبيعي. التابع ?signaled: يتحقَّق إذا كانت الحالة stat للعملية تشير إلى أنَّها أُنهيت ...

يُعيد التابع pid معرِّف العملية (process ID) الذي يمثِّله كائن حالة stat محدَّد. البنية العامة pid → integer القيم المعادة يُعاد معرِّف العملية لكائن الحالة stat المعطى. أمثلة مثالٌ عن استخدام التابع pid: fork { exit } #=> 26569 Process.wait #=> 26569 $?.pid #=> 26569 انظر أيضًا التابع exitstatus: يُعيد البِتَّات الثمانية الأقل أهمية للقيمة التي تعيدها الشيفرة وتخرج بها من الحالة stat. التابع stopsig: يُعيد عدد الإشارات ...

يُعيد التابع pid معرِّف العملية (process ID) الذي يمثِّله كائن حالة stat محدَّد. البنية العامة pid → integer القيم المعادة يُعاد معرِّف العملية لكائن الحالة stat المعطى. أمثلة مثالٌ عن استخدام التابع pid: fork { exit } #=> 26569 Process.wait #=> 26569 $?.pid #=> 26569 انظر أيضًا التابع exitstatus: يُعيد البِتَّات الثمانية الأقل أهمية للقيمة التي تعيدها الشيفرة وتخرج بها من الحالة stat. التابع stopsig: يُعيد عدد الإشارات ...

يُعيد التابع to_i بِتَّات حالة العمليَّة stat على شكل عددٍ صحيح. البحث في وجلب معلوماتٍ من هذه البِتَّات يعتمد على المنصَّة. البنية العامة to_i → integer to_int → integer القيم المعادة يُعاد عددٌ صحيحٌ يمثِّل بِتَّات حالة العمليَّة stat. أمثلة مثالٌ عن استخدام التابع to_i: fork { exit 0xab } #=> 26566 Process.wait #=> 26566 sprintf('%04x', $?.to_i) #=> "ab00" ...

يُعيد التابع to_i بِتَّات حالة العمليَّة stat على شكل عددٍ صحيح. البحث في وجلب معلوماتٍ من هذه البِتَّات يعتمد على المنصَّة. البنية العامة to_i → integer to_int → integer القيم المعادة يُعاد عددٌ صحيحٌ يمثِّل بِتَّات حالة العمليَّة stat. أمثلة مثالٌ عن استخدام التابع to_i: fork { exit 0xab } #=> 26566 Process.wait #=> 26566 sprintf('%04x', $?.to_i) #=> "ab00" ...

يُعيد التابع exitstatus البِتَّات الثمانية الأقل أهمية للقيمة التي تعيدها الشيفرة وتخرج بها من الحالة stat. يمكن استدعاء هذا التابع إذا أعطى التابع ?exited القيمة true فقط. البنية العامة exitstatus → integer or nil القيم المعادة يُعاد عددٌ صحيحٌ يمثِّل البِتَّات الثمانية الأقل أهمية للقيمة التي تعيدها الشيفرة وتخرج بها من الحالة stat، أو تُعاد القيمة العدميَّة nil. أمثلة مثالٌ عن استخدام التابع exitstatus: fork { } #=> 26572 Process.wait ...

يُعيد التابع exitstatus البِتَّات الثمانية الأقل أهمية للقيمة التي تعيدها الشيفرة وتخرج بها من الحالة stat. يمكن استدعاء هذا التابع إذا أعطى التابع ?exited القيمة true فقط. البنية العامة exitstatus → integer or nil القيم المعادة يُعاد عددٌ صحيحٌ يمثِّل البِتَّات الثمانية الأقل أهمية للقيمة التي تعيدها الشيفرة وتخرج بها من الحالة stat، أو تُعاد القيمة العدميَّة nil. أمثلة مثالٌ عن استخدام التابع exitstatus: fork { } #=> 26572 Process.wait ...

يتحقَّق التابع ?success إذا كانت حالة العملية stat تشير إلى أنَّها ناجحة. البنية العامة success? → true, false or nil القيم المعادة تُعاد القيمة true إذا كانت العمليَّة ناجحة، أو تُعاد القيمة  false إن لم تكن العملية ناجحة، أو تُعاد القيمة nil إذا لم يعيد التابع ?exited القيمة true. انظر أيضًا التابع ?coredump: يتحقَّق إذا كانت حالة العمليَّة قد ولَّدت تفريغًا للذاكرة عندما أُنهيت. التابع ?exited: يتحقَّق إذا كانت حالة العمليَّة stat قد أُنهيَت بشكلٍ طبيعي. التابع ?signaled: يتحقَّق إذا ...

يتحقَّق التابع ?success إذا كانت حالة العملية stat تشير إلى أنَّها ناجحة. البنية العامة success? → true, false or nil القيم المعادة تُعاد القيمة true إذا كانت العمليَّة ناجحة، أو تُعاد القيمة  false إن لم تكن العملية ناجحة، أو تُعاد القيمة nil إذا لم يعيد التابع ?exited القيمة true. انظر أيضًا التابع ?coredump: يتحقَّق إذا كانت حالة العمليَّة قد ولَّدت تفريغًا للذاكرة عندما أُنهيت. التابع ?exited: يتحقَّق إذا كانت حالة العمليَّة stat قد أُنهيَت بشكلٍ طبيعي. التابع ?signaled: يتحقَّق إذا ...

يتحقَّق التابع ?stopped إذا كانت العمليَّة قد أوقِفَت. يعيد التابع القيمة true فقط إذا ضُبطت الراية WUNTRACED في استدعاء wait الموافق. البنية العامة stopped? → true or false القيم المعادة تُعاد القيمة true إذا كان العمليَّة متوقِّفة، خلاف ذلك تُعاد القيمة false. انظر أيضًا التابع ?coredump: يتحقَّق إذا كانت حالة العمليَّة قد ولَّدت تفريغًا للذاكرة عندما أُنهيت. التابع ?exited: يتحقَّق إذا كانت حالة العمليَّة stat قد أُنهيَت بشكلٍ طبيعي. التابع ?signaled: يتحقَّق إذا كانت الحالة stat للعملية تشير إلى أنَّها ...

يتحقَّق التابع ?stopped إذا كانت العمليَّة قد أوقِفَت. يعيد التابع القيمة true فقط إذا ضُبطت الراية WUNTRACED في استدعاء wait الموافق. البنية العامة stopped? → true or false القيم المعادة تُعاد القيمة true إذا كان العمليَّة متوقِّفة، خلاف ذلك تُعاد القيمة false. انظر أيضًا التابع ?coredump: يتحقَّق إذا كانت حالة العمليَّة قد ولَّدت تفريغًا للذاكرة عندما أُنهيت. التابع ?exited: يتحقَّق إذا كانت حالة العمليَّة stat قد أُنهيَت بشكلٍ طبيعي. التابع ?signaled: يتحقَّق إذا كانت الحالة stat للعملية تشير إلى أنَّها ...

يُعيد التابع stat المعلومات الداخلية للمتعقب. المحتويات المعادة مُتعلقة بالتنفيذ (implementation). وقد تتغير في المستقبل. هذا التابع مخصوص بتصحيح (debugging) الصنف TracePoint نفسه. البنية العامة stat → obj‎ القيمة المعادة تعاد المعلومات الداخلية للمتعقب. انظر أيضًا التابع new: يُعيد متعقبًا جديدًا. التابع trace: ينشِّط التعقب تلقائيًا. مصادر قسم التابع stat‎ في الصنف TracePoint‎ في توثيق روبي الرسمي.

يُعيد التابع termsig عدد الإشارات التي تسبَّبت في إنهاء العمليَّة (أو القيمة nil إذا لم تنهَ العمليَّة بواسطة إشارة غير ملتقطة [uncaught signal]). البنية العامة termsig → integer or nil القيم المعادة يُعاد عدد الإشارات التي تسبَّبت في إنهاء العمليَّة، أو تُعاد القيمة nil إذا لم تنهَ العمليَّة بواسطة إشارة غير ملتقطة. انظر أيضًا التابع exitstatus: يُعيد البِتَّات الثمانية الأقل أهمية للقيمة التي تعيدها الشيفرة وتخرج بها من الحالة stat. التابع pid: يُعيد معرِّف العملية (process ID) الذي يمثِّله كائن ...