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