_ultoa_s, _ultow_s

将无符号长整数转换为字符串。 这些是 _ultoa, _ultow 的版本与安全增强的 CRT中的安全功能如中所述。

errno_t _ultoa_s(
    unsigned long value,
    char *str,
    size_t sizeOfstr,
    int radix 
);
errno_t _ultow_s(
    unsigned long value,
    wchar_t *str,
    size_t sizeOfstr,
    int radix 
);
template <size_t size>
errno_t _ultoa_s(
    unsigned long value,
    char (&str)[size],
    int radix 
); // C++ only
template <size_t size>
errno_t _ultow_s(
    unsigned long value,
    wchar_t (&str)[size],
    int radix 
); // C++ only

参数

  • value
    将转换的数字。

  • str
    字符串结果。

  • sizeOfstr
    str 的大小 (以字节为单位) _ultoa_s 的或字的 _ultow_s的。

  • radix
    value基础。

返回值

零,如果函数运行成功或错误代码。

备注

_ultoa_s 函数在 str转换 value 数字转换为 null 终止的字符串) 并存储结果 (33 个字节)。 radix 参数指定 value基础,必须在范围 2 – 36。 _ultow_s 是 _ultoa_s的一个宽字符版本; _ultow_s 的第二个参数是宽字符字符串。

如果 str 是 NULL 指针,或者,如果 sizeOfstr 小于或等于零,无效参数调用处理程序,如 参数验证所述。 如果执行允许继续,这些函数返回 -1 并将 errno 到 EINVAL,或者 value 或 str 超出了长整数的大小,则这些功能将返回 a-1 并将 errno 到 ERANGE。

在 C++ 中,使用这些功能由模板重载简化;重载可推断缓冲区长度 (自动不再需要指定范围参数),并且还可以用以较新,安全重复自动替换旧,不安全的功能。 有关更多信息,请参见 安全模板重载

一般文本例程映射

TCHAR.H 实例

未定义的 _UNICODE _MBCS

定义的 _MBCS

定义的 _UNICODE

_ultot_s

_ultoa_s

_ultoa_s

_ultow_s

要求

实例

必需的头

_ultoa_s

stdlib.h

_ultow_s

stdlib.h

有关其他的兼容性信息,请参见中介绍的 兼容性

.NET Framework 等效项

系统:: 转换:: ToString

请参见

参考

数据转换

_ultoa, _ultow

_ltoa, _ltow

_ltoa_s, _ltow_s

_ltoa_s, _ltow_s