الدالة time_sleep_until()‎‎ في PHP

من موسوعة حسوب
< PHP

(PHP 5 >= 5.1.0, PHP 7)

تُأَخِّرُ الدالةُ time_sleep_until()‎ تنفيذَ البرنامج حتى الوقت المحدد.

الوصف

bool time_sleep_until ( float $timestamp )

تُأَخِّرُ الدالةُ time_sleep_until()‎ تنفيذَ البرنامج حتى تحقيق الزمن المضاف للمعامل timestamp.

المعاملات

timestamp

المعامل timestamp هو الزمن الذي ينبغي أن يعمل البرنامج عنده.

القيم المعادة

تعيد الدالة time_sleep_until()‎ القيمة TRUE عند نجاح تنفيذها، أو القيمة FALSE عند حدوث خطأ.

سجل التغييرات

الإصدار الوصف
5.3.0 صارتْ الدالةُ time_sleep_until()‎ الآن مُتاحةً على منصات ويندوز.

الأخطاء والاستثناءات

إذا كان الزمن المحدد للمعامل timestamp في الماضي، فستنشئ الدالة تحذيرًا من النوع E_WARNING.

أمثلة

المثال 1: مثال على الدالة time_sleep_until()‎

<?php
// يعيد false وينشئ تحذيرًا
var_dump(time_sleep_until(time()-1));
// قد يعمل فقط على أجهزة الكمبيوتر السريعة، وينام الوقت الحالي + 0.2 ثانية
var_dump(time_sleep_until(microtime(true)+0.2));
?>

ملاحظات

ملاحظة: سَتُسَلَّمُ جميعُ الإشارات بعد أن يستيقظ البرنامج.

انظر أيضًا

  • الدالة sleep()‎: تأخير التنفيذ.
  • الدالة usleep()‎: تأخير التنفيذ مدةً تُقدر بالميكروثانية.
  • الدالة time_nanosleep()‎: تأخير لعدد من الثواني والنانوثانية.
  • الدالة set_time_limit()‎: تحديد الحد الأقصى لوقت التنفيذ.

مصادر