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

من موسوعة حسوب
< Ruby‏ | Dir
لا ملخص تعديل
ط مراجعة وتدقيق
 
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE:  التابع <code>entries</code> الخاص بالصنف <code>Dir</code> في روبي}}</noinclude>
<noinclude>{{DISPLAYTITLE: التابع <code>Dir.entries</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Dir]]
[[تصنيف: Ruby Dir]]
يعيد التابع <code>entries‎</code> مصفوفة تحتوي جميع أسماء الملفات الموجودة في المجلد المحدد. وفي حال عدم وجود المجلد المحدد، فسيُطلق الخطأ <code>SystemCallError</code>.  
يعيد التابع <code>entries‎</code> مصفوفةً تحتوي جميع أسماء الملفات الموجودة في المجلد المحدد. في حال عدم وجود هذا المجلد، سيُطلق الخطأ <code>SystemCallError</code>.  


يمكن تمرير وسيط اختياري ''<code>encoding</code>، والذي يحدد'' ترميز المجلد. أما إن لم يُحدّد، فسيٌستخدم ترميز نظام الملفات.  
يمكن تمرير الوسيط <code>encoding</code> الاختياري إلى التابع الذي يحدد ترميز المجلد. أمَّا إن لم يعطَ، فسيٌستخدم ترميز نظام الملفات.
 
==البنية العامة==
== البنية العامة ==
<syntaxhighlight lang="ruby">
<syntaxhighlight lang="ruby">
entries( dirname ) → array
entries( dirname ) → array
entries( dirname, encoding: enc ) → array
entries( dirname, encoding: enc ) → array
</syntaxhighlight>
</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">
== القيمة المٌعادة ==
مصفوفة تحتوي جميع أسماء الملفات في المجلد المحدد.
 
== أمثلة ==
مثال عن استخدام التابع <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"]
Dir.entries("testdir")  #=> [".", "..", "config.h", "main.rb"]


</syntaxhighlight>
</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/children|children]]‎</code> : يعيد التابع <code>children‎</code> مصفوفة تحتوي جميع أسماء الملفات في المجلد المحدد باستثناء "<code>.</code>" و "<code>..</code>". في حالة عدم وجود المجلد المحدد، فسيُطلق الخطأ<code>SystemCallError</code>.
 
== مصادر ==
* [http://ruby-doc.org/core-2.5.1/Dir.html#method-c-entries قسم التابع entries في الصنف Dir في توثيق روبي الرسمي.]

المراجعة الحالية بتاريخ 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: يعيد مصفوفة تحتوي جميع أسماء الملفات في المجلد المحدد باستثناء "." و "..".

مصادر