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

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

يعيد التابع entries‎ مصفوفةً تحتوي جميع أسماء الملفات الموجودة في المجلد المحدد. في حال عدم وجود هذا المجلد، سيُطلق الخطأ SystemCallError.

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

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

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

المعاملات

`dirname`

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

`encoding`

ترميز المجلد.

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

تُعاد مصفوفةٌ تحوي جميع أسماء الملفات في المجلد المحدد.

أمثلة

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

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

انظر أيضًا

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

مصادر

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

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