_ltoa_s、_ltow_s

项目
06/09/2015

将长整数转换为字符串。 _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 函数将 value 的数值转换为 null 终止字符字符串并将结果 (33 字节)存储到str。 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++ 中，使用这些函数由模板重载简化；重载可以自动推导出缓冲区长度 (不再需要指定大小参数)，并且它们可以自动用以更新、更安全的对应物替换旧的、不安全的函数。有关更多信息，请参见安全模板重载。

一般文本例程映射