الفرق بين المراجعتين ل"Ruby/Dir"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
سطر 58: سطر 58:
 
يعيد التابع <code>new</code> كائنًا مجلديًا (directory object) جديدًا خاصًا بالمجلد المعطى. 
 
يعيد التابع <code>new</code> كائنًا مجلديًا (directory object) جديدًا خاصًا بالمجلد المعطى. 
  
=== [[Ruby/Dir/delete|التابع delete]] ===
+
=== [[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كمعامل.

التابع delete

التابع delete

مصادر