_sprintf_p
, _sprintf_p_l
, _swprintf_p
, _swprintf_p_l
將格式化資料寫入字串,而且可以指定在格式字串中使用參數的順序。
語法
int _sprintf_p(
char *buffer,
size_t sizeOfBuffer,
const char *format [,
argument_list]
);
int _sprintf_p_l(
char *buffer,
size_t sizeOfBuffer,
const char *format,
_locale_t locale [,
argument_list]
);
int _swprintf_p(
wchar_t *buffer,
size_t sizeOfBuffer,
const wchar_t *format [,
argument_list]
);
int _swprintf_p_l(
wchar_t *buffer,
size_t sizeOfBuffer,
const wchar_t *format,
_locale_t locale [,
argument_list]
);
參數
buffer
輸出的儲存位置
sizeOfBuffer
要儲存的最大字元數。
format
格式控制字串。
argument_list
格式字串的選擇性引數。
locale
要使用的地區設定。
如需詳細資訊,請參閱 格式規格語法 。
傳回值
寫入的字元數,如果發生錯誤,則為 -1。
備註
_sprintf_p
函式會在 buffer
中格式化並儲存一連串字元和值。 中的每個引數 argument_list
都會根據 中的 format
對應格式規格來轉換和輸出。 自 format
變數使用 和 wprintf
函 式的格式規格語法 printf
。 null 字元會附加至最後一個寫入的字元之後。 如果在重疊的字串之間進行複製,則行為是未定義的。 _sprintf_p
和 sprintf_s
之間的差異在於 _sprintf_p
支援位置參數,可讓您指定格式字串中使用引數的順序。 如需詳細資訊,請參閱 printf_p
位置參數 。
_swprintf_p
是 _sprintf_p
的寬字元版本, _swprintf_p
的指標引數是寬字元字串。 中的 _swprintf_p
編碼錯誤偵測可能與 中的 _sprintf_p
偵測不同。 _swprintf_p
和 fwprintf_p
的運作方式完全相同,不同處在於 _swprintf_p
會將輸出寫入字串,而非類型 FILE
的目的地,而且 _swprintf_p
需要 count
參數指定要寫入的字元數上限。 這些有 _l
尾碼的函式版本是一樣的,不同之處在於會使用傳入的地區設定,而不使用目前的執行緒地區設定。
_sprintf_p
會傳回儲存在 buffer
中的位元組數目,不計結束的 null 字元。 _swprintf_p
會傳回儲存在 buffer
中的寬字元數目,不計結束的 null 寬字元。 如果 buffer
或 format
為 Null 指標,或如果格式字串包含不正確格式字元,則會叫用不正確參數處理常式,如參數驗證 中所述 。 如果允許繼續執行,這些函式會傳回 -1,並將 errno
設為 EINVAL
。
重要
從 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.3500000000000000008)會繼續四捨五入至 2.4。 這些函式完成的四捨五入現在也會遵守 所 fesetround
設定的浮點舍入模式。 之前,舍入一律選擇 FE_TONEAREST
行為。 這項變更只會影響使用 Visual Studio 2019 16.2 版和更新版本所建置的程式。 若要使用舊版浮點舍入行為,請連結至 'legacy_stdio_float_rounding.obj' 。
泛型文字常式對應
TCHAR.H 常規 |
_UNICODE 和 _MBCS 未定義 |
_MBCS 定義 |
_UNICODE 定義 |
---|---|---|---|
_stprintf_p |
_sprintf_p |
_sprintf_p |
_swprintf_p |
_stprintf_p_l |
_sprintf_p_l |
_sprintf_p_l |
_swprintf_p_l |
需求
常式 | 必要的標頭 |
---|---|
_sprintf_p , _sprintf_p_l |
<stdio.h> |
_swprintf_p , _swprintf_p_l |
<stdio.h> 或 <wchar.h> |
如需相容性詳細資訊,請參閱相容性。
範例:用來 _sprintf_p
格式化資料
// crt_sprintf_p.c
// This program uses _sprintf_p to format various
// data and place them in the string named buffer.
//
#include <stdio.h>
int main( void )
{
char buffer[200],
s[] = "computer", c = 'l';
int i = 35,
j;
float fp = 1.7320534f;
// Format and print various data:
j = _sprintf_p( buffer, 200,
" String: %s\n", s );
j += _sprintf_p( buffer + j, 200 - j,
" Character: %c\n", c );
j += _sprintf_p( buffer + j, 200 - j,
" Integer: %d\n", i );
j += _sprintf_p( buffer + j, 200 - j,
" Real: %f\n", fp );
printf( "Output:\n%s\ncharacter count = %d\n",
buffer, j );
}
Output:
String: computer
Character: l
Integer: 35
Real: 1.732053
character count = 79
範例:錯誤碼處理
// crt_swprintf_p.c
// This is the wide character example which
// also demonstrates _swprintf_p returning
// error code.
#include <stdio.h>
#define BUFFER_SIZE 100
int main( void )
{
wchar_t buffer[BUFFER_SIZE];
int len;
len = _swprintf_p(buffer, BUFFER_SIZE, L"%2$s %1$d",
0, L" marbles in your head.");
_printf_p( "Wrote %d characters\n", len );
// _swprintf_p fails because string contains WEOF (\xffff)
len = _swprintf_p(buffer, BUFFER_SIZE, L"%s",
L"Hello\xffff world" );
_printf_p( "Wrote %d characters\n", len );
}
Wrote 24 characters
Wrote -1 characters
另請參閱
資料流 I/O
_fprintf_p
, _fprintf_p_l
, _fwprintf_p
, _fwprintf_p_l
fprintf
, _fprintf_l
, fwprintf
, _fwprintf_l
_printf_p
, _printf_p_l
, _wprintf_p
, _wprintf_p_l
printf
, _printf_l
, wprintf
, _wprintf_l
sprintf
, _sprintf_l
, swprintf
, _swprintf_l
, __swprintf_l
scanf
, _scanf_l
, wscanf
, _wscanf_l
sscanf
, _sscanf_l
, swscanf
, _swscanf_l
sscanf_s
, _sscanf_s_l
, swscanf_s
, _swscanf_s_l
vprintf
函數
printf_p
位置參數
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應