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

من موسوعة حسوب
< Ruby‏ | Dir
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:  التابع <code>open</code> الخاص بالصنف <code>Dir</code> في روبي}}</noinclude> تصنيف: Ruby تصنيف: Rub...'
 
لا ملخص تعديل
سطر 3: سطر 3:
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Dir]]
[[تصنيف: 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">
<syntaxhighlight lang="ruby">
new( string ) → aDir
open( string ) → aDir  
new( string, encoding: enc ) → aDir
open( string, encoding: enc ) → aDir
</syntaxhighlight>
open( string ) {| aDir | block } → anObject
open( string, encoding: enc ) {| aDir | block } → anObject
</syntaxhighlight>الوسيط الاختياري ''<code>encoding</code>'' يحدد ترميز المجلد. وفي حال عدم إعطائه، سيُستخدم ترميز نظام الملفات.


== المعاملات ==
== المعاملات ==
سطر 19: سطر 19:


=== <code>encoding</code> ===
=== <code>encoding</code> ===
يحدد ترميز المجلد
يحدد ترميز المجلد.


== القيمة المٌعادة ==
== القيمة المٌعادة ==
يعيد التابع <code>new</code> كائنًا مجلديًا (directory object) جديدًا خاصًا بالمجلد المعطى.
يعيد التابع <code>open</code> كائنًا مجلديًا (directory object) جديدًا. وفي حالة إعطاء كتلة فسيعيد قيمة تلك الكتلة.


== أنظر أيضًا ==
== أنظر أيضًا ==
* صفحة الصنف <code>[[Ruby/Dir|Dir]]</code>.
* صفحة الصنف <code>[[Ruby/Dir|Dir]]</code>.
* التابع <code>[[Ruby/Dir/chdir|chdir]]</code>: يستبدل التابع <code>chdir‎</code> مجلد العمل (working directory) الحالي للعملية ويعيّن مكانه السلسلة النصية المعطاة.
* التابع <code>[[Ruby/Dir/new|new]]</code>: يعيد التابع <code>new</code> كائنًا مجلديًا (directory object) جديدًا خاصًا بالمجلد المعطى. 


== مصادر ==
== مصادر ==
* [http://ruby-doc.org/core-2.5.1/Dir.html#method-c-new قسم  التابع new في الصنف Dir في توثيق روبي الرسمي.]
* [http://ruby-doc.org/core-2.5.1/Dir.html#method-c-open قسم  التابع open في الصنف Dir في توثيق روبي الرسمي.]

مراجعة 18:13، 23 سبتمبر 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

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

المعاملات

string 

يحدد اسم المجلد المعطى.

encoding

يحدد ترميز المجلد.

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

يعيد التابع open كائنًا مجلديًا (directory object) جديدًا. وفي حالة إعطاء كتلة فسيعيد قيمة تلك الكتلة.

أنظر أيضًا

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

مصادر