نتائج البحث

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

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

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

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

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

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

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

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

يعيد التابع 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: يعيد ...

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

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

يعيد التابع 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: يعيد عددًا صحيحًا يمثِّل نوع الجهاز الذي يتواجد فيه ...

يتحقق التابع 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?‎ في ...

يعيد التابع 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 ...

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

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

يتحقق التابع 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) ...

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

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

يتحقق التابع 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) ...

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

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

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

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

يعيد التابع 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 ...

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

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

يعيد التابع 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 المعطى. التابع ...

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

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

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

يعيد التابع 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، ...

يعيد التابع 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: يعرِّف نوع الملف ...

يعرِّف التابع 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?‎: يتحقق إن ...

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

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

يعيد التابع 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 المعطى. ...

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

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

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

يعيد التابع 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: يعيد عددًا صحيحًا يمثِّل نوع الجهاز الذي يتواجد فيه ...

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

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

يولد التابع 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, # ...

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

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

(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". ...

يوازن المعامل <=> بين الكائنات 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: ينشئ ...

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