Fdel、Fdel32(3fml)

名前

Fdel()、Fdel32() - バッファからフィールド・オカレンスを削除

形式

#include <stdio.h> 
#include "fml.h" 
int 
Fdel(FBFR *fbfr, FLDID fieldid, FLDOCC oc) 
#include "fml32.h" 
int 
Fdel32(FBFR32 *fbfr, FLDID32 fieldid, FLDOCC32 oc)

機能説明

Fdel() は、指定されたフィールド・オカレンスをバッファから削除します。fbfr は、フィールド化バッファを指すポインタです。fieldid は、フィールド識別子です。oc はフィールドのオカレンス番号です。

フィールド化バッファに、1 つのフィールドに対し複数のオカレンスがあり、最後のオカレンスでないフィールド・オカレンスが削除された場合、バッファにある高位のオカレンスは、1 つずつ繰り下がります。すべてのオカレンスのオカレンス番号を同じままにするためには、Fchg() を使用してフィールド・オカレンス値をヌル値に設定します。

FLD_PTR 型の値の場合、Fdel32() によって FLD_PTR フィールド・オカレンスが削除されても、参照されるバッファは変更されないか、ポインタは解放されません。データ・バッファは、オペークなポインタとして扱われます。

Fdel32() は 32 ビット FML で使用されます。

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

戻り値

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

エラー

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

関連項目