![]() |
![]() |
|
|
Fvals、Fvals32(3fml)
名前
Fvals()、Fvals32() - フィールド・オカレンスの文字列の値を返す
形式
#include <stdio.h>
#include "fml.h"
char *
Fvals(FBFR *fbfr, FLDID fieldid, FLDOCC oc)
#include "fml32.h"
char *
Fvals32(FBFR32 *fbfr, FLDID32 fieldid, FLDOCC32 oc)
機能説明
Fvals() は、文字列の値の場合に Ffind() 同様に動作しますが、値が返されることを保証します。fbfr は、フィールド化バッファを指すポインタです。 fieldid は、フィールド識別子です。oc はフィールドのオカレンス番号です。
指定したフィールド・オカレンスが見つからない場合は、NULL が返されます。この関数は、戻り値をチェックせずにフィールドの値を別の関数に渡すのに役立ちます。この関数は、タイプ FLD_STRING のフィールドに対してのみ有効です。ヌル文字列は、別のフィールド・タイプに対して自動的に返されます (つまり、変換が行われません)。
Fvals32() は 32 ビット FML で使用されます。
マルチスレッドのアプリケーション内のスレッドは、TPINVALIDCONTEXT を含め、どのようなコンテキスト状態で実行している場合でも、Fvals() または Fvals32() を呼び出すことができます。
戻り値
この関数は、エラーが発生すると NULL を返し、Ferror を設定してエラー条件を示します。
エラー
次の条件の場合、Fvals() は異常終了し、Ferror を次の値に設定します。
バッファが適切なバウンダリで開始していません。
バッファがフィールド化されていないか、または Finit() で初期化されていません。
指定されたフィールド識別子は無効です。
FLD_STRING が誤っている、またはフィールド・タイプが FLD_STRING ではありません。
関連項目
「FML 関数の紹介」、CFfind、CFfind32(3fml)、Ffind、Ffind32(3fml)、Fvall、Fvall32(3fml)
![]() |
![]() |
![]() |
|
Copyright © 2001 BEA Systems, Inc. All rights reserved.
|