wcscpy, wcscpy_s
来自 zh.cppreference.net
| 定义于头文件 <wchar.h>
|
||
wchar_t* wcscpy( wchar_t* dest, const wchar_t* src );
|
(1) | (自 C95 起) (至 C99) |
wchar_t* wcscpy( wchar_t* restrict dest, const wchar_t* restrict src );
|
(自 C99 起) | |
errno_t wcscpy_s( wchar_t* restrict dest, rsize_t destsz,
const wchar_t* restrict src );
|
(2) | (自 C11 起) |
1) 将 src 指向的宽字符串（包括终止空宽字符）复制到 dest 指向的宽字符数组。如果 dest 数组不够大，则行为未定义。如果字符串重叠，则行为未定义。
srcdestdest2) 与 (1) 相同，但它可能用未指定值填充目标数组的剩余部分，并且在运行时检测以下错误，并调用当前安装的约束处理函数：
srcsrc 或 dest 是空指针destdestszdestsz 为零或大于 RSIZE_MAXRSIZE_MAX / sizeof(wchar_t)destszwcsnlen_s(src, destsz)destsz 小于或等于 wcsnlen_s(src, destsz)，即会发生截断- 源字符串和目标字符串之间会发生重叠
- 与所有边界检查函数一样，仅当实现定义了 __STDC_LIB_EXT1__，且用户在包含 wchar.h 之前将 __STDC_WANT_LIB_EXT1__ 定义为整数常量 1 时，wcscpy_s 才保证可用。
wcscpy_s__STDC_LIB_EXT1____STDC_WANT_LIB_EXT1__1<>
参数
| dest | - | 指向待复制目标宽字符数组的指针 |
| src | - | 指向待复制源空终止宽字符串的指针 |
| destsz | - | 最多写入的字符数，通常为目标缓冲区的大小 |
返回值
1)返回 dest 的副本
dest2)成功时返回零，错误时返回非零。此外，错误时将 L'\0' 写入 dest[0]（除非 dest 是空指针，或者 destsz 为零或大于 RSIZE_MAX）。
L'\0'dest[0]destdestszRMAX_SIZE / sizeof(wchar_t)示例
运行此代码
#include <locale.h>
#include <stdio.h>
#include <wchar.h>
int main(void)
{
wchar_t* src = L"犬 means dog";
// src[0] = L'狗' ; // this would be undefined behavior
wchar_t dst[wcslen(src) + 1]; // +1 for the null terminator
wcscpy(dst, src);
dst[0] = L'狗'; // OK
setlocale(LC_ALL, "en_US.utf8");
printf("src = %ls\ndst = %ls\n", src, dst);
}
输出：
src = 犬 means dog
dst = 狗 means dog
- 引用
- C23 标准 (ISO/IEC 9899:2024): 7.31.4.2.1 wcscpy 函数 (p: 438)
- K.3.9.3.1.1 wcscpy_s 函数 (p: 663)
- C17 标准 (ISO/IEC 9899:2018): 7.29.4.1.2 wcscpy 函数 (p: TBD)
- K.3.9.2.1.1 wcscpy_s 函数 (p: TBD)
- C11 标准 (ISO/IEC 9899:2011): 7.29.4.1.2 wcscpy 函数 (p: 430)
- K.3.9.2.1.1 wcscpy_s 函数 (p: 639)
- C99 标准 (ISO/IEC 9899:1999): 7.24.4.1.2 wcscpy 函数 (p: 376)
参阅
(C95)(C11) |
从字符串复制一定数量的宽字符到另一个字符串 (函数) |
(C95)(C11) |
在两个非重叠数组之间复制一定数量的宽字符 (函数) |
(C11) |
将一个字符串复制到另一个字符串 (函数) |
wcscpy 的 C++ 文档 for wcscpy
| |