BtrieveBulkRetrieveAttributes クラス

Btrieve 一括取得属性クラス。 [詳解]

#include <btrieveCpp.h>

公開メンバ関数
	BtrieveBulkRetrieveAttributes ()
	~BtrieveBulkRetrieveAttributes ()
Btrieve::StatusCode	AddField (int offset, int length)
	フィールドを追加します。 [詳解]
Btrieve::StatusCode	AddFilter (BtrieveFilter *btrieveFilter)
	フィルターを追加します。 [詳解]
Btrieve::StatusCode	SetMaximumRecordCount (int maximumRecordCount)
	最大レコード数を設定します。 [詳解]
Btrieve::StatusCode	SetMaximumRejectCount (int maximumRejectCount)
	最大リジェクト カウントを設定します。 [詳解]
Btrieve::StatusCode	SetSkipCurrentRecord (bool skipCurrentRecord)
	現在のレコードのスキップを設定します。 [詳解]

詳解

Btrieve 一括取得属性クラス。

各種例:

bfilter.cpp, btestbulk.cpp.

構築子と解体子

BtrieveBulkRetrieveAttributes()

BtrieveBulkRetrieveAttributes::BtrieveBulkRetrieveAttributes

(

)

スニペット

   BtrieveBulkRetrieveAttributes btrieveBulkRetrieveAttributes;

~BtrieveBulkRetrieveAttributes()

BtrieveBulkRetrieveAttributes::~BtrieveBulkRetrieveAttributes

(

)

関数詳解

AddField()

Btrieve::StatusCode BtrieveBulkRetrieveAttributes::AddField	(	int	offset,
		int	length
	)

フィールドを追加します。

引数

[in]	offset	オフセット。オフセットは Btrieve::MAXIMUM_RECORD_LENGTH より小さくなければなりません。
[in]	length	長さ。長さは Btrieve::MAXIMUM_RECORD_LENGTH に制限されています。

説明

初期の状態では、一括取得属性にフィールドは含まれていません。 （オフセット＋長さ）は Btrieve::MAXIMUM_RECORD_LENGTH に制限されています。 追加したすべてのフィールドの長さの合計は Btrieve::MAXIMUM_RECORD_LENGTH に制限されています。

スニペット

   // If AddField() fails.
   if ((status = btrieveBulkRetrieveAttributes.AddField(0, sizeof(record))) != Btrieve::STATUS_CODE_NO_ERROR)
   {
      printf("Error: BtrieveBulkRetrieveAttributes::AddField():%d:%s.\n", status, Btrieve::StatusCodeToString(status));
      goto leave;
   }

戻り値

= Btrieve::STATUS_CODE_NO_ERROR	成功。
!= Btrieve::STATUS_CODE_NO_ERROR	エラーが発生しました。

参照

Btrieve::StatusCodeToString

各種例:

bfilter.cpp, btestbulk.cpp.

AddFilter()

Btrieve::StatusCode BtrieveBulkRetrieveAttributes::AddFilter

(

BtrieveFilter *

btrieveFilter

)

フィルターを追加します。

引数

[in]

btrieveFilter

フィルター。

説明

初期の状態では、一括取得属性にフィルターは含まれていません。

スニペット

   // If AddFilter() fails.
   if ((status = btrieveBulkRetrieveAttributes.AddFilter(&btrieveFilter)) != Btrieve::STATUS_CODE_NO_ERROR)
   {
      printf("Error: BtrieveBulkRetrieveAttributes::AddFilter():%d:%s.\n", status, Btrieve::StatusCodeToString(status));
      goto leave;
   }

戻り値

= Btrieve::STATUS_CODE_NO_ERROR	成功。
!= Btrieve::STATUS_CODE_NO_ERROR	エラーが発生しました。

参照

Btrieve::StatusCodeToString

各種例:

bfilter.cpp, btestbulk.cpp.

SetMaximumRecordCount()

Btrieve::StatusCode BtrieveBulkRetrieveAttributes::SetMaximumRecordCount

(

int

maximumRecordCount

)

最大レコード数を設定します。

引数

[in]

maximumRecordCount

最大レコード数。最大レコード数は、0 より大きく Btrieve::MAXIMUM_BULK_RECORD_COUNT 以下でなければなりません。

説明

最大レコード数のデフォルト値は 0 です。

スニペット

   // If SetMaximumRecordCount() fails.
   if ((status = btrieveBulkRetrieveAttributes.SetMaximumRecordCount(1)) != Btrieve::STATUS_CODE_NO_ERROR)
   {
      printf("Error: BtrieveBulkRetrieveAttributes::SetMaximumRecordCount():%d:%s.\n", status, Btrieve::StatusCodeToString(status));
      goto leave;
   }

戻り値

= Btrieve::STATUS_CODE_NO_ERROR	成功。
!= Btrieve::STATUS_CODE_NO_ERROR	エラーが発生しました。

参照

Btrieve::StatusCodeToString

各種例:

bfilter.cpp, btestbulk.cpp.

SetMaximumRejectCount()

Btrieve::StatusCode BtrieveBulkRetrieveAttributes::SetMaximumRejectCount

(

int

maximumRejectCount

)

最大リジェクト カウントを設定します。

引数

[in]

maximumRejectCount

最大リジェクト カウント。最大リジェクト カウントは、0 以上で 65536 より小さくなければなりません。値 0 は、最大リジェクト カウントを Zen 定義の値に設定します。

説明

最大リジェクト カウントのデフォルト値は Zen 定義値です。

スニペット

   // If SetMaximumRejectCount() fails.
   if ((status = btrieveBulkRetrieveAttributes.SetMaximumRejectCount(MAX_X - MIN_X + 1)) != Btrieve::STATUS_CODE_NO_ERROR)
   {
      printf("Error: BtrieveBulkRetrieveAttributes::SetMaximumRejectCount():%d:%s.\n", status, Btrieve::StatusCodeToString(status));
      goto leave;
   }

戻り値

= Btrieve::STATUS_CODE_NO_ERROR	成功。
!= Btrieve::STATUS_CODE_NO_ERROR	エラーが発生しました。

参照

Btrieve::StatusCodeToString

各種例:

bfilter.cpp, btestbulk.cpp.

SetSkipCurrentRecord()

Btrieve::StatusCode BtrieveBulkRetrieveAttributes::SetSkipCurrentRecord

(

bool

skipCurrentRecord

)

現在のレコードのスキップを設定します。

引数

[in]

skipCurrentRecord

現在のレコードをスキップするかどうか。

説明

デフォルトでは、現在のレコードのスキップは無効になっています。

スニペット

   // If SetSkipCurrentRecord() fails.
   if ((status = btrieveBulkRetrieveAttributes.SetSkipCurrentRecord(false)) != Btrieve::STATUS_CODE_NO_ERROR)
   {
      printf("Error: BtrieveBulkRetrieveAttributes::SetSkipCurrentRecord():%d:%s.\n", status, Btrieve::StatusCodeToString(status));
      goto leave;
   }

戻り値

= Btrieve::STATUS_CODE_NO_ERROR	成功。
!= Btrieve::STATUS_CODE_NO_ERROR	エラーが発生しました。

参照

Btrieve::StatusCodeToString

各種例:

bfilter.cpp, btestbulk.cpp.