fprintf 的封装（vsprintf,va_start(), va_arg(), va_end()可变参数列表）

http://www.cnblogs.com/leaven/archive/2010/06/29/1767374.html

 

 

首先我们来看一个封装的实例：

#include  < stdio.h >
#include  < stdlib.h >
#include  < stdarg.h >

#define  FPRINT_OUT_FILE_PATH "/dev/pts/2"
FILE  *  console_printf_f;

int  My_fprintf( const     char     * form ,...)
{
    va_list   arg;   
     int    done;   
     char  pbString[ 256 ];
  
    va_start(arg,form);  
    vsprintf(pbString,form,arg);　　　　　　　　　　　//若此行和下行改为：done = fprintf(console_printf_f,form,arg);则可变
    done  =  fprintf(console_printf_f,pbString);　　　//参数的值不能正常显示，原因是参数传递错误，fprintf不能正确处理va_list类型的参数
     // done = printf(pbString);
    va_end(arg);   
     return    done;   
}

int  main()
{
     int  i;
    console_printf_f = fopen(FPRINT_OUT_FILE_PATH,  " w "  );
    My_fprintf( " hello my_fprintf %d %d %d  %s /n " , 0 , 1 , 2 , " ni hao  " );
    fprintf(console_printf_f, " hello fprintf %d %s /n " , 32  , " ni hao  " );
    fclose(console_printf_f);
     return   0 ;
}

 

 1.fprintf()原形：
#include <stdio.h>
int fprintf( FILE *stream, const char *format, ... );

2.vsprintf(), vnsprintf()的原形及使用：

#include  < stdarg.h >   
int  vsprintf( char   * str,  const   char   * format, va_list ap);  
int  vsnprintf( char   * str, size_t size,  const   char   * format, va_list ap); 

说明：
vsprintf() 和 vsnprintf() 基本一样，但后者比前者多了一个字节数的限定。

vsprintf() 参数说明：
str : 一般是个字符缓冲区的首地址；
format : 是带有格式说明的字符串，如同 printf() 中第一个参数；
ap : va_list 类型，关于 va_list 类型说明见：http://www.groad.net/bbs/read.php?tid-947.html

应用举例：

代码

#include  < stdio.h >   
#include  < stdarg.h >   

void  log_msg ( const   char   * text, ...)  
{  
     char  buf [ 256 ];  
    va_list args;  
    va_start (args, text);  
    vsprintf (buf , text, args);  
    printf ( " %s " , buf);  
    va_end (args);    
}  

int  main()  
{  
     int  year  =   2008 ;  
     char   * ptr  =   " china " ;  
    log_msg ( " hello %d Beijing and welcome to %s/n " , year, ptr);  
     return  ( 0 );  
} 

运行与输出：

[beyes@localhost vsprintf]$ ./vsprintf.exe
hello 2008 Beijing and welcome to china

 

3.可变参数列表：

1）相关函数：

#include <stdarg.h>
void va_start( va_list ap , last);
type va_arg( va_list ap , type);
void va_end( va_list ap);
void va_copy( va_list dest , va_list src);

2）也许有时会需要不同类型、不同数目的参数来调用函数。<stdarg.h> 声明了一个 va_list 类型，还定义了三个宏来逐步跟踪一个参数列表。对于调用函数来说，它并不会知道这个列表里的参数个数及其类型。
调用函数必须声明一个 va_list 类型的变量。va_list 类型在宏 va_start()，va_arg()，和 va_end() 中用到。
va_start()
宏 va_start() 初始化

ap 这个参数，这是为了后面的 va_arg() 和 va_end() 会用到此参数。这个宏是必须被第一个调用的。
last  参数是可变参数列表之前的最近的一个参数的名字，也就是说，这是调用函数 所知道的最近的一个类型。由于这个参数( last )的地址可能会在 va_start() 中用到，所以它不能是一个寄存器变量，或者是一个函数，抑或是一个数组类型。
va_arg()
va_arg() 宏展开成一个表达式，这个表达式含有调用函数中下一个参数的值和类型。
其中，ap 是经由 va_start() 初始化后的 va_list ap 。每次调用 va_arg() 都会改变 ap，这样一来下一次的调用就会返回下一个参数。参数 type 是一个已指定过的类型名(如 int , char )，这样一来，通过增加 * 到 type 中( 如 int *, char *)就可以简单地获得一个已指定类型对象的指针类型。
在调用 va_start() 后第一次使用 va_arg() 会返回 last 后的参数。连续调用则返回剩下的参数。
如果已没有下一个参数，或者 type 与下一个参数的实际类型并不兼容，则发生的错误不可预料。
如果把 ap 传递给一个调用 va_arg(ap, type) 的函数，那么当这个函数返回后，ap 的值为未定义。

va_end()
在同一个函数里，每一次调用 va_start() 都必须和 va_end() 相配对。在调用 va_end( ap ) 后，ap 变为未定义。对于多重遍历参数列表，则每次配对使用 va_start() 和 va_end() 是可以的。va_end() 可能是一个宏，或者是一个函数。
举例：

代码

#include  < stdio.h >
#include  < stdarg.h >

void  foo( char   * fmt, ...)
{
        va_list ap;
         int      d;
         char  c,  * s;

        va_start(ap, fmt);
         while  ( * fmt)
                 switch  ( * fmt ++ ) {
                 case   ' s ' :
                        s  =  va_arg(ap,  char   * );
                        printf( " string %s/n " , s);
                         break ;
                 case   ' d ' :
                        d  =  va_arg(ap,  int );
                        printf( " int %d/n " , d);
                         break ;
                 case   ' c ' :
                        c  =  ( char ) va_arg(ap,  int );
                        printf( " char %c/n " , c);
                         break ;
                }
        va_end(ap);
}
int  main()
{
         int  val1  =   20 ;
         char  buf[ 20 ]  =  { " hello world " };
        foo( " kkkkkk%dxxxxxsxxxxx " ,val1,buf);
         return   0 ;
}

 

运行及输出：
beyes@linux-beyes:~/C> ./varg.exe
int 20
string hello world

说明：
在 foo() 函数中，使用一个 while 循环遍历 fmt 所指向字符串中的每一个字符，这是为了要找出与 switch 所定制相匹配的字符。假如找到匹配项，那么就调用 va_arg()。在 va_arg() 中，ap 表示了 fmt 指向字符串后面的参数列表。每一次调用 va_arg() 就会读出参数列表中的一个项，假如得到的这个参数列表中的项的实际类型和 va_arg() 中的第二个参数指明的类型一样，那么这个宏调用成功。如果是乱指定一个未知的类型，比如 kk ，那么这在编译时也会给出错误的提示：

varg.c: In function ‘foo’:
varg.c:14: error: expected specifier-qualifier-list before ‘kk’

如果指定一个不兼容的类型，比如把上面的 char * 改写成 int，编译时给出提示：
varg.c: In function ‘foo’:
varg.c:14: warning: assignment makes pointer from integer without a cast

这是个警告信息，意思是没有通过类型强制转换就把一个整数类型变成指针类型。但程序运行后仍然打印出想要的信息。