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

من موسوعة حسوب
< Ruby‏ | Dir
اذهب إلى التنقل اذهب إلى البحث

يفتح التابع open مجلدًا محدَّدًا ثمَّ يعيد كائنًا يشير إليه. إن لم تمرَّر إليه كتلة، فهو مرادف للتابع Dir::new. أمَّا إن مُرِّرت إليه كتلة، فسيُمرّر إليها aDir (انظر فقرة البنية العامة) كمعامل. يُغلَق المجلد في بعد الانتهاء من تنفيذ الكتلة، ويعيد التابع Dir::open ناتج تنفيذ هذه الكتلة.

البنية العامة

open( string )  aDir 
open( string, encoding: enc )  aDir
open( string ) {| aDir | block }  anObject
open( string, encoding: enc ) {| aDir | block }  anObject

المعاملات

string 

اسم المجلد المراد فتحه.

encoding

يحدِّد هذا الوسيط الاختياري ترميز المجلد. وفي حال عدم إعطائه، سيُستخدم ترميز نظام الملفات.

القيمة المعادة

يعيد التابع open كائنًا مجلديًا (directory object) جديدًا يشير إلى المجلد الذي تمَّ فتحه لم تُعطَ أية كتلة block، أو يعاد ناتج تنفيذ الكتلة block إن أعطيت بعد فتح المجلد وتمريره إليها ثمَّ إغلاقه عند الانتهاء.

انظر أيضًا

  • التابع new: يعيد كائنًا مجلديًا (directory object) جديدًا خاصًا بالمجلد المعطى. 

مصادر