عرض مصدر Ruby/ObjectSpace/count objects

{{DISPLAYTITLE:التابع <code>Object.count_objects</code> في روبي}}
يُحصِي التابع <code>count_objects</code> جميع الكائنات التي من نوعٍ واحد.

من المتوقع أن يعمل هذا التابع على C Ruby فقط.

== البنية العامة ==
<syntaxhighlight lang="ruby">
count_objects([result_hash]) → hash
</syntaxhighlight>

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

=== <code>result_hash</code> ===
إذا أُعطي الوسيط الاختياري <code>result_hash</code>، فسيُستبدَل (overwritten) الناتج ويعدَّل قبل إعادته ثمَّ يُعاد. الهدف من استعمال هذا المعامل هو تفادي تأثير الاختبار (probe effect).

== القيم المعادة ==
تُعاد تجزئةٌ (hash) مثل:<syntaxhighlight lang="ruby">
{
  :TOTAL=>10000,
  :FREE=>3011,
  :T_OBJECT=>6,
  :T_CLASS=>404,
  # ...
}

</syntaxhighlight>تتبع هذه المحتويات طريقة التنفيذ، لذلك قد تتغيَّر في المستقبل.

المفاتيح التي تبدأ بالمقطع <code>_T</code> تعني كائنات نشطة مثل <code>T_ARRAY</code> الذي يمثِّل عدد المصفوفات. يمثِّل المفتاح <code>FREE:</code> عدد مداخل الكائن (object slots) غير المستعملة حاليًا. يمثِّل المفتاح <code>TOTAL:</code> المجموع الكلي لما يسبقه.

== أمثلة ==
مثالٌ عن استخدام التابع <code>count_objects</code>:<syntaxhighlight lang="ruby">
h = {}
ObjectSpace.count_objects(h)
puts h
# => { :TOTAL=>10000, :T_CLASS=>158280, :T_MODULE=>20672, :T_STRING=>527249 }

</syntaxhighlight>

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

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

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