الفرق بين المراجعتين لصفحة: «Ruby/Dir/children»

المراجعة الحالية بتاريخ 22:30، 10 نوفمبر 2018

يعيد التابع children‎ مصفوفة تحوي جميع أسماء الملفات في المجلد المحدد باستثناء "." و "..". في حالة عدم وجود المجلد المحدد، فسيُطلق الخطأ SystemCallError.

يمكن تمرير الوسيط الاختياري encoding الذي يحدِّد ترميز المجلد. أمَّا إن لم يُحدّد، فسيٌستخدم ترميز نظام الملفات نفسه.

البنية العامة

children( dirname ) → array 
children( dirname, encoding: enc ) → array

المعاملات

`dirname`

اسم المجلد المُحدد المراد معرفة محتواه.

`encoding`

ترميز المجلد. إن لم يُحدّد، فسيٌستخدم ترميز نظام الملفات.

القيمة المعادة

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

أمثلة

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

Dir.children("testdir")   #=> ["config.h", "main.rb"]

انظر أيضًا

التابع entries: يعيد مصفوفة تحتوي جميع أسماء الملفات الموجودة في المجلد المحدد. في حال عدم وجود المجلد المحدَّد، فسيُطلق الخطأ SystemCallError.

مصادر

قسم التابع children في الصنف Dir في توثيق روبي الرسمي.

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE:  التابع <code>children</code> الخاص بالصنف <code>Dir</code> في روبي}}</noinclude>
+<noinclude>{{DISPLAYTITLE:  التابع <code>Dir.children</code> في روبي}}</noinclude>
 [[تصنيف: Ruby]]
 [[تصنيف: Ruby Method]]
 [[تصنيف: Ruby Dir]]
-يعيد التابع <code>children‎</code> مصفوفة تحتوي جميع أسماء الملفات في المجلد المحدد باستثناء "<code>.</code>" و "<code>..</code>". في حالة عدم وجود المجلد المحدد، فسيُطلق الخطأ <code>SystemCallError</code>.
+يعيد التابع <code>children‎</code> مصفوفة تحوي جميع أسماء الملفات في المجلد المحدد باستثناء "<code>.</code>" و "<code>..</code>". في حالة عدم وجود المجلد المحدد، فسيُطلق الخطأ <code>SystemCallError</code>.
-يمكن تمرير وسيط اختياري ''<code>encoding</code>، والذي يحدد'' ترميز المجلد. أما إن لم يُحدّد، فسيٌستخدم ترميز نظام الملفات.
+يمكن تمرير الوسيط الاختياري <code>encoding</code> الذي يحدِّد ترميز المجلد. أمَّا إن لم يُحدّد، فسيٌستخدم ترميز نظام الملفات نفسه.
+==البنية العامة==
-== البنية العامة ==
 <syntaxhighlight lang="ruby">
 children( dirname ) → array
 children( dirname, encoding: enc ) → array
 </syntaxhighlight>
+==المعاملات==
-== المعاملات ==
+===<code>dirname</code>===
+اسم المجلد المُحدد المراد معرفة محتواه.
-=== <code>dirname </code> ===
+===<code>encoding</code>===
-اسم المجلد المُحدد.
+ترميز المجلد. إن لم يُحدّد، فسيٌستخدم ترميز نظام الملفات.
+==القيمة المعادة==
-=== <code>encoding</code> ===
+تُعاد مصفوفة تحوي جميع أسماء الملفات في المجلد <code>dirname</code> المحدَّد باستثناء "<code>.</code>" و "<code>..</code>".
-يحدد  ترميز المجلد. وإن لم يُحدّد، فسيٌستخدم ترميز نظام الملفات.
+==أمثلة==
+مثال عن استخدام التابع <code>children</code> على المجلد <code>testdir</code> الذي يحتوي ملفين عاديين (<code>config.h</code> و <code>main.rb</code>)، والمجلد الأب (<code>..</code>)، والمجلد نفسه (<code>.</code>):<syntaxhighlight lang="ruby">
-== القيمة المٌعادة ==
-مصفوفة تحتوي جميع أسماء الملفات في المجلد المحدد باستثناء "<code>.</code>" و "<code>..</code>".
-== أمثلة ==
-أمثلة عن استخدام التابع <code>children‎</code>:<syntaxhighlight lang="ruby">
 Dir.children("testdir")   #=> ["config.h", "main.rb"]
 </syntaxhighlight>
+==انظر أيضًا==
-== أنظر أيضًا ==
+*التابع <code>[[Ruby/Dir/entries|entries]]</code>: يعيد مصفوفة تحتوي جميع أسماء الملفات الموجودة في المجلد المحدد. في حال عدم وجود المجلد المحدَّد، فسيُطلق الخطأ <code>SystemCallError</code>.
-* صفحة الصنف <code>[[Ruby/Dir|Dir]]</code>.
+==مصادر==
+*[http://ruby-doc.org/core-2.5.1/Dir.html#method-c-children قسم التابع children في الصنف Dir في توثيق روبي الرسمي.]
-* التابع <code>[[Ruby/Dir/chdir|chdir]]‎</code> : يستبدل التابع <code>chdir‎</code> مجلد العمل (working directory) الحالي للعملية ويعيّن مكانه السلسلة النصية المعطاة.
-== مصادر ==
-* [http://ruby-doc.org/core-2.5.1/Dir.html#method-c-children قسم  التابع children في الصنف Dir في توثيق روبي الرسمي.]