التابع Dir.entries في روبي

من موسوعة حسوب
< Ruby‏ | Dir

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

مصادر