الفرق بين المراجعتين ل"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

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

مصادر