C ライブラリ関数 - memmove()
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;
}
#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では、
destとsrcは2つの独立した配列であり、重複はありません。memmove(dest, src, 9)将srcの最初の9バイトがそのままコピーされますdest。 - シナリオ2では、
str + 2(デスティネーション)とstr(ソース)は同じ配列内の重複領域を指しています。memmove上書きされるデータを先に保存してからコピーを完了するため、結果は正しくなります。 - シナリオ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;
}
#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;
}
#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;
}
#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.h