عرض مصدر PHP/time sleep until

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

تُأَخِّرُ الدالةُ <code>time_sleep_until()‎</code> تنفيذَ البرنامج حتى الوقت المحدد.

== الوصف ==
<syntaxhighlight lang="php">
bool time_sleep_until ( float $timestamp )
</syntaxhighlight>تُأَخِّرُ الدالةُ <code>time_sleep_until()</code>‎ تنفيذَ البرنامج حتى تحقيق الزمن المضاف للمعامل <code>timestamp</code>.

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

=== <code>timestamp</code> ===
المعامل <code>timestamp</code> هو الزمن الذي ينبغي أن يعمل البرنامج عنده.

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

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

== الأخطاء والاستثناءات ==
إذا كان الزمن المحدد للمعامل <code>timestamp</code> في الماضي، فستنشئ الدالة تحذيرًا من النوع <code>E_WARNING</code>.

== أمثلة ==
المثال 1: مثال على الدالة <code>time_sleep_until()‎</code><syntaxhighlight lang="php">
<?php
// يعيد false وينشئ تحذيرًا
var_dump(time_sleep_until(time()-1));
// قد يعمل فقط على أجهزة الكمبيوتر السريعة، وينام الوقت الحالي + 0.2 ثانية
var_dump(time_sleep_until(microtime(true)+0.2));
?>
</syntaxhighlight>

== ملاحظات ==
ملاحظة: سَتُسَلَّمُ جميعُ الإشارات بعد أن يستيقظ البرنامج.

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

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