_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

有关更多兼容性信息,请参见中介绍的 兼容性

.NET Framework 等效项

系统:: 转换:: ToString

请参见

参考

数据转换

_itoa, _i64toa, _ui64toa, _itow, _i64tow, _ui64tow

_ultoa, _ultow

_ultoa_s, _ultow_s