vsprintf、 _vsprintf_l、 vswprintf、 _vswprintf_l、 __vswprintf_l

發行項
02/28/2013

撰寫使用指標引數清單的格式化的輸出。這些函式更安全版本都可使用; see vsprintf_s、 _vsprintf_s_l、 vswprintf_s、 _vswprintf_s_l.

int vsprintf(
   char *buffer,
   const char *format,
   va_list argptr 
); 
int _vsprintf_l(
   char *buffer,
   const char *format,
   locale_t locale,
   va_list argptr 
); 
int vswprintf(
   wchar_t *buffer,
   size_t count,
   const wchar_t *format,
   va_list argptr 
);
int _vswprintf_l(
   wchar_t *buffer,
   size_t count,
   const wchar_t *format,
   locale_t locale,
   va_list argptr 
);
int __vswprintf_l(
   wchar_t *buffer,
   const wchar_t *format,
   locale_t locale,
   va_list argptr 
);
template <size_t size>
int vsprintf(
   char (&buffer)[size],
   const char *format,
   va_list argptr 
); // C++ only
template <size_t size>
int _vsprintf_l(
   char (&buffer)[size],
   const char *format,
   locale_t locale,
   va_list argptr 
); // C++ only
template <size_t size>
int vswprintf(
   wchar_t (&buffer)[size],
   size_t count,
   const wchar_t *format,
   va_list argptr 
); // C++ only
template <size_t size>
int _vswprintf_l(
   wchar_t (&buffer)[size],
   size_t count,
   const wchar_t *format,
   locale_t locale,
   va_list argptr 
); // C++ only

參數

buffer
輸出的儲存位置。
count
最大字元長度，才能儲存在UNICODE之這個函式的版本。
format
格式規格。
argptr
引數清單的指標。
locale
若要使用地區設定。

傳回值

vsprintf與vswprintf傳回寫入的字元數，不包含結束的 null 字元或為負值，如果發生輸出錯誤。如果buffer或format是空值的指標，如所述，這些函式叫用無效的參數處理常式中，參數驗證。如果執行，則允許繼續執行，這些函數會傳回-1，並設定errno到EINVAL。

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

備註

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

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

安全性提示
使用vsprintf，這裡沒有方法可以限制的字元數寫入時，亦即以這個函式的程式碼就會受到影響的緩衝區滿溢。使用 _vsnprintf 相反的就是呼叫 _vscprintf 來判斷是否需要多大的緩衝區。此外，確保format不是使用者定義的字串。如需詳細資訊，請參閱避免緩衝區滿溢，。

vswprintf符合 ISO C 標準，而第二個參數，這會count，型別的size_t。若要強制舊的非標準方式，定義_CRT_NON_CONFORMING_SWPRINTFS.舊的行為可能不是在未來的版本中，因此必須變更程式碼，以使用新一致的行為。

在 C++ 中，這些函式會有範本的多載，叫用這些函式的較新的、安全對應項目。如需詳細資訊，請參閱安全範本多載。

泛用文字常式對應

TCHAR。H 常式	_UNICODE & 未定義的 _MBCS	定義的 _MBCS	定義 _unicode 之後
_vstprintf	vsprintf	vsprintf	vswprintf
_vstprintf_l	_vsprintf_l	_vsprintf_l	_vswprintf_l

需求

常式	所需的標頭	選擇性標頭
vsprintf, _vsprintf_l	<stdio.h> 和 <stdarg.h>	<varargs.h> *
vswprintf, _vswprintf_l	<stdio.h> 或 <wchar.h>，和 <stdarg.h>	<varargs.h> *

* UNIX V 相容性的必要項。

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

範例

// crt_vsprintf.c
// compile with: /W3
// This program uses vsprintf to write to a buffer.
// The size of the buffer is determined by _vscprintf.

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

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

    // retrieve the variable arguments
    va_start( args, format );
    
    len = _vscprintf( format, args ) // _vscprintf doesn't count
                                + 1; // terminating '\0'
    
    buffer = (char*)malloc( len * sizeof(char) );

    vsprintf( buffer, format, args ); // C4996
    // Note: vsprintf is deprecated; consider using vsprintf_s instead
    puts( buffer );

    free( buffer );
}

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