在学习APUE、UNP1/2的这三套书籍时候,发现,其实可以使用强大的包裹函数,直接封装了错误信息提示,为调试代码,维护代码,带来了巨大的提升。
本文:将尝试解析,包裹函数的作用,并对比非包裹函数的使用情况和案例分析,以此来理解”包裹“一词。
首先,包裹函数最关键一步,是错误处理,其余所有的系统/非系统的调用API接口,都经过包裹封装,而封装内部,都会含有错误处理函数。
APUE、UNP1/2(下面简称:参考书),参考书上的错误处理,都是封装了多个重要应用的。我们来看看。
/* Fatal error related to system call
* Print message and terminate */
void
err_sys(const char *fmt, ...)
{
va_list ap;
va_start(ap, fmt);
err_doit(1, LOG_ERR, fmt, ap);
va_end(ap);
exit(1);
}
这是使用最多的函数,大部分包裹函数都是由它来显示反馈信息。
1. 使用了类似printf函数格式的接口格式,使用非常方便。
2.函数内依赖可变参数实现
3.直接调用exit(1),即可退出进程并清空所有缓冲
其中,又调用了关键封装:err_doit
/* Print message and return to caller
* Caller specifies "errnoflag" and "level" */
static void
err_doit(int errnoflag, int level, const char *fmt, va_list ap)
{
int errno_save, n;
char buf[MAXLINE + 1];
errno_save = errno; /* value caller might want printed */
#ifdef HAVE_VSNPRINTF
vsnprintf(buf, MAXLINE, fmt, ap); /* safe */
#else
vsprintf(buf, fmt, ap); /* not safe */
#endif
n = strlen(buf);
if (errnoflag)
snprintf(buf + n, MAXLINE - n, ": %s", strerror(errno_save));
strcat(buf, "\n");
if (daemon_proc) {
syslog(level, buf);
} else {
fflush(stdout); /* in case stdout and stderr are the same */
fputs(buf, stderr);
fflush(stderr);
}
return;
}
该函数:
1. 马上保存errno全局变量,确保可靠性和错误信息的准确性
2. 调用vsnprintf(一般都是这个分支),将输出信息,导入buf
3. 是否启动系统sys的守护进程,是则讲错误信息输出到系统sys,否则输出到stderr并fflush确保
4. 又继续使用strcat,确保错误信息字符串一定是'\n'结束
5.为了提供由用户选择是否使用syslog日志功能,提供全局开关变量daemon_proc,而该变量,由daemon_init()函数确定,是否启动一个daemon守护进程。
解析该函数的参数:
errnoflag:选择是否加入errno错误源信息,调用strerror()返回错误字符串。下面是它的另一个调用(与上面第一个调用不同)
/* Nonfatal error unrelated to system call
* Print message and return */
void
err_msg(const char *fmt, ...)
{
va_list ap;
va_start(ap, fmt);
err_doit(0, LOG_INFO, fmt, ap);
va_end(ap);
return;
}
可见,第一个参数是不一样的:
1则输出errno错误源信息;0则不输出errno错误源信息
其实,还是想说说这个err_msg函数:
它并不退出进程,只是直接向输出(先不管是syslog还是stderr)输出信息,在相当有用,通常在非致命错误下使用(err_sys是致命错误,所以退出进程)
level:决定本次err_doit的syslog等级(如果使用syslog的话)
具体等级由syslog系统实现决定,不详细解析。
总结:
上面的使用,或许对新手来说,确实是有点多,这里提供一点参数,作用以后重学习使用。