CFchg、CFchg32(3fml)

名前

CFchg()、CFchg32() - フィールドの変換および変更

形式

#include <stdio.h> 
#include "fml.h" 
int CFchg(FBFR *fbfr, FLDID fieldid, FLDOCC oc, char *value, 
       FLDLEN len, int type) 
#include "fml32.h" 
int CFchg32(FBFR32 *fbfr, FLDID32 fieldid, FLDOCC32 oc, 
       char *value,
FLDLEN32 len, int type)

機能説明

CFchg() は、Fchg() に似た働きをしますが、フィールドがフィールド化バッファにおいて変更されるために、最初に、ユーザ指定の type から fieldid 型に value を変換します。fbfr は、フィールド化バッファを指すポインタです。fieldid は、フィールド識別子です。oc はフィールドのオカレンス番号です。value は、新しい値を指すポインタです。len は、変更される値の長さです。len は、型が FLD_CARRAY の場合のみ必要です。type は、value のデータ・タイプです。

存在しないフィールド・オカレンスが指定された場合、必要とされる値が追加されるまで、存在しないオカレンスに NULL 値が追加されます (たとえば、バッファに存在しないフィールドのフィールド・オカレンスを 4 に変更すると、3 個の NULL 値の後に指定されたフィールド値が追加されます)。

FLD_PTR、FLD_FML32、または FLD_VIEW32 のフィールド・タイプが使用されると、この関数は異常終了します。CFchg() または CFchg32() が使用されている場合に、これらのフィールド・タイプの 1 つが指定されると、Ferror に FEBADOP が設定されます。

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

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

戻り値

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

エラー

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

[FMALLOC]

関連項目