strncat、_strncat_l、wcsncat、_wcsncat_l、_mbsncat、_mbsncat_l

项目
06/09/2015

向字符串追加字符。关于这些函数的更多安全版本；请参见 strncat_s、_strncat_s_l、wcsncat_s、_wcsncat_s_l、_mbsncat_s、_mbsncat_s_l。

重要

_mbsncat 和 _mbsncat_l 不能在 Windows 运行时执行的应用程序中使用。有关详细信息，请参见 CRT functions not supported with /ZW（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
null 终止的源字符串。
count
要追加的字符数。
locale
要使用的区域设置。

返回值

返回指向目标字符串的指针。没有保留任何返回值以指示错误。

备注

strncat 函数至多追加strSource的第一 count 字符到strDest。 strSource 的初始字符覆盖 strDest终止 null 字符。在 count 字符追加之前，如果 null 字符出现在strSource中，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 导致缓冲区溢出。