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

المراجعة الحالية بتاريخ 08:56، 23 ديسمبر 2018

يشبه التابع open التابع new تمامًا عند استدعائه دون كتلة، أو يُمرّر الكائن IO الذي جرى إنشاؤه كوسيط إلى الكتلة المعطاة ثم يعيد الناتج الذي تعيده الكتلة. سيتم إغلاق ذلك المجرى تلقائيًا عند إنهاء الكتلة منه. وفي هذه الحالة.

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

open(fd, mode="r" [, opt]) → io
open(fd, mode="r" [, opt]) {|io| block }  → obj‎

المعاملات

`fd‎`

واصف الملف المراد فتحه.

`mode‎`

وضع الفتح الذي يحدد الكيفية والغرض من فتح الملف ذي الواصف fd. القيمة الافتراضية هي: "r". لمعرفة القيم التي يمكن استعمالها مع هذا المعامل، ارجع إلى صفحة التابع new.

`opt‎`

يمكن استخدام هذا المعامل لتحديد أجزاء من الوضع mode بطريقة أكثر قابلية للقراءة. للمزيد من التفاصيل، ارجع إلى صفحة التابع new.

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

يعاد كائن جديد من النوع IO إن لم تعطَ الكتلة block، أو يعاد ناتج تنفيذ الكتلة block مع الكائن IO المنشأ آنذاك.

انظر أيضًا

التابع new: يُنشئ كائنًا جديدًا من النوع IO.
التابع sysopen: يفتح الملف الموجود في المسار المحدد، ثم يعيد واصف الملف الأساسي كعدد صحيح.
التابع reopen: يعيد ربط المجرى الذي استُدعي معه مع مجرى آخر جديد أو موجود مسبقًا.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع <code>open‎</code> الخاص بالصنف <code>IO</code> في روبي}}</noinclude>
+<noinclude>{{DISPLAYTITLE: التابع <code>IO.open‎</code> في روبي}}</noinclude>
 [[تصنيف: Ruby]]
 [[تصنيف: Ruby Method]]
 [[تصنيف: Ruby IO]]
-عند عدم تمرير كتلة، فسيكون التابع <code>open</code> مرادفاً للتابع <code>[[Ruby/IO/new|new]]</code>.  أما في حال تمرير الكتلة البرمجية، فسيُمرّر إليها  [[Ruby/IO|مجرى د/خ]] المستقبِل كوسيط، وسيتم إغلاق ذلك المجرى تلقائيًا عند إنهاء الكتلة. وفي هذه الحالة، سيعيد التابع <code>[[Ruby/IO/open|open]]</code> قيمة الكتلة.
+يشبه التابع <code>open</code> التابع <code>[[Ruby/IO/new|new]]</code> تمامًا عند استدعائه دون كتلة، أو يُمرّر الكائن <code>IO</code> الذي جرى إنشاؤه كوسيط إلى الكتلة المعطاة ثم يعيد الناتج الذي تعيده الكتلة. سيتم إغلاق ذلك المجرى تلقائيًا عند إنهاء الكتلة منه. وفي هذه الحالة.
-راجع صفحة <code>[[Ruby/IO/new|new]]</code> للتعرف على الوسائط <code>fd</code> و <code>mode</code> و <code>opt</code>.
 ==البنية العامة==
 <syntaxhighlight lang="ruby">open(fd, mode="r" [, opt]) → io
 open(fd, mode="r" [, opt]) {|io| block }  → obj‎</syntaxhighlight>
-==القيمة المُعادة==
-يعيد التابع <code>open</code> كائنا من النوع <code>IO</code>.
-==انظر أيضا==
+== المعاملات ==
-*التابع <code>[[Ruby/IO/new|new]]</code>: يُعيد التابع <code>new</code> كائنًا جديدًا من النوع <code>[[Ruby/IO|IO]]</code>
+===<code>fd‎</code>===
+واصف الملف المراد فتحه.
+===<code>mode‎</code>===
+وضع الفتح الذي يحدد الكيفية والغرض من فتح الملف ذي الواصف <code>fd</code>. القيمة الافتراضية هي: "r". لمعرفة القيم التي يمكن استعمالها مع هذا المعامل، ارجع إلى صفحة التابع <code>[[Ruby/IO/new|new]]</code>.
+===<code>opt‎</code>===
+يمكن استخدام هذا المعامل لتحديد أجزاء من الوضع <code>mode</code> بطريقة أكثر قابلية للقراءة. للمزيد من التفاصيل، ارجع إلى صفحة التابع <code>[[Ruby/IO/new|new]]</code>.
+==القيمة المعادة==
+يعاد كائن جديد من النوع <code>[[Ruby/IO|IO]]</code> إن لم تعطَ الكتلة <code>block</code>، أو يعاد ناتج تنفيذ الكتلة <code>block</code> مع الكائن <code>[[Ruby/IO|IO]]</code> المنشأ آنذاك.
+==انظر أيضًا==
+*التابع <code>[[Ruby/IO/new|new]]</code>: يُنشئ كائنًا جديدًا من النوع <code>[[Ruby/IO|IO]]</code>.
+*التابع [[Ruby/IO/sysopen|<code>sysopen</code>]]: يفتح الملف الموجود في المسار المحدد، ثم يعيد واصف الملف الأساسي ك[[Ruby/Integer|عدد صحيح]].
+*التابع [[Ruby/IO/reopen|<code>reopen</code>]]: يعيد ربط <nowiki/>[[Ruby/IO|المجرى]] الذي استُدعي معه مع <nowiki/>[[Ruby/IO|مجرى]] آخر جديد أو موجود مسبقًا.
 ==مصادر==
-*[http://ruby-doc.org/core-2.5.1/IO.html#method-c-open قسم  التابع open‎ في الصنف IO‎ في توثيق روبي الرسمي.]
+*[http://ruby-doc.org/core-2.5.1/IO.html#method-c-open قسم التابع open‎ في الصنف IO‎ في توثيق روبي الرسمي.]