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