_ltoa_s, _ltow_s
long 정수를 문자열로 변환합니다. CRT의 보안 기능에 설명된 대로 보안 향상 기능이 포함된 _ltoa, _ltow 버전입니다.
errno_t _ltoa_s(
long value,
char *str,
size_t sizeOfstr,
int radix
);
errno_t _ltow_s(
long value,
wchar_t *str,
size_t sizeOfstr,
int radix
);
template <size_t size>
errno_t _ltoa_s(
long value,
char (&str)[size],
int radix
); // C++ only
template <size_t size>
errno_t _ltow_s(
long value,
wchar_t (&str)[size],
int radix
); // C++ only
매개 변수
value
변환될 수 있는 숫자str
결과 문자열에 대한 버퍼입니다.sizeOfstr
_ltoa_s 를 위한 str 의 바이트 단위 또는 _ltow_s의 단어의 크기입니다.radix
value 의 기본
반환 값
함수가 성공하면 0, 그렇지 않으면 오류 코드입니다.
설명
_ltoa_s 함수는 str 에서 (최대 33바이트까지) 결과를 저장하고 null로 끝나는 문자열로 value 의 숫자를 변환합니다. radix 인수는 value 의 기본을 지정합니다. 이 범위는 2에서 36 까지 입니다. 만일 radix 이 10 및 value 가 음수이면 저장된 문자열의 첫 문자는 빼기 기호 ( )입니다. _ltow_s는 _ltoa_s의 와이드 문자 버전이며, _ltow_s에 대한 두 번째 인수는 와이드 문자 문자열입니다.
만일 str 이 NULL 포인터거나 sizeOfstr 이 0과 같거나 더 적을 경우, 이러한 함수는 매개 변수 유효성 검사 에서 설명된대로 잘못된 매개변수 처리기를 호출합니다. 만일 예외가 계속 허용되는 경우, 이러한 함수는 -1 반환하고 errno 를 EINVAL 설정하거나 value 또는 str 는 long 정수의 범위를 벗어나는 경우, 이러한 함수는 -1을 반환하고 errno 를 ERANGE 로 설정합니다.
C++에서는 템플릿 오버로드로 인해 이러한 함수를 사용하는 것이 보다 간단해 집니다. 오버로드는 버퍼 길이를 자동으로 유추할 수 있으며(크기 인수를 지정할 필요가 없어짐), 기존의 비보안 함수를 보다 최신의 보안 대응 함수로 자동으로 바꿀 수 있습니다. 자세한 내용은 안전한 템플릿 오버로드을 참조하십시오.
제네릭 텍스트 라우팅 매핑
Tchar.h 루틴 |
_UNICODE 및 _MBCS 정의되지 않음 |
_MBCS 정의됨 |
_UNICODE 정의됨 |
---|---|---|---|
_ltot_s |
_ltoa_s |
_ltoa_s |
_ltow_s |
요구 사항
루틴 |
필수 헤더 |
---|---|
_ltoa_s |
<stdlib.h> |
_ltow_s |
<stdlib.h> |
호환성에 대한 자세한 내용은 소개 단원의 호환성 부분을 참조하십시오.