std::wcsncat

 

C++

编译器支持

独立和托管

语言

标准库

标准库头文件

命名要求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用实用工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

并发支持库 (C++11)

执行支持库 (C++26)

技术规范

符号索引

外部库

 

字符串库

以 null 结尾的字符串

字节字符串

多字节字符串

宽字符串

类

basic_string

basic_string_view (C++17)

char_traits

 

以 null 结尾的宽字符串

函数
字符操作
iswalnum iswalpha iswlower iswupper iswdigit iswxdigit iswblank (C++11)   wctype iswctype	iswcntrl iswgraph iswspace iswprint iswpunct towlower towupper wctrans towctrans
转换为数字格式
wcstolwcstoll (C++11) wcstoulwcstoull (C++11)	wcstofwcstodwcstold (C++11)(C++11) wcstoimaxwcstouimax (C++11)(C++11)
字符串操作
wcslen wcscpy wcsncpy wcscat wcsncat wcscmp wcscoll wcsncmp	wcsxfrm wcschr wcsrchr wcspbrk wcsspn wcscspn wcsstr wcstok
数组操作
wmemcpy wmemmove wmemcmp	wmemchr wmemset

 

定义在头文件 <cwchar> 中
wchar_t* wcsncat( wchar_t* dest, const wchar_t* src, std::size_t count );

将 src 指向的宽字符串中最多 count 个宽字符追加到 dest 指向的字符字符串的末尾，如果复制了 null 终止符，则停止。宽字符 src[0] 替换了 dest 末尾的 null 终止符。null 终止符始终追加到末尾（因此函数最多可能写入的宽字符数为 count + 1）。

如果目标数组的大小不足以容纳 src 和 dest 的内容以及终止的 null 宽字符，则行为未定义。

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

参数

dest	-	指向要追加到的以 null 结尾的宽字符串的指针
src	-	指向要从中复制的以 null 结尾的宽字符串的指针
count	-	要复制的最大宽字符数

返回值

dest

示例

运行此代码

#include <clocale>
#include <cwchar> 
#include <iostream>
 
int main(void) 
{
    wchar_t str[50] = L"Земля, прощай.";
    std::wcsncat(str, L" ", 1);
    std::wcsncat(str, L"В добрый путь.", 8); // only append the first 8 wide chars
 
    std::setlocale(LC_ALL, "en_US.utf8");
    std::wcout.imbue(std::locale("en_US.utf8"));
    std::wcout << str << '\n';
}

可能的输出

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

另请参见

wcscat	将一个宽字符串的副本追加到另一个宽字符串 (函数)
strncat	将两个字符串的特定数量的字符连接起来 (函数)
wcscpy	将一个宽字符串复制到另一个宽字符串 (函数)
C 文档 for wcsncat