C 库函数 - sigpending()

sigpending 函数是 C 标准库中的一个函数，用于获取当前进程挂起（未决）的信号集。未决信号是在被阻塞后尚未处理的信号。此函数定义在 <signal.h> 头文件中。

语法

int sigpending(sigset_t *set);

参数

sigset_t *set：指向一个 sigset_t 类型的变量，该变量将被填充为当前进程的未决信号集。

返回值

成功时返回 0。
失败时返回 -1，并设置 errno 以指示错误类型。

实例

以下是一个使用 sigpending 函数获取当前进程未决信号集的示例程序。该程序阻塞 SIGINT 信号，然后发送该信号，并使用 sigpending 检查该信号是否在未决信号集中。

实例

#include <stdio.h>
#include <signal.h>
#include <unistd.h>

void handle_sigint(int sig) {
printf("Caught signal %d\n", sig);
}

int main() {
sigset_t new_mask, old_mask, pending;

// 设置 SIGINT 的处理程序
signal(SIGINT, handle_sigint);

// 初始化信号集并阻塞 SIGINT 信号
sigemptyset(&new_mask);
sigaddset(&new_mask, SIGINT);
if (sigprocmask(SIG_BLOCK, &new_mask, &old_mask) == -1) {
perror("sigprocmask");
return 1;
}

// 发送 SIGINT 信号
raise(SIGINT);

// 获取未决信号集
if (sigpending(&pending) == -1) {
perror("sigpending");
return 1;
}

// 检查 SIGINT 是否在未决信号集中
if (sigismember(&pending, SIGINT)) {
printf("SIGINT is pending\n");
} else {
printf("SIGINT is not pending\n");
}

// 恢复原来的信号屏蔽字
if (sigprocmask(SIG_SETMASK, &old_mask, NULL) == -1) {
perror("sigprocmask");
return 1;
}

return 0;
}

编译并运行程序后，输出将是：

SIGINT is pending
Caught signal 2

程序首先阻塞 SIGINT 信号，然后发送该信号，并使用 sigpending 检查 SIGINT 是否在未决信号集中。最后，程序恢复原来的信号屏蔽字，并捕捉到 SIGINT 信号，执行信号处理程序。

解析

sigset_t new_mask, old_mask, pending;：定义了三个信号集，用于控制信号屏蔽和存储未决信号集。
使用 sigprocmask 函数阻塞 SIGINT 信号，并保存原来的信号屏蔽字。
使用 raise 函数发送 SIGINT 信号。
使用 sigpending 函数获取未决信号集，并检查 SIGINT 是否在未决信号集中。
使用 sigprocmask 函数恢复原来的信号屏蔽字。

注意事项

sigpending 函数获取当前进程的未决信号集，包括所有已发送但尚未处理的信号。
信号处理函数应尽量简短，因为在处理信号时会阻塞其他信号。长时间运行的信号处理函数可能会影响程序的实时性。

C 标准库 - <signal.h>