共用方式為

_vsprintf_p、_vsprintf_p_l、_vswprintf_p、_vswprintf_p_l

使用指向參數清單的指標編寫格式化輸出，並能夠指定參數的使用順序。

語法

int _vsprintf_p(
   char *buffer,
   size_t sizeInBytes,
   const char *format,
   va_list argptr
);
int _vsprintf_p_l(
   char *buffer,
   size_t sizeInBytes,
   const char *format,
   _locale_t locale,
   va_list argptr
);
int _vswprintf_p(
   wchar_t *buffer,
   size_t count,
   const wchar_t *format,
   va_list argptr
);
int _vswprintf_p_l(
   wchar_t *buffer,
   size_t count,
   const wchar_t *format,
   _locale_t locale,
   va_list argptr
);

參數

buffer
輸出的存儲位置。

sizeInBytes
buffer以字元為單位的大小。

count
要存儲的最大字元數，以此函數的 UNICODE 版本表示。

format
格式規範。

argptr
指向參數清單的指標。

locale
要使用的地區設定。

返回值

_vsprintf_p 並 _vswprintf_p 返回寫入的字元數，不包括終止 NULL 字元，如果發生輸出錯誤，則返回負值。 如果 是bufferNULL指標 和 sizeInBytes or count 為零，則函數傳回本應寫入的字元數，不包括終止字元NULL。 如果 the buffer 有效且 sizeInBytes / count 為零，則返回 -1。

備註

這些函數中的每一個都採用指向參數清單的指標，然後將給定數據格式化並寫入 指向的 buffer記憶體。

這些函數與 不同 vsprintf_s ，僅在 vswprintf_s 於它們支援位置參數。 有關更多資訊，請參閱 printf_p位置參數。

這些帶有 _l 後綴的函數的版本是相同的，只是它們使用傳入的locale參數，而不是當前線程區域設置。

buffer如果 or format 參數是NULL指標，或者格式字串包含無效的格式字元，則會調用無效的參數處理程式，如參數驗證中所述。 如果允許繼續執行，則函數傳回 -1 並設定為 errnoEINVAL。

這很重要

從 Windows 10 版本 2004 (組建 19041) 開始，函式 printf 系列會根據 IEEE 754 規則來列印可精確表示的浮點數以進行四捨五入。 在舊版的 Windows 中，「5」結尾的可精確表示浮點數一律會四捨五入。 IEEE 754指出，浮點數必須四捨五入到最接近的偶數位數 (也稱為「四捨六入五成雙」)。 例如，printf("%1.0f", 1.5) 和 printf("%1.0f", 2.5) 應該四捨五入為 2。 先前，1.5 會四捨五入為 2，而 2.5 會四捨五入為 3。 這項變更只會影響可精確表示的位數。 例如，2.35 (在記憶體中表示時會接近 2.35000000000000008) 會繼續四捨五入至 2.4。 這些函式所完成的四捨五入現在也會遵守 fesetround 所設定的浮點數四捨五入模式。 之前，四捨五入一律會選擇 FE_TONEAREST 行為。 這項變更只會影響使用 Visual Studio 2019 16.2 版和更新版本所建置的程式。 若要使用舊版浮點捨入行為，請與 legacy_stdio_float_rounding.obj連結。

一般文字常式對應

TCHAR.H 常式 _UNICODE 和 _MBCS 未定義 _MBCS 已定義 _UNICODE 已定義
_vstprintf_p _vsprintf_p _vsprintf_p _vswprintf_p
_vstprintf_p_l _vsprintf_p_l _vsprintf_p_l _vswprintf_p_l

需求

常規 必要的標頭 選擇性標頭
_vsprintf_p、_vsprintf_p_l <stdio.h> 和 <stdarg.h> <varargs.h>*
_vswprintf_p、_vswprintf_p_l <stdio.h> 或 <wchar.h> 和 <stdarg.h> <varargs.h>*

* UNIX V 相容性需要。

如需相容性詳細資訊，請參閱相容性。

範例

// crt__vsprintf_p.c
// This program uses vsprintf_p to write to a buffer.
// The size of the buffer is determined by _vscprintf_p.

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

void example( char * format, ... )
{
    va_list  args;
    int      len;
    char     *buffer = NULL;

    va_start( args, format );

    // _vscprintf doesn't count the
    // null terminating string so we add 1.
    len = _vscprintf_p( format, args ) + 1;

    // Allocate memory for our buffer
    buffer = (char*)malloc( len * sizeof(char) );
    if (buffer)
    {
        _vsprintf_p( buffer, len, format, args );
        puts( buffer );
        free( buffer );
    }
    va_end( args );
}

int main( void )
{
    // First example
    example( "%2$d %1$c %3$d", '<', 123, 456 );

    // Second example
    example( "%s", "This is a string" );
}

123 < 456
This is a string

另請參閱

資料流 I/O
vprintf 函數
格式規範語法： printf 和 wprintf 函數
fprintf、 、 _fprintf_l、 fwprintf_fwprintf_l
printf、 、 _printf_l、 wprintf_wprintf_l
sprintf、_sprintf_l、swprintf、_swprintf_l、__swprintf_l
va_arg、 、 va_copy、 va_endva_start

  • Last updated on