الفرق بين المراجعتين ل"Ruby/File"
جميل-بيلوني (نقاش | مساهمات) (إضافة الصفحة) |
جميل-بيلوني (نقاش | مساهمات) (إضافة محتويات الصفحة.) |
||
| (مراجعة متوسطة واحدة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 1: | سطر 1: | ||
| − | الصنف <code>File</code> هو اختصار لأي كائن ملفٍ قابل | + | <noinclude>{{DISPLAYTITLE: الصنف <code>File</code> في روبي}}</noinclude> |
| + | الصنف <code>File</code> هو اختصار لأي كائن ملفٍ قابل للوصول عبر البرنامج ومرتبط عن كثب بالصنف <code>[[Ruby/IO|IO]]</code>. يتضمن الصنف <code>File</code> توابع الوحدة <code>[[Ruby/FileTest|FileTest]]</code> كتوابع صنفٍ مما يسمح لك باستعمال <code>[[Ruby/File/exists-3F|File.exist?("foo")]]</code> مثلًا. | ||
في شرح توابع الصنف <code>File</code> التالية، تكون بتات الأذونات (permission bits) مجموعة من البتات التي تعتمد على المنصة المستعملة والتي تشير إلى أذونات الملف. في الأنظمة الشبيهة بيونكس، تُعرض الأذونات على شكل مجموعة من ثلاثة ثمانيات (octets)؛ الأولى من أجل المالك، والثانية من أجل المجموعة المالكة، والثالثة تخص الأشخاص الآخرين. في كل واحدة من هذه الثمانية، يمكن ضبط الأذونات فيها إلى أذونات القراءة أو الكتابة أو التنفيذ للملف. | في شرح توابع الصنف <code>File</code> التالية، تكون بتات الأذونات (permission bits) مجموعة من البتات التي تعتمد على المنصة المستعملة والتي تشير إلى أذونات الملف. في الأنظمة الشبيهة بيونكس، تُعرض الأذونات على شكل مجموعة من ثلاثة ثمانيات (octets)؛ الأولى من أجل المالك، والثانية من أجل المجموعة المالكة، والثالثة تخص الأشخاص الآخرين. في كل واحدة من هذه الثمانية، يمكن ضبط الأذونات فيها إلى أذونات القراءة أو الكتابة أو التنفيذ للملف. | ||
| سطر 57: | سطر 58: | ||
===<code>[[Ruby/File/dirname|dirname]]</code>=== | ===<code>[[Ruby/File/dirname|dirname]]</code>=== | ||
يعيد جميع مكونات المسار المعطى لملفٍ باستثناء المكون الأخير (الاسم الأساسي [basename]) الذي يلي آخر فاصل في المسار. | يعيد جميع مكونات المسار المعطى لملفٍ باستثناء المكون الأخير (الاسم الأساسي [basename]) الذي يلي آخر فاصل في المسار. | ||
| − | |||
| − | |||
| − | |||
===<code>[[Ruby/File/executable-3F|executable?]]</code>=== | ===<code>[[Ruby/File/executable-3F|executable?]]</code>=== | ||
| سطر 89: | سطر 87: | ||
===<code>[[Ruby/File/ftype|ftype]]</code>=== | ===<code>[[Ruby/File/ftype|ftype]]</code>=== | ||
| − | يعرِّف | + | يعرِّف نوع الملف المعطى. |
===<code>[[Ruby/File/grpowned-3F|grpowned?]]</code>=== | ===<code>[[Ruby/File/grpowned-3F|grpowned?]]</code>=== | ||
| سطر 98: | سطر 96: | ||
===<code>[[Ruby/File/join|join]]</code>=== | ===<code>[[Ruby/File/join|join]]</code>=== | ||
| + | يعيد سلسلة نصية جديدة مكونة من جمع السلاسل النصية المُمرَّرة إليها باستعمال الفاصل "/". | ||
| + | |||
===<code>[[Ruby/File/lchmod|lchmod]]</code>=== | ===<code>[[Ruby/File/lchmod|lchmod]]</code>=== | ||
| + | يشبه التابع <code>[[Ruby/File/chmod|chmod]]</code> باستثناء أنه لا يتبع الوصلات الرمزية (أي أنه يغير أذونات الوصلة نفسها وليس الملف الذي تشير إليه). | ||
| + | |||
===<code>[[Ruby/File/lchown|lchown]]</code>=== | ===<code>[[Ruby/File/lchown|lchown]]</code>=== | ||
| + | يشبه التابع <code>[[Ruby/File/chown|chown]]</code> باستثناء أنه لا يتبع الوصلات الرمزية (أي أنه يغير المالك والمجموعة المالكة للوصلة نفسها وليس للملف الذي تشير إليه). | ||
| + | |||
===<code>[[Ruby/File/link|link]]</code>=== | ===<code>[[Ruby/File/link|link]]</code>=== | ||
| + | ينشئ اسمًا جديدًا لملف موجود باستعمال وصلة صلبة (hard link). | ||
| + | |||
===<code>[[Ruby/File/lstat|lstat]]</code>=== | ===<code>[[Ruby/File/lstat|lstat]]</code>=== | ||
| + | يشبه التابع <code>[[Ruby/File/stat|stat]]</code> باستثناء أنَّه لا يتبع الوصلات الرمزية (أي أنَّه يعيد كائنًا من النوع <code>[[Ruby/File::Stat|File::Stat]]</code> للوصلة نفسها وليس للملف الذي تشير إليه). | ||
| + | |||
===<code>[[Ruby/File/lutime|lutime]]</code>=== | ===<code>[[Ruby/File/lutime|lutime]]</code>=== | ||
| + | يعين وقتي الوصول والتعديل لملف أو ملفات محدَّدة. | ||
| + | |||
===<code>[[Ruby/File/mkfifo|mkfifo]]</code>=== | ===<code>[[Ruby/File/mkfifo|mkfifo]]</code>=== | ||
| + | ينشئ ملفًا خاصًّا من النوع "أنبوبة مسماة" (FIFO ويدعى أحيانًا named pipe) باسم وأذونات محدَّدة. | ||
| + | |||
===<code>[[Ruby/File/mtime|mtime]]</code>=== | ===<code>[[Ruby/File/mtime|mtime]]</code>=== | ||
| + | يعيد وقت التعديل للملف المحدَّد. | ||
| + | |||
===<code>[[Ruby/File/new|new]]</code>=== | ===<code>[[Ruby/File/new|new]]</code>=== | ||
| + | يفتح ملفًا محدَّدًا وبوضع معيَّن ثم يعيد كائنًا جديدًا من النوع <code>[[Ruby/File|File]]</code>. | ||
| + | |||
===<code>[[Ruby/File/open|open]]</code>=== | ===<code>[[Ruby/File/open|open]]</code>=== | ||
| + | يشبه التابع <code>[[Ruby/File/new|new]]</code> تمامًا إن لم تعطَ كتلة برمجية معه أو سيمُرَّر الملف بعد فتحه (الكائن <code>[[Ruby/File|File]]</code>) إلى الكتلة ثم سيُغلق تلقائيًّا عند انتهاء تنفيذ الكتلة. | ||
| + | |||
===<code>[[Ruby/File/owned-3F|owned?]]</code>=== | ===<code>[[Ruby/File/owned-3F|owned?]]</code>=== | ||
| + | يتحقق إن كان ملفٌ ما موجودًا وكان مالك هذا الملف هو نفسه المعرِّف الفعلي للمستخدم المالك للعملية التي استدعته. | ||
| + | |||
===<code>[[Ruby/File/path|path]]</code>=== | ===<code>[[Ruby/File/path|path]]</code>=== | ||
| + | يعيد سلسلة نصية تمثِّل المسار المعطى. | ||
| + | |||
===<code>[[Ruby/File/pipe-3F|pipe?]]</code>=== | ===<code>[[Ruby/File/pipe-3F|pipe?]]</code>=== | ||
| + | يتحقق إن كان ملفٌ ما أنبوبًا (pipe). | ||
| + | |||
===<code>[[Ruby/File/readable-3F|readable?]]</code>=== | ===<code>[[Ruby/File/readable-3F|readable?]]</code>=== | ||
| + | يتحقق إن كان ملفٌ ما قابلًا للقراءة من طرف مُعرِّف المستخدم والمجموعة الفعلي للعملية الحالية. | ||
| + | |||
===<code>[[Ruby/File/readable_real-3F|readable_real?]]</code>=== | ===<code>[[Ruby/File/readable_real-3F|readable_real?]]</code>=== | ||
| + | يتحقق إن كان ملفٌ ما قابلًا للقراءة من طرف مُعرِّف المستخدم والمجموعة الحقيقي للعملية الحالية. | ||
| + | |||
===<code>[[Ruby/File/readlink|readlink]]</code>=== | ===<code>[[Ruby/File/readlink|readlink]]</code>=== | ||
| + | يعيد اسم الملف الذي تشير إليه الوصلة المعطاة. | ||
| + | |||
===<code>[[Ruby/File/realdirpath|realdirpath]]</code>=== | ===<code>[[Ruby/File/realdirpath|realdirpath]]</code>=== | ||
| + | يعيد اسم المسار الحقيقي (المطلق) لمسارٍ ما في نظام الملفات الفعلي. | ||
| + | |||
===<code>[[Ruby/File/realpath|realpath]]</code>=== | ===<code>[[Ruby/File/realpath|realpath]]</code>=== | ||
| + | يعيد اسم المسار الحقيقي (المطلق) لمسارٍ ما في نظام الملفات الفعلي. | ||
| + | |||
===<code>[[Ruby/File/rename|rename]]</code>=== | ===<code>[[Ruby/File/rename|rename]]</code>=== | ||
| + | يعيد تسمية ملف محدَّد إلى اسم جديد. | ||
| + | |||
===<code>[[Ruby/File/setgid-3F|setgid?]]</code>=== | ===<code>[[Ruby/File/setgid-3F|setgid?]]</code>=== | ||
| + | يتحقق إن كان البت <code>setgid</code> (بت معرِّف المجموعة المالكة) مضبوطًا للملف المحدَّد. | ||
| + | |||
===<code>[[Ruby/File/setuid-3F|setuid?]]</code>=== | ===<code>[[Ruby/File/setuid-3F|setuid?]]</code>=== | ||
| + | يتحقق إن كان البت <code>setuid</code> (بت معرِّف المستخدم المالك) مضبوطًا للملف المحدَّد. | ||
| + | |||
===<code>[[Ruby/File/size|size]]</code>=== | ===<code>[[Ruby/File/size|size]]</code>=== | ||
| + | يعيد حجم الملف المحدَّد. | ||
| + | |||
===<code>[[Ruby/File/size-3F|size?]]</code>=== | ===<code>[[Ruby/File/size-3F|size?]]</code>=== | ||
| + | يتحقق إن كان ملفٌ ما غير موجود أو معدوم الحجم. | ||
| + | |||
===<code>[[Ruby/File/socket-3F|socket?]]</code>=== | ===<code>[[Ruby/File/socket-3F|socket?]]</code>=== | ||
| + | يتحقق إن كان ملفٌ ما مقبسًا. | ||
| + | |||
===<code>[[Ruby/File/split|split]]</code>=== | ===<code>[[Ruby/File/split|split]]</code>=== | ||
| + | يقتطع مسار الملف المُمرَّر إليه إلى جزأين: أحدهما لمجلد، والآخر للملف ثم يعيدهما في مصفوفة. | ||
| + | |||
===<code>[[Ruby/File/stat|stat]]</code>=== | ===<code>[[Ruby/File/stat|stat]]</code>=== | ||
| + | يعيد كائنًا من النوع <code>[[Ruby/File::Stat|File::Stat]]</code> للملف المحدَّد. | ||
| + | |||
===<code>[[Ruby/File/sticky-3F|sticky?]]</code>=== | ===<code>[[Ruby/File/sticky-3F|sticky?]]</code>=== | ||
| + | يتحقق إن كان ملفٌ ما قد ضُبِط فيه البت اللاصق (sticky bit). | ||
| + | |||
===<code>[[Ruby/File/symlink|symlink]]</code>=== | ===<code>[[Ruby/File/symlink|symlink]]</code>=== | ||
| + | ينشئ وصلةً رمزيةً باسم محدَّد لملف معيَّن موجود. | ||
| + | |||
===<code>[[Ruby/File/symlink-3F|symlink?]]</code>=== | ===<code>[[Ruby/File/symlink-3F|symlink?]]</code>=== | ||
| + | يتحقق إن كان ملفٌ ما وصلةً رمزيةً. | ||
| + | |||
===<code>[[Ruby/File/truncate|truncate]]</code>=== | ===<code>[[Ruby/File/truncate|truncate]]</code>=== | ||
| + | يقتطع ملفًا ما إلى حجمٍ محدَّدٍ. | ||
| + | |||
===<code>[[Ruby/File/umask|umask]]</code>=== | ===<code>[[Ruby/File/umask|umask]]</code>=== | ||
| + | يعيد القيمة الحالية للقناع <code>umask</code> للعملية الحالية أو يضبطها إلى قيمة محدَّدة إن مُرِّرت هذه القيمة إليه. | ||
| + | |||
===<code>[[Ruby/File/unlink|unlink]]</code>=== | ===<code>[[Ruby/File/unlink|unlink]]</code>=== | ||
| + | يحذف ملفًا محدَّدًا. | ||
| + | |||
===<code>[[Ruby/File/utime|utime]]</code>=== | ===<code>[[Ruby/File/utime|utime]]</code>=== | ||
| + | يضبط وقتي الوصول والتعديل لملف أو عدة ملفات محدَّدة. | ||
| + | |||
===<code>[[Ruby/File/world_readable-3F|world_readable?]]</code>=== | ===<code>[[Ruby/File/world_readable-3F|world_readable?]]</code>=== | ||
| + | يتحقق إن كان ملفٌ ما قابل للقراءة من طرف الآخرين. | ||
| + | |||
===<code>[[Ruby/File/world_writable-3F|world_writable?]]</code>=== | ===<code>[[Ruby/File/world_writable-3F|world_writable?]]</code>=== | ||
| + | يعيد إن كان ملفٌ ما قابل للكتابة من طرف الآخرين. | ||
| + | |||
===<code>[[Ruby/File/writable-3F|writable?]]</code>=== | ===<code>[[Ruby/File/writable-3F|writable?]]</code>=== | ||
| + | يتحقق إن كان ملفٌ ما قابلًا للكتابة من طرف مُعرِّف المستخدم والمجموعة الفعلي للعملية الحالية. | ||
| + | |||
===<code>[[Ruby/File/writable_real-3F|writable_real?]]</code>=== | ===<code>[[Ruby/File/writable_real-3F|writable_real?]]</code>=== | ||
| + | يعيد إن كان ملفٌ ما قابلًا للكتابة من طرف مُعرِّف المستخدم والمجموعة الحقيقي للعملية الحالية. | ||
| + | |||
===<code>[[Ruby/File/zero-3F|zero?]]</code>=== | ===<code>[[Ruby/File/zero-3F|zero?]]</code>=== | ||
| + | يتحقق إن كان ملفٌ ما موجودًا وخاويًا (صفر الحجم). | ||
== توابع النسخة العامة == | == توابع النسخة العامة == | ||
| + | ===<code>[[Ruby/File/atime-i|atime]]</code>=== | ||
| + | يعيد زمن آخر وصول إلى ملفٍ محدَّدٍ، أو وقت الإنشاء للملف إن لم يتم الوصول إليه. | ||
| + | |||
| + | ===<code>[[Ruby/File/birthtime-i|birthtime]]</code>=== | ||
| + | يعيد وقت إنشاء ملف محدَّد. | ||
| + | |||
| + | ===<code>[[Ruby/File/chmod-i|chmod]]</code>=== | ||
| + | يغيِّر بتات الأذونات للملف الذي استدعي معه. | ||
| + | |||
| + | ===<code>[[Ruby/File/chown-i|chown]]</code>=== | ||
| + | يغير المالك والمجموعة المالكة للملف الذي استدعي معه إلى مالك ومجموعة مالكة أخرى. | ||
| + | |||
| + | ===<code>[[Ruby/File/ctime-i|ctime]]</code>=== | ||
| + | يعيد وقت آخر تغيير أجري على الملف الذي استدعي معه. | ||
| + | |||
| + | ===<code>[[Ruby/File/flock|flock]]</code>=== | ||
| + | يقفل الملف الذي استدعي معه أو يلغي القفل الذي طُبِّق عليه لحماية الملف أثناء إجراء عمليَّة عليه (مثل القراءة منه أو الكتابة عليه) إشارةً إلى أنَّ هذا الملف يُستعمل الآن. | ||
| + | |||
| + | ===<code>[[Ruby/File/lstat-i|lstat]]</code>=== | ||
| + | يشبه التابع <code>[[Ruby/IO/stat|IO.stat]]</code> باستثناء أنَّه لا يتبع الوصلات الرمزية (أي أنَّه يعيد كائنًا من النوع <code>File::Stat</code> للوصلة نفسها وليس للملف الذي تشير إليه). | ||
| + | |||
| + | ===<code>[[Ruby/File/mtime-i|mtime]]</code>=== | ||
| + | يعيد وقت التعديل للملف الذي استدعي معه. | ||
| + | |||
| + | ===<code>[[Ruby/File/path-i|path]]</code>=== | ||
| + | يعيد سلسلة نصية تمثِّل المسار الذي استُعمِل لإنشاء الملف الذي استدعي معه. | ||
| + | |||
| + | ===<code>[[Ruby/File/size-i|size]]</code>=== | ||
| + | يعيد حجم الملف الذي استدعي معه. | ||
| + | |||
| + | ===<code>[[Ruby/File/to_path|to_path]]</code>=== | ||
| + | يعيد سلسلة نصية تمثِّل المسار الذي استُعمِل لإنشاء الملف الذي استدعي معه. | ||
| + | |||
| + | ===<code>[[Ruby/File/truncate-i|truncate]]</code>=== | ||
| + | يقتطع الملف الذي استدعي معه إلى حجمٍ محدَّدٍ. | ||
| + | |||
| + | == مصادر == | ||
| + | * [http://ruby-doc.org/core-2.5.1/File.html صفحة الصنف File في توثيق روبي الرسمي.] | ||
| + | [[تصنيف: Ruby]] | ||
| + | [[تصنيف: Ruby Class]] | ||
| + | [[تصنيف: Ruby File]] | ||
المراجعة الحالية بتاريخ 08:44، 1 ديسمبر 2018
الصنف File هو اختصار لأي كائن ملفٍ قابل للوصول عبر البرنامج ومرتبط عن كثب بالصنف IO. يتضمن الصنف File توابع الوحدة FileTest كتوابع صنفٍ مما يسمح لك باستعمال File.exist?("foo") مثلًا.
في شرح توابع الصنف File التالية، تكون بتات الأذونات (permission bits) مجموعة من البتات التي تعتمد على المنصة المستعملة والتي تشير إلى أذونات الملف. في الأنظمة الشبيهة بيونكس، تُعرض الأذونات على شكل مجموعة من ثلاثة ثمانيات (octets)؛ الأولى من أجل المالك، والثانية من أجل المجموعة المالكة، والثالثة تخص الأشخاص الآخرين. في كل واحدة من هذه الثمانية، يمكن ضبط الأذونات فيها إلى أذونات القراءة أو الكتابة أو التنفيذ للملف.
بتات الأذونات 0644 (في الصيغة الثمانية) ستُفسَّر على أنَّها أذونات قراءة وكتابة للمالك، وقراءة فقط للمجموعة المالكة والآخرين. البتات ذات الترتيب الأعلى قد تُستعمل للإشارة إلى نوع الملف (أي هل هو ملفٌ عادي أم مجلد، أم أنبوب، أم مقبس، ...إلخ.) وميزات خاصة أخرى. إن كانت الأذونات لمجلدٍ، فسيكون معنى بت التنفيذ مخالف لما هو معروف، إذ يتيح البحث عن المجلد عند ضبطه ومنحه لهذا لمجلد.
في الأنظمة الغير مطابقة لمعايير POSIX، قد يكون هنالك إمكانية لجعل الملف قابلًا للقراءة أو قابلًا للقراءة والكتابة. في هذه الحالة، ستُجمَّع بتات الأذونات المتبقية لتمثِّل قيم أخرى محدَّدة. في ويندوز NT مثلًا، تشير قيمة بتات الأذونات 0644 الافتراضية إلى أذونات القراءة والكتابة للمالك، والقراءة فقط لبقية المستخدمين. الشي الوحيد الذي يمكن فعله هنا هو جعل الملف قابلًا للقراءة فقط وهذا ما تفعله القيمة 0444.
هنالك ثوابت متنوعة يمكن استعمال مع توابع الصنف File تجدها في صفحة الثوثيق File::Constants.
الثوابت
ALT_SEPARATOR
يمثِّل الفاصل البديل المحدَّد من طرف المنصة المستعملة.
PATH_SEPARATOR
يمثِّل الفاصل المستعمل في فصل قائمة المسارات.
SEPARATOR
يمثِّل الفاصل المستعمل في فصل أجزاء المجلدات في المسار.
توابع الصنف العامة
absolute_path
يحول اسم مسار محدَّد إلى مسار مطلق.
atime
يعيد زمن آخر وصول إلى ملفٍ محدَّدٍ.
basename
يعيد آخر مكوِّن من مسار اسم الملف المعطى.
birthtime
يعيد وقت إنشاء ملف محدَّد.
blockdev?
يتحقق إن كان ملفٌ ما هو جهاز كتلي (block device).
chardev?
يتحقق إن كان ملفٌ ما هو جهاز محرفي (character device).
chmod
يغيِّر بتات الأذونات لملف أو عدة ملفات محدَّدة.
chown
يغير المالك والمجموعة المالكة لملف أو عدة ملفات محدَّدة إلى مالك ومجموعة مالكة أخرى.
ctime
يعيد وقت آخر تغيير أجري على ملف محدَّد.
delete
يحذف ملفًا محدَّدًا.
directory?
يتحقق إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ.
dirname
يعيد جميع مكونات المسار المعطى لملفٍ باستثناء المكون الأخير (الاسم الأساسي [basename]) الذي يلي آخر فاصل في المسار.
executable?
يتحقق إن كان ملفٌ ما قابلًا للتنفيذ من طرف المعرِّف الفعلي للمستخدم المالك والمجموعة المالكة للعملية الحالية.
executable_real?
يتحقق إن كان ملفٌ ما قابلًا للتنفيذ من طرف المعرِّف الحقيقي للمستخدم المالك والمجموعة المالكة للعملية الحالية.
exist?
يتحقق إن كان ملفٌ ما موجودًا.
exists?
أصبح مهملًا. لا تستخدمه رجاءً.
expand_path
يحول مسار ملفٍ ما إلى مسار مطلق مع توسيع الرمز ~ إن وجد في المسار المعطى.
extname
يعيد لاحقة الملف المعطى. لاحقة الملف هي جزء من اسمه وتتوضع في مساره بعد آخر نقطة فيه.
file?
يتحقق إن كان ملفٌ ما موجودًا وكان ملفًا طبيعيًّا.
fnmatch
يتحقق من تطابق مسار مع نمط محدَّد.
fnmatch?
يتحقق من تطابق مسار مع نمط محدَّد.
ftype
يعرِّف نوع الملف المعطى.
grpowned?
يتحقق إن كان ملفٌ ما موجودًا وكان معرِّف المجموعة المالكة الفعلي للعملية التي استدعت التابع هو مالك هذا الملف.
identical?
يتحقق إن كان الملفان المعطيان متماثلين تمامًا.
join
يعيد سلسلة نصية جديدة مكونة من جمع السلاسل النصية المُمرَّرة إليها باستعمال الفاصل "/".
lchmod
يشبه التابع chmod باستثناء أنه لا يتبع الوصلات الرمزية (أي أنه يغير أذونات الوصلة نفسها وليس الملف الذي تشير إليه).
lchown
يشبه التابع chown باستثناء أنه لا يتبع الوصلات الرمزية (أي أنه يغير المالك والمجموعة المالكة للوصلة نفسها وليس للملف الذي تشير إليه).
link
ينشئ اسمًا جديدًا لملف موجود باستعمال وصلة صلبة (hard link).
lstat
يشبه التابع stat باستثناء أنَّه لا يتبع الوصلات الرمزية (أي أنَّه يعيد كائنًا من النوع File::Stat للوصلة نفسها وليس للملف الذي تشير إليه).
lutime
يعين وقتي الوصول والتعديل لملف أو ملفات محدَّدة.
mkfifo
ينشئ ملفًا خاصًّا من النوع "أنبوبة مسماة" (FIFO ويدعى أحيانًا named pipe) باسم وأذونات محدَّدة.
mtime
يعيد وقت التعديل للملف المحدَّد.
new
يفتح ملفًا محدَّدًا وبوضع معيَّن ثم يعيد كائنًا جديدًا من النوع File.
open
يشبه التابع new تمامًا إن لم تعطَ كتلة برمجية معه أو سيمُرَّر الملف بعد فتحه (الكائن File) إلى الكتلة ثم سيُغلق تلقائيًّا عند انتهاء تنفيذ الكتلة.
owned?
يتحقق إن كان ملفٌ ما موجودًا وكان مالك هذا الملف هو نفسه المعرِّف الفعلي للمستخدم المالك للعملية التي استدعته.
path
يعيد سلسلة نصية تمثِّل المسار المعطى.
pipe?
يتحقق إن كان ملفٌ ما أنبوبًا (pipe).
readable?
يتحقق إن كان ملفٌ ما قابلًا للقراءة من طرف مُعرِّف المستخدم والمجموعة الفعلي للعملية الحالية.
readable_real?
يتحقق إن كان ملفٌ ما قابلًا للقراءة من طرف مُعرِّف المستخدم والمجموعة الحقيقي للعملية الحالية.
readlink
يعيد اسم الملف الذي تشير إليه الوصلة المعطاة.
realdirpath
يعيد اسم المسار الحقيقي (المطلق) لمسارٍ ما في نظام الملفات الفعلي.
realpath
يعيد اسم المسار الحقيقي (المطلق) لمسارٍ ما في نظام الملفات الفعلي.
rename
يعيد تسمية ملف محدَّد إلى اسم جديد.
setgid?
يتحقق إن كان البت setgid (بت معرِّف المجموعة المالكة) مضبوطًا للملف المحدَّد.
setuid?
يتحقق إن كان البت setuid (بت معرِّف المستخدم المالك) مضبوطًا للملف المحدَّد.
size
يعيد حجم الملف المحدَّد.
size?
يتحقق إن كان ملفٌ ما غير موجود أو معدوم الحجم.
socket?
يتحقق إن كان ملفٌ ما مقبسًا.
split
يقتطع مسار الملف المُمرَّر إليه إلى جزأين: أحدهما لمجلد، والآخر للملف ثم يعيدهما في مصفوفة.
stat
يعيد كائنًا من النوع File::Stat للملف المحدَّد.
sticky?
يتحقق إن كان ملفٌ ما قد ضُبِط فيه البت اللاصق (sticky bit).
symlink
ينشئ وصلةً رمزيةً باسم محدَّد لملف معيَّن موجود.
symlink?
يتحقق إن كان ملفٌ ما وصلةً رمزيةً.
truncate
يقتطع ملفًا ما إلى حجمٍ محدَّدٍ.
umask
يعيد القيمة الحالية للقناع umask للعملية الحالية أو يضبطها إلى قيمة محدَّدة إن مُرِّرت هذه القيمة إليه.
unlink
يحذف ملفًا محدَّدًا.
utime
يضبط وقتي الوصول والتعديل لملف أو عدة ملفات محدَّدة.
world_readable?
يتحقق إن كان ملفٌ ما قابل للقراءة من طرف الآخرين.
world_writable?
يعيد إن كان ملفٌ ما قابل للكتابة من طرف الآخرين.
writable?
يتحقق إن كان ملفٌ ما قابلًا للكتابة من طرف مُعرِّف المستخدم والمجموعة الفعلي للعملية الحالية.
writable_real?
يعيد إن كان ملفٌ ما قابلًا للكتابة من طرف مُعرِّف المستخدم والمجموعة الحقيقي للعملية الحالية.
zero?
يتحقق إن كان ملفٌ ما موجودًا وخاويًا (صفر الحجم).
توابع النسخة العامة
atime
يعيد زمن آخر وصول إلى ملفٍ محدَّدٍ، أو وقت الإنشاء للملف إن لم يتم الوصول إليه.
birthtime
يعيد وقت إنشاء ملف محدَّد.
chmod
يغيِّر بتات الأذونات للملف الذي استدعي معه.
chown
يغير المالك والمجموعة المالكة للملف الذي استدعي معه إلى مالك ومجموعة مالكة أخرى.
ctime
يعيد وقت آخر تغيير أجري على الملف الذي استدعي معه.
flock
يقفل الملف الذي استدعي معه أو يلغي القفل الذي طُبِّق عليه لحماية الملف أثناء إجراء عمليَّة عليه (مثل القراءة منه أو الكتابة عليه) إشارةً إلى أنَّ هذا الملف يُستعمل الآن.
lstat
يشبه التابع IO.stat باستثناء أنَّه لا يتبع الوصلات الرمزية (أي أنَّه يعيد كائنًا من النوع File::Stat للوصلة نفسها وليس للملف الذي تشير إليه).
mtime
يعيد وقت التعديل للملف الذي استدعي معه.
path
يعيد سلسلة نصية تمثِّل المسار الذي استُعمِل لإنشاء الملف الذي استدعي معه.
size
يعيد حجم الملف الذي استدعي معه.
to_path
يعيد سلسلة نصية تمثِّل المسار الذي استُعمِل لإنشاء الملف الذي استدعي معه.
truncate
يقتطع الملف الذي استدعي معه إلى حجمٍ محدَّدٍ.