wcsncpy

1）count将由src（包括终止空宽字符）指向的宽字符串中的大多数字符复制到指向的宽字符数组dest。

如果count在整个字符串src被复制之前达到，则生成的宽字符数组不是以空字符结尾的。

如果在复制了终止空宽字符后src，count未写入，则会写入更多空宽字符，dest直到写入count字符总数为止。

如果字符串重叠，则行为不确定。

2）与（1）相同，除了该函数不会继续将零写入目标数组以填充为止count，它将在写入终止空字符后停止（如果源中没有空值，则将其写入dest[count]并且然后写入停止）。此外，在运行时检测到以下错误并调用当前安装的约束处理函数：

• src或者dest是空指针
• destsz或者count是零或大于RSIZE_MAX/sizeof(wchar_t)
• count大于或等于destsz，但destsz小于或等于wcsnlen_s(src, count)，换句话说，会发生截断
• 源和目标字符串之间会发生重叠

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

参数

返回值

1）返回一份副本 dest

2）在成功时返回零，错误时返回非零值。此外，在错误，写入L'\0'到dest[0]（除非dest是空指针或destsz为零或大于RSIZE_MAX/sizeof(wchar_t)），并且可以与揍未指定的值的目标阵列的其余部分。

注意

在典型用法中，count是目标数组中的元素数量。

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

示例

​

#include <stdio.h>
#include <wchar.h>
#include <locale.h>
 
int main(void)
{
    wchar_t src[] = L"わゐ";
    wchar_t dest[6] = {L'あ', L'い', L'う', L'え', L'お'};
 
    wcsncpy(dest, src, 4); // this will copy わゐ and repeat L'\0' two times
 
    puts("The contents of dest are: ");
    setlocale(LC_ALL, "en_US.utf8");
    for(wchar_t* p = dest; p-dest < sizeof dest / sizeof *dest; ++p) {
        if(*p)
            printf("%lc ", *p);
        else
            printf("\\0 ");
    }
}

​

可能的输出：

​

The contents of dest are: 
わ ゐ \0 \0 お \0

​

参考

• C11标准（ISO/IEC 9899:2011）：
  • 7.29.4.2.2 wcsncpy函数（p: 431）
  • K.3.9.2.1.2 wcsncpy_s函数（p: 640-641）
• C99标准（ISO/IEC 9899:1999）：
  • 7.24.4.2.2 wcsncpy函数（p: 377）

另请参阅

| C ++文档wcsncpy |