![]() |
![]() |
|
|
Funindex、Funindex32(3fml)
名前
Funindex()、Funindex32() - フィールド化バッファのインデックスの破棄
形式
#include <stdio.h>
#include "fml.h"
FLDOCC
Funindex(FBFR *)
#include "fml32.h"
FLDOCC32
Funindex32(FBFR32 *fbfr)
機能説明
Funindex() は、フィールド化バッファのインデックスを破棄します。fbfr は、フィールド化バッファを指すポインタです。この関数が正常終了して戻る場合は、バッファはインデックスなしになります。結果として、インデックスにバッファ領域は割り当てられず、ユーザ・フィールドとして利用可能な領域が増加します。ただし、アクセス時間が遅くなる可能性があります。ディスクに格納する場合、または別の場所に転送する場合は、バッファをインデックスなしにすることが有効です。ディスク格納の場合、ディスク領域が節約され、転送を行う場合、転送コストを減少させることができます。
バッファがインデックスなしになった後、バッファ開始からの上位バイトの数は関数呼び出し Fused(fbfr) によって決定されます。
Funindex32() は 32 ビット FML で使用されます。
マルチスレッドのアプリケーション内のスレッドは、TPINVALIDCONTEXT を含め、どのようなコンテキスト状態で実行している場合でも、Funindex() または Funindex32() を呼び出すことができます。
戻り値
Funindex() は、インデックスが取り除かれる前にバッファが持つインデックスの要素数を返します。
この関数は、エラー発生時に -1 を返し、Ferror を設定してエラー条件を示します。
エラー
次の条件の場合、Funindex() は、異常終了し、Ferror を次の値に設定します。
バッファが適切なバウンダリで開始していません。
バッファがフィールド化されていないか、または Finit() で初期化されていません。
関連項目
「FML 関数の紹介」、Findex、Findex32(3fml)、Frstrindex、Frstrindex32(3fml)、Fsizeof、Fsizeof32(3fml)、Funused、Funused32(3fml)
![]() |
![]() |
![]() |
|
Copyright © 2001 BEA Systems, Inc. All rights reserved.
|