التابع Dir.children في روبي
اذهب إلى التنقل
اذهب إلى البحث
يعيد التابع 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.