命名空间
变体
操作

wmemmove, wmemmove_s

来自 cppreference.cn
< c‎ | string‎ | wide
定义于头文件 <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) 相同,除了以下错误在运行时被检测到并调用当前安装的 约束处理函数
  • srcdest 是空指针
  • destszcount 大于 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) 成功时返回零,错误时返回非零值。此外,在错误时,用空宽字符 L'\0' 填充整个 dst 直到但不包括 dst+dstsz (除非 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); // copy from [δεζ] to [εζη]
    printf("%ls\n", str);
}

输出

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

[编辑] 参考

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

[编辑] 参见

将一个缓冲区移动到另一个缓冲区
(函数) [编辑]
在两个非重叠数组之间复制一定数量的宽字符
(函数) [编辑]
C++ 文档 关于 wmemmove