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