strncat, _strncat_l, wcsncat, wcsncat_l, _mbsncat _mbsncat_l

아티클
04/10/2013

String의 문자를 추가 합니다.보다 안전한 버전의이 함수 사용할 수 있는 보려면 strncat_s, _strncat_s_l, wcsncat_s, _wcsncat_s_l, _mbsncat_s, _mbsncat_s_l .

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

char *strncat(
   char *strDest,
   const char *strSource,
   size_t count 
);
wchar_t *wcsncat(
   wchar_t *strDest,
   const wchar_t *strSource,
   size_t count 
);
unsigned char *_mbsncat(
   unsigned char *strDest,
   const unsigned char *strSource,
   size_t count
);
unsigned char *_mbsncat_l(
   unsigned char *strDest,
   const unsigned char *strSource,
   size_t count,
   _locale_t locale
);
template <size_t size>
char *strncat(
   char (&strDest)[size],
   const char *strSource,
   size_t count 
); // C++ only
template <size_t size>
wchar_t *wcsncat(
   wchar_t (&strDest)[size],
   const wchar_t *strSource,
   size_t count 
); // C++ only
template <size_t size>
unsigned char *_mbsncat(
   unsigned char (&strDest)[size],
   const unsigned char *strSource,
   size_t count
); // C++ only
template <size_t size>
unsigned char *_mbsncat_l(
   unsigned char (&strDest)[size],
   const unsigned char *strSource,
   size_t count,
   _locale_t locale
); // C++ only

매개 변수

strDest
대상 null로 끝나는 문자열입니다.
strSource
소스를 null로 끝나는 문자열입니다.
count
추가할 문자 수입니다.
locale
사용 하는 로캘.

반환 값

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

설명

strncat 함수 추가, 기껏해야 첫 번째 count 자 strSource 에 strDest.초기 문자를 strSource 의 null 종결 문자를 덮어씁니다 strDest.Null 문자가 있는 경우 strSource 전에 count 문자가 추가 됩니다, strncat 까지의 모든 문자를 추가 합니다. strSource를 null 문자까지.경우 count 의 길이 보다 큰 경우 strSource, 길이 strSource 대신 사용 됩니다 count.모든 경우 결과 문자열 null 문자로 종료 됩니다.중복 문자열 사이 복사를 사용 하면 동작이 정의 되지 않습니다.

보안 정보
strncat충분 한 공간을 확인 하지 않습니다 strDest. 따라서 버퍼 오버런의 잠재적인 원인입니다.유의 count 추가; 문자 수 제한 크기에 제한이 없는 strDest.다음 예제를 참조하십시오.자세한 내용은 버퍼 오버런 방지.

wcsncat및 _mbsncat 와이드 및 멀티 바이트 문자 버전의 strncat.문자열 인수 및 반환 값을 wcsncat 와이드 문자 문자열입니다. _mbsncat 멀티 바이트 문자 문자열입니다.이러한 세 가지 함수 그렇지에 동일 하 게 동작 합니다.

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

C + +에서는 이러한 함수 템플릿 오버 로드를 사용합니다.자세한 내용은 보안 템플릿 오버 로드을 참조하십시오.

일반 텍스트 루틴 매핑

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

[!참고]

_strncat_l및 _wcsncat_l 없음 로캘 종속성 있고 직접 호출 하기 위한 것이 아닙니다.내부용으로 제공 되는 _tcsncat_l.

요구 사항

루틴	필수 헤더
strncat	<string.h>
wcsncat	<string.h> 또는 <wchar.h>
_mbsncat	<mbstring.h>
_mbsncat_l	<mbstring.h>

추가 호환성 정보를 참조 하십시오. 호환성 소개에서 합니다.

예제

// crt_strncat.c
// Use strcat and strncat to append to a string.
#include <stdlib.h>

#define MAXSTRINGLEN 39

char string[MAXSTRINGLEN+1];
// or char *string = malloc(MAXSTRINGLEN+1);

void BadAppend( char suffix[], int n )
{
   strncat( string, suffix, n );
}

void GoodAppend( char suffix[], size_t n )
{
   strncat( string, suffix, __min( n, MAXSTRINGLEN-strlen(string)) );
}

int main( void )
{
   string[0] = '\0';
   printf( "string can hold up to %d characters\n", MAXSTRINGLEN );

   strcpy( string, "This is the initial string!" );
   // concatenate up to 20 characters...
   BadAppend( "Extra text to add to the string...", 20 );
   printf( "After BadAppend :  %s (%d chars)\n", string, strlen(string) );

   strcpy( string, "This is the initial string!" );
   // concatenate up to 20 characters...
   GoodAppend( "Extra text to add to the string...", 20 );
   printf( "After GoodAppend:  %s (%d chars)\n", string, strlen(string) );
}

Output

string can hold up to 39 characters
After BadAppend :  This is the initial string!Extra text to add to (47 chars)
After GoodAppend:  This is the initial string!Extra text t (39 chars)

이때 BadAppend 버퍼 오버런이 발생 합니다.