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

من موسوعة حسوب
أنشأ الصفحة ب' <noinclude>{{DISPLAYTITLE: منشئ ملفات تعريف جمع البيانات المهملة (GC::Profiler) في روبي}}</noinclude> = منشئ ملفات تع...'
 
مراجعة وتدقيق.
 
(مراجعة متوسطة واحدة بواسطة مستخدم واحد آخر غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: منشئ ملفات تعريف جمع البيانات المهملة (GC::Profiler) في روبي}}</noinclude>
<noinclude>{{DISPLAYTITLE:الوحدة <code>GC::Profiler</code> في روبي}}</noinclude>يوفر مُنشئ ملفات تعريف جمع البيانات المهملة <code>GC::Profiler</code> الوصول إلى معلومات عن تشغيلات <code>[[Ruby/GC|GC]]</code> بما في ذلك الوقت والطول وحجم مساحة الكائن. اطلع مثلًا على المثال التالي:<syntaxhighlight lang="ruby">
GC::Profiler.enable
require 'rdoc/rdoc'
GC::Profiler.report
GC::Profiler.disable
</syntaxhighlight>اطلع أيضًا على صفحات التوابع <code>[[Ruby/GC/count|GC.count]]</code> و <code>[[Ruby/GC/malloc allocated size|GC.malloc_allocated_size]]</code> و <code>[[Ruby/GC/malloc allocations|GC.malloc_allocations]]</code>.


= منشئ ملفات تعريف جمع البيانات المهملة (GC::Profiler) =
== توابع الصنف العام ==
يوفر مُنشئ ملفات تعريف جمع البيانات المهملة GC::Profiler الوصول إلى معلومات عن تشغيلات GC بما في ذلك الوقت والطول وحجم مساحة الكائن.
===<code>[[Ruby/GC::Profiler/clear|clear]]</code>===
يمسح بيانات مُنشئ ملفات تعريف <code>[[Ruby/GC|GC]]</code>.


أمثلة:
===<code>[[Ruby/GC::Profiler/disable|disable]]</code>===
يوقف مُنشئ ملفات تعريف <code>[[Ruby/GC|GC]]</code>.


انظر أيضًا GC.count و GC.malloc_allocated_size و GC.malloc_allocations
===<code>[[Ruby/GC::Profiler/enable|enable]]</code>===
يبدأ منشئ ملفات تعريف <code>[[Ruby/GC|GC]]</code>.


=== توابع الصنف العام ===
===<code>[[Ruby/GC::Profiler/enabled-3F|enabled?‎]]</code>===
يتحقق من الحالة الحالية لوضع مُنشئ ملفات تعريف <code>[[Ruby/GC|GC]]</code>.


==== <code>GC::Profiler.clear → nil</code> ====
===<code>[[Ruby/GC::Profiler/raw_data|raw_data]]</code>===
مسح بيانات مُنشئ ملفات تعريف GC.
يعيد مصفوفة من <nowiki/>[[Ruby/Hash|الأنواع Hash]] تحوي بيانات ملفات التعريف الأولية الفردية مُرتَّبة من الأقدم إلى الأحدث بواسطة <code>‎:GC_INVOKE_TIME</code>.


==== <code>GC::Profiler.disable → nil</code> ====
===<code>[[Ruby/GC::Profiler/report|report]]</code>===
إيقاف مُنشئ ملفات تعريف GC.
يكتب الناتج ‎<code>::result</code> على المجرى <code>‎$stdout</code> أو كائن من النوع <code>[[Ruby/IO|IO]]</code>.


==== <code>GC::Profiler.enable → nil</code> ====
===<code>[[Ruby/GC::Profiler/result|result]]</code>===
بدء منشئ ملفات تعريف GC.
يعيد تقرير بيانات ملف التعريف.


==== <code>GC::Profiler.enabled? → true or false</code> ====
===<code>[[Ruby/GC::Profiler/total_time|total_time]]</code>===
الحالة الحالية لوضع مُنشئ ملفات تعريف GC.
يعيد إجمالي الوقت المستخدم لتجميع البيانات المهملة بالثواني.


==== <code>GC::Profiler.raw_data → [Hash, ...]‎</code> ====
== مصادر ==
إعادة مصفوفة Array من تجزئات بيانات ملفات التعريف الأولية الفردية مُرتَّبة من الأقدم إلى الأحدث بواسطة ‎:GC_INVOKE_TIME.
* [http://ruby-doc.org/core-2.5.1/GC/Profiler.html صفحة الوحدة GC::Profiler في توثيق روبي الرسمي].
 
فعلى سبيل المثال:
 
وتعني المفاتيح:
 
===== <code>‎:GC_TIME</code> =====
الوقت المنقضي Time بالثواني لتشغيل GC هذا.
 
===== <code>:GC_INVOKE_TIME</code> =====
الوقت المنقضي Time بالثواني من بدء التشغيل وحتى استدعاء GC.
 
===== <code>‎:HEAP_USE_SIZE</code> =====
إجمالي ‫ذاكرة‬ ‫التكدس‬ المستخدمة بوحدة البايت.
 
===== <code>:HEAP_TOTAL_SIZE</code> =====
إجمالي ‫ذاكرة‬ ‫التكدس‬ بوحدة البايت.
 
===== <code>:HEAP_TOTAL_OBJECTS</code> =====
إجمالي عدد الكائنات.
 
===== <code>‎:GC_IS_MARKED</code> =====
إعادة <code>true</code> إذا كان GC في مرحلة التحديد.
 
إذا بُنيَ روبي مع GC_PROFILE_MORE_DETAIL، سيكون من الممكن أيضا الوصول إلى مفاتيح التجزئة التالية:
 
==== <code>GC::Profiler.report</code> ====
 
==== <code>GC::Profiler.report(io)‎</code> ====
كتابة ‎::result إلى ‎$stdout أو كائن IO المُعطي.
 
==== <code>GC::Profiler.result → String</code> ====
إعادة تقرير بيانات ملف التعريف مثل:
 
==== <code>GC::Profiler.total_time → float</code> ====
إجمالي الوقت المستخدم لتجميع البيانات المهملة بالثواني.
 
= مصادر =
* صفحة GC::Profiler في توثيق روبي الرسمي.
[[تصنيف:Ruby]]
[[تصنيف:Ruby]]
[[تصنيف:Ruby Methods]]
[[تصنيف:Ruby Module]]
[[تصنيف:Ruby GC::Profiler]]

المراجعة الحالية بتاريخ 07:52، 25 نوفمبر 2018

يوفر مُنشئ ملفات تعريف جمع البيانات المهملة GC::Profiler الوصول إلى معلومات عن تشغيلات GC بما في ذلك الوقت والطول وحجم مساحة الكائن. اطلع مثلًا على المثال التالي:

GC::Profiler.enable
require 'rdoc/rdoc'
GC::Profiler.report
GC::Profiler.disable

اطلع أيضًا على صفحات التوابع GC.count و GC.malloc_allocated_size و GC.malloc_allocations.

توابع الصنف العام

clear

يمسح بيانات مُنشئ ملفات تعريف GC.

disable

يوقف مُنشئ ملفات تعريف GC.

enable

يبدأ منشئ ملفات تعريف GC.

enabled?‎

يتحقق من الحالة الحالية لوضع مُنشئ ملفات تعريف GC.

raw_data

يعيد مصفوفة من الأنواع Hash تحوي بيانات ملفات التعريف الأولية الفردية مُرتَّبة من الأقدم إلى الأحدث بواسطة ‎:GC_INVOKE_TIME.

report

يكتب الناتج ‎::result على المجرى ‎$stdout أو كائن من النوع IO.

result

يعيد تقرير بيانات ملف التعريف.

total_time

يعيد إجمالي الوقت المستخدم لتجميع البيانات المهملة بالثواني.

مصادر