다음을 통해 공유


_mbsnbcat, _mbsnbcat_l

덧붙여서, 최대추가, 다른 멀티 바이트 문자 문자열을 한 바이트의 첫 n 바이트입니다. 이러한 기능의 더 안전한 버전을 사용할 수 있습니다. _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 함수는 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++에서 이러한 함수는 보다 최신의 보안 대응 함수를 호출하는 템플릿 오버로드를 갖고 있습니다. 자세한 내용은 안전한 템플릿 오버로드을 참조하십시오.

제네릭 텍스트 라우팅 매핑

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