strncat、 _strncat_l、 wcsncat、 wcsncat_l、 _mbsncat _mbsncat_l

發行項
03/27/2013

字串的其他字元。這些函式更安全的可用版本的詳細資訊，請參閱 strncat_s、 _strncat_s_l、 wcsncat_s、 _wcsncat_s_l、 _mbsncat_s、 _mbsncat_s_l 。

重要事項
_mbsncat 和 _mbsncat_l 不能用於 Windows 執行階段執行的應用程式。如需詳細資訊，請參閱 CRT 函式不支援使用 /ZW。

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
innull 結尾的來源字串。
count
要附加的字元數。
locale
使用的地區設定。

傳回值

讓指標回到目的資料。傳回值不會保留表示錯誤。

備註

strncat 函式，附加至多， strSource 第一個 count 字元至 strDest中。strSource 的初始字元覆寫 strDest結束的 null 字元。如果 null 字元出現在 strSource ， count 字元附加前，附加 strncat 從 strSource中的所有字元，由 null 字元。如果 count 大於 strSource的長度，長度 strSource 在 count位置。所有情況下，結果產生的字串是以 Null 字元。如果複製發生在重疊的字串之間，行為是未定義。

安全性提示
strncat 不會檢查 strDest的足夠的空間;所以緩衝區滿溢的一個可能的原因。記住 count 條件附加的字元數;會在 strDest大小的一項限制。請參閱下列範例。如需詳細資訊，請參閱 Avoiding Buffer Overruns 。

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>

如需其他相容性資訊，請參閱入門介紹中的相容性 (Compatibility) 。

範例

// 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 造成緩衝區滿溢。