الفرق بين المراجعتين ل"Ruby/Dir/entries"

من موسوعة حسوب
< Ruby‏ | Dir
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:  التابع <code>entries</code> الخاص بالصنف <code>Dir</code> في روبي}}</noinclude> تصنيف: Ruby تصنيف:...')
 
ط (مراجعة وتدقيق)
 
(مراجعة متوسطة واحدة بواسطة مستخدم واحد آخر غير معروضة)
سطر 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>children‎</code> مصفوفة تحتوي جميع أسماء الملفات في المجلد المحدد باستثناء "<code>.</code>" و "<code>..</code>". في حالة عدم وجود المجلد المحدد، فسيُطلق الخطأ <code>SystemCallError</code>.  
+
يعيد التابع <code>entries‎</code> مصفوفةً تحتوي جميع أسماء الملفات الموجودة في المجلد المحدد. في حال عدم وجود هذا المجلد، سيُطلق الخطأ <code>SystemCallError</code>.  
  
يمكن تمرير وسيط اختياري ''<code>encoding</code>، والذي يحدد'' ترميز المجلد. أما إن لم يُحدّد، فسيٌستخدم ترميز نظام الملفات.  
+
يمكن تمرير الوسيط <code>encoding</code> الاختياري إلى التابع الذي يحدد ترميز المجلد. أمَّا إن لم يعطَ، فسيٌستخدم ترميز نظام الملفات.
 
+
==البنية العامة==
== البنية العامة ==
 
 
<syntaxhighlight lang="ruby">
 
<syntaxhighlight lang="ruby">
children( dirname ) → array  
+
entries( dirname ) → array
children( 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">
== القيمة المٌعادة ==
+
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>
 
</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 في توثيق روبي الرسمي.]
 

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

مصادر