عرض مصدر Ruby/Dir

<noinclude>{{DISPLAYTITLE: صفحة الصنف <code>Dir</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby Dir]]
كائنات الصنف<code>Dir</code> هي مجريات مجلدات (directory streams) في نظام الملفات الأساسي. فهي توفر مجموعة متنوعة من الطرق لعرض المجلدات ومحتوياتها. انظر أيضًا صفحة [[Ruby/File|File]]. 

يحتوي المجلد المستخدم في الأمثلة الموجودة في صفحات التوابع ملفين عاديين (<code>config.h</code> و <code>main.rb</code>) ، والمجلد الأب (<code>..</code>) ، والمجلد نفسه (<code>.</code>).
==توابع الصنف العامة (Public Class Methods)==

=== [[Ruby/Dir/5B-5D|التابع []]] ===
يكافئ التابع <code>Dir[]‎</code> استدعاء <code>Dir.glob([string,...], 0)</code>‎. 

=== [[Ruby/Dir/chdir|التابع <code>chdir‎</code>]] ===
يستبدل التابع <code>chdir‎</code> مجلد العمل (working directory) الحالي للعملية ويعيّن مكانه السلسلة النصية المعطاة. 

=== [[Ruby/Dir/children|التابع children]] ===
يعيد التابع <code>children‎</code> مصفوفة تحتوي جميع أسماء الملفات في المجلد المحدد باستثناء "<code>.</code>" و "<code>..</code>". في حالة عدم وجود المجلد المحدد، فسيُطلق الخطأ<code>SystemCallError</code>.

=== [[Ruby/Dir/chroot|التابع chroot]] ===
يغير التابع <code>chroot</code>  جذر (root)  نظام الملفات الخاص بالعملية (process). فقط العمليات ذات الامتياز  (privileged process) مُخوّلة لاستدعاء هذا التابع.  

=== [[Ruby/Dir/delete|التابع delete]] ===
يمحو التابع <code>delete‎</code> المجلد المحدد، سيُطلق خطأ من صنف فرعي (subclass) من <code>SystemCallError</code>  في حال لم يكن المجلد موجودًا. 

=== [[Ruby/Dir/each child|التابع each_child]] ===
يستدعي التابع <code>each_child</code> الكتلة المعطاة على كل ملف من الملفات المحتواة في المجلد المحدد، باستثناء "<code>..</code>" و "<code>.</code>". حيث يمُمرّر أسماء تلك الملفات كوسائط للكتلة. 

=== [[Ruby/Dir/delete|التابع delete]] ===
يمحو التابع <code>delete‎</code> المجلد المحدد، سيُطلق خطأ من صنف فرعي (subclass) من <code>SystemCallError</code>  في حال لم يكن المجلد موجودًا.

=== [[Ruby/Dir/empty|التابع ?empty]] ===
يتحقق التابع <code>?empty</code> مما إذا كان المجلد المعطى فارغًا. 

=== [[Ruby/Dir/entries|التابع entries]] ===
يعيد التابع <code>entries‎</code> مصفوفة تحتوي جميع أسماء الملفات الموجودة في المجلد المحدد. في حال عدم وجود المجلد المحدد، فسيُطلق الخطأ <code>SystemCallError</code>. 

=== [[Ruby/Dir/exist|التابع ?exist]] ===
يتحقق التابع <code>?exist</code> مما إذا كان الملف المعطى مجلدًا. 

=== [[Ruby/Dir/exists|التابع exists]] ===
هذا التابع صار متجاوزا، لا تستخدمه. انظر التابع <code>[[Ruby/Dir/exist|?exist]]</code>. 

=== [[Ruby/Dir/foreach|التابع foreach]] ===
يستدعي التابع <code>foreach</code> الكتلة المعطاة على كل ملف من الملفات المحتواة في المجلد المحدد. حيث يمُمرّر أسماء تلك الملفات كوسائط للكتلة. 

=== [[Ruby/Dir/getwd|التابع getwd]] ===
يعيد التابع <code>getwd</code> مسار مجلد العمل (working directory) الحالي للعملية (process) على شكل سلسلة نصية.

=== [[Ruby/Dir/glob|التابع glob]] ===
يوسّع التابع <code>glob</code>  الوسيط الممرّر <code>pattern</code>، والذي هو عبارة عن سلسلة نصية نمطية (pattern string) أو مصفوفة من السلاسل النصية النمطية، ويعيد مصفوفة تحتوي أسماء الملفات المتطابقة لذلك النمط.

=== [[Ruby/Dir/home|التابع home]] ===
يعيد التابع <code>home</code> المجلد الرئيسي (home directory) للمستخدم الحالي أو للمستخدم المعطى في حال إعطائه. 

=== [[Ruby/Dir/mkdir|التابع mkdir]] ===
ينشئ التابع <code>mkdir</code> مجلدًا جديدًا.

=== [[Ruby/Dir/new|التابع new]] ===
يعيد التابع <code>new</code> كائنًا مجلديًا (directory object) جديدًا خاصًا بالمجلد المعطى. 

=== [[Ruby/Dir/delete|التابع delete]] ===

=== [[Ruby/Dir/delete|التابع delete]] ===

=== [[Ruby/Dir/delete|التابع delete]] ===

==مصادر<span> </span>==
*[http://ruby-doc.org/core-2.5.1/Dir.html قسم  الصنف Dir في توثيق روبي الرسمي.]