عرض مصدر Ruby/ObjectSpace/garbage collect

{{DISPLAYTITLE:التابع <code>Object.garbage_collect</code> في روبي}}
يبدأ التابع <code>garbage_collect</code> عملية جمع المهملات (garbage collection)، إلّا إذا عُطِّلت يدويًا.

يُعرَّف هذا التابع عبر وسائط الكلمات المفتاحية (keyword arguments) المُعيَّنة افتراضيًا للقيمة <code>true</code>:<syntaxhighlight lang="ruby">
def GC.start(full_mark: true, immediate_sweep: true); end
</syntaxhighlight>يمكنك تعيين القيمة <code>false</code> للمعامل <code>full_mark</code> لتنفيذ الوحدة <code>GC</code> الثانوية.

ويمكنك تعيين القيمة <code>false</code> للمعامل <code>immediate_sweep</code> لتأجيل الكنس (sweeping، استخدام الكنس الكسول [lazy sweep]).

ملاحظة: تعتمد وسائط الكلمات المفتاحية على التطبيق والاصدار المُستخدم من روبي. لا يُضمن أن تبقى متوافقةً مستقبلًا، وقد يتم تجاهلها إذا كان التطبيق الأساسي لا يدعمها.

== البنية العامة ==
<syntaxhighlight lang="ruby">
start → nil
garbage_collect → nil
include GC; garbage_collect → nil
start(full_mark: true, immediate_sweep: true) → nil
garbage_collect(full_mark: true, immediate_sweep: true) → nil
include GC; garbage_collect(full_mark: true, immediate_sweep: true) → nil

</syntaxhighlight>

== المعاملات ==

=== <code>full_mark</code> ===
يأخذ هذا المعامل القيمة <code>true</code> (افتراضيًا) أو <code>false</code>، ويستخدم لتنفيذ الوحدة <code>[[Ruby/GC|GC]]</code> الثانوية.

=== immediate_sweep ===
يأخذ هذا المعامل القيمة <code>true</code> (افتراضيًا) أو <code>false</code>، ويستخدم لتأجيل الكنس (استخدام الكنس الكسول).

== القيم المعادة ==
تُعاد القيمة <code>nil</code> عند نجاح العملية.

== انظر أيضًا ==
* التابع <code>[[Ruby/ObjectSpace/ id2ref|id2ref_]]</code>: يُحوِل معرِّف الكائن إلى مرجعٍ للكائن.
* التابع <code>[[Ruby/ObjectSpace/count objects|count_objects]]</code>: يُحصِي جميع الكائنات التي من نوعٍ واحد.

* التابع <code>[[Ruby/ObjectSpace/define finalizer|define_finalizer]]</code>: يضيف كتلة <code>aProc</code> كمُنهِي ليُستدعى بعد تدمير الكائن.

* التابع <code>[[Ruby/ObjectSpace/each object|each_object]]</code>: يستدعي كتلةً محدَّدةً مرةً لكل كائنٍ نشطٍ أو غير مباشرٍ في هذه العملية الحالية في روبي.
* التابع <code>[[Ruby/ObjectSpace/undefine finalizer|undefine_finalizer]]</code>: يحذف جميع مُنهِيَات الكائن المعطى.

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