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

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

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

إليك مثلًا الشيفرة التالية:

[
  {
     :GC_TIME=>1.3000000000000858e-05,
     :GC_INVOKE_TIME=>0.010634999999999999,
     :HEAP_USE_SIZE=>289640,
     :HEAP_TOTAL_SIZE=>588960,
     :HEAP_TOTAL_OBJECTS=>14724,
     :GC_IS_MARKED=>false
  },
  # ...
]

وتعني المفاتيح الموجودة في الشيفرة ما يلي:

‎:GC_TIME: الوقت Time المنقضي بالثواني لتشغيل GC هذا.

‎:GC_INVOKE_TIME: الوقت Time المنقضي بالثواني من بدء التشغيل وحتى استدعاء GC.

‎:HEAP_USE_SIZE: إجمالي ‫ذاكرة‬ ‫الكومة (heap) المستخدمة بوحدة البايت.

‎:HEAP_TOTAL_SIZE: إجمالي ‫ذاكرة‬ ‫الكومة بوحدة البايت.

‎:HEAP_TOTAL_OBJECTS: إجمالي عدد الكائنات.

‎:GC_IS_MARKED: إعادة true إذا كان GC في مرحلة التحديد.

إذا بُنيَت روبي مع GC_PROFILE_MORE_DETAIL، سيكون من الممكن أيضًا الوصول إلى مفاتيح النوع Hash التالية:

:GC_MARK_TIME
:GC_SWEEP_TIME
:ALLOCATE_INCREASE
:ALLOCATE_LIMIT
:HEAP_USE_PAGES
:HEAP_LIVE_OBJECTS
:HEAP_FREE_OBJECTS
:HAVE_FINALIZE

البنية العامة

GC::Profiler.raw_data → [Hash, ...]

القيمة المعادة

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

انظر أيضا

التابع report: يكتب الناتج ‎::result على المجرى ‎$stdout أو كائن من النوع IO.
التابع total_time: يعيد إجمالي الوقت المستخدم لتجميع البيانات المهملة بالثواني.

مصادر

قسم التابع raw_data في الصنف GC::Profiler في توثيق روبي الرسمي.

@@ سطر 3: / سطر 3: @@
 [[تصنيف: Ruby Method]]
 [[تصنيف: Ruby GC::Profiler]]
-يعيد التابع <code>raw_data</code>
+يعيد التابع <code>raw_data</code>  مصفوفة من [[Ruby/Hash|الأنواع Hash]] تحوي بيانات ملفات التعريف الأولية الفردية مُرتَّبة من الأقدم إلى الأحدث بواسطة <code>‎:GC_INVOKE_TIME</code>.
+إليك مثلًا الشيفرة التالية:<syntaxhighlight lang="ruby">
+[
+  {
+     :GC_TIME=>1.3000000000000858e-05,
+     :GC_INVOKE_TIME=>0.010634999999999999,
+     :HEAP_USE_SIZE=>289640,
+     :HEAP_TOTAL_SIZE=>588960,
+     :HEAP_TOTAL_OBJECTS=>14724,
+     :GC_IS_MARKED=>false
+  },
+  # ...
+]
+</syntaxhighlight>وتعني المفاتيح الموجودة في الشيفرة ما يلي:
+* <code>‎:GC_TIME</code>: الوقت <code>[[Ruby/Time|Time]]</code> المنقضي بالثواني لتشغيل <code>[[Ruby/GC|GC]]</code> هذا.
+* ‎<code>:GC_INVOKE_TIME</code>: الوقت <code>[[Ruby/Time|Time]]</code> المنقضي بالثواني من بدء التشغيل وحتى استدعاء <code>[[Ruby/GC|GC]]</code>.
+* <code>‎:HEAP_USE_SIZE</code>: إجمالي ‫ذاكرة‬ ‫الكومة (heap) المستخدمة بوحدة البايت.
+* ‎<code>:HEAP_TOTAL_SIZE</code>: إجمالي ‫ذاكرة‬ ‫الكومة بوحدة البايت.
+* ‎<code>:HEAP_TOTAL_OBJECTS</code>: إجمالي عدد الكائنات.
+* <code>‎:GC_IS_MARKED</code>: إعادة <code>true</code> إذا كان GC في مرحلة التحديد.
+إذا بُنيَت روبي مع <code>GC_PROFILE_MORE_DETAIL</code>، سيكون من الممكن أيضًا الوصول إلى مفاتيح [[Ruby/Hash|النوع Hash]] التالية:<syntaxhighlight lang="ruby">
+:GC_MARK_TIME
+:GC_SWEEP_TIME
+:ALLOCATE_INCREASE
+:ALLOCATE_LIMIT
+:HEAP_USE_PAGES
+:HEAP_LIVE_OBJECTS
+:HEAP_FREE_OBJECTS
+:HAVE_FINALIZE
+</syntaxhighlight>
 ==البنية العامة==
 <syntaxhighlight lang="ruby">GC::Profiler.raw_data → [Hash, ...]</syntaxhighlight>
 ==القيمة المعادة==
-تعاد
+تعاد مصفوفة من [[Ruby/Hash|الأنواع Hash]] تحوي بيانات ملفات التعريف الأولية الفردية مُرتَّبة من الأقدم إلى الأحدث بواسطة <code>‎:GC_INVOKE_TIME</code>.
 ==انظر أيضا==
+* التابع <code>[[Ruby/GC::Profiler/report|report]]</code>: يكتب الناتج ‎<code>::result</code> على المجرى <code>‎$stdout</code> أو كائن من النوع <code>[[Ruby/IO|IO]]</code>.
+* التابع <code>[[Ruby/GC::Profiler/total time|total_time]]</code>: يعيد إجمالي الوقت المستخدم لتجميع البيانات المهملة بالثواني.
 ==مصادر==
 *[http://ruby-doc.org/core-2.5.1/GC/Profiler.html#method-c-raw_data قسم التابع raw_data في الصنف GC::Profiler في توثيق روبي الرسمي.]