vsprintf, _vsprintf_l, vswprintf, _vswprintf_l, __vswprintf_l
编写格式化输出使用指针参数列表。 这些功能的更安全版本可用; 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 是 null 指针,这些函数调用的参数无效处理程序,如 参数验证所述。 如果执行允许继续,这些函数返回 -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" );
}
.NET Framework 等效项
请参见
参考
fprintf, _fprintf_l, fwprintf, _fwprintf_l
printf, _printf_l, wprintf, _wprintf_l