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