_ultoa_s, _ultow_s

아티클
06/09/2015

부호 없는 long 정수를 문자열로 변환합니다. CRT의 보안 기능에 설명된 대로 보안 향상 기능이 포함된 _ultoa, _ultow 버전입니다.

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
_ultoa_s를 위한 str의 바이트 단위 또는 _ultow_s의 단어의 크기입니다.
radix
value 의 기본

반환 값

함수가 성공하면 0, 그렇지 않으면 오류 코드입니다.

설명

_ultoa_s 함수는 value 의 숫자를 null로 끝나는 문자 문자열로 변환하고 결과(최대 33바이트 까지)를 str 에 저장합니다. radix 인수는 value 의 기본을 지정합니다. 이 범위는 2에서 36 까지 입니다. _ultow_s는 _ultoa_s의 와이드 문자 버전이며, _ultow_s에 대한 두 번째 인수는 와이드 문자 문자열입니다.

만일 str가 NULL 포인터이거나 sizeOfstr이 0보다 적거나 같은 경우, 매개 변수 유효성 검사에 설명된 대로 잘못된 매개변수 처리기가 호출됩니다. 함수의 실행이 계속되도록 허용되는 경우, 이러한 함수는 -1을 반환하고 errno를 EINVAL 로 설정하거나 만약 value 또는 str이 long 정수의 범위를 벗어나는 경우, 이러한 함수는 -1을 반환하고 errno을 ERANGE로 설정합니다.

C++에서는 템플릿 오버로드로 인해 이러한 함수를 사용하는 것이 보다 간단해 집니다. 오버로드는 버퍼 길이를 자동으로 유추할 수 있으며(크기 인수를 지정할 필요가 없어짐), 기존의 비보안 함수를 보다 최신의 보안 대응 함수로 자동으로 바꿀 수 있습니다. 자세한 내용은 안전한 템플릿 오버로드을 참조하십시오.

제네릭 텍스트 라우팅 매핑