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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
سطر 2: سطر 2:
 
[[تصنيف: Ruby]]
 
[[تصنيف: Ruby]]
 
[[تصنيف: Ruby Dir]]
 
[[تصنيف: Ruby Dir]]
كائنات الصنف<code>Dir</code> هي مجريات مجلدات (directory streams) في نظام الملفات الأساسي. فهي توفر مجموعة متنوعة من الطرق لعرض المجلدات ومحتوياتها. انظر أيضًا صفحة [[Ruby/File|File]].  
+
كائنات الصنف<code>Dir</code> هي مجريات مجلدات (directory streams) في نظام الملفات الأساسي. فهي توفر مجموعة من الطرق لعرض المجلدات ومحتوياتها. انظر صفحة [[Ruby/File|File]] لمزيد من المعلومات.  
  
 
يحتوي المجلد المستخدم في الأمثلة الموجودة في صفحات التوابع ملفين عاديين (<code>config.h</code> و <code>main.rb</code>) ، والمجلد الأب (<code>..</code>) ، والمجلد نفسه (<code>.</code>).
 
يحتوي المجلد المستخدم في الأمثلة الموجودة في صفحات التوابع ملفين عاديين (<code>config.h</code> و <code>main.rb</code>) ، والمجلد الأب (<code>..</code>) ، والمجلد نفسه (<code>.</code>).

مراجعة 17:56، 24 سبتمبر 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) على شكل سلسلة نصية. 

التابع rmdir

يمحو التابع rmdir‎ المجلد المحدد، سيُطلق خطأ من صنف فرعي (subclass) من SystemCallError  في حال لم يكن المجلد فارغًا .

التابع unlink

يمحو التابع unlink‎ المجلد المحدد، سيُطلق خطأ من صنف فرعي (subclass) من SystemCallError  في حال لم يكن المجلد فارغًا.

توابع الكائن العامة (Public Instance Methods)

التابع close

يغلق التابع close مجرى المجلد (directory stream)، استدعاء هذا التابع على على كائن Dir مغلق صار يُتجاهل منذ روبي 2.3. 

التابع each

يستدعي التابع each الكتلة المعطاة على كل ملف من الملفات المحتواة في المجلد المحدد. حيث يمُمرّر أسماء تلك الملفات كوسائط للكتلة. 

التابع fileno

يعيد التابع fileno عددًا صحيحًا يمثل واصف الملف العددي (numeric file descriptor) المُستخدم في الكائن من صنف Dir الذي استُدعي معه.

التابع inspect

يعيد التابع inspect سلسلة نصية تصف الكائن (من صنف Dir) الذي استُدعي معه.

التابع path

يعيد التابع path المسار المُمرّر إلى الباني new على شكل سلسلة نصية. 

التابع pos

يعيد التابع pos الموضع الحالي في الكائن من صنف Dir الذي استٌدعي معه. أنظر أيضًا التابع seek

التابع seek

يذهب التابع seek إلى موضع محدد في الكائن من صنف Dir الذي استٌدعي معه.

التعبير pos =‎

التعبير pos =‎ هو مرادف للتابع seek. بيد أنّه يعيد معامل الموضع (position parameter). 

التابع read

يقرأ التابع read المدخل الموالي في الكائن المجلدي (dir object) الذي استُدعي معه ثم يعيده على شكل سلسلة نصية. وفي نهاية المجرى يعيد القيمةnil .

التابع rewind

يعيد التابع rewind الموضع الراهن عند المدخل الأول.

التابع tell

يعيد التابع tell الموضع الحالي في الكائن من صنف Dir الذي استٌدعي معه. أنظر أيضًا التابع seek.

التابع to_path

يعيد التابع to_path المسار المُمرّر (في الوسيط path) إلى الباني new على شكل سلسلة نصية. 

مصادر