[函数]SyncEvent::wait()函数—用法及示例

函数名：SyncEvent::wait()

适用版本：PHP 7 >= 7.4.0

函数描述：SyncEvent::wait()函数用于等待同步事件的触发。它会阻塞当前线程，直到同步事件被触发或超时。

语法：bool SyncEvent::wait ([ float $timeout = -1 ] )

参数：

• timeout（可选）：等待同步事件触发的超时时间，单位为秒。默认值为-1，表示无限等待。如果设置为0，表示立即返回结果。

返回值：如果同步事件被触发，返回true；如果超时或出现错误，返回false。

示例：

<?php
// 创建一个同步事件
$event = new SyncEvent();

// 在另一个线程中触发事件
$anotherThread = new Thread(function () use ($event) {
    sleep(3);
    $event->trigger();
});

// 启动另一个线程
$anotherThread->start();

// 在当前线程中等待事件触发
if ($event->wait(5)) {
    echo "事件已触发！\n";
} else {
    echo "等待超时或出现错误。\n";
}

// 等待另一个线程执行完毕
$anotherThread->join();
?>

在上面的示例中，我们首先创建了一个SyncEvent对象，然后在另一个线程中通过sleep()函数模拟了一个耗时的操作，在3秒后触发了同步事件。接着，在主线程中调用了wait()函数来等待事件的触发，设置超时时间为5秒。如果事件在5秒内触发，就会输出"事件已触发！"；如果超时或出现错误，就会输出"等待超时或出现错误。"最后，我们使用join()函数等待另一个线程执行完毕，以确保示例的完整执行。

请注意，SyncEvent类是在PHP 7.4.0版本中引入的，因此在使用该函数之前，请确保你的PHP版本符合要求。