다음을 통해 공유

_mbsnbcat, _mbsnbcat_l

  • 아티클

한 멀티바이트 문자열의 첫 번째 n 바이트만 다른 문자열에 추가합니다. 이러한 함수의 더 안전한 버전을 사용할 수 있습니다. _mbsnbcat_s, _mbsnbcat_s_l(을)를 참조하세요.

Important

이 API는 Windows 런타임에서 실행되는 애플리케이션에서 사용할 수 없습니다. 자세한 내용은 유니버설 Windows 플랫폼 앱에서 지원되지 않는 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
dest에 추가할 src의 바이트 수입니다.

locale
사용할 로캘입니다.

반환 값

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

설명

_mbsnbcat 함수는 src의 처음 count 바이트 이하를 dest에 추가합니다. dest에서 null 문자 바로 앞에 오는 바이트가 선행 바이트인 경우 src의 초기 바이트가 이 선행 바이트를 덮어씁니다. 그렇지 않으면 src의 초기 바이트가 dest의 null 종결 문자를 덮어씁니다. src 바이트가 추가되기 전에 count에 null 바이트가 나타나는 경우 __mbsnbcat는 src의 모든 바이트를 null 바이트까지 추가합니다. count가 src의 길이보다 크면 src의 길이가 count 대신 사용됩니다. 결과 문자열은 null 문자로 끝납니다. 중복되는 문자열 간에 복사가 이뤄지면 이 동작은 정의되지 않습니다.

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

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

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

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

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

일반 텍스트 루틴 매핑

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>

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

참고 항목

문자열 조작
_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