الفرق بين المراجعتين لصفحة: «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>IO.open</code> مرادفاً للتابع <code>[[Ruby/IO/new|::new]]</code>.  أما في حال تمرير الكتلة البرمجية، فسيُمرّر إليها <code>io</code> (انظر فقرة البنية العامة) كوسيط، وسيتم إغلاق [[Ruby/IO|مجرى د/خ]] (<code>[[Ruby/IO|IO]]</code>) تلقائيًا عند إنهاء الكتلة. في هذه الحالة، سيعيد التابع <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>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/new|new]]</code>: يُعيد التابع <code>new</code> كائنًا جديدًا من النوع <code>[[Ruby/IO|IO]]</code> لواصف الملف (file descriptor) المعطى <code>fd</code> (انظر فقرة البنية العامة) والوضع <code>mode</code>.  يمكن استخدام <code>opt</code> لتحديد أجزاء من <code>mode</code> بطريقة أكثر قابلية للقراءة.  انظر أيضًا صفحتي <code>[[Ruby/IO/sysopen|::sysopen]]</code> و <code>[[Ruby/IO/for_fd|::for_fd]]</code>.
+يعاد كائن جديد من النوع <code>[[Ruby/IO|IO]]</code> إن لم تعطَ الكتلة <code>block</code>، أو يعاد ناتج تنفيذ الكتلة <code>block</code> مع الكائن <code>[[Ruby/IO|IO]]</code> المنشأ آنذاك.
-* التابع <code>[[Ruby/IO/pipe|pipe]]</code>: ينشئ التابع <code>pipe</code> زوجًا من مداخل الأنابيب (pipe endpoints) (متصلة ببعضها البعض) ثم يعيدها على هيئة [[Ruby/Array|مصفوفة]] ثنائية من [[Ruby/IO|مجريات د/خ]] <code>IO</code>:‏ <code>[</code> <code>read_io</code> و <code>write_io</code> <code>]</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‎ في توثيق روبي الرسمي.]