wcscat, wcscat_s

 

C

编译器支持

语言

头文件

类型支持

程序工具

变参函数支持

错误处理

动态内存管理

字符串库

算法

数值

日期和时间工具

输入/输出支持

本地化支持

并发支持 (C11)

技术规范

符号索引

 

字符串库

空终止字节字符串

空终止多字节字符串

空终止宽字符串

 

空终止宽字符串

函数 字符分类 iswalnum (C95) iswalpha (C95) iswlower (C95) iswupper (C95) iswdigit (C95) iswxdigit (C95)   iswblank (C99) iswctype (C95) iswcntrl (C95) iswgraph (C95) iswspace (C95) iswprint (C95) iswpunct (C95) wctype (C95) 字符操作 towlower (C95) towupper (C95) wctrans (C95) towctrans (C95) 转换为数字格式 wcstolwcstoll (C95)(C99) wcstofwcstodwcstold (C99)(C95)(C99) wcstoulwcstoull (C95)(C99) wcstoimaxwcstoumax (C99)(C99)     字符串操作 wcscpywcscpy_s (C95)(C11) wcsncpywcsncpy_s (C95)(C11) wcsxfrm (C95) wcscatwcscat_s (C95)(C11) wcsncatwcsncat_s (C95)(C11)

字符串检查 wcslenwcsnlen_s (C95)(C11) wcsstr (C95) wcscmp (C95) wcsncmp (C95) wcscoll (C95) wcschr (C95) wcsrchr (C95) wcspbrk (C95) wcsspn (C95) wcscspn (C95) wcstokwcstok_s (C95)(C11) 数组操作 wmemcpywmemcpy_s (C95)(C11) wmemmovewmemmove_s (C95)(C11)   wmemcmp (C95) wmemchr (C95) wmemset (C95) 类型 wchar_t wint_t (C95) wctrans_t wctype_t (C95)(C95) 宏 WCHAR_MIN WCHAR_MAX (C95)(C95) WEOF (C95)

 

在头文件 <wchar.h> 中定义
	(1)
wchar_t *wcscat( wchar_t *dest, const wchar_t *src );			(自 C95 起) (直到 C99)
wchar_t *wcscat( wchar_t *restrict dest, const wchar_t *restrict src );			(C99 起)
errno_t wcscat_s( wchar_t *restrict dest, rsize_t destsz,                   const wchar_t *restrict src );		(2)	(C11 起)

1) 将 src 指向的宽字符串的副本附加到 dest 指向的宽字符串的末尾。宽字符 src[0] 替换 dest 末尾的空终止符。结果宽字符串以空字符终止。如果目标数组不够大，无法容纳 str 和 dest 的内容以及终止空宽字符，则行为未定义。如果字符串重叠，则行为未定义。

2) 与 (1) 相同，除了它可能会用未指定的值破坏目标数组的其余部分（从写入 destsz 的最后一个字符开始），并且以下错误在运行时检测到并调用当前安装的 约束处理程序 函数

• `src` 或 `dest` 是空指针
• destsz 为零或大于 RSIZE_MAX/sizeof(wchar_t)
• dest 的前 destsz 个宽字符中没有空终止符
• 将发生截断（dest 末尾的可用空间不足以容纳 src 的每个宽字符，包括空终止符）
• 源字符串和目标字符串之间会发生重叠

与所有边界检查函数一样，只有当实现定义了 __STDC_LIB_EXT1__ 并且用户在包含 <wchar.h> 之前将 __STDC_WANT_LIB_EXT1__ 定义为整数常量 1 时，才能保证 wcscat_s 可用。

参数

dest	-	指向要追加的以空终止的宽字符串的指针
src	-	指向要从中复制的以空终止的宽字符串的指针
destsz	-	要写入的最大字符数，通常是目标缓冲区的长度

返回值

1) 返回 `dest` 的副本

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

示例

运行此代码

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

输出

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

参考

• C17 标准 (ISO/IEC 9899:2018)

• 7.29.4.3.1 wcscat 函数 (p: 315)

• K.3.9.2.2.1 wcscat_s 函数 (p: 466)

• C11 标准 (ISO/IEC 9899:2011)

• 7.29.4.3.1 wcscat 函数 (p: 432)

• K.3.9.2.2.1 wcscat_s 函数 (p: 642-643)

• C99 标准 (ISO/IEC 9899:1999)

• 7.24.4.3.1 wcscat 函数 (p: 378)

另请参阅

wcsncatwcsncat_s (C95)(C11)	将一定数量的宽字符从一个宽字符串附加到另一个宽字符串 (函数)
strcatstrcat_s (C11)	连接两个字符串 (函数)
wcscpywcscpy_s (C95)(C11)	将一个宽字符串复制到另一个宽字符串 (函数)
C++ 文档 用于 wcscat