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

من موسوعة حسوب
< Ruby‏ | IO
لا ملخص تعديل
ط تدقيق
 
سطر 3: سطر 3:
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby IO]]
[[تصنيف: Ruby IO]]
يغلق التابع <code>close</code> [[Ruby/IO|مجرى د/خ]]، ويرسل (flushes) أي كتابات مُعلّقة إلى نظام التشغيل.  
يغلق التابع <code>close</code> [[Ruby/IO|المجرى]] الذي استدعي معه ويرسل (flushes) أي كتابات مُعلّقة إلى نظام التشغيل.  


المجرى لن يكون متاحًا لأي عمليات إضافية على البيانات؛ وفي حال محاولة إجراء مثل تلك العمليات، فسيُطللق الخطأ <code>IOError</code>. يتم إغلاق [[Ruby/IO|مجاري د/خ]] تلقائيًا من طرف جامع المهملات (garbage collector).
لن يكون المجرى متاحًا لأية عمليات إضافية على البيانات؛ وفي حال محاولة إجراء مثل تلك العمليات، فسيُطلَق الخطأ <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.
أصبحت روبي تتجاهل استدعاء هذا التابع على [[Ruby/IO|مجاري د/خ]] المغلقة منذ الإصدار 2.3.
==البنية العامة==
==البنية العامة==
<syntaxhighlight lang="ruby">close→ nil‎</syntaxhighlight>
<syntaxhighlight lang="ruby">close→ nil‎</syntaxhighlight>
==القيمة المُعادة==
==القيمة المعادة==
يعيد  التابع <code>close</code> '''القيمة <code>nil</code>.'''
تعاد القيمة <code>nil</code> بعد إغلاق المجرى المعطى، أو يطلق الخطأ <code>[[Ruby/IOError|IOError]]</code>.


==انظر أيضا==
==انظر أيضًا==
* التابع <code>[[Ruby/IO/close_on_exec-3D|close_on_exec=‎]]</code>: يعين قيمة الراية close-on-exec.
* التابع <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 قسم التابع close‎ في الصنف IO‎ في توثيق روبي الرسمي.]
*[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?‎: يتحقق إن كان مجرى د/خ مغلقًا تمامًا.

مصادر