|
|
|
|
|
Fgets、Fgets32(3fml)
名前
Fgets()、Fgets32() - 値を文字列に変換
形式
#include <stdio.h>
#include "fml.h"
int
Fgets(FBFR *fbfr, FLDID fieldid, FLDOCC oc, char *buf)
#include "fml32.h"
int
Fgets32(FBFR32 *fbfr, FLDID32 fieldid, FLDOCC32 oc, char *buf)
機能説明
Fgets() は、フィールド化バッファからフィールド・オカレンスを検索し、値をユーザ型 FLD_STRING に変換します。fbfr は、フィールド化バッファを指すポインタです。fieldid は、フィールド識別子です。oc はフィールドのオカレンス番号です。Fgets() の呼び出し側は、プライベート・バッファを指すポインタ (buf) を提供します。プライベート・バッファは、検索されるフィールド値のために使用されます。buf は、値を保持するために十分に大きいと想定されています。基本的に、Fgets() は、想定されている utype (FLD_STRING) および ulen (値が 0) を利用して CFget() を呼び出します。
Fgets32() は 32 ビット FML で使用されます。
マルチスレッドのアプリケーション内のスレッドは、TPINVALIDCONTEXT を含め、どのようなコンテキスト状態で実行している場合でも、Fgets() または Fgets32() を呼び出すことができます。
戻り値
この関数は、エラー発生時に -1 を返し、Ferror を設定してエラー条件を示します。
エラー
次の条件の場合、Fgets() は異常終了し、Ferror を次の値に設定します。
バッファが適切なバウンダリで開始していません。
バッファがフィールド化されていないか、または Finit() で初期化されていません。
フィールド・オカレンスが要求されましたが、指定されたフィールドおよびオカレンスは、フィールド化バッファにありませんでした。
指定されたフィールド識別子は無効です。
指定されたフィールド識別子は無効です。
malloc() を使用しての領域の動的な割り当てが失敗しました。
関連項目
「FML 関数の紹介」、CFget、CFget32(3fml)、Fget、Fget32(3fml)、Fgetalloc、Fgetalloc32(3fml)、Fgetlast、Fgetlast32(3fml)、Fgetsa、Fgetsa32(3fml)
|
|
|
|
|
|
Copyright © 2001 BEA Systems, Inc. All rights reserved.
|