apue读书笔记【二】:处理可变参数(2) vsnprintf

 vsnprintf  用于向字符串中打印数据、数据格式用户自定义。

我阅读apue书中的源码例子中发现些函数，位置于apue.h 和  error.c中。作者用可变参数的处理与vsnprintf结合，封装了错误打印的方法。

头文件:
　　#include <stdarg.h>
函数声明:
　　int vsnprintf(char *buffer, size_t max_count, const char *format, va_list vArgList);
参数说明:
　　1. char *buffer [out],把生成的格式化的字符串存放在这里.
　　2. size_t max_count [in], buffer可接受的最大字节数,防止产生数组越界.
　　3. const char *format [in], 格式化字符串
　　4. va_list vArgList [in], va_list变量. va:variable-argument:可变参数
　　用法类似于vsprintf,只不过加了max_count的限制

demo:

#include <stdarg.h> /*for va_list*/
#include <stdio.h> /*for vsnprintf*/
/**
    头文件:
　　#include <stdarg.h>
　　函数声明:
　　int vsnprintf(char *buffer, size_t max_count, const char *format, va_list vArgList);
　　参数说明:
　　1. char *buffer [out],把生成的格式化的字符串存放在这里.
　　2. size_t max_count [in], buffer可接受的最大字节数,防止产生数组越界.
　　3. const char *format [in], 格式化字符串
　　4. va_list vArgList [in], va_list变量. va:variable-argument:可变参数
　　用法类似于vsprintf,只不过加了max_count的限制

   返回值说明:
　　如果成功调用此函数，返回写到buffer中的字符的个数（不包括结尾的'\0'）。snprintf和vsnprintf函数不能够写多于size大小（包括结尾的'0'）的字节数。
    如果输出因为以上原因被截断，返回成功写入buffer的字符数（不包括结尾的'\0'），如果有足够的内存空间的话。
	所以，如果返回值等于size或者大于size，表示输出到buffer的字符被截断，如果输出过程中遇到错误，则返回一个负数。
**/

int mon_log(char* format,...){

	 char str_tmp[10];
	 
	 va_list vArgList;//定义一个va_list型的变量，这个变量是指向参数的指针

     va_start(vArgList,format);//用va_start宏初始化变量,这个宏的第二个参数是第一个可变参数的前一个参数,是一个固定的参数.

	 int nSize=vsnprintf(str_tmp,1,format,vArgList);//nSize的大小不包括‘\0’，第二个参数填1是不能写进去内容的（因为'\0'占了一个字节）

	 va_end(vArgList);//用va_end宏结束可变参数的获取

	 printf("nSize: %d, buff: %s\n", nSize, str_tmp);

	 return 0;
}

int main(){
  
   mon_log("%d", 1);
}

输出：

      

由输出可以看出 vsnprintf的返回值就是本应写进buffer缓存区的字符个数，第二个参数的意思就是实际允许写进buffer缓存区的最大字符个数
为了说明第二个参数，调整vsnprintf的第二个参数，demo如下

#include <stdarg.h> /*for va_list*/
#include <stdio.h> /*for vsnprintf*/
/**
    头文件:
　　#include <stdarg.h>
　　函数声明:
　　int vsnprintf(char *buffer, size_t max_count, const char *format, va_list vArgList);
　　参数说明:
　　1. char *buffer [out],把生成的格式化的字符串存放在这里.
　　2. size_t max_count [in], buffer可接受的最大字节数,防止产生数组越界.
　　3. const char *format [in], 格式化字符串
　　4. va_list vArgList [in], va_list变量. va:variable-argument:可变参数
　　用法类似于vsprintf,只不过加了max_count的限制

   返回值说明:
　　如果成功调用此函数，返回写到buffer中的字符的个数（不包括结尾的'\0'）。snprintf和vsnprintf函数不能够写多于size大小（包括结尾的'0'）的字节数。
    如果输出因为以上原因被截断，返回成功写入buffer的字符数（不包括结尾的'\0'），如果有足够的内存空间的话。
	所以，如果返回值等于size或者大于size，表示输出到buffer的字符被截断，如果输出过程中遇到错误，则返回一个负数。
**/

int mon_log(char* format,...){

	 char str_tmp[10];
	 
	 va_list vArgList;//定义一个va_list型的变量，这个变量是指向参数的指针

     va_start(vArgList,format);//用va_start宏初始化变量,这个宏的第二个参数是第一个可变参数的前一个参数,是一个固定的参数.

	 int nSize=vsnprintf(str_tmp,10,format,vArgList);//nSize的大小不包括‘\0’，第二个参数填1是不能写进去内容的（因为'\0'占了一个字节）

	 va_end(vArgList);//用va_end宏结束可变参数的获取

	 printf("nSize: %d, buff: %s\n", nSize, str_tmp);

	 return 0;
}

int main(){
  
   mon_log("%d,%d,%d,%d", 1,2,3,4);
}

输出：

       

自己把程序拿下来改改，再跑跑就清楚很多了。

demo不怕多，再来一个：

#include <stdio.h>
#include <stdarg.h> /*for va_list*/
#include <memory.h> /*for memset*/

void FormatOutput(char*  formatstring, ...)
{
   int nSize = 0;
   char buff[10];
   memset(buff, 0, sizeof(buff));
   va_list args;
   va_start(args, formatstring);
   nSize = vsnprintf( buff, sizeof(buff) - 1, formatstring, args); // C4996
// Note: vsnprintf is deprecated; consider vsnprintf_s instead
   printf("nSize: %d, buff: %s\n", nSize, buff);
}

int main() {
   FormatOutput("%s %s", "Hi", "there");
   FormatOutput("%s %s", "Hi", "there!");
   FormatOutput("%s %s", "Hi", "there!!");
   return 0;
}