|
|
|
|
|
Fcpy、Fcpy32(3fml)
名前
Fcpy()、Fcpy32() - ソース・バッファを宛先バッファにコピー
形式
#include <stdio.h>
#include "fml.h"
int
Fcpy(FBFR *dest, FBFR *src)
#include "fml32.h"
int
Fcpy32(FBFR32 *dest, FBFR32 *src)
機能説明
Fcpy() は、あるフィールド化バッファの内容を他のフィールド化バッファに複写するために使用されます。dest は、宛先バッファのポインタです。src は、元のフィールド化バッファを指すポインタです。Fcpy() は、宛先がフィールド化バッファであることを想定しています。このようにすると、宛先バッファに、ソース・バッファのデータを入れるための十分な大きさがあるか検査できます。
FLD_PTR 型の値の場合、Fcpy32() はバッファのポインタをコピーします。アプリケーション・プログラマは、対応するポインタがコピーされるバッファの再割り当て、および解放を管理する必要があります。
Fcpy32() は 32 ビット FML で使用されます。
マルチスレッドのアプリケーション内のスレッドは、TPINVALIDCONTEXT を含め、どのようなコンテキスト状態で実行している場合でも、Fcpy() または Fcpy32() を呼び出すことができます。
戻り値
この関数は、エラー発生時に -1 を返し、Ferror を設定してエラー条件を示します。
エラー
次の条件の場合、Fcpy() は異常終了し、Ferror を次の値に設定します。
ソース・バッファまたは宛先バッファのどちらかが適切なバウンダリで開始していません。
ソース・バッファあるいは宛先バッファのどちらかが、フィールド化バッファでない、あるいは Finit() によって初期化されていません。
宛先バッファは、ソース・バッファを保持できる十分な大きさではありません。
関連項目
「FML 関数の紹介」、Fmove、Fmove32(3fml)
|
|
|
|
|
|
Copyright © 2001 BEA Systems, Inc. All rights reserved.
|