_mbsnbcat_s, _mbsnbcat_s_l

멀티바이트 문자열에 추가합니다( 최대 다른 멀티바이트 문자열의 첫 번째 n 바이트). 이러한 함수는 CRT의 _mbsnbcat_mbsnbcat_l보안 기능에 설명된 대로 보안이 향상된 버전입니다.

Important

이 API는 Windows 런타임에서 실행되는 애플리케이션에서 사용할 수 없습니다. 자세한 내용은 유니버설 Windows 플랫폼 앱에서 지원되지 않는 CRT 함수를 참조하세요.

구문

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	any	any	EINVAL
모두	<= 0	any	EINVAL
모두	any	NULL	EINVAL

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

설명

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

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

C++에서 이러한 함수의 사용은 템플릿 오버로드에 의해 간소화됩니다. 오버로드는 버퍼 길이를 자동으로 유추하여 크기 인수를 지정할 필요가 없으며, 보다 안전한 최신 함수를 자동으로 사용하여 이전의 덜 안전한 함수를 대체할 수 있습니다. 자세한 내용은 보안 템플릿 오버로드를 참조 하세요.

이러한 함수의 디버그 라이브러리 버전은 먼저 버퍼를 0xFE 채웁니다. 이 동작을 사용하지 않도록 설정하려면 .를 사용합니다 _CrtSetDebugFillThreshold.

기본적으로 이 함수의 전역 상태는 애플리케이션으로 범위가 지정됩니다. 이 동작을 변경하려면 CRT의 전역 상태를 참조하세요.

일반 텍스트 루틴 매핑

Tchar.h 루틴	_UNICODE 정의 _MBCS 되지 않음	_MBCS 정의	_UNICODE 정의
_tcsncat_s	strncat_s	_mbsnbcat_s	wcsncat_s
_tcsncat_s_l	_strncat_s_l	_mbsnbcat_s_l	_wcsncat_s_l

요구 사항

루틴에서 반환된 값	필수 헤더
_mbsnbcat_s	<mbstring.h>
_mbsnbcat_s_l	<mbstring.h>

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

참고 항목

문자열 조작
_mbsnbcmp, _mbsnbcmp_l
_strncnt, _wcsncnt, _mbsnbcnt, _mbsnbcnt_l, _mbsnccnt, _mbsnccnt_l
_mbsnbcpy, _mbsnbcpy_l
_mbsnbcpy_s, _mbsnbcpy_s_l
_mbsnbset, _mbsnbset_l
strncat, _strncat_l, wcsncat, _wcsncat_l, _mbsncat, _mbsncat_l
strncat_s, _strncat_s_l, wcsncat_s, _wcsncat_s_l, _mbsncat_s, _mbsncat_s_l