wmemmove, wmemmove_s

在標頭檔案 `<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 可用。

#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 函式 (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 函式 (p: 378)

[編輯] 另請參閱

memmovememmove_s (C11)	將一個緩衝區移動到另一個緩衝區 (函式) [編輯]
wmemcpywmemcpy_s (C95)(C11)	在兩個不重疊的陣列之間複製一定數量的寬字元 (函式) [編輯]
C++ 文件為 wmemmove

編譯器支援
語言
標頭檔案
型別支援
程式工具
變參函式支援
錯誤處理
動態記憶體管理
字串庫
演算法
數值
日期和時間工具
輸入/輸出支援
本地化支援
併發支援 (C11)
技術規範
符號索引

cppreference.com

名稱空間

變體

檢視

操作

wmemmove, wmemmove_s

目錄

[編輯] 引數

[編輯] 返回值

[編輯] 注意

[編輯] 示例

[編輯] 參考

[編輯] 另請參閱

導航

工具箱

dest	-	指向要複製到的寬字元陣列的指標
src	-	指向要複製的寬字元陣列的指標
destsz	-	要寫入的最大寬字元數（目標緩衝區的大小）
count	-	要複製的寬字元數