_mbsnbcat, _mbsnbcat_l

아티클
04/10/2013

기껏해야 첫 번째 추가 n 다른 멀티 바이트 문자 문자열의 바이트 수입니다.보다 안전한 버전의이 함수를 사용할 수 있습니다. see _mbsnbcat_s, _mbsnbcat_s_l.

중요
이 API는 Windows 런타임에서 실행 되는 응용 프로그램에서 사용할 수 없습니다.자세한 내용은 /zw에 지원 되는 CRT 함수.

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

매개 변수

dest
멀티 바이트 문자 대상 null로 끝나는 문자열입니다.
src
멀티 바이트 문자 소스 null로 끝나는 문자열입니다.
count
바이트 수를 src 에 추가할 dest.
locale
사용 하는 로캘.

반환 값

_mbsnbcat대상 문자열에 대 한 포인터를 반환합니다.반환 값이 없는 오류를 나타내기 위해 예약 되어 있습니다.

설명

_mbsnbcat 함수 추가, 기껏해야 첫 번째 count 바이트의 src 에 dest.경우에 null 문자 바로 앞의 바이트 dest 의 초기 바이트, 선행 바이트 인지 src 이 선행 바이트를 덮어씁니다.그렇지 않으면 초기 바이트의 src 의 null 종결 문자를 덮어씁니다 dest.Null 바이트 있는 경우 src 전에 count 바이트 추가 됩니다, _mbsnbcat 에서 모든 바이트를 추가 src를 null 문자까지.경우 count 의 길이 보다 큰 경우 src, 길이 src 대신 사용 됩니다 count.결과 문자열은 null 문자로 종료 됩니다.중복 문자열 사이 복사를 사용 하면 동작이 정의 되지 않습니다.

출력 값의 설정에 의해 영향을 받지는 LC_CTYPE 범주 설정 로케일입니다. 볼 setlocale 에 대 한 자세한 내용은._mbsnbcat 버전의 함수에 대 한이 로케일 종속 동작입니다; 현재 로케일을 사용 하 여 _mbsnbcat_l 버전 대신 전달 로캘 매개 변수를 사용 하는 경우를 제외 하 고 동일 합니다.자세한 내용은 로캘을 참조하십시오.

보안 참고 는 null로 끝나는 문자열을 사용 합니다.Null로 끝나는 문자열을 대상 버퍼의 크기를 초과 해서는 안됩니다.자세한 내용은 버퍼 오버런 방지.

경우 dest 또는 src 는 NULL, 함수에 설명 된 대로 잘못 된 매개 변수 오류를 생성 합니다 매개 변수 유효성 검사.함수 반환 오류 처리 EINVAL 를 설정 하 고 errno 에 EINVAL.

C + +에서는 이러한 함수 최신, 보안 대응 함수를 호출 하는 템플릿 오버 로드 되어 있습니다.자세한 내용은 보안 템플릿 오버 로드을 참조하십시오.

일반 텍스트 루틴 매핑

Tchar.h 루틴	_UNICODE 및 _mbcs가 정의 되어 있지 않습니다	_Mbcs가 정의	_Unicode가 정의
_tcsncat	strncat	_mbsnbcat	wcsncat
_tcsncat_l	_strncat_l	_mbsnbcat_l	_wcsncat_l

요구 사항

루틴	필수 헤더
_mbsnbcat	<mbstring.h>
_mbsnbcat_l	<mbstring.h>

자세한 호환성에 대 한 내용은 호환성 소개에서 합니다.

해당 .NET Framework 항목

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

참고 항목

참조

문자열 조작 (CRT)

_mbsnbcmp, _mbsnbcmp_l

_strncnt, _wcsncnt, _mbsnbcnt, _mbsnbcnt_l, _mbsnccnt, _mbsnccnt_l

_mbsnbcpy, _mbsnbcpy_l

_mbsnbicmp, _mbsnbicmp_l

_mbsnbset, _mbsnbset_l

strncat, _strncat_l, wcsncat, wcsncat_l, _mbsncat _mbsncat_l

_mbsnbcat_s, _mbsnbcat_s_l

다음을 통해 공유