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 );			(since C95) (until C99)
wchar_t *wcscat( wchar_t *restrict dest, const wchar_t *restrict src );			(since C99)
errno_t wcscat_s( wchar_t *restrict dest, rsize_t destsz,                   const wchar_t *restrict src );		(2)	(since 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