الفرق بين المراجعتين لصفحة: «PHP/sleep»
< PHP
رؤيا-بنعطية (نقاش | مساهمات) لا ملخص تعديل |
رؤيا-بنعطية (نقاش | مساهمات) تعديلات طفيفة على التنسيق |
||
| (2 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 2: | سطر 2: | ||
(PHP 4, PHP 5, PHP 7) | (PHP 4, PHP 5, PHP 7) | ||
تُأَخِّرُ الدالةُ sleep() تنفيذَ البرنامج. | تُأَخِّرُ الدالةُ <code>sleep()</code> تنفيذَ البرنامج. | ||
== الوصف == | == الوصف == | ||
<syntaxhighlight lang="php"> | <syntaxhighlight lang="php"> | ||
int sleep ( int $seconds ) | int sleep ( int $seconds ) | ||
</syntaxhighlight>تُأَخِّرُ الدالةُ sleep() تنفيذ البرنامج لعدد محدد من الثواني. | </syntaxhighlight>تُأَخِّرُ الدالةُ <code>sleep()</code> تنفيذ البرنامج لعدد محدد من الثواني. | ||
== المعاملات == | == المعاملات == | ||
=== seconds === | === <code>seconds</code> === | ||
زمن الإيقاف بالثواني. | زمن الإيقاف بالثواني. | ||
== القيم المعادة == | == القيم المعادة == | ||
تعيد الدالة sleep() القيمة 0 عند نجاح تنفيذها، أو القيمة FALSE عند حدوث خطأ. | تعيد الدالة <code>sleep()</code> القيمة 0 عند نجاح تنفيذها، أو القيمة <code>FALSE</code> عند حدوث خطأ. | ||
إذا قُطِعَتْ عملية الاستدعاء بواسطة إشارة، فستعيد الدالة sleep() قيمةً غير صفرية. في نظام ويندوز، ستكون هذه القيمة دائمًا 192 (قيمة WAIT_IO_COMPLETION ثابتة داخل | إذا قُطِعَتْ عملية الاستدعاء بواسطة إشارة، فستعيد الدالة <code>sleep()</code> قيمةً غير صفرية. في نظام ويندوز، ستكون هذه القيمة دائمًا 192 (قيمة <code>WAIT_IO_COMPLETION</code> ثابتة داخل ويندوز API). في الأنظمة الأخرى، ستكون القيمةُ المعادة عددَ الثواني المتبقية على التوقف. | ||
== الأخطاء والاستثناءات == | == الأخطاء والاستثناءات == | ||
إذا كان عدد الثواني المحدد سالبًا، فستنشئ الدالة تنبيهًا من النوع E_WARNING. | إذا كان عدد الثواني المحدد سالبًا، فستنشئ الدالة تنبيهًا من النوع <code>E_WARNING</code>. | ||
== سجل التغييرات == | == سجل التغييرات == | ||
{| class="wikitable" | {| class="wikitable" | ||
!الإصدار | |||
!الوصف | |||
|- | |- | ||
|5.3.4 | |5.3.4 | ||
|قبل الإصدار PHP 5.3.4، دائمًا ما تعيد الدالةُ sleep() القيمة NULL عند عملها على نظام التشغيل | |قبل الإصدار PHP 5.3.4، دائمًا ما تعيد الدالةُ <code>sleep()</code> القيمة <code>[[PHP/null|NULL]]</code> عند عملها على نظام التشغيل ويندوز بغض النظر هل قُوطعت العملية أم لا. | ||
|} | |} | ||
== أمثلة == | == أمثلة == | ||
المثال 1: مثال على الدالة sleep()<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 | ||
| سطر 58: | سطر 50: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* الدالة usleep(): تأخير التنفيذ مدةً تُقدر بالميكروثانية. | * الدالة <code>[[PHP/usleep|usleep()]]</code>: تأخير التنفيذ مدةً تُقدر بالميكروثانية. | ||
* الدالة time_nanosleep(): تأخير لعدد من الثواني والنانوثانية. | * الدالة <code>[[PHP/time nanosleep|time_nanosleep()]]</code>: تأخير لعدد من الثواني والنانوثانية. | ||
* الدالة time_sleep_until(): تأخير البرنامج حتى الوقت المحدد. | * الدالة <code>[[PHP/time sleep until|time_sleep_until()]]</code>: تأخير البرنامج حتى الوقت المحدد. | ||
* الدالة set_time_limit(): تحديد الحد الأقصى لوقت التنفيذ. | * الدالة <code>[[PHP/set time limit|set_time_limit()]]</code>: تحديد الحد الأقصى لوقت التنفيذ. | ||
== مصادر == | == مصادر == | ||
المراجعة الحالية بتاريخ 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(): تحديد الحد الأقصى لوقت التنفيذ.