الفرق بين المراجعتين لصفحة: «PHP/sleep»

المراجعة الحالية بتاريخ 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()‎: تحديد الحد الأقصى لوقت التنفيذ.

مصادر

صفحة الدالة sleep في توثيق PHP الرسمي.

@@ سطر 17: / سطر 17: @@
 تعيد الدالة <code>sleep()‎</code> القيمة 0 عند نجاح تنفيذها، أو القيمة <code>FALSE</code> عند حدوث خطأ.
-إذا قُطِعَتْ عملية الاستدعاء بواسطة إشارة، فستعيد الدالة <code>sleep()</code>‎ قيمةً غير صفرية. في نظام ويندوز، ستكون هذه القيمة دائمًا 192 (قيمة <code>WAIT_IO_COMPLETION</code> ثابتة داخل Windows API). في الأنظمة الأخرى، ستكون القيمةُ المعادة عددَ الثواني المتبقية على التوقف.
+إذا قُطِعَتْ عملية الاستدعاء بواسطة إشارة، فستعيد الدالة <code>sleep()</code>‎ قيمةً غير صفرية. في نظام ويندوز، ستكون هذه القيمة دائمًا 192 (قيمة <code>WAIT_IO_COMPLETION</code> ثابتة داخل ويندوز API). في الأنظمة الأخرى، ستكون القيمةُ المعادة عددَ الثواني المتبقية على التوقف.
 == الأخطاء والاستثناءات ==
@@ سطر 28: / سطر 28: @@
 |-
 |5.3.4
-|قبل الإصدار PHP 5.3.4، دائمًا ما تعيد الدالةُ <code>sleep()</code>‎ القيمة <code>[[PHP/null|NULL]]</code> عند عملها على نظام التشغيل Windows بغض النظر هل قُوطعت العملية أم لا.
+|قبل الإصدار PHP 5.3.4، دائمًا ما تعيد الدالةُ <code>sleep()</code>‎ القيمة <code>[[PHP/null|NULL]]</code> عند عملها على نظام التشغيل ويندوز بغض النظر هل قُوطعت العملية أم لا.
 |}