الفرق بين المراجعتين لصفحة: «PHP/time sleep until»
< PHP
رؤيا-بنعطية (نقاش | مساهمات) لا ملخص تعديل |
رؤيا-بنعطية (نقاش | مساهمات) تعديلات طفيفة على التنسيق |
||
| (1 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 2: | سطر 2: | ||
(PHP 5 >= 5.1.0, PHP 7) | (PHP 5 >= 5.1.0, PHP 7) | ||
تُأَخِّرُ الدالةُ time_sleep_until() تنفيذَ البرنامج حتى الوقت المحدد. | تُأَخِّرُ الدالةُ <code>time_sleep_until()</code> تنفيذَ البرنامج حتى الوقت المحدد. | ||
== الوصف == | == الوصف == | ||
<syntaxhighlight lang="php"> | <syntaxhighlight lang="php"> | ||
bool time_sleep_until ( float $timestamp ) | bool time_sleep_until ( float $timestamp ) | ||
</syntaxhighlight>تُأَخِّرُ الدالةُ time_sleep_until() تنفيذَ البرنامج حتى تحقيق الزمن المضاف للمعامل timestamp. | </syntaxhighlight>تُأَخِّرُ الدالةُ <code>time_sleep_until()</code> تنفيذَ البرنامج حتى تحقيق الزمن المضاف للمعامل <code>timestamp</code>. | ||
== المعاملات == | == المعاملات == | ||
=== timestamp === | === <code>timestamp</code> === | ||
المعامل timestamp هو الزمن الذي ينبغي أن يعمل البرنامج عنده. | المعامل <code>timestamp</code> هو الزمن الذي ينبغي أن يعمل البرنامج عنده. | ||
== القيم المعادة == | == القيم المعادة == | ||
تعيد الدالة time_sleep_until() القيمة TRUE عند نجاح تنفيذها، أو القيمة FALSE عند حدوث خطأ. | تعيد الدالة <code>time_sleep_until()</code> القيمة <code>TRUE</code> عند نجاح تنفيذها، أو القيمة <code>FALSE</code> عند حدوث خطأ. | ||
== سجل التغييرات == | == سجل التغييرات == | ||
{| class="wikitable" | {| class="wikitable" | ||
!الإصدار | |||
!الوصف | |||
|- | |- | ||
|5.3.0 | |5.3.0 | ||
|صارتْ الدالةُ time_sleep_until() الآن مُتاحةً على منصات ويندوز. | |صارتْ الدالةُ <code>time_sleep_until()</code> الآن مُتاحةً على منصات ويندوز. | ||
|} | |} | ||
== الأخطاء والاستثناءات == | == الأخطاء والاستثناءات == | ||
إذا كان الزمن المحدد للمعامل timestamp في الماضي، فستنشئ الدالة تحذيرًا من النوع E_WARNING. | إذا كان الزمن المحدد للمعامل <code>timestamp</code> في الماضي، فستنشئ الدالة تحذيرًا من النوع <code>E_WARNING</code>. | ||
== أمثلة == | == أمثلة == | ||
المثال 1: مثال على الدالة time_sleep_until()<syntaxhighlight lang="php"> | المثال 1: مثال على الدالة <code>time_sleep_until()</code><syntaxhighlight lang="php"> | ||
<?php | <?php | ||
// يعيد false وينشئ تحذيرًا | // يعيد false وينشئ تحذيرًا | ||
var_dump(time_sleep_until(time()-1)); | var_dump(time_sleep_until(time()-1)); | ||
// قد يعمل فقط على أجهزة الكمبيوتر السريعة، وينام الوقت الحالي + 0.2 ثانية | // قد يعمل فقط على أجهزة الكمبيوتر السريعة، وينام الوقت الحالي + 0.2 ثانية | ||
var_dump(time_sleep_until(microtime(true)+0.2)); | var_dump(time_sleep_until(microtime(true)+0.2)); | ||
?> | ?> | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| سطر 48: | سطر 43: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* الدالة sleep(): تأخير التنفيذ. | * الدالة <code>[[PHP/sleep|sleep()]]</code>: تأخير التنفيذ. | ||
* الدالة usleep(): تأخير التنفيذ مدةً تُقدر بالميكروثانية. | * الدالة <code>[[PHP/usleep|usleep()]]</code>: تأخير التنفيذ مدةً تُقدر بالميكروثانية. | ||
* الدالة time_nanosleep(): تأخير لعدد من الثواني والنانوثانية. | * الدالة <code>[[PHP/time nanosleep|time_nanosleep()]]</code>: تأخير لعدد من الثواني والنانوثانية. | ||
* الدالة set_time_limit(): تحديد الحد الأقصى لوقت التنفيذ. | * الدالة <code>[[PHP/set time limit|set_time_limit()]]</code>: تحديد الحد الأقصى لوقت التنفيذ. | ||
== مصادر == | == مصادر == | ||
المراجعة الحالية بتاريخ 15:56، 29 مايو 2018
(PHP 5 >= 5.1.0, PHP 7)
تُأَخِّرُ الدالةُ time_sleep_until() تنفيذَ البرنامج حتى الوقت المحدد.
الوصف
bool time_sleep_until ( float $timestamp )
تُأَخِّرُ الدالةُ time_sleep_until() تنفيذَ البرنامج حتى تحقيق الزمن المضاف للمعامل timestamp.
المعاملات
timestamp
المعامل timestamp هو الزمن الذي ينبغي أن يعمل البرنامج عنده.
القيم المعادة
تعيد الدالة time_sleep_until() القيمة TRUE عند نجاح تنفيذها، أو القيمة FALSE عند حدوث خطأ.
سجل التغييرات
| الإصدار | الوصف |
|---|---|
| 5.3.0 | صارتْ الدالةُ time_sleep_until() الآن مُتاحةً على منصات ويندوز.
|
الأخطاء والاستثناءات
إذا كان الزمن المحدد للمعامل timestamp في الماضي، فستنشئ الدالة تحذيرًا من النوع E_WARNING.
أمثلة
المثال 1: مثال على الدالة time_sleep_until()
<?php
// يعيد false وينشئ تحذيرًا
var_dump(time_sleep_until(time()-1));
// قد يعمل فقط على أجهزة الكمبيوتر السريعة، وينام الوقت الحالي + 0.2 ثانية
var_dump(time_sleep_until(microtime(true)+0.2));
?>
ملاحظات
ملاحظة: سَتُسَلَّمُ جميعُ الإشارات بعد أن يستيقظ البرنامج.
انظر أيضًا
- الدالة
sleep(): تأخير التنفيذ. - الدالة
usleep(): تأخير التنفيذ مدةً تُقدر بالميكروثانية. - الدالة
time_nanosleep(): تأخير لعدد من الثواني والنانوثانية. - الدالة
set_time_limit(): تحديد الحد الأقصى لوقت التنفيذ.