Namespaces
Variants

wmemmove, wmemmove_s

From cppreference.net
< c ‎ | string ‎ | wide
C
Strings library
Null-terminated wide strings
定义于头文件 <wchar.h>
wchar_t * wmemmove ( wchar_t * dest, const wchar_t * src, size_t count ) ;
(1) (C95 起)
errno_t wmemmove_s ( wchar_t * dest, rsize_t destsz,
const wchar_t * src, rsize_t count ) ;
(2) (C11 起)
1) 从 src 所指向的宽字符数组中精确复制 count 个连续宽字符到 dest 所指向的宽字符数组。若 count 为零，函数不执行任何操作。数组可以重叠：复制过程如同先将宽字符复制到临时宽字符数组，再从临时数组复制到 dest 。
2) 与 (1) 相同，区别在于以下错误会在运行时被检测并调用当前安装的 约束处理函数 ：
  • src 或 dest 是空指针
  • destsz 或 count 大于 RSIZE_MAX / sizeof ( wchar_t )
  • count 大于 destsz （将发生溢出）
与所有边界检查函数一样，仅当实现定义了 __STDC_LIB_EXT1__ 且用户在包含 <wchar.h> 前将 __STDC_WANT_LIB_EXT1__ 定义为整型常量 1 时，才保证 wmemcpy_s 可用。

目录

参数

dest - 指向目标宽字符数组的指针
src - 指向源宽字符数组的指针
destsz - 最大写入宽字符数（目标缓冲区大小）
count - 要复制的宽字符数量

返回值

1) 返回 dest 的副本
2) 成功时返回零，错误时返回非零值。此外，在发生错误时，将整个 dst 直至但不包括 dst + dstsz 的范围填充为空宽字符 L ' \0 ' （除非 dest 为空或 destsz 大于 RSIZE_MAX / sizeof ( wchar_t ) ）

注释

此函数对区域设置不敏感，且不关注所复制的 wchar_t 对象值：空字符及无效字符均会被复制。

示例

运行此代码 
#include <locale.h>
#include <stdio.h>
#include <wchar.h>
int main(void)
{
    setlocale(LC_ALL, "en_US.utf8");
    wchar_t str[] = L"αβγδεζηθικλμνξοπρστυφχψω";
    printf("%ls\n", str);
    wmemmove(str + 4, str + 3, 3); // 从 [δεζ] 复制到 [εζη]
    printf("%ls\n", str);
}

输出： 

αβγδεζηθικλμνξοπρστυφχψω
αβγδδεζθικλμνξοπρστυφχψω

参考文献

  • C23 标准 (ISO/IEC 9899:2024):
  • 7.29.4.2.4 wmemmove 函数 (p: TBD)
  • K.3.9.2.1.4 wmemmove_s 函数 (p: TBD)
  • C17 标准 (ISO/IEC 9899:2018):
  • 7.29.4.2.4 wmemmove 函数 (p: TBD)
  • K.3.9.2.1.4 wmemmove_s 函数 (p: TBD)
  • C11 标准 (ISO/IEC 9899:2011):
  • 7.29.4.2.4 wmemmove 函数 (p: 432)
  • K.3.9.2.1.4 wmemmove_s 函数 (p: 642)
  • C99标准（ISO/IEC 9899:1999）：
  • 7.24.4.2.4 wmemmove函数（页码：378）

参阅

(C11)
移动一个缓冲区到另一个缓冲区
(函数)
(C95) (C11)
在两个非重叠数组间复制指定数量的宽字符
(函数)
C++ documentation for wmemmove