الفرق بين المراجعتين لصفحة: «Ruby/Dir»
لا ملخص تعديل |
لا ملخص تعديل |
||
| سطر 58: | سطر 58: | ||
يعيد التابع <code>new</code> كائنًا مجلديًا (directory object) جديدًا خاصًا بالمجلد المعطى. | يعيد التابع <code>new</code> كائنًا مجلديًا (directory object) جديدًا خاصًا بالمجلد المعطى. | ||
=== [[Ruby/Dir/ | === [[Ruby/Dir/open|التابع open]] === | ||
في حال عدم إعطاء كتلة، فإنّ التابع <code>open</code> هو مرادف لـ <code>Dir::new</code>. وفي حالة إعطاء كتلة، فسيُمرّر إليها <code>aDir</code>كمعامل. | |||
=== [[Ruby/Dir/delete|التابع delete]] === | === [[Ruby/Dir/delete|التابع delete]] === | ||
مراجعة 18:12، 23 سبتمبر 2018
كائنات الصنفDir هي مجريات مجلدات (directory streams) في نظام الملفات الأساسي. فهي توفر مجموعة متنوعة من الطرق لعرض المجلدات ومحتوياتها. انظر أيضًا صفحة File.
يحتوي المجلد المستخدم في الأمثلة الموجودة في صفحات التوابع ملفين عاديين (config.h و main.rb) ، والمجلد الأب (..) ، والمجلد نفسه (.).
توابع الصنف العامة (Public Class Methods)
التابع []
يكافئ التابع Dir[] استدعاء Dir.glob([string,...], 0).
التابع chdir
يستبدل التابع chdir مجلد العمل (working directory) الحالي للعملية ويعيّن مكانه السلسلة النصية المعطاة.
التابع children
يعيد التابع children مصفوفة تحتوي جميع أسماء الملفات في المجلد المحدد باستثناء "." و "..". في حالة عدم وجود المجلد المحدد، فسيُطلق الخطأSystemCallError.
التابع chroot
يغير التابع chroot جذر (root) نظام الملفات الخاص بالعملية (process). فقط العمليات ذات الامتياز (privileged process) مُخوّلة لاستدعاء هذا التابع.
التابع delete
يمحو التابع delete المجلد المحدد، سيُطلق خطأ من صنف فرعي (subclass) من SystemCallError في حال لم يكن المجلد موجودًا.
التابع each_child
يستدعي التابع each_child الكتلة المعطاة على كل ملف من الملفات المحتواة في المجلد المحدد، باستثناء ".." و ".". حيث يمُمرّر أسماء تلك الملفات كوسائط للكتلة.
التابع delete
يمحو التابع delete المجلد المحدد، سيُطلق خطأ من صنف فرعي (subclass) من SystemCallError في حال لم يكن المجلد موجودًا.
التابع ?empty
يتحقق التابع ?empty مما إذا كان المجلد المعطى فارغًا.
التابع entries
يعيد التابع entries مصفوفة تحتوي جميع أسماء الملفات الموجودة في المجلد المحدد. في حال عدم وجود المجلد المحدد، فسيُطلق الخطأ SystemCallError.
التابع ?exist
يتحقق التابع ?exist مما إذا كان الملف المعطى مجلدًا.
التابع exists
هذا التابع صار متجاوزا، لا تستخدمه. انظر التابع ?exist.
التابع foreach
يستدعي التابع foreach الكتلة المعطاة على كل ملف من الملفات المحتواة في المجلد المحدد. حيث يمُمرّر أسماء تلك الملفات كوسائط للكتلة.
التابع getwd
يعيد التابع getwd مسار مجلد العمل (working directory) الحالي للعملية (process) على شكل سلسلة نصية.
التابع glob
يوسّع التابع glob الوسيط الممرّر pattern، والذي هو عبارة عن سلسلة نصية نمطية (pattern string) أو مصفوفة من السلاسل النصية النمطية، ويعيد مصفوفة تحتوي أسماء الملفات المتطابقة لذلك النمط.
التابع home
يعيد التابع home المجلد الرئيسي (home directory) للمستخدم الحالي أو للمستخدم المعطى في حال إعطائه.
التابع mkdir
ينشئ التابع mkdir مجلدًا جديدًا.
التابع new
يعيد التابع new كائنًا مجلديًا (directory object) جديدًا خاصًا بالمجلد المعطى.
التابع open
في حال عدم إعطاء كتلة، فإنّ التابع open هو مرادف لـ Dir::new. وفي حالة إعطاء كتلة، فسيُمرّر إليها aDirكمعامل.