عرض مصدر Ruby/Queue/close

{{DISPLAYTITLE:التابع <code>Queue.close</code> في روبي}}
يغلق التابع <code>close</code> الطابور الذي استُدعي معه. لا يمكن إعادة فتح طابور الانتظار المُغلق.

بعد اكتمال استدعاء طلب الإغلاق، سيكون التالي صحيحًا:
* سيعيد التابع <code>[[Ruby/Queue/closed-3F|?closed]]</code>  القيمة <code>true</code>.
* سيُتجاهل التابع <code>[[Ruby/Queue/close|close]]</code> إن استدعي مرة أخرى مع نفس الطابور.
* استدعاء التابع <code>[[Ruby/Queue/enq|enq]]</code> أو التابع <code>[[Ruby/Queue/push|push]]</code> أو المعامل<code>[[Ruby/Queue/3C-3C|>>]]</code>  سيرمي استثناءً.
* عندما يُعيد التابع <code>[[Ruby/Queue/empty-3F|?empty]]</code>  القيمة <code>false</code>، سيُعيد استدعاء التابع <code>[[Ruby/Queue/deq|deq]]</code> أو <code>[[Ruby/Queue/pop|pop]]</code> أو <code>[[Ruby/Queue/shift|shift]]</code> كائنًا من طابور الانتظار كالمعتاد.
الاستثناء <code>ClosedQueueError</code> موروثٌ من الصنف [[Ruby/StopIteration|StopIteration]]، لذلك يمكنك كسر كتلة حلقة التكرار (loop block).

== البنية العامة ==
<syntaxhighlight lang="ruby">
close
</syntaxhighlight>

== أمثلة ==
مثالٌ عن استخدام التابع <code>close</code>:<syntaxhighlight lang="ruby">
    q = Queue.new
    Thread.new{
      while e = q.deq # wait for nil to break loop
        # ...
      end
    }
    q.close

</syntaxhighlight>

== انظر أيضًا ==
* التابع <code>[[Ruby/Queue/length|length]]</code> : يعيد طول الطابور الذي استُدعي معه.
* التابع <code>[[Ruby/Queue/clear|clear]]</code> : يحذف كل الكائنات من الطابور الذي استُدعي معه.
* التابع <code>[[Ruby/Queue/pop|pop]]</code>: يجلب بياناتٍ من الطابور الذي استُدعي معه.

== مصادر ==
* [http://ruby-doc.org/core-2.5.1/Queue.html#method-i-close صفحة التابع close في الصنف queue في توثيق روبي الرسمي.]
[[تصنيف:Ruby]]
[[تصنيف:Ruby Method]]
[[تصنيف:Ruby Queue]]