_vsnprintf 用法


_vsnprintf,C語言庫函數之一,屬於可變參數。用於向字符串中打印數據、數據格式用戶自定義。
頭文件:
#include <stdarg.h>
函數聲明:
int _vsnprintf(char* str, size_t size, const char* format, va_list ap);
參數說明:
char *str [out],把生成的格式化的字符串存放在這里.
size_t size [in], str可接受的最大字節數,防止產生數組越界.
const char *format [in], 指定輸出格式的字符串,它決定了你需要提供的可變參數的類型、個數和順序。
va_list ap [in], va_list變量. va:variable-argument:可變參數
函數功能:將可變參數格式化輸出到一個字符數組。
用法類似於vsprintf,不過加了size的限制,防止了內存溢出(size為str所指的存儲空間的大小)。
返回值:執行成功,返回寫入到字符數組str中的字符個數(不包含終止符),最大不超過size;執行失敗,返回負值,並置errno.[1] 
備注:
linux環境下是:vsnprintf
VC6環境下是:_vsnprintf
#include <stdio.h>
#include <stdarg.h>
int mon_log(char* format, ...)
{
char str_tmp[50];
int i=0;
va_list vArgList; //定義一個va_list型的變量,這個變量是指向參數的指針.
va_start (vArgList, format); //用va_start宏初始化變量,這個宏的第二個參數是第一個可變參數的前一個參 //數,是一個固定的參數.
i=_vsnprintf(str_tmp, 50, format, vArgList); //注意,不要漏掉前面的_
va_end(vArgList); //用va_end宏結束可變參數的獲取
return i; //返回參數的字符個數中間有逗號間隔
}
//調用上面的函數
void main()
  {
  int i=mon_log("%s,%d,%d,%d","asd",2,3,4);
  printf("%d\n",i);
  }
輸出 9。
asd,2,3,4
123456789 (共9個字符,間隔符逗號計算在內)
返回值用法:
#include <stdio.h>
#include <stdlib.h>
#include <stdarg.h>
char *make_message(const char *fmt, ...) {
/* 初始時假設我們只需要不超過100字節大小的空間 */
int n, size = 100;
char *p;
va_list ap;
if ( (p = (char *) malloc(size*sizeof(char))) == NULL)
return NULL;
while (1) {
/* 嘗試在申請的空間中進行打印操作 */
va_start(ap, fmt);
n = vsnprintf (p, size, fmt, ap);
va_end(ap);
/* 如果vsnprintf調用成功,返回該字符串 */
if (n > -1 && n < size)
return p;
/* vsnprintf調用失敗(n<0),或者p的空間不足夠容納size大小的字符串(n>=size),嘗試申請更大的空間*/
size *= 2; /* 兩倍原來大小的空間 */
if ((p = (char *)realloc(p, size*sizeof(char))) == NULL)
return NULL;
}
}
int main() {
/* 調用上面的函數 */
char* str = make_message("%d,%d,%d,%d",5,6,7,8);
printf("%s\n",str);
free(str);
/* 輸出5,6,7,8*/
return 0;
}
代碼在vc6.0下調試通過。
本文主要介紹va_start和va_end的使用及原理。

  在以前的一篇帖子Format MessageBox 詳解中曾使用到va_start和va_end這兩個宏,但對它們也只是泛泛的了解。

  介紹這兩個宏之前先看一下C中傳遞函數的參數時的用法和原理: 

1.在C中,當我們無法列出傳遞函數的所有實參的類型和數目時,可以用省略號指定參數表

void foo(...);
void foo(parm_list,...);
這種方式和我們以前認識的不大一樣,但我們要記住這是C中一種傳參的形式,在后面我們就會用到它。


2.函數參數的傳遞原理

  函數參數是以數據結構:棧的形式存取,從右至左入棧。

  首先是參數的內存存放格式:參數存放在內存的堆棧段中,在執行函數的時候,從最后一個開始入棧。因此棧底高地址,棧頂低地址,舉個例子如下:
void func(int x, float y, char z);
  那么,調用函數的時候,實參 char z 先進棧,然后是 float y,最后是 int x,因此在內存中變量的存放次序是 x->y->z,因此,從理論上說,我們只要探測到任意一個變量的地址,並且知道其他變量的類型,通過指針移位運算,則總可以順藤摸瓜找到其他的輸入變量。
  下面是 <stdarg.h> 里面重要的幾個宏定義如下:
typedef char* va_list;
void va_start ( va_list ap, prev_param ); /* ANSI version */
type va_arg ( va_list ap, type ); 
void va_end ( va_list ap ); 
va_list 是一個字符指針,可以理解為指向當前參數的一個指針,取參必須通過這個指針進行。
<Step 1> 在調用參數表之前,定義一個 va_list 類型的變量,(假設va_list 類型變量被定義為ap);
<Step 2> 然后應該對ap 進行初始化,讓它指向可變參數表里面的第一個參數,這是通過 va_start 來實現的,第一個參數是 ap 本身,第二個參數是在變參表前面緊挨着的一個變量,即“...”之前的那個參數;
<Step 3> 然后是獲取參數,調用va_arg,它的第一個參數是ap,第二個參數是要獲取的參數的指定類型,然后返回這個指定類型的值,並且把 ap 的位置指向變參表的下一個變量位置;
<Step 4> 獲取所有的參數之后,我們有必要將這個 ap 指針關掉,以免發生危險,方法是調用 va_end,他是輸入的參數 ap 置為 NULL,應該養成獲取完參數表之后關閉指針的習慣。說白了,就是讓我們的程序具有健壯性。通常va_start和va_end是成對出現。
例如 int max(int n, ...); 其函數內部應該如此實現:
#include <iostream.h> 
void fun(int a, ...) 
{ 
  int *temp = &a;
  temp++;
  for (int i = 0; i < a; ++i) 
  { 
    cout << *temp << endl; 
    temp++; 
  } 
}
int main() 
{ 
  int a = 1; 
  int b = 2; 
  int c = 3; 
  int d = 4; 
  fun(4, a, b, c, d); 
  system("pause"); 
  return 0; 
} 

Output:: 
1 
2 
3 
4

3:獲取省略號指定的參數
  在函數體中聲明一個va_list,然后用va_start函數來獲取參數列表中的參數,使用完畢后調用va_end()結束。像這段代碼: 
void TestFun(char* pszDest, int DestLen, const char* pszFormat, ...) 
{ 
va_list args; 
va_start(args, pszFormat); //一定要“...”之前的那個參數
_vsnprintf(pszDest, DestLen, pszFormat, args); 
va_end(args); 
}
 
4.演示如何使用參數個數可變的函數,采用ANSI標准形式 
#include 〈stdio.h〉 
#include 〈string.h〉 
#include 〈stdarg.h〉 

/*函數原型聲明,至少需要一個確定的參數,注意括號內的省略號*/ 
int demo( char, ... ); 
void main( void ) 
{ 
   demo("DEMO", "This", "is", "a", "demo!", ""); 
} 

/*ANSI標准形式的聲明方式,括號內的省略號表示可選參數*/ 
int demo( char msg, ... ) 
{ 
       /*定義保存函數參數的結構*/
   va_list argp; 
   int argno = 0; 
   char para; 
     /*argp指向傳入的第一個可選參數,msg是最后一個確定的參數*/ 
   va_start( argp, msg ); 
   while (1) 
       { 
        para = va_arg( argp, char); 
           if ( strcmp( para, "") == 0 ) 
               break; 
           printf("Parameter #%d is: %s\n", argno, para); 
           argno++; 
} 
va_end( argp ); 
/*將argp置為NULL*/
return 0; 
}
 以上是對va_start和va_end的介紹。

 

    最后,希望轉載的朋友能夠尊重作者的勞動成果,加上轉載地址:http://www.cnblogs.com/hanyonglu/archive/2011/05/07/2039916.html  謝謝。

    

    完畢。^_^ 

 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM