vsprintf_s、 _vsprintf_s_l、 vswprintf_s、 _vswprintf_s_l

發行項
02/28/2013

撰寫使用指標引數清單的格式化的輸出。這些是舊版vsprintf、 _vsprintf_l、 vswprintf、 _vswprintf_l、 __vswprintf_l中所述的安全性增強功能與安全性功能，則在 CRT 中。

int vsprintf_s(
   char *buffer,
   size_t numberOfElements,
   const char *format,
   va_list argptr 
); 
int _vsprintf_s_l(
   char *buffer,
   size_t numberOfElements,
   const char *format,
   locale_t locale,
   va_list argptr 
); 
int vswprintf_s(
   wchar_t *buffer,
   size_t numberOfElements,
   const wchar_t *format,
   va_list argptr 
);
int _vswprintf_s_l(
   wchar_t *buffer,
   size_t numberOfElements,
   const wchar_t *format,
   locale_t locale,
   va_list argptr 
);
template <size_t size>
int vsprintf_s(
   char (&buffer)[size],
   const char *format,
   va_list argptr 
); // C++ only
template <size_t size>
int vswprintf_s(
   wchar_t (&buffer)[size],
   const wchar_t *format,
   va_list argptr 
); // C++ only

參數

buffer
輸出的儲存位置。
numberOfElements
大小的buffer以字元為單位。
format
格式規格。
argptr
引數清單的指標。
locale
若要使用地區設定。

傳回值

vsprintf_s與vswprintf_s傳回寫入的字元數，不包含結束的 null 字元或為負值，如果發生輸出錯誤。如果buffer或format時發現 null 指標，如果計數是零，或如果格式字串包含無效的格式字元，不正確的參數處理常式會叫用，如所述參數驗證。若要繼續，允許執行，函數會傳回-1，並設定errno到EINVAL。

有關這些及其他錯誤碼資訊，請參閱 _doserrno、 errno、 _sys_errlist，以及 _sys_nerr。

備註

每個函式接受指標引數] 清單中，並再設定格式並將寫入指定的資料所指的記憶體buffer。

vswprintf_s符合 ISO C 標準的vswprintf，這需要第二個參數中， count，型別的size_t。

這些函式與非安全的版本不同，只有一個安全版本都支援位置參數。如需詳細資訊，請參閱 printf_p 位置參數。

使用這些函式的版本_l尾碼完全相同，不同之處在於它們使用傳遞中而不是目前執行緒的地區設定的地區設定參數。

在 C++ 中，使用這些函式已經過簡化的樣板的多載；多載可以自動推斷緩衝區長度 (而不必指定 size 引數)，它們可以自動取代較舊的、不安全的函式與其較新的、安全的對應項目。如需詳細資訊，請參閱安全範本多載。

泛用文字常式對應

TCHAR。H 常式	_UNICODE & 未定義的 _MBCS	定義的 _MBCS	定義 _unicode 之後
_vstprintf_s	vsprintf_s	vsprintf_s	vswprintf_s
_vstprintf_s_l	_vsprintf_s_l	_vsprintf_s_l	_vswprintf_s_l

需求

常式	所需的標頭	選擇性標頭
vsprintf_s, _vsprintf_s_l	<stdio.h> 和 <stdarg.h>	<varargs.h> *
vswprintf_s, _vswprintf_s_l	<stdio.h> 或 <wchar.h>，和 <stdarg.h>	<varargs.h> *

* UNIX V 相容性的必要項。

其他的相容性資訊，請參閱相容性在簡介中。

範例

// crt_vsprintf_s.c
// This program uses vsprintf_s to write to a buffer.
// The size of the buffer is determined by _vscprintf.

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

void test( char * format, ... )
{
   va_list args;
   int len;
   char * buffer;

   va_start( args, format );
   len = _vscprintf( format, args ) // _vscprintf doesn't count
                               + 1; // terminating '\0'
   buffer = malloc( len * sizeof(char) );
   vsprintf_s( buffer, len, format, args );
   puts( buffer );
   free( buffer );
}

int main( void )
{
   test( "%d %c %d", 123, '<', 456 );
   test( "%s", "This is a string" );
}