_ultoa_s, _ultow_s

아티클
02/21/2013

부호 없는 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
Base of 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 + +에서이 함수를 사용 하 여 템플릿 오버 로드에 단순화 됩니다. 오버 로드에서 버퍼 길이가 자동으로 유추할 수 있습니다 (size 인수를 지정할 필요가 없습니다) 및 해당 보안에서 이미지와 이전, 안전 하지 않은 함수가 자동으로 바꿀 수 있습니다.자세한 내용은 보안 템플릿 오버 로드를 참조하십시오.

일반 텍스트 루틴 매핑