_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相应的格式规范转换。 该格式包括普通字符并具有窗体和功能和 printf的 format 参数相同。
这些功能的版本与 _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 |
有关更多兼容性信息,请参见中介绍的 兼容性 。