_ltoa_s, _ltow_s
将长整数转换为字符串。 这些是 _ltoa, _ltow 的版本与安全增强的 CRT中的安全功能如中所述。
errno_t _ltoa_s(
long value,
char *str,
size_t sizeOfstr,
int radix
);
errno_t _ltow_s(
long value,
wchar_t *str,
size_t sizeOfstr,
int radix
);
template <size_t size>
errno_t _ltoa_s(
long value,
char (&str)[size],
int radix
); // C++ only
template <size_t size>
errno_t _ltow_s(
long value,
wchar_t (&str)[size],
int radix
); // C++ only
参数
value
将转换的数字。str
结果字符串的缓冲区。sizeOfstr
str 的大小 (以字节为单位) _ltoa_s 的或字的 _ltow_s的。radix
value基础。
返回值
零,如果函数运行成功或错误代码。
备注
_ltoa_s 函数在 str转换 value 数字转换为 null 终止的字符串) 并存储结果 (33 个字节)。 radix 参数指定 value基础,必须在范围 2 – 36。 如果 radix 等于 10,而 value 为负,存储的字符串的第一个字符为减号 (-)。 _ltow_s 是 _ltoa_s的一个宽字符版本; _ltow_s 的第二个参数是宽字符字符串。
如果 str 是 NULL 指针或 sizeOfstr 小于或等于零,这些函数调用无效参数处理程序,如 参数验证所述。 如果执行允许继续,这些函数返回 -1 并将 errno 到 EINVAL,或者 value 或 str 超出了长整数的大小,这些函数返回 a-1 并将 errno 到 ERANGE。
在 C++ 中,使用这些功能由模板重载简化;重载可推断缓冲区长度 (自动不再需要指定范围参数),并且还可以用以较新,安全重复自动替换旧,不安全的功能。 有关更多信息,请参见 安全模板重载。
一般文本例程映射
Tchar.h 实例 |
未定义的 _UNICODE 和 _MBCS |
定义的 _MBCS |
定义的 _UNICODE |
---|---|---|---|
_ltot_s |
_ltoa_s |
_ltoa_s |
_ltow_s |
要求
实例 |
必需的头 |
---|---|
_ltoa_s |
stdlib.h |
_ltow_s |
stdlib.h |
有关更多兼容性信息,请参见中介绍的 兼容性 。