_vsnprintf 用法

可以和va_start va_end結合使用,實現對參數的合併


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


函數簡介

頭文件:
  #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, ...)
  {
  va_list vArgList; //定義一個va_list型的變量,這個變量是指向參數的指針.
  va_start(vArgList, format); //用va_start初始化變量,這個宏的第二個參數是第一個可變參數的前一個參數,是一個固定的參數.
  _vsnprintf(str_tmp, 3, format, vArgList); //注意,不要漏掉前面的_
  va_end(vArgList); //用va_end結束可變參數的獲取
  return 0;
  }
  //調用上面的函數
  mon_log("%d,%d,%d,%d", 1,2,3,4);
  返回值用法:
  #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)) == 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)) == NULL)
  return NULL;
  }
  }
  int main() {
  /* 調用上面的函數 */
  char* str = make_message("%d,%d,%d,%d",5,6,7,8);
  printf("%s\n",str);
  return 0;
  }

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章