عرض مصدر PHP/time nanosleep

<noinclude>{{DISPLAYTITLE:الدالة <code>time_nanosleep()</code>‎ في PHP}}</noinclude>
(PHP 5, PHP 7)

تُأَخِّرُ الدالةُ <code>time_nanosleep()</code>‎ تنفيذَ البرنامج عددًا من الثواني والنانوثانية.

== الوصف ==
<syntaxhighlight lang="php">
mixed time_nanosleep ( int $seconds , int $nanoseconds )
</syntaxhighlight>تُأَخِّرُ الدالةُ <code>time_nanosleep()‎</code> تنفيذَ البرنامج بتحديد المعاملين <code>seconds</code> و <code>nanoseconds</code>.

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

=== <code>seconds</code> ===
يجب أن يكون عددًا صحيحًا غير سالب.

=== <code>nanoseconds</code> ===
يجب أن يكون عددًا صحيحًا غير سالب أقل من مليار.

== القيم المعادة ==
تعيد الدالة <code>time_nanosleep()‎</code> القيمة <code>TRUE</code> عند نجاح تنفيذها، أو القيمة <code>FALSE</code> عند حدوث خطأ.

إذا قوطع التأخير بإرسال النظام لإشارة من إشارات المقاطعة، فستعيد الدالة <code>time_nanosleep()‎</code> مصفوفةً ترابطيةً فيها المكونات الآتية:
* <code>seconds</code>: عدد الثواني المتبقية في التأخير.
* <code>nanoseconds</code>: عدد النانوثانية المتبقية في التأخير.

== سجل التغييرات ==
{| class="wikitable"
!الإصدار
!الوصف
|-
|5.3.0
|صارتْ الدالةُ <code>time_nanosleep()‎</code> الآن مُتاحةً على منصات ويندوز.
|}

== أمثلة ==
المثال 1: مثال على الدالة <code>time_nanosleep()</code>‎<syntaxhighlight lang="php">
<?php
// احذر! لن يعمل هذا كما هو متوقع إذا أُعِيْدَتْ مصفوفة
if (time_nanosleep(0, 500000000)) {
   echo "Slept for half a second.\n";
}
// هذا أفضل
if (time_nanosleep(0, 500000000) === true) {
   echo "Slept for half a second.\n";
}
// وهذا هو الأفضل
$nano = time_nanosleep(2, 100000);
if ($nano === true) {
   echo "Slept for 2 seconds, 100 microseconds.\n";
} elseif ($nano === false) {
  echo "Sleeping failed.\n";
} elseif (is_array($nano)) {
  $seconds = $nano['seconds'];
  $nanoseconds = $nano['nanoseconds'];
  echo "Interrupted by a signal.\n";
  echo "Time remaining: $seconds seconds, $nanoseconds nanoseconds.";
}
?>


</syntaxhighlight>

== انظر أيضًا ==
* الدالة <code>[[PHP/sleep|sleep()]]</code>‎: تأخير التنفيذ.
* الدالة <code>[[PHP/usleep|usleep()‎]]</code>: تأخير التنفيذ مدةً تُقدر بالميكروثانية.
* الدالة <code>[[PHP/time sleep until|time_sleep_until()]]</code>‎: تأخير البرنامج حتى الوقت المحدد.
* الدالة <code>[[PHP/set time limit|set_time_limit()‎]]</code>: تحديد الحد الأقصى لوقت التنفيذ.

== مصادر ==
* [http://php.net/manual/en/function.time-nanosleep.php صفحة الدالة time_nanosleep في توثيق PHP الرسمي.]
[[تصنيف:PHP]]
[[تصنيف:PHP Function]]
[[تصنيف:PHP Miscellaneous]]