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

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

مصادر