wcscat, wcscat_s
From cppreference.net
|
定义于头文件
<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
)
)。
示例
运行此代码
输出:
Земля, прощай. В добрый путь.
参考文献
- 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函数(页码:378)
参见
|
(C95)
(C11)
|
将指定数量的宽字符从一个宽字符串追加到另一个宽字符串
(函数) |
|
(C11)
|
连接两个字符串
(函数) |
|
(C95)
(C11)
|
将一个宽字符串复制到另一个宽字符串
(函数) |
|
C++ 文档
关于
wcscat
|
|