이 문서는 기계 번역을 이용하여 번역되었습니다. 문서를 영문으로 보려면 영문 확인란을 선택하세요. 마우스 포인터를 텍스트 위로 이동시켜 팝업 창에서 영문 텍스트를 표시할 수도 있습니다.
번역
영문

_mbsnbcat_s, _mbsnbcat_s_l

 

멀티바이트 문자열을 최소한 다른 멀티바이트 문자열의 첫 번째 n바이트에 추가합니다.   CRT의 보안 기능에 설명된 대로 강화된 보안 기능이 있는 _mbsnbcat, _mbsnbcat_l의 버전입니다.  

System_CAPS_important중요

이 API는 Windows 런타임에서 실행되는 응용 프로그램에서 사용할 수 없습니다.  자세한 내용은 CRT 함수는 /ZW 옵션을 지원하지 않음을 참조하세요.  

errno_t _mbsnbcat_s(
   unsigned char *dest,
   size_t sizeInBytes,
   const unsigned char *src,
   size_t count 
);
errno_t _mbsnbcat_s_l(
   unsigned char *dest,
   size_t sizeInBytes,
   const unsigned char *src,
   size_t count,
   _locale_t locale
);
template <size_t size>
errno_t _mbsnbcat_s(
   unsigned char (&dest)[size],
   const unsigned char *src,
   size_t count 
); // C++ only
template <size_t size>
errno_t _mbsnbcat_s_l(
   unsigned char (&dest)[size],
   const unsigned char *src,
   size_t count,
   _locale_t locale
); // C++ only

dest

null로 끝나는 멀티바이트 문자 대상 문자열입니다.

sizeInBytes

dest 버퍼의 크기(바이트)입니다.

src

null로 끝나는 멀티바이트 문자 소스 문자열입니다.

Count

dest에 추가할 src의 바이트 수입니다.

locale

사용할 로캘입니다.

성공하면 0이고, 그렇지 않으면 오류 코드입니다.

오류 조건

Dest

sizeInBytes

src

반환 값

NULL

모두

모두

EINVAL

모두

<= 0

모두

EINVAL

모두

모두

NULL

EINVAL

오류 조건이 발생하는 경우 함수는 매개 변수 유효성 검사에 설명된 대로 잘못된 매개 변수 오류를 발생시킵니다.  오류가 처리되면 함수는 EINVAL을 반환하고 errnoEINVAL로 설정합니다.  

_mbsnbcat_s 함수는 dest에 최소한 count의 첫 번째 src 바이트를 추가합니다.   dest에서 null 문자 바로 앞에 오는 바이트가 선행 바이트인 경우 해당 바이트는 src의 초기 바이트에 의해 덮어쓰여집니다.  그렇지 않으면 src의 초기 바이트가 dest의 null 종결 문자를 덮어씁니다.   src 바이트가 추가되기 전에 count에 null 바이트가 나타나는 경우 __mbsnbcat_ssrc의 모든 바이트를 null 바이트까지 추가합니다.   countsrc의 길이보다 크면 src의 길이가 count 대신 사용됩니다.  결과 문자열은 null 문자로 끝납니다.  중복되는 문자열 간에 복사가 이뤄지면 이 동작은 정의되지 않습니다.  

출력 값은 로캘의 LC_CTYPE 범주 설정에 영향을 받습니다. 자세한 내용은 setlocale, _wsetlocale을 참조하세요.   _l 접미사가 없는 함수는 현재 로캘을 사용하고 _l 접미사가 있는 함수는 전달된 로캘 매개 변수를 대신 사용한다는 점을 제외하고 이러한 함수의 버전은 동일합니다.   더 자세한 내용은 로캘를 참고하십시오.   

C++에서는 템플릿 오버로드를 통해 이러한 함수를 사용하는 것이 보다 간단해집니다. 오버로드는 버퍼 길이를 자동으로 유추할 수 있으므로 크기 인수를 지정할 필요가 없어지고 보안 수준이 낮은 기존 함수를 보안 수준이 높은 최신 함수로 자동으로 바꿀 수 있습니다.  자세한 내용은 안전한 템플릿 오버로드를 참조하세요.  

이러한 함수의 디버그 버전은 우선 0xFD로 버퍼를 채웁니다.  이 동작을 사용하지 않으려면 _CrtSetDebugFillThreshold를 사용하세요.  

제네릭 텍스트 라우팅 매핑

TCHAR.H 루틴

_UNICODE 및 _MBCS 정의되지 않음

_MBCS 정의됨

_UNICODE 정의됨

_tcsncat

strncat

_mbsnbcat_s

wcsncat

_tcsncat_s_l

_strncat_s_l

_mbsnbcat_s_l

_wcsncat_s_l

요구 사항

루틴

필수 헤더

_mbsnbcat_s

<mbstring.h>

_mbsnbcat_s_l

<mbstring.h>

호환성에 대한 자세한 내용은 호환성을 참조하세요.

.NET Framework 동일 요소

해당 사항 없음. 표준 C 함수를 호출하려면 PInvoke를 사용합니다. 자세한 내용은 플랫폼 호출 예제를 참조하세요.

표시: