الفرق بين المراجعتين ل"Ruby/Dir"
سطر 61: | سطر 61: | ||
في حال عدم إعطاء كتلة، فإنّ التابع <code>open</code> هو مرادف لـ <code>Dir::new</code>. وفي حالة إعطاء كتلة، فسيُمرّر إليها <code>aDir</code>كمعامل. | في حال عدم إعطاء كتلة، فإنّ التابع <code>open</code> هو مرادف لـ <code>Dir::new</code>. وفي حالة إعطاء كتلة، فسيُمرّر إليها <code>aDir</code>كمعامل. | ||
− | === [[Ruby/Dir/ | + | === [[Ruby/Dir/pwd|التابع pwd]] === |
+ | يعيد التابع <code>pwd</code> مسار مجلد العمل (working directory) الحالي للعملية (process) على شكل سلسلة نصية. | ||
=== [[Ruby/Dir/delete|التابع delete]] === | === [[Ruby/Dir/delete|التابع delete]] === |
مراجعة 18:17، 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
كمعامل.
التابع pwd
يعيد التابع pwd
مسار مجلد العمل (working directory) الحالي للعملية (process) على شكل سلسلة نصية.