Fadd、Fadd32(3fml)

名前

Fadd()、Fadd32() - 新しいフィールド・オカレンスの追加

形式

#include <stdio.h> 
#include "fml.h" 
int Fadd(FBFR *fbfr, FLDID fieldid, char *value, FLDLEN len) 
#include "fml32.h" 
int Fadd32(FBFR32 *fbfr, FLDID32 fieldid, char *value, FLDLEN32 len)

機能説明

Fadd() は、指定されたフィールド値を指定されたバッファに追加します。fbfr は、フィールド化バッファを指すポインタです。fieldid は、フィールド識別子です。value は、新しい値を指すポインタです。したがって、ポインタの型は、追加される値と同じフィールド識別子の型である必要があります。len は、追加される値の長さです。len は、FLD_CARRAY 型の場合のみ必要です。

追加する値は、value パラメータで指定する場所にあります。既に 1 つまたは複数のフィールド・オカレンスがある場合、新しいフィールド・オカレンスとして値が追加され、現在指定されているオカレンスの最大値より 1 つ大きいオカレンス番号が割り当てられます (指定されたオカレンスを追加するには、Fchg() を使用する必要があります)。

上記の「形式」の項では、Fadd() の引数 value のデータ型は、char のポインタ (C の char * ) として記述されています。技術的には、これは、単に、Fadd() に渡せる値のある特定の型を記述しています。実際、引数 value の型は、追加されているフィールドのフィールド化バッファ表現と同じ型のオブジェクトのポインタである必要があります。たとえば、フィールドが、FLD_LONG 型でバッファに格納されている場合は、value の型は、long のポインタ (C の long *) である必要があります。同様に、FLD_SHORT 型でバッファに格納される場合、value は、short 型のポインタ (C の short *) である必要があります。大事なことは、Fadd() は、value が指すオブジェクトが、追加される格納済みのフィールドの型と同じ型を持っていることを想定しているということです。

FLD_PTR 型の値の場合、Fadd32() はポインタの値を格納します。FLD_PTR フィールドで指定されるバッファは、tpalloc() 呼び出しで割り当てる必要があります。FLD_FML32 型の値の場合、Fadd32() はインデックスを除いた FLD_FML32 フィールド全体の値を格納します。FLD_VIEW32 型の値の場合、Fadd() は FVIEWFLD 型の構造体へのポインタを格納します。これには、vflags (現在未使用で 0 にセットされた flags フィールド)、vname (VIEW 名を含む文字配列)、および data (C 構造体として格納される VIEW データへのポインタ) が含まれます。アプリケーションは、vname と data を Fadd32() に提供します。

FLD_CARRAY 型の値の場合、値の長さは len 引数で指定されます。FLD_CARRAY 以外のすべての型では、value が参照するオブジェクトの長さは、その型から導かれ (たとえば、FLD_FLOAT の場合、長さは、sizeof(float) になる)、len の内容は無視されます。

Fadd32 は 32 ビット FML で使用されます。

マルチスレッドのアプリケーション内のスレッドは、TPINVALIDCONTEXT を含め、どのようなコンテキスト状態で実行している場合でも、Fadd() または Fadd32() を呼び出すことができます。

戻り値

この関数は、エラー発生時に -1 を返し、Ferror を設定してエラー条件を示します。

エラー

次の条件の場合、Fadd() は異常終了し、Ferror を次の値に設定します。

関連項目