C ライブラリ関数 - memmove()

C 标准库 - string.hC 標準ライブラリ - string.h


memmove()は C 言語標準ライブラリ<string.h>のメモリ操作関数で、指定したバイト数をソースアドレスからデスティネーションアドレスにコピーし、メモリの重複を安全に処理できます。

単語の意味:memmoveであるmemory move(メモリ移動)の略で、メモリ内のデータを移動することを意味します。

C ライブラリ関数void *memmove(void *str1, const void *str2, size_t n)からstr2コピーnバイトをstr1。

memcpy() との違い:

  • デスティネーション領域とソース領域がメモリ上で重複する場合、memmove()は、ソースデータが上書きされる前に、重複部分のバイトを安全にデスティネーション領域へ転送できることを保証するため、memcpy()より信頼性が高くなります。
  • デスティネーション領域とソース領域が完全に重複しない場合は、memmove()の動作はmemcpy()と同じです。
  • 2つのメモリ領域が重複しているかどうかわからない場合は、優先して使用すべきですmemmove()。

関数宣言

void *memmove(void *str1, const void *str2, size_t n)

パラメータの説明

  • str1:デスティネーションアドレス。コピー内容を格納するメモリ領域を指します(型はvoid*)。
  • str2:ソースアドレス。コピーするデータの開始位置を指します(型はconst void*)。
  • n:コピーするバイト数(size_t型)。

戻り値

デスティネーションの記憶領域str1を指すポインタを返します(渡されたstr1と同じ)。

ヘッダーファイル

#include <string.h>

例

例1:基本的な使い方

次の例では、memmove()の重複しない場合と重複する場合の2つのシナリオでの使い方を示しています:

例

#include <stdio>
#include <string.h>

int main()
{
    /* シナリオ1:重複しないメモリコピー */
    char dest[] = "oldstring";
    char src[]  = "newstring";

    printf("重複しないコピー前:dest = %s, src = %s\n", dest, src);
    memmove(dest, src, 9);
    printf("重複しないコピー後:dest = %s, src = %s\n", dest, src);

    /* シナリオ2:重複するメモリコピー(memmove の利点) */
    char str[] = "123456789";
    printf("\n重複コピー前:%s\n", str);
    memmove(str + 2, str, 6);
    printf("重複コピー後:%s\n", str);

    return 0;
}

実行結果:

非重叠拷贝前:dest = oldstring, src = newstring
非重叠拷贝后:dest = newstring, src = newstring

重叠拷贝前:123456789
重叠拷贝后:121234569

コードの解説:

  1. シナリオ1では、destとsrcは2つの独立した配列であり、重複はありません。memmove(dest, src, 9) 将 srcの最初の9バイトがそのままコピーされますdest。
  2. シナリオ2では、str + 2(デスティネーション)とstr(ソース)は同じ配列内の重複領域を指しています。memmove上書きされるデータを先に保存してからコピーを完了するため、結果は正しくなります。
  3. シナリオ2を次のものに置き換えるとmemcpy、一部のコンパイラやプラットフォームでは誤った結果が生じる可能性があります。なぜならmemcpy重複するケースの処理を保証しないためです。

例2:重複メモリの処理

2つのメモリ領域が重複する場合、memmove()それでも正しい結果が得られます:

例

#include <stdio>
#include <string.h>

int main()
{
    char str[] = "memmove can be very useful";

    printf("Before: %s\n", str);
    /* 位置11から始まる7バイトを位置5にコピーします。2つの領域は重複しています */
    memmove(str + 5, str + 11, 7);
    printf("After:  %s\n", str);

    return 0;
}

実行結果:

Before: memmove can be very useful
After:  memmove can be very useful

コードの解説:

  • 元の文字列では、位置5から始まる部分は"ve can be very useful"、位置11から始まる7バイトは"can be"(末尾のスペースを含みます)。
  • memmove(str + 5, str + 11, 7) 将 "can be"位置5に移動すると、2つの領域は重複しますが、memmoveは、アドレスの大小に応じて順方向または逆方向のコピー戦略を選択し、データの整合性を保証します。
  • コピー後、位置5から始まる内容は"can be"になり、残りの文字はそのまま保持されます。

例3:memcpy() と memmove() の比較

次の例は、同じ重複シナリオで2つの関数が異なる結果を生む可能性があることを示しています:

例

#include <stdio>
#include <string.h>

int main()
{
    char str1[] = "abcdefghij";
    char str2[] = "abcdefghij";

    printf("Original: %s\n", str1);

    /* memcpy を使用:重複時の動作は未定義 */
    memcpy(str1 + 2, str1, 5);
    printf("memcpy:   %s\n", str1);

    /* memmove を使用:重複時の動作は保証される */
    memmove(str2 + 2, str2, 5);
    printf("memmove:  %s\n", str2);

    return 0;
}

実行結果:

Original: abcdefghij
memcpy:   ababababij
memmove:  ababcdfghij

説明:この例では、memcpyはバイト単位で順方向にコピーするため、ソースデータが先に上書きされ、出力が期待と一致しません。一方、memmoveは重複を検出して逆方向コピーを採用するため、結果は正しくなります。異なるプラットフォームやコンパイラのmemcpy実装の動作が異なる可能性があるため、重複するシナリオでは常に使用すべきですmemmove。


例4:指定バイト数のコピー

memmove()はバイト単位の操作であり、文字列の終端文字を自動的に書き込まないため、使用時は手動で追加する必要があります'\0':

例

#include <stdio>
#include <string.h>

int main()
{
    char src[]  = "Hello, World!";
    char dest[20];

    /* 先頭5バイトのみコピー */
    memmove(dest, src, 5);
    dest[5] = '\0';  /* 文字列の終端文字を手動で追加 */

    printf("Source: %s\n", src);
    printf("Dest:   %s\n", dest);
    printf("Length: %zu\n", strlen(dest));

    return 0;
}

実行結果:

Source: Hello, World!
Dest:   Hello
Length: 5

コードの解説:

  • memmove(dest, src, 5)は最初の5バイトのみコピーします('H' 'e' 'l' 'l' 'o')。
  • memmove()はデスティネーションの末尾に自動的に書き込みません'\0'、省略するとdest[5] = '\0'、後続の文字列操作(例:printf、strlen)は不確定なメモリを読み取るため、未定義動作を引き起こします。

memcpy() との違い

特性 memcpy() memmove()
メモリ重複の処理 動作は未定義で、誤った結果が生じる可能性があります 安全に処理し、正しいコピーを保証します
実装方式 順番に直接バイト単位でコピーする 重複の方向を検出し、順方向または逆方向のコピーを選択する
性能 通常はやや速い(重複検出のオーバーヘッドなし) やや遅い(重複検出ロジックを含む)
使用上の推奨 ソースとデスティネーションが完全に重複しないことを確認できた場合に使用 重複がある場合、または重複するか不明な場合に使用

C 标准库 - string.hC 標準ライブラリ - string.h

その他の拡張