الفرق بين المراجعتين لصفحة: «Ruby/Dir/open»

المراجعة الحالية بتاريخ 06:42، 11 نوفمبر 2018

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

مصادر

قسم التابع open في الصنف Dir في توثيق روبي الرسمي.

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE:  التابع <code>open</code> الخاص بالصنف <code>Dir</code> في روبي}}</noinclude>
+<noinclude>{{DISPLAYTITLE:  التابع <code>Dir.open</code> في روبي}}</noinclude>
 [[تصنيف: Ruby]]
 [[تصنيف: Ruby Method]]
 [[تصنيف: Ruby Dir]]
-يعيد التابع <code>new</code> كائنًا مجلديًا (directory object) جديدًا خاصًا بالمجلد المعطى.
+يفتح التابع <code>open</code> مجلدًا محدَّدًا ثمَّ يعيد كائنًا يشير إليه. إن لم تمرَّر إليه كتلة، فهو مرادف للتابع <code>Dir::new</code>. أمَّا إن مُرِّرت إليه كتلة، فسيُمرّر إليها <code>aDir</code> (انظر فقرة البنية العامة) كمعامل. يُغلَق المجلد في بعد الانتهاء من تنفيذ الكتلة، ويعيد التابع <code>Dir::open</code> ناتج تنفيذ هذه الكتلة.
+==البنية العامة==
-الوسيط الاختياري ''<code>encoding</code>'' يحدد ترميز المجلد. وفي حال عدم إعطائه، سيُستخدم ترميز نظام الملفات.
-== البنية العامة ==
 <syntaxhighlight lang="ruby">
-new( string ) → aDir
+open( string ) → aDir
-new( string, encoding: enc ) → aDir
+open( string, encoding: enc ) → aDir
+open( string ) {| aDir | block } → anObject
+open( string, encoding: enc ) {| aDir | block } → anObject
 </syntaxhighlight>
+==المعاملات==
-== المعاملات ==
+===<code>string</code> ===
+اسم المجلد المراد فتحه.
-=== <code>string</code> ===
+===<code>encoding</code>===
-يحدد اسم المجلد المعطى.
+يحدِّد هذا الوسيط الاختياري ترميز المجلد. وفي حال عدم إعطائه، سيُستخدم ترميز نظام الملفات.
+==القيمة المعادة==
-=== <code>encoding</code> ===
+يعيد التابع <code>open</code> كائنًا مجلديًا (directory object) جديدًا يشير إلى المجلد الذي تمَّ فتحه لم تُعطَ أية كتلة <code>block</code>، أو يعاد ناتج تنفيذ الكتلة <code>block</code> إن أعطيت بعد فتح المجلد وتمريره إليها ثمَّ إغلاقه عند الانتهاء.
-يحدد ترميز المجلد
+==انظر أيضًا==
+*التابع <code>[[Ruby/Dir/new|new]]</code>: يعيد كائنًا مجلديًا (directory object) جديدًا خاصًا بالمجلد المعطى.
-== القيمة المٌعادة ==
+==مصادر==
-يعيد التابع <code>new</code> كائنًا مجلديًا (directory object) جديدًا خاصًا بالمجلد المعطى.
+*[http://ruby-doc.org/core-2.5.1/Dir.html#method-c-open قسم التابع open في الصنف Dir في توثيق روبي الرسمي.]
-== أنظر أيضًا ==
-* صفحة الصنف <code>[[Ruby/Dir|Dir]]</code>.
-* التابع <code>[[Ruby/Dir/chdir|chdir]]</code>: يستبدل التابع <code>chdir‎</code> مجلد العمل (working directory) الحالي للعملية ويعيّن مكانه السلسلة النصية المعطاة.
-== مصادر ==
-* [http://ruby-doc.org/core-2.5.1/Dir.html#method-c-new قسم  التابع new  في الصنف Dir في توثيق روبي الرسمي.]