_scprintf_p、 _scprintf_p_l、 _scwprintf_p、 _scwprintf_p_l
在格式化字串中,傳回字元的數,且能夠在格式字串中指定參數所使用的順序。
int _scprintf_p(
const char *format [,
argument] ...
);
int _scprintf_p_l(
const char *format,
locale_t locale [,
argument] ...
);
int _scwprintf_p (
const wchar_t *format [,
argument] ...
);
int _scwprintf_p _l(
const wchar_t *format,
locale_t locale [,
argument] ...
);
參數
format
控制項的格式字串。argument
選擇性的引數。locale
若要使用地區設定。
傳回值
傳回如果該字串一樣列印或傳送到檔案或使用指定的格式代碼的緩衝區,則會產生的字元數。 傳回的值不包含結束的 null 字元。 _scwprintf_p寬字元來執行相同的功能。
之間的差異_scprintf_p 和_scprintf 的_scprintf_p 支援位置參數,它可讓您在格式字串中指定的引數所使用的順序。 如需詳細資訊,請參閱 printf_p 位置參數。
如果format是NULL指標,不正確的參數處理常式會叫用,如所述參數驗證。 如果執行,則允許繼續執行,這些函數會傳回-1,並設定errno到EINVAL。
如需這些和其他錯誤碼資訊,請參閱 _doserrno、 errno、 _sys_errlist,以及 _sys_nerr。
備註
每個argument (如果有的話) 會轉換成對應的格式規格,以根據format。 一般字元所組成的格式,與具有相同的表單,並作為format引數的 printf。
使用這些函式的版本_l尾碼完全相同,不同之處在於它們使用傳遞中而不是目前執行緒的地區設定的地區設定參數。
安全性提示 |
---|
請確定format不是使用者定義的字串。 |
泛用文字常式對應
Tchar.h 常式 |
_Unicode 之後,未定義的 _MBCS |
定義的 _MBCS |
定義 _unicode 之後 |
---|---|---|---|
_sctprintf_p |
_scprintf_p |
_scprintf_p |
_scwprintf_p |
_sctprintf_p_l |
_scprintf_p_l |
_scprintf_p_l |
_scwprintf_p_l |
需求
常式 |
所需的標頭 |
---|---|
_scprintf_p, _scprintf_p_l |
<stdio.h> |
_scwprintf_p, _scwprintf_p_l |
<stdio.h> 或者 <wchar.h> |
如需相容性資訊,請參閱相容性在簡介中。