pthread_cond_timedwait 使用方法

`pthread_cond_timedwait` 函数用于在指定的时间内等待条件变量满足。以下是 `pthread_cond_timedwait` 函数的使用方法：

int pthread_cond_timedwait(pthread_cond_t *restrict cond, pthread_mutex_t *restrict mutex, const struct timespec *restrict abstime);

参数说明：
- `cond`：指向条件变量的指针。
- `mutex`：指向互斥锁的指针，用于保护共享资源。
- `abstime`：指向 `struct timespec` 结构体的指针，表示等待的绝对时间。

函数返回值：
- 成功时返回 0。
- 如果等待超时，则返回 ETIMEDOUT 错误。
- 其他错误情况下返回相应的错误码。

使用 `pthread_cond_timedwait` 函数的一般步骤如下：

1. 在进入等待之前，获取互斥锁。
2. 设置等待的绝对时间。
3. 调用 `pthread_cond_timedwait` 函数，传入条件变量、互斥锁和绝对时间作为参数。
4. 根据返回值判断等待的结果，如果返回 0，则条件满足可以继续执行；如果返回 ETIMEDOUT，则表示等待超时。
5. 在条件满足或超时后，释放互斥锁。

下面是一个示例代码：

#include <pthread.h>
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>

pthread_mutex_t mutex = PTHREAD_MUTEX_INITIALIZER;
pthread_cond_t cond = PTHREAD_COND_INITIALIZER;

void* thread_func(void* arg) {
    sleep(5); // 模拟一些操作
    pthread_mutex_lock(&mutex);
    pthread_cond_signal(&cond); // 发送信号通知等待的线程
    pthread_mutex_unlock(&mutex);
    return NULL;
}

int main() {
    pthread_t thread;
    struct timespec timeout;

    // 获取当前时间并设置等待时间为 3 秒
    clock_gettime(CLOCK_REALTIME, &timeout);
    timeout.tv_sec += 3;

    pthread_create(&thread, NULL, thread_func, NULL);

    pthread_mutex_lock(&mutex);
    int result = pthread_cond_timedwait(&cond, &mutex, &timeout);
    if (result == 0) {
        printf("条件满足，继续执行\n");
    } else if (result == ETIMEDOUT) {
        printf("等待超时\n");
    } else {
        printf("等待出错\n");
    }
    pthread_mutex_unlock(&mutex);

    pthread_join(thread, NULL);

    return 0;
}

在上述示例中，我们创建了一个线程，在 5 秒后发送信号通知等待的线程。等待的线程在等待超过 3 秒后会自动返回 ETIMEDOUT 错误。

希望以上信息能够帮助到你。如果你还有其他问题，请随时提问。