_mbsnbcat, _mbsnbcat_l

덧붙여서, 최대추가, 다른 멀티 바이트 문자 문자열을 한 바이트의 첫 n 바이트입니다. 이러한 기능의 더 안전한 버전을 사용할 수 있습니다. _mbsnbcat_s, _mbsnbcat_s_l를 참조하십시오.

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 함수는 src 의 바이트의 count 에서 dest 로 최대한 덧붙입니다. 이 dest 의 null 문자가 즉시 선행하는 바이트가 읽어진 바이트인 경우, src 의 초기 바이트는 읽어진 바이트에 덮어씁니다. 그렇지 않으면, src 의 초기 바이트는 dest 의 null 종결 문자 로 덮어씁니다. 이 count 바이트가 덧붙여지기전, null 바이트가 src 에 발생하는 경우, _mbsnbcat 은 null 문자를 추가한 src로 부터 모든 바이트를 덧붙입니다. 이 count 이 src의 길이보다 큰 경우, count 장소에 src 이 사용됩니다. 결과 문자열은 null 문자로 종결됩니다. 중복되는 문자열 간에 복사가 이뤄지면 이 동작은 정의되지 않습니다.

출력 값은 로캘의 LC_CTYPE 범주 설정에 영향을 받습니다. 자세한 내용은 setlocale을 참조하십시오. 함수가 사용하는 로캘 종속 동작을 위한 현재 로캘의 _mbsnbcat 버전; _mbsnbcat_l 버전은 대신에 통과한 로캘 매기 변수를 사용하는 동일한 예외입니다. 자세한 내용은 로캘을 참조하십시오.

보안 정보 는 null로 끝나는 문자열을 사용 합니다. Null로 끝나는 문자열 대상 버퍼의 크기를 초과할 수 없습니다. 자세한 내용은 버퍼 오버런 방지를 참조하십시오.

여기 dest 혹은 src 이 NULL인 경우, 함수는 매개 변수 유효성 검사로 설명된 잘못된 매개 변수 오류를 생성할 겁니다. 오류가 처리가된 경우, 함수는 EINVAL 을 반환하고 errno 을 EINVAL 으로 설정합니다.

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

제네릭 텍스트 라우팅 매핑

요구 사항

호환성 정보에 대한 자세한 내용은 호환성을 참조하십시오.

해당 .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