wcsncat, wcsncat_s
来自 zh.cppreference.net
| 定义于头文件 <wchar.h>
|
||
wchar_t* wcsncat( wchar_t* dest, const wchar_t* src, size_t count );
|
(1) | （自 C95 起） （至 C99） |
wchar_t* wcsncat( wchar_t* restrict dest,
const wchar_t* restrict src, size_t count );
|
（自 C99 起） | |
errno_t wcsncat_s( wchar_t* restrict dest, rsize_t destsz,
const wchar_t* restrict src, rsize_t count );
|
(2) | （自 C11 起） |
1) 追加至多
count 个宽字符，这些字符来自以 src 所指向的宽字符串，当复制到空终止符时停止，并追加到以 dest 所指向的字符串的末尾。宽字符 src[0] 替换位于 dest 末尾的空终止符。空终止符总是在最后追加（因此函数可能写入的最大宽字符数为 count + 1）。 如果目标数组空间不足以同时容纳
src 和 dest 以及结尾的空宽字符，则行为未定义。 如果字符串重叠，行为未定义。
2) 同 (1) ，但此函数可能会破坏目标数组的剩余部分（从写入的最后一个宽字符到
destsz ），并且会在运行时检测以下错误并调用当前安装的 constraint handler 函数：
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> 。参数
| dest | - | 指向要追加内容的以空字符结尾的宽字符串的指针 |
| src | - | 指向要复制的以空字符结尾的宽字符串的指针 |
| count | - | 要复制的最大宽字符数 |
| destsz | - | 目标缓冲区的大小 |
返回值
1) 返回
dest 的副本2) 成功时返回零，出错时返回非零。此外，出错时会将
L'\0' 写入 dest[0]（除非 dest 是空指针或 destsz 为零或大于 RSIZE_MAX / sizeof(wchar_t)）。注意
虽然为了适应目标缓冲区而进行截断是一个安全风险，因此对于wcsncat_s来说违反了运行时约束，但可以通过将count指定为目标数组大小减一的方式来获得截断行为：它将复制前count个宽字符，并像往常一样附加空终止符：
size_t count = sizeof dst / sizeof *dst;
wcsncat_s(dst, count, src, count - wcsnlen_s(dst, count) - 1);
示例
运行此代码
#include <locale.h>
#include <stdio.h>
#include <wchar.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);
}
可能的输出：
Земля, прощай. В добрый
参考文献
- C23标准（ISO/IEC 9899:2024）：
- 7.31.4.3.2 wcsncat函数（第439页）
- K.3.9.3.2.2 wcsncat_s函数（第666页）
- C17标准（ISO/IEC 9899:2018）：
- 7.29.4.3.2 wcsncat函数（第315页）
- K.3.9.2.2.2 wcsncat_s函数（第466-467页）
- C11标准（ISO/IEC 9899:2011）：
- 7.29.4.3.2 wcsncat函数（第432-433页）
- K.3.9.2.2.2 wcsncat_s函数（第643-644页）
- C99标准（ISO/IEC 9899:1999）：
- 7.24.4.3.2 wcsncat函数（第378-379页）
参见
|
(C95)
(C11)
|
将一个宽字符串的副本追加到另一个宽字符串
(函数) |
|
(C11)
|
连接两个字符串的指定数量字符
(函数) |
|
(C95)
(C11)
|
将一个宽字符串复制到另一个宽字符串
(函数) |
|
C++ 文档
关于
wcsncat
|
|