_ultoa_s， _ultow_s

项目
02/21/2013

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

一般文本例程映射