wcsncat

1）count从指向的宽字符串中追加最宽字符src，如果将空终止符复制，则停止到指向的字符串的末尾dest。宽字符src[0]将替换在结尾处的空终止符dest。结束符总是附加空终止符（因此函数可能写入的最大宽字符数是count+1）。

如果目标数组不够大，两者的内容的行为是不确定的str，并dest和终止空宽字符。

如果字符串重叠，则行为未定义。

2）与（1）相同，只是此函数可能会破坏目标数组的其余部分（从写入的最后一个字节开始destsz），并且在运行时检测到以下错误并调用当前安装的约束处理函数：

• src或者dest是空指针
• destsz或者count是零或大于RSIZE_MAX/sizeof(wchar_t)
• 在第一个destsz字节中没有空宽字符dest
• 则会发生截断：count或者其中src较小者的长度超过了dest和的空终止符之间的可用空间destsz。
• 源和目标字符串之间会发生重叠

作为所有边界检查函数，wcsncat_s只有在被__STDC_LIB_EXT1__实现定义__STDC_WANT_LIB_EXT1__并且1在包含之前用户定义为整数常量时才能保证可用wchar.h。

参数

返回值

1）返回一份副本 dest

2）在成功时返回零，错误时返回非零值。此外，在错误，写入L'\0'到dest[0]（除非dest是空指针或destsz为零或大于RMAX_SIZE/sizeof(wchar_t)）。

注意

尽管适合目标缓冲区的截断存在安全风险并因此违反了运行时间约束wcsncat_s，但可以通过指定count等于目标数组的大小减1 来获得截断行为：它将复制第一个count宽字符并追加一如既往的终结者：wcsncat_s(dst, sizeof dst/sizeof *dst, src, (sizeof dst/sizeof *dst)-wcsnlen_s(dst, sizeof dst/sizeof *dst)-1);

示例

​

#include <wchar.h> 
#include <stdio.h>
#include <locale.h>
 
int main(void) 
{
    wchar_t str[50] = L"Земля, прощай.";
    wcsncat(str, L" ", 1);
    wcsncat(str, L"В добрый путь.", 8); // only append the first 8 wide chars
    setlocale(LC_ALL, "en_US.utf8");
    printf("%ls", str);
}

​

可能的输出：

​

Земля, прощай. В добрый

​

参考

• C11标准（ISO/IEC 9899:2011）：
  • 7.29.4.3.2 wcsncat函数（p: 432-433）
  • K.3.9.2.2.2 wcsncat_s函数（p: 643-644）
• C99标准（ISO/IEC 9899:1999）：
  • 7.24.4.3.2 wcsncat函数（p: 378-379）

另请参阅

| C ++文档wcsncat |