_ultoa_s、_ultow_s

2015-06-09

将无符号 long 整数转换为字符串。 _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 函数将 value 的数值转换为 null 终止字符字符串并将结果 (33 字节)存储到str。 radix 参数指定了 value基，其值的范围必须是从 2 到 36。 _ultow_s 是 _ultoa_s 的宽字符版本；_ultow_s 的第二个参数是宽字符串。

如果str 是一个 NULL 指针，或者如果 sizeOfstr 小于等于零，将调用无效参数处理程序，正如参数验证所述。如果允许继续执行，这些函数返回 -1 并将 errno 设置为 EINVAL 或如果 value 或 str 超出长整数范围，这些函数将返回 a-1 并将 errno 设置为 ERANGE。

在 C++ 中，使用这些函数由模板重载简化；重载可以自动推导出缓冲区长度 (不再需要指定大小参数)，并且它们可以自动用以更新、更安全的对应物替换旧的、不安全的函数。有关更多信息，请参见安全模板重载。

一般文本例程映射