_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 謝謝。 完畢。^_^