الفرق بين المراجعتين لصفحة: «Ruby/IO/close»
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) ط تدقيق |
||
سطر 3: | سطر 3: | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby IO]] | [[تصنيف: Ruby IO]] | ||
يغلق التابع <code>close</code> [[Ruby/IO| | يغلق التابع <code>close</code> [[Ruby/IO|المجرى]] الذي استدعي معه ويرسل (flushes) أي كتابات مُعلّقة إلى نظام التشغيل. | ||
لن يكون المجرى متاحًا لأية عمليات إضافية على البيانات؛ وفي حال محاولة إجراء مثل تلك العمليات، فسيُطلَق الخطأ <code>[[Ruby/IOError|IOError]]</code>. يتم إغلاق [[Ruby/IO|مجاري د/خ]] تلقائيًا من طرف جامع المهملات (garbage collector). | |||
في حال فتح [[Ruby/IO|مجرى د/خ]] بواسطة التابع <code>[[Ruby/IO/popen|popen]]</code>، فسيعيّن التابع <code>close</code> قيمة <code>$?</code>. | في حال فتح [[Ruby/IO|مجرى د/خ]] بواسطة التابع <code>[[Ruby/IO/popen|popen]]</code>، فسيعيّن التابع <code>close</code> قيمة <code>$?</code>. | ||
تتجاهل | أصبحت روبي تتجاهل استدعاء هذا التابع على [[Ruby/IO|مجاري د/خ]] المغلقة منذ الإصدار 2.3. | ||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby">close→ nil</syntaxhighlight> | <syntaxhighlight lang="ruby">close→ nil</syntaxhighlight> | ||
==القيمة | ==القيمة المعادة== | ||
تعاد القيمة <code>nil</code> بعد إغلاق المجرى المعطى، أو يطلق الخطأ <code>[[Ruby/IOError|IOError]]</code>. | |||
==انظر | ==انظر أيضًا== | ||
* التابع <code>[[Ruby/IO/close_on_exec-3D| | * التابع <code>[[Ruby/IO/close_on_exec-3D|close_on_exec]]</code>: يعين عند استدعائه بالشكل <code>close_on_exec = bool</code> قيمة الراية <code>close-on-exec</code> إلى القيمة <code>bool</code>. | ||
* التابع [[Ruby/IO/close read|<code>close_read</code>]]: يغلق طرف القراءة الخاص [[Ruby/IO|بمجرى د/خ]] مزدوج (duplex). | |||
* التابع <code>[[Ruby/IO/closed-3F|closed?]]</code>: يتحقق إن كان مجرى د/خ مغلقًا تمامًا. | |||
==مصادر== | ==مصادر== | ||
*[http://ruby-doc.org/core-2.5.1/IO.html#method-i-close قسم | *[http://ruby-doc.org/core-2.5.1/IO.html#method-i-close قسم التابع close في الصنف IO في توثيق روبي الرسمي.] |
المراجعة الحالية بتاريخ 08:42، 22 ديسمبر 2018
يغلق التابع close
المجرى الذي استدعي معه ويرسل (flushes) أي كتابات مُعلّقة إلى نظام التشغيل.
لن يكون المجرى متاحًا لأية عمليات إضافية على البيانات؛ وفي حال محاولة إجراء مثل تلك العمليات، فسيُطلَق الخطأ IOError
. يتم إغلاق مجاري د/خ تلقائيًا من طرف جامع المهملات (garbage collector).
في حال فتح مجرى د/خ بواسطة التابع popen
، فسيعيّن التابع close
قيمة $?
.
أصبحت روبي تتجاهل استدعاء هذا التابع على مجاري د/خ المغلقة منذ الإصدار 2.3.
البنية العامة
close→ nil
القيمة المعادة
تعاد القيمة nil
بعد إغلاق المجرى المعطى، أو يطلق الخطأ IOError
.
انظر أيضًا
- التابع
close_on_exec
: يعين عند استدعائه بالشكلclose_on_exec = bool
قيمة الرايةclose-on-exec
إلى القيمةbool
. - التابع
close_read
: يغلق طرف القراءة الخاص بمجرى د/خ مزدوج (duplex). - التابع
closed?
: يتحقق إن كان مجرى د/خ مغلقًا تمامًا.