عرض مصدر Ruby/Process/clock gettime

<noinclude>{{DISPLAYTITLE: التابع <code>Process.clock_gettime</code> في روبي}}</noinclude>
يعيد التابع <code>clock_gettime</code> الوقت المعاد عبر الدالة <code>clock_gettime()‎</code> الذي يخص POSIX.
==البنية العامة==
<syntaxhighlight lang="ruby">clock_gettime(clock_id [, unit]) → number</syntaxhighlight>تعيد الدالة الضمنية، التي هي <code>clock_gettime()‎</code>، عدد النانو ثواني. الكائن <code>[[Ruby/Float|Float]]</code> (العدد العشري المضاعف وفق المعيار IEEE 754) ليس كافيًا لتمثيل القيمة المعادة من أجل <code>CLOCK_REALTIME</code>. إن كان عدد النانو ثواني الدقيق نفسه مطلوب، فاستعمل القيمة ‎<code>:nanoseconds</code> مع المعامل <code>unit</code>.

يختلف أصل (نقطة الصفر) القيمة المعادة. على سبيل المثال، يمكن أن يكون نقطة بدء تشغيل النظام، أو بدء تشغيل العملية، أو وقت بدء توقيت يونكس ...إلخ.

يُعرَّف الأصل في <code>CLOCK_REALTIME</code> على أنَّه بدء توقيت يونكس (1970-01-01 00:00:00 UTC). مع ذلك، تجد أنَّ بعض الأنظمة تُدخِل الثواني الكبيسة في الحسبان والآخر لا يفعل ذلك. لذلك، يمكن أن تُفسَّر النتيجة بشكل مختلف عبر الأنظمة. يُنصح باستعمال [[Ruby/Time/now|<code>Time.now</code>]] عبر <code>CLOCK_REALTIME</code>.

==المعاملات==
===<code>clock_id</code>===
يحدِّد نوع النبضات. يُحدَّد هذا المعامل كثابت يبدأ بالسابقة <code>Process::CLOCK_‎</code> مثل <code>Process::CLOCK_REALTIME</code> و <code>Process::CLOCK_MONOTONIC</code>.

تعتمد الثوابت المدعومة على نظام التشغيل المستعمل وإصداره. توفر روبي الأنواع التالية للمعامل <code>clock_id</code> (إن كانت متاحة بحسب نظام التشغيل):
{| class="wikitable"
!النوع المعامل <code>clock_id</code>
!نوع وإصدار نظام التشغيل
|-
|<code>CLOCK_REALTIME</code>
|SUSv2-4, Linux 2.5.63, FreeBSD 3.0, NetBSD 2.0, OpenBSD 2.1, macOS 10.12
|-
|<code>CLOCK_MONOTONIC</code>
|SUSv3-4, Linux 2.5.63, FreeBSD 3.0, NetBSD 2.0, OpenBSD 3.4, macOS 10.12
|-
|<code>CLOCK_PROCESS_CPUTIME_ID</code>
|SUSv3-4, Linux 2.5.63, OpenBSD 5.4, macOS 10.12
|-
|<code>CLOCK_THREAD_CPUTIME_ID</code>
|SUSv3-4, Linux 2.5.63, FreeBSD 7.1, OpenBSD 5.4, macOS 10.12
|-
|<code>CLOCK_VIRTUAL</code>
|FreeBSD 3.0, OpenBSD 2.1
|-
|<code>CLOCK_PROF</code>
|FreeBSD 3.0, OpenBSD 2.1
|-
|<code>CLOCK_REALTIME_FAST</code>
|FreeBSD 8.1
|-
|<code>CLOCK_REALTIME_PRECISE</code>
|FreeBSD 8.1
|-
|<code>CLOCK_REALTIME_COARSE</code>
|Linux 2.6.32
|-
|<code>CLOCK_REALTIME_ALARM</code>
|Linux 3.0
|-
|<code>CLOCK_MONOTONIC_FAST</code>
|FreeBSD 8.1
|-
|<code>CLOCK_MONOTONIC_PRECISE</code>
|Linux 2.6.32
|-
|<code>CLOCK_MONOTONIC_RAW</code>
|Linux 2.6.28, macOS 10.12
|-
|<code>CLOCK_MONOTONIC_RAW_APPROX</code>
|macOS 10.12
|-
|<code>CLOCK_BOOTTIME</code>
|Linux 2.6.39
|-
|<code>CLOCK_BOOTTIME_ALARM</code>
|Linux 3.0
|-
|<code>CLOCK_UPTIME</code>
|FreeBSD 7.0, OpenBSD 5.5
|-
|<code>CLOCK_UPTIME_FAST</code>
|FreeBSD 8.1
|-
|<code>CLOCK_UPTIME_RAW</code>
|macOS 10.12
|-
|<code>CLOCK_UPTIME_RAW_APPROX</code>
|macOS 10.12
|-
|<code>CLOCK_UPTIME_PRECISE</code>
|FreeBSD 8.1
|-
|<code>CLOCK_SECOND</code>
|FreeBSD 8.1
|}
انتبه إلى أنَّ SUS تعني مواصفات يونكس المنفردة ([[wikipedia:Single_UNIX_Specification|Single Unix Specification]]). تحتوي SUS على معايير POSIX و <code>clock_gettime</code> مُعرَّفٌ في أحد أجزاء POSIX. تُعرِّف SUS الثابت <code>CLOCK_REALTIME</code> بشكل اجباري ولكن الثوابت <code>CLOCK_MONOTONIC</code>، و <code>CLOCK_PROCESS_CPUTIME_ID</code>، و <code>CLOCK_THREAD_CPUTIME_ID</code> هي اختيارية.

أضف إلى ذلك أنَّ هنالك العديد من الرموز يمكن استعمالها مع المعامل <code>clock_id</code>، إذ يوجد محاكيات للدالة <code>clock_gettime()‎</code>.

على سبيل المثال، الثابت <code>Process::CLOCK_REALTIME</code> مُعرَّف بالشكل ‎<code>:GETTIMEOFDAY_BASED_CLOCK_REALTIME</code> عندما لا يكون <code>clock_gettime()‎</code> متاحًا.

محاكيات من أجل <code>CLOCK_REALTIME</code> هي:
{| class="wikitable"
!المحاكي
!الوصف
|-
|<code>‎:GETTIMEOFDAY_BASED_CLOCK_REALTIME</code>
|استعمل <code>gettimeofday()‎</code> المُعرَّف من طرف SUS. (ألغى SUSv4 هذا المحاكي.) الدقة هي 1 ميكروثانية.
|-
|<code>‎:TIME_BASED_CLOCK_REALTIME</code>
|استعمل <code>time()‎</code> المُعرَّف من طرف ISO C. الدقة هي 1 ثانية.
|}
محاكيات من أجل <code>CLOCK_MONOTONIC</code> هي:
{| class="wikitable"
!المحاكي
!الوصف
|-
|<code>‎:MACH_ABSOLUTE_TIME_BASED_CLOCK_MONOTONIC</code>
|استعمل <code>mach_absolute_time()‎</code>، وهو متاح على Darwin. تعتمد الدقة على المعالج.
|-
|<code>‎:TIMES_BASED_CLOCK_MONOTONIC</code>
|استعمل القيمة الناتجة من <code>times()‎</code> المُعرَّف من طرف POSIX. تعرِّفه POSIX بالشكل: "<code>times()‎</code> يجب أن يعيد الوقت الحقيقي المنقضي في دقات النبضات منذ نقطة اعتباطية في الماضي (وقت بدء تشغيل النظام مثلًا)". على سبيل المثال، يعيد نظام لينكس قيمةً تعمتد على اللحظات (jiffies) وهي رتيبة (monotonic). على أي حال، يستعمل 4.4BSD الدالة <code>gettimeofday()‎</code> وهي ليست رتيبة. (FreeBSD يستعمل <code>clock_gettime(CLOCK_MONOTONIC)‎</code> عوضًا عن ذلك.) الدقة هي دقة النبضات. يُظهر الأمر <code>getconf CLK_TCK</code> دقات النبضات بالثانية. (دقات النبضات في الثانية تُعرَّف بواحدة الماكرو هرتز [HZ macro] في الأنظمة القديمة.) إن كانت 100 وكان clock_t هو نوع صحيح بطول 32 بت، فستكون الدقة 10 ميلي ثاينة ولا يمكن أن تصمد أكثر من 497 يوم.
|}
محاكيات من أجل <code>CLOCK_PROCESS_CPUTIME_ID</code> هي:
{| class="wikitable"
!المحاكي
!الوصف
|-
|<code>‎:GETRUSAGE_BASED_CLOCK_PROCESS_CPUTIME_ID</code>
|استعمل <code>getrusage()‎</code> المُعرَّف من طرف SUS. تُستعمَل الدالة <code>getrusage()‎</code> مع <code>RUSAGE_SELF</code> للحصول على الوقت للعملية المستدعية فقط (باستثناء الوقت للعملية الابن). النتيجة هي جمع وقت المستخدم (ru_utime) ووقت النظام (ru_stime). الدقة هي 1 ميكروثاينة.
|-
|<code>‎:TIMES_BASED_CLOCK_PROCESS_CPUTIME_ID</code>
|استعمل <code>times()‎</code> المُعرَّف من طرف POSIX. النتيجة هي جمع وقت المستخدم (tms_utime) ووقت النظام (tms_stime). يُتجاهَل <code>tms_cutime</code> و <code>tms_cstime</code> لاستثناء الوقت من أجل العمليات الأبناء. الدقة هي دقة النبضة. يُظهِر الأمر <code>getconf CLK_TCK</code> دقات النبضات بالثاينة. (دقات النبضات في الثانية تُعرَّف بواحدة الماكرو هرتز [HZ macro] في الأنظمة القديمة.) إن كانت 100، فستكون الدقة 10 ميلي ثانية.
|-
|<code>‎:CLOCK_BASED_CLOCK_PROCESS_CPUTIME_ID</code>
|استعمل <code>clock()‎</code> المُعرَّفة من طرف ISO C. الدقة هي ‎<code>1/CLOCKS_PER_SEC</code>. إنَّ <code>CLOCKS_PER_SEC</code> هو ماكرو من مستوى C (أي C-level macro) مُعرَّف في الملف time.h. تُعرِّف SUS الثابت <code>CLOCKS_PER_SEC</code> بالقيمة 1000000. قد تُعرِّفه الأنظمة الغير شبيه بيونكس بقيمة مختلفة. إن كانت قيمة <code>CLOCKS_PER_SEC</code> هي 1000000 وكان نوع clock_t عددٌ صحيح بطول 32 بت، فلا يمكن أن تصمد (تمثِّل) أكثر من 72 دقيقة.
|}
إن كانت القيمة المعطاة للمعامل <code>clock_id</code> غير مدعومة، فسيُطلَق الخطأ <code>Errno::EINVAL</code>.

=== <code>unit</code> ===
يحدِّد نوع القيمة المعادة. يمكن أن يأخذ إحدى القيم التالية:
{| class="wikitable"
!قيمة المعامل unit
!الوصف
|-
|<code>‎:float_second</code>
|[[Ruby/Float|عدد عشري]] يمثِّل عدد الثواني (القيمة الافتراضية).
|-
|<code>‎:float_millisecond</code>
|[[Ruby/Float|عدد عشري]] يمثِّل عدد الميلي ثواني.
|-
|<code>‎:float_microsecond</code>
|[[Ruby/Float|عدد عشري]] يمثِّل عدد الميكرو ثواني.
|-
|<code>‎:second</code>
|[[Ruby/Integer|عدد صحيح]] يمثِّل عدد الثواني.
|-
|<code>‎:millisecond</code>
|[[Ruby/Integer|عدد صحيح]] يمثِّل عدد الميلي ثواني.
|-
|<code>‎:microsecond</code>
|[[Ruby/Integer|عدد صحيح]] يمثِّل عدد الميكرو ثواني.
|-
|<code>‎:nanosecond</code>
|[[Ruby/Integer|عدد صحيح]] يمثِّل عدد النانو ثواني.
|}

== القيم المعادة ==
يعاد عدد يمثِّل الوقت المعاد عبر الدالة <code>clock_gettime()‎</code> الذي يخص POSIX.

== أمثلة ==
مثال على استعمال التابع <code>clock_gettime</code>:<syntaxhighlight lang="ruby">
p Process.clock_gettime(Process::CLOCK_MONOTONIC)
#=> 896053.968060096
</syntaxhighlight>

==انظر أيضًا==
*التابع <code>[[Ruby/Process/abort|abort]]</code>: ينهي تنفيذ العملية مباشرةً بشكل فعَّال عبر استدعاء <code>[[Ruby/Kernel/exit|Kernel.exit(false)‎]]</code>.

*التابع <code>[[Ruby/Process/clock getres|clock_getres]]</code>: يعيد دقة الوقت المعادة عبر الدالة <code>clock_getres()‎</code> التي تخص POSIX.
==مصادر==
*[http://ruby-doc.org/core-2.5.1/Process.html#method-c-clock_gettime قسم التابع clock_gettime في الصنف Process في توثيق روبي الرسمي.]
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Process]]