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で示されるワイド文字配列からdestで示されるワイド文字配列へ、count個の連続するワイド文字をコピーします。countがゼロの場合、関数は何もしません。配列は重複する可能性があります。コピーは、ワイド文字が一時的なワイド文字配列にコピーされ、その後一時的な配列からdestにコピーされたかのように実行されます。

2) (1) と同じですが、実行時に以下のエラーが検出され、現在インストールされている制約ハンドラ関数が呼び出されます。

src または dest がヌルポインタである
destsz または count が RSIZE_MAX / sizeof(wchar_t) より大きい。
count が destsz より大きい（オーバーフローが発生する）。

すべての境界チェック機能と同様に、wmemcpy_s が利用可能であることが保証されるのは、実装によって __STDC_LIB_EXT1__ が定義され、ユーザーが <wchar.h> をインクルードする前に __STDC_WANT_LIB_EXT1__ を整数定数 1 に定義した場合のみです。

2) 成功した場合はゼロを返し、エラーの場合は非ゼロを返します。また、エラー時には、dest が null でないか、または destsz が RSIZE_MAX/sizeof(wchar_t) より大きくない限り、dst から dst+dstsz まで（ただし dst+dstsz は含まない）すべてヌルワイド文字 L'\0' で埋めます。

[編集] 注釈

この関数はロケールに依存せず、コピーする 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関数 (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)	オーバーラップしていない2つの配列間で、指定された数のワイド文字をコピーする (関数) [編集]
C++ ドキュメント (wmemmove)

コンパイラサポート
言語
ヘッダー
型サポート
プログラムユーティリティ
可変長引数関数のサポート
エラーハンドリング
動的メモリ管理
文字列ライブラリ
アルゴリズム
数値
日付と時刻のユーティリティ
入出力サポート
ローカライゼーションサポート
並行処理サポート (C11)
技術仕様
シンボルインデックス

cppreference.com

名前空間

変種

表示

操作

wmemmove, wmemmove_s

目次

[編集] パラメータ

[編集] 戻り値

[編集] 注釈

[編集] 例

[編集] 参照

[編集] 関連項目

ナビゲーション

ツールボックス

dest	-	コピー先のワイド文字配列へのポインタ
src	-	コピー元のワイド文字配列へのポインタ
destsz	-	書き込むワイド文字の最大数（宛先バッファのサイズ）
count	-	コピーするワイド文字の数