_ltoa_s， _ltow_s

项目
02/21/2013

将长整数转换为字符串。这些是 _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++ 中，使用这些功能由模板重载简化;重载可推断缓冲区长度 (自动不再需要指定范围参数)，并且还可以用以较新，安全重复自动替换旧，不安全的功能。有关更多信息，请参见安全模板重载。

一般文本例程映射