الصنف Dir في روبي

من موسوعة حسوب
اذهب إلى: تصفح، ابحث

كائنات الصنف Dir هي مجاري مجلدات (directory streams) تمثِّل الجلدات في نظام الملفات الأساسي لنظام التشغيل. فهي توفر طرائق متعددة لعرض المجلدات ومحتوياتها. انظر أيضًا صفحة الصنف File لمزيد من المعلومات.

يحوي المجلد المستخدم في الأمثلة الموجودة في صفحات التوابع ملفين عاديين هما: config.h و main.rb، بالإضافة إلى المجلد الأب (..) ، والمجلد نفسه (.).

توابع الصنف العامة (Public Class Methods)

المعامل []

يكافئ استدعاء Dir.glob([string,...], 0)‎. 

chdir‎

يغيِّر مجلد العمل (working directory) الحالي للعملية الحالية إلى مجلَّدٍ محدَّدٍ.

children

يعيد مصفوفة تحوي جميع أسماء الملفات في المجلد المحدد باستثناء "." و "..".

chroot

يغير المجلد الجذر (root) لنظام الملفات الخاص بالعملية الحالية.

each_child

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

delete

يحذف مجلدًا محدَّدًا.

?empty

يتحقق فيما إذا كان المجلد المعطى فارغًا.

entries

يتحقق فيما إذا كان الملف المعطى مجلدًا.

?exist

يتحقق مما إذا كان الملف المعطى مجلدًا. 

exists

أصبح مهملًا، لذا لا تستخدمه بعد الآن. استعمل التابع ?exist عوضًا عنه.

foreach

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

getwd

يعيد مسار مجلد العمل (working directory) الحالي للعملية الحالية.

glob

يوسّع الوسيطَ pattern الممرّر (انظر فقرة البنية العامة)، الذي هو سلسلة نصية نمطية (pattern string) أو مصفوفة من السلاسل النصية النمطية، ويعيد مصفوفة تحتوي أسماء الملفات المُطابقة لذلك النمط.

home

يعيد المجلد الرئيسي (home directory) للمستخدم الحالي أو للمستخدم المعطى في حال إعطائه.

mkdir

ينشئ مجلدًا جديدًا باسم محدَّد، مع تحديد أذوناته أيضًا.

new

يعيد كائنًا مجلديًا (directory object) جديدًا خاصًا بالمجلد المعطى.

open

يفتح مجلدًا محدَّدًا ثمَّ يعيد كائنًا يشير إليه. 

pwd

يعيد مسار مجلد العمل (working directory) الحالي للعملية.

rmdir

يحذف مجلدًا محدَّدًا.

unlink

يحذف مجلدًا محدَّدًا.

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

close

يغلق التابع close مجرى مجلد محدَّدٍ.

each

يستدعي الكتلة المعطاة على كل ملف من الملفات الموجودة في مجلد محدَّد، إذ تمُمرّر أسماء تلك الملفات كوسائط للكتلة.

fileno

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

inspect

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

path

يعيد المسار المُمرّر إلى الباني new عند إنشائه للكائن Dir المعطى.

pos

يعيد موضع المؤشر الحالي في المجلد الذي استٌدعي معه.

seek

يذهب التابع seek إلى موضع محدد في المجلد الذي استٌدعي معه.

pos = integer‎

يحدِّد التابع pos عند استدعائه بالشكل pos = integer‎ موضع المؤشر الحالي في المجلد.

read

يقرأ التابع read المدخلة التالية في المجلد الذي استُدعي معه ثم يعيده في سلسلة نصية.

rewind

يعيد التابع rewind ضبط موضع المؤشر الحالي في المجلد إلى بدايته.

tell

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

to_path

يعيد المسار المُمرّر إلى الباني new عند إنشائه للكائن Dir المعطى.

مصادر