الفرق بين المراجعتين لصفحة: «PHP/sleep»
< PHP
رؤيا-بنعطية (نقاش | مساهمات) إضافات و تعديلات تنسيقية |
رؤيا-بنعطية (نقاش | مساهمات) تعديلات طفيفة على التنسيق |
||
| (1 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 17: | سطر 17: | ||
تعيد الدالة <code>sleep()</code> القيمة 0 عند نجاح تنفيذها، أو القيمة <code>FALSE</code> عند حدوث خطأ. | تعيد الدالة <code>sleep()</code> القيمة 0 عند نجاح تنفيذها، أو القيمة <code>FALSE</code> عند حدوث خطأ. | ||
إذا قُطِعَتْ عملية الاستدعاء بواسطة إشارة، فستعيد الدالة <code>sleep()</code> قيمةً غير صفرية. في نظام ويندوز، ستكون هذه القيمة دائمًا 192 (قيمة <code>WAIT_IO_COMPLETION</code> ثابتة داخل | إذا قُطِعَتْ عملية الاستدعاء بواسطة إشارة، فستعيد الدالة <code>sleep()</code> قيمةً غير صفرية. في نظام ويندوز، ستكون هذه القيمة دائمًا 192 (قيمة <code>WAIT_IO_COMPLETION</code> ثابتة داخل ويندوز API). في الأنظمة الأخرى، ستكون القيمةُ المعادة عددَ الثواني المتبقية على التوقف. | ||
== الأخطاء والاستثناءات == | == الأخطاء والاستثناءات == | ||
| سطر 24: | سطر 24: | ||
== سجل التغييرات == | == سجل التغييرات == | ||
{| class="wikitable" | {| class="wikitable" | ||
!الإصدار | |||
!الوصف | |||
|- | |- | ||
|5.3.4 | |5.3.4 | ||
|قبل الإصدار PHP 5.3.4، دائمًا ما تعيد الدالةُ <code>sleep()</code> القيمة <code>NULL</code> عند عملها على نظام التشغيل | |قبل الإصدار PHP 5.3.4، دائمًا ما تعيد الدالةُ <code>sleep()</code> القيمة <code>[[PHP/null|NULL]]</code> عند عملها على نظام التشغيل ويندوز بغض النظر هل قُوطعت العملية أم لا. | ||
|} | |} | ||
| سطر 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 | ||
المراجعة الحالية بتاريخ 15:52، 29 مايو 2018
(PHP 4, PHP 5, PHP 7)
تُأَخِّرُ الدالةُ sleep() تنفيذَ البرنامج.
الوصف
int sleep ( int $seconds )
تُأَخِّرُ الدالةُ sleep() تنفيذ البرنامج لعدد محدد من الثواني.
المعاملات
seconds
زمن الإيقاف بالثواني.
القيم المعادة
تعيد الدالة sleep() القيمة 0 عند نجاح تنفيذها، أو القيمة FALSE عند حدوث خطأ.
إذا قُطِعَتْ عملية الاستدعاء بواسطة إشارة، فستعيد الدالة sleep() قيمةً غير صفرية. في نظام ويندوز، ستكون هذه القيمة دائمًا 192 (قيمة WAIT_IO_COMPLETION ثابتة داخل ويندوز API). في الأنظمة الأخرى، ستكون القيمةُ المعادة عددَ الثواني المتبقية على التوقف.
الأخطاء والاستثناءات
إذا كان عدد الثواني المحدد سالبًا، فستنشئ الدالة تنبيهًا من النوع E_WARNING.
سجل التغييرات
| الإصدار | الوصف |
|---|---|
| 5.3.4 | قبل الإصدار PHP 5.3.4، دائمًا ما تعيد الدالةُ sleep() القيمة NULL عند عملها على نظام التشغيل ويندوز بغض النظر هل قُوطعت العملية أم لا.
|
أمثلة
المثال 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(): تحديد الحد الأقصى لوقت التنفيذ.