다음을 통해 공유

_mbsnbcpy, _mbsnbcpy_l

  • 아티클

문자열의 n바이트 단위를 대상 문자열에 복사합니다. 이러한 함수의 더 안전한 버전을 사용할 수 있습니다. 다음을 참조하세요_mbsnbcpy_s_l_mbsnbcpy_s.

Important

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

구문

unsigned char * _mbsnbcpy(
   unsigned char * strDest,
   const unsigned char * strSource,
   size_t count
);
unsigned char * _mbsnbcpy_l(
   unsigned char * strDest,
   const unsigned char * strSource,
   size_t count,
   _locale_t locale
);
template <size_t size>
unsigned char * _mbsnbcpy(
   unsigned char (&strDest)[size],
   const unsigned char * strSource,
   size_t count
); // C++ only
template <size_t size>
unsigned char * _mbsnbcpy_l(
   unsigned char (&strDest)[size],
   const unsigned char * strSource,
   size_t count,
   _locale_t locale
); // C++ only

매개 변수

strDest
복사할 문자열의 대상입니다.

strSource
복사할 문자열입니다.

count
복사할 바이트 수입니다.

locale
사용할 로캘입니다.

반환 값

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

설명

_mbsnbcpy 함수는 strSource에서 strDest로 count바이트를 복사합니다. count가 strDest의 크기를 초과하거나 원본 및 대상 문자열이 겹치면 _mbsnbcpy의 동작이 정의되지 않습니다.

null 포인터인 경우 strSource 이 함수는 매개 변수 유효성 검사에 설명된 대로 잘못된 매개 변수 처리기를 호출합니다.strDest 계속해서 실행하도록 허용된 경우 함수가 NULL를 반환하며 errno를 EINVAL로 설정합니다.

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

Important

이러한 함수는 버퍼 오버런 위협에 노출될 수 있습니다. 버퍼 오버런은 보증되지 않은 권한 승격을 초래하거나 시스템을 위태롭게 하는 임의의 공격자 코드를 실행하기 위해 사용될 수 있습니다. 자세한 내용은 버퍼 오버런 방지를 참조하세요.

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

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

일반 텍스트 루틴 매핑

Tchar.h 루틴 _UNICODE 및 _MBCS 정의되지 않음 정의된 _MBCS 정의된 _UNICODE
_tcsncpy strncpy _mbsnbcpy wcsncpy
_tcsncpy_l _strncpy_l _mbsnbcp_l _wcsncpy_l

요구 사항

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

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

참고 항목

문자열 조작
_mbsnbcat, _mbsnbcat_l
_mbsnbcmp, _mbsnbcmp_l
_strncnt, _wcsncnt, _mbsnbcnt, _mbsnbcnt_l, _mbsnccnt_mbsnccnt_l
_mbsnbset, _mbsnbset_l
strncpy, _strncpy_l, wcsncpy, _wcsncpy_l, _mbsncpy_mbsncpy_l