フィールド化バッファを移動する関数

フィールド化バッファの位置に関する唯一の制約は、フィールド化バッファを short 型境界に調整しなければならないことです。この制約がなければ、フィールド化バッファをメモリ内で自由に移動できます。

Fmove

src がフィールド化バッファを指し、dest がフィールド化バッファを保持できるサイズの記憶領域を指す場合は、以下のコードを使用してフィールド化バッファを移動できます。

FBFR *src;
char *dest;
. . .
memcpy(dest, src, Fsizeof(src));

C の実行時メモリ管理関数の 1 つである memcpy は、指定したバイト数のバッファ (3 つ目の引数で指定) を、指定した領域 (2 つ目の引数で指定) から別の領域 (1 つ目の引数で指定) に移動します。

memcpy を使用するとフィールド化バッファをコピーできますが、コピー先のバッファは、コピー元と同じになります。たとえば、コピー先の空き領域のバイト数は、コピー元の空き領域のバイト数と同じです。

Fmove は、memcpy と同じように動作します。ただし、明示的に長さを指定する必要はありません (自動的に算出されます)。

int
Fmove(char *dest, FBFR *src)

以下はパラメータの説明です。

たとえば、次のコードでは、Fmove は、ソース・バッファがフィールド化バッファかどうかを確認しますが、このバッファの変更は行いません。

FBFR *src;
char *dest;
. . .
if(Fmove(dest,src) < 0) 
	   F_error("pgm_name");

Fcpy

Fcpy は、あるフィールド化バッファを別のフィールド化バッファで上書きするために使用します。

int
Fcpy(FBFR *dest, FBFR *src)

以下はパラメータの説明です。

Fcpy は、上書きされたフィールド化バッファの全体の長さを保持するため、フィールド化バッファのサイズを拡大または縮小する場合に便利です。次の例を参照してください。

FBFR *src, *dest;
. . .
if(Fcpy(dest, src) < 0)
        F_error("pgm_name");

注記 フィールド化バッファのサイズを、現在格納されているデータの領域より小さくすることはできません。