_vsnprintf在可變參數打印中的用法

_vsnprintf，C語言庫函數之一，屬於可變參數。用於向字符串中打印數據、數據格式用戶自定義。

 

函數簡介

編輯

頭文件:

#include <stdarg.h>

函數聲明:

int _vsnprintf(char* str, size_t size, const char* format, va_list ap);

參數說明:

1. char *str [out],把生成的格式化的字符串存放在這里.
2. size_t size [in], str可接受的最大字符數[1]   (非字節數，UNICODE一個字符兩個字節),防止產生 數組越界.
3. const char *format [in], 指定輸出格式的字符串，它決定了你需要提供的可變參數的類型、個數和順序。
4. va_list ap [in], va_list變量. va:variable-argument:可變參數

函數功能：將可變參數格式化輸出到一個字符數組。

用法類似於vsprintf，不過加了size的限制，防止了內存溢出（size為str所指的存儲空間的大小）。

返回值：執行成功，返回寫入到字符數組str中的字符個數（不包含終止符），最大不超過size；執行失敗，返回負值，並置 errno.[2]  

備注:

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個字符，間隔符逗號計算在內）[2]  

返回值用法

#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);
    /* we allocate the memory in the make_message function, so we should release it by caller(main function). */
    return 0;
}