التابع Dir.open في روبي
يفتح التابع 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) جديدًا خاصًا بالمجلد المعطى.