الفرق بين المراجعتين لصفحة: «PHP/sleep»
< PHP
رؤيا-بنعطية (نقاش | مساهمات) إضافات و تعديلات تنسيقية |
رؤيا-بنعطية (نقاش | مساهمات) تعديلات طفيفة على التنسيق |
||
| سطر 24: | سطر 24: | ||
== سجل التغييرات == | == سجل التغييرات == | ||
{| class="wikitable" | {| class="wikitable" | ||
!الإصدار | |||
!الوصف | |||
|- | |- | ||
|5.3.4 | |5.3.4 | ||
|قبل الإصدار PHP 5.3.4، دائمًا ما تعيد الدالةُ <code>sleep()</code> القيمة <code>NULL</code> عند عملها على نظام التشغيل Windows بغض النظر هل قُوطعت العملية أم لا. | |قبل الإصدار PHP 5.3.4، دائمًا ما تعيد الدالةُ <code>sleep()</code> القيمة <code>[[PHP/null|NULL]]</code> عند عملها على نظام التشغيل Windows بغض النظر هل قُوطعت العملية أم لا. | ||
|} | |} | ||
| سطر 34: | سطر 34: | ||
المثال 1: مثال على الدالة <code>sleep()</code><syntaxhighlight lang="php"> | المثال 1: مثال على الدالة <code>sleep()</code><syntaxhighlight lang="php"> | ||
<?php | <?php | ||
// الوقت الحالي | // الوقت الحالي | ||
echo date('h:i:s') . "\n"; | echo date('h:i:s') . "\n"; | ||
// تأخير التنفيذ لمدة 10 ثوان | // تأخير التنفيذ لمدة 10 ثوان | ||
sleep(10); | sleep(10); | ||
// استيقظ! | // استيقظ! | ||
echo date('h:i:s') . "\n"; | echo date('h:i:s') . "\n"; | ||
?> | ?> | ||
</syntaxhighlight>ناتج المثال السابق:<syntaxhighlight lang=" | </syntaxhighlight>ناتج المثال السابق:<syntaxhighlight lang="text"> | ||
05:31:23 | 05:31:23 | ||
05:31:33 | 05:31:33 | ||
مراجعة 14:00، 29 مايو 2018
(PHP 4, PHP 5, PHP 7)
تُأَخِّرُ الدالةُ sleep() تنفيذَ البرنامج.
الوصف
int sleep ( int $seconds )
تُأَخِّرُ الدالةُ sleep() تنفيذ البرنامج لعدد محدد من الثواني.
المعاملات
seconds
زمن الإيقاف بالثواني.
القيم المعادة
تعيد الدالة sleep() القيمة 0 عند نجاح تنفيذها، أو القيمة FALSE عند حدوث خطأ.
إذا قُطِعَتْ عملية الاستدعاء بواسطة إشارة، فستعيد الدالة sleep() قيمةً غير صفرية. في نظام ويندوز، ستكون هذه القيمة دائمًا 192 (قيمة WAIT_IO_COMPLETION ثابتة داخل Windows API). في الأنظمة الأخرى، ستكون القيمةُ المعادة عددَ الثواني المتبقية على التوقف.
الأخطاء والاستثناءات
إذا كان عدد الثواني المحدد سالبًا، فستنشئ الدالة تنبيهًا من النوع E_WARNING.
سجل التغييرات
| الإصدار | الوصف |
|---|---|
| 5.3.4 | قبل الإصدار PHP 5.3.4، دائمًا ما تعيد الدالةُ sleep() القيمة NULL عند عملها على نظام التشغيل Windows بغض النظر هل قُوطعت العملية أم لا.
|
أمثلة
المثال 1: مثال على الدالة sleep()
<?php
// الوقت الحالي
echo date('h:i:s') . "\n";
// تأخير التنفيذ لمدة 10 ثوان
sleep(10);
// استيقظ!
echo date('h:i:s') . "\n";
?>
ناتج المثال السابق:
05:31:23
05:31:33
انظر أيضًا
- الدالة
usleep(): تأخير التنفيذ مدةً تُقدر بالميكروثانية. - الدالة
time_nanosleep(): تأخير لعدد من الثواني والنانوثانية. - الدالة
time_sleep_until(): تأخير البرنامج حتى الوقت المحدد. - الدالة
set_time_limit(): تحديد الحد الأقصى لوقت التنفيذ.