الفرق بين المراجعتين لصفحة: «PHP/sleep»
< PHP
رؤيا-بنعطية (نقاش | مساهمات) لا ملخص تعديل |
رؤيا-بنعطية (نقاش | مساهمات) إضافات و تعديلات تنسيقية |
||
| سطر 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 ثابتة داخل Windows API). في الأنظمة الأخرى، ستكون القيمةُ المعادة عددَ الثواني المتبقية على التوقف. | إذا قُطِعَتْ عملية الاستدعاء بواسطة إشارة، فستعيد الدالة <code>sleep()</code> قيمةً غير صفرية. في نظام ويندوز، ستكون هذه القيمة دائمًا 192 (قيمة <code>WAIT_IO_COMPLETION</code> ثابتة داخل Windows API). في الأنظمة الأخرى، ستكون القيمةُ المعادة عددَ الثواني المتبقية على التوقف. | ||
== الأخطاء والاستثناءات == | == الأخطاء والاستثناءات == | ||
إذا كان عدد الثواني المحدد سالبًا، فستنشئ الدالة تنبيهًا من النوع E_WARNING. | إذا كان عدد الثواني المحدد سالبًا، فستنشئ الدالة تنبيهًا من النوع <code>E_WARNING</code>. | ||
== سجل التغييرات == | == سجل التغييرات == | ||
| سطر 28: | سطر 28: | ||
|- | |- | ||
|5.3.4 | |5.3.4 | ||
|قبل الإصدار PHP 5.3.4، دائمًا ما تعيد الدالةُ sleep() القيمة NULL عند عملها على نظام التشغيل Windows بغض النظر هل قُوطعت العملية أم لا. | |قبل الإصدار PHP 5.3.4، دائمًا ما تعيد الدالةُ <code>sleep()</code> القيمة <code>NULL</code> عند عملها على نظام التشغيل Windows بغض النظر هل قُوطعت العملية أم لا. | ||
|} | |} | ||
== أمثلة == | == أمثلة == | ||
المثال 1: مثال على الدالة sleep()<syntaxhighlight lang="php"> | المثال 1: مثال على الدالة <code>sleep()</code><syntaxhighlight lang="php"> | ||
<?php | <?php | ||
| سطر 58: | سطر 58: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* الدالة 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>: تحديد الحد الأقصى لوقت التنفيذ. | ||
== مصادر == | == مصادر == | ||
مراجعة 00:17، 27 مايو 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(): تحديد الحد الأقصى لوقت التنفيذ.