sem_time_wait() 相关函数

`sem_time_wait()` 函数是一个基于信号量的同步函数，它用于等待一个信号量，如果信号量的值大于 0，则将信号量的值减一并立即返回，否则会挂起当前线程，直到信号量的值大于 0 或者指定的超时时间到了。

该函数通常用于实现多线程之间的同步，比如线程 A 需要等待线程 B 完成某个操作后才能继续执行，此时线程 B 可以在完成操作后通过信号量的值加一，而线程 A 可以通过调用 `sem_time_wait()` 函数等待信号量的值大于 0。

函数的参数包括信号量对象、等待时间（以毫秒为单位）和错误码指针。当信号量的值大于 0 时，函数会立即返回 0；当信号量的值为 0 时，函数会等待指定的时间，如果在等待时间内信号量的值大于 0，则函数返回 0，否则返回 -1 并设置错误码。

以下是 `sem_time_wait()` 函数的一些示例代码：

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

sem_t sem;

void *thread_func(void *arg) {
    printf("Thread %ld: waiting for semaphore...\n", (long)arg);
    if (sem_time_wait(&sem, 2000) == 0) {
        printf("Thread %ld: semaphore acquired!\n", (long)arg);
        sleep(1);
        sem_post(&sem);
    } else {
        printf("Thread %ld: semaphore timed out!\n", (long)arg);
    }
    pthread_exit(NULL);
}

int main(int argc, char *argv[]) {
    int i, num_threads;
    pthread_t *threads;

    if (argc < 2) {
        fprintf(stderr, "Usage: %s num_threads\n", argv[0]);
        exit(EXIT_FAILURE);
    }

    num_threads = atoi(argv[1]);
    threads = (pthread_t *)malloc(num_threads * sizeof(pthread_t));

    sem_init(&sem, 0, 0);

    for (i = 0; i < num_threads; i++) {
        pthread_create(&threads[i], NULL, thread_func, (void *)(long)i);
    }

    for (i = 0; i < num_threads; i++) {
        pthread_join(threads[i], NULL);
    }

    sem_destroy(&sem);

    free(threads);

    return EXIT_SUCCESS;
}

在上面的示例代码中，我们创建了 num_threads 个线程，每个线程都会等待信号量 sem，并在等待时间内尝试获取信号量。如果线程获取到了信号量，它会等待 1 秒钟，然后释放信号量；如果线程没有获取到信号量，它会打印一条超时的消息。主线程等待所有子线程结束后，销毁信号量并退出。