Btrieve ファイルクラス。 [詳解]

#include <btrieveCpp.h>

公開メンバ関数
	BtrieveFile ()

	~BtrieveFile ()

Btrieve::StatusCode	BulkCreate (BtrieveBulkCreatePayload btrieveBulkCreatePayload, BtrieveBulkCreateResult btrieveBulkCreateResult)
	一括作成。 [詳解]

Btrieve::StatusCode	BulkRetrieveNext (BtrieveBulkRetrieveAttributes bulkRetrieveAttributes, BtrieveBulkRetrieveResult bulkRetrieveResult, Btrieve::LockMode lockMode=Btrieve::LOCK_MODE_NONE)
	次の一括取得。 [詳解]

Btrieve::StatusCode	BulkRetrievePrevious (BtrieveBulkRetrieveAttributes bulkRetrieveAttributes, BtrieveBulkRetrieveResult bulkRetrieveResult, Btrieve::LockMode lockMode=Btrieve::LOCK_MODE_NONE)
	前の一括取得。 [詳解]

long long	GetCursorPosition ()
	カーソル位置を取得します。 [詳解]

Btrieve::StatusCode	GetInformation (BtrieveFileInformation *btrieveFileInformation)
	ファイル情報を取得します。 [詳解]

Btrieve::StatusCode	GetLastStatusCode ()
	最新のステータスコードを取得します。 [詳解]

int	GetNumerator (long long cursorPosition, int denominator)
	分母に対して、ファイル内のカーソル位置がある場所に最も近似する分子を取得します。 [詳解]

int	GetNumerator (Btrieve::Index index, const char *key, int keyLength, int denominator)
	分母に対して、インデックス内のキーがある場所に最も近似する分子を取得します。 [詳解]

int	GetPercentage (long long cursorPosition)
	ファイル内のカーソル位置がある場所に最も近似するパーセンテージを取得します。 [詳解]

int	GetPercentage (Btrieve::Index index, const char *key, int keyLength)
	指定されたインデックス内のキーがある場所に最も近似するパーセンテージを取得します。 [詳解]

Btrieve::StatusCode	IndexCreate (BtrieveIndexAttributes *btrieveIndexAttributes)
	インデックスを作成します。 [詳解]

Btrieve::StatusCode	IndexDrop (Btrieve::Index index)
	インデックスを削除します。 [詳解]

Btrieve::StatusCode	KeyRetrieve (Btrieve::Comparison comparison, Btrieve::Index index, const char *key, int keyLength)
	指定された比較、インデックス、およびキーを使用して、キーを取得します。 [詳解]

Btrieve::StatusCode	KeyRetrieveFirst (Btrieve::Index index, char *key, int keySize)
	先頭のキーを取得します。 [詳解]

Btrieve::StatusCode	KeyRetrieveLast (Btrieve::Index index, char *key, int keySize)
	末尾のキーを取得します。 [詳解]

Btrieve::StatusCode	KeyRetrieveNext (char *key, int keySize)
	次にあるキーを取得します。 [詳解]

Btrieve::StatusCode	KeyRetrievePrevious (char *key, int keySize)
	前にあるキーを取得します。 [詳解]

Btrieve::StatusCode	RecordAppendChunk (const char *chunk, int chunkLength)
	レコードチャンクを追加します。 [詳解]

Btrieve::StatusCode	RecordCreate (char *record, int recordLength)
	レコードを作成します。 [詳解]

Btrieve::StatusCode	RecordDelete ()
	レコードを削除します。 [詳解]

int	RecordRetrieve (Btrieve::Comparison comparison, Btrieve::Index index, const char key, int keyLength, char record, int recordSize, Btrieve::LockMode lockMode=Btrieve::LOCK_MODE_NONE)
	指定された比較、インデックス、およびキーを使用して、レコードを取得します。 [詳解]

int	RecordRetrieveByCursorPosition (Btrieve::Index index, long long cursorPosition, char *record, int recordSize, Btrieve::LockMode lockMode=Btrieve::LOCK_MODE_NONE)
	カーソル位置によってレコードを取得します。 [詳解]

int	RecordRetrieveByFraction (Btrieve::Index index, int numerator, int denominator, char *record, int recordSize, Btrieve::LockMode lockMode=Btrieve::LOCK_MODE_NONE)
	分数によってレコードを取得します。 [詳解]

int	RecordRetrieveByPercentage (Btrieve::Index index, int percentage, char *record, int recordSize, Btrieve::LockMode lockMode=Btrieve::LOCK_MODE_NONE)
	パーセンテージによってレコードを取得します。 [詳解]

int	RecordRetrieveChunk (int offset, int length, char *chunk, int chunkSize, Btrieve::LockMode lockMode=Btrieve::LOCK_MODE_NONE)
	レコードチャンクを取得します。 [詳解]

int	RecordRetrieveChunk (int length, char *chunk, int chunkSize, Btrieve::LockMode lockMode=Btrieve::LOCK_MODE_NONE)
	現在のオフセットからレコードチャンクを取得します。 [詳解]

int	RecordRetrieveFirst (Btrieve::Index index, char *record, int recordSize, Btrieve::LockMode lockMode=Btrieve::LOCK_MODE_NONE)
	先頭のレコードを取得します。 [詳解]

int	RecordRetrieveLast (Btrieve::Index index, char *record, int recordSize, Btrieve::LockMode lockMode=Btrieve::LOCK_MODE_NONE)
	末尾のレコードを取得します。 [詳解]

int	RecordRetrieveNext (char *record, int recordSize, Btrieve::LockMode lockMode=Btrieve::LOCK_MODE_NONE)
	次にあるレコードを取得します。 [詳解]

int	RecordRetrievePrevious (char *record, int recordSize, Btrieve::LockMode lockMode=Btrieve::LOCK_MODE_NONE)
	前にあるレコードを取得します。 [詳解]

Btrieve::StatusCode	RecordTruncate (int offset)
	レコードを切り詰めます。 [詳解]

Btrieve::StatusCode	RecordTruncate ()
	現在のオフセットでレコードを切り詰めます。 [詳解]

Btrieve::StatusCode	RecordUnlock (Btrieve::UnlockMode unlockMode)
	レコード（複数可）のロックを解除します。 [詳解]

Btrieve::StatusCode	RecordUpdate (const char *record, int recordLength)
	レコードを更新します。 [詳解]

Btrieve::StatusCode	RecordUpdateChunk (int offset, const char *chunk, int chunkLength)
	レコードチャンクを更新します。 [詳解]

Btrieve::StatusCode	RecordUpdateChunk (const char *chunk, int chunkLength)
	現在のオフセットでレコードチャンクを更新します。 [詳解]

Btrieve::StatusCode	SetOwner (Btrieve::OwnerMode ownerMode, const char ownerName=NULL, const char ownerNameAgain=NULL, bool useLongOwnerName=true)
	オーナーを設定します。 [詳解]

Btrieve::StatusCode	UnlockCursorPosition (long long cursorPosition)
	カーソル位置のロックを解除します。 [詳解]

詳解

Btrieve ファイルクラス。

Btrieve ファイル内のレコードを取得、更新、および削除するためには、カーソルが確立されている必要があります。カーソルを確立するために使用されるメソッドの中には、次のものがあります。

確立されると、カーソルはファイル内のレコードをスキャンできるようになります。ファイル中をスキャンするために使用されるメソッドの中には、次のものがあります。

カーソルを繰り返し再確立することができます。

各種例:: bfileattributes.cpp, bfileinformation.cpp, bfilter.cpp, bindexattributes.cpp, bkeyonly.cpp, block.cpp, bpercentage.cpp, btest.cpp, btestappend.cpp, btestbulk.cpp, btestchunk.cpp, btestvlr.cpp, Test_BTRV2.cpp.

構築子と解体子

◆ BtrieveFile()

BtrieveFile::BtrieveFile ( )

スニペット: BtrieveFile btrieveFile;

参照: BtrieveClient::FileOpen

◆ ~BtrieveFile()

BtrieveFile::~BtrieveFile ( )

参照: BtrieveClient::FileClose

関数詳解

◆ BulkCreate()

Btrieve::StatusCode BtrieveFile::BulkCreate	(	BtrieveBulkCreatePayload *	btrieveBulkCreatePayload,
		BtrieveBulkCreateResult *	btrieveBulkCreateResult
	)

一括作成。

引数

[in]	btrieveBulkCreatePayload	一括作成ペイロード。
[out]	btrieveBulkCreateResult	一括作成結果。

スニペット: // If BulkCreate() fails.
if ((status = btrieveFile->BulkCreate(&btrieveBulkCreatePayload, &btrieveBulkCreateResult)) != Btrieve::STATUS_CODE_NO_ERROR)
{
printf("Error: BtrieveFile::BulkCreate():%d:%s.\n", status, Btrieve::StatusCodeToString(status));
goto leave;
}

カーソル: カーソルは影響を受けません。

現在のオフセット: 現在のオフセットは影響を受けません。

戻り値

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

参照: Btrieve::StatusCodeToString

各種例:: btestbulk.cpp.

◆ BulkRetrieveNext()

Btrieve::StatusCode BtrieveFile::BulkRetrieveNext	(	BtrieveBulkRetrieveAttributes *	bulkRetrieveAttributes,
		BtrieveBulkRetrieveResult *	bulkRetrieveResult,
		Btrieve::LockMode	lockMode = `Btrieve::LOCK_MODE_NONE`
	)

次の一括取得。

引数

[in]	bulkRetrieveAttributes	一括取得属性。
[out]	bulkRetrieveResult	一括取得結果。
[in]	lockMode	ロックモード。

スニペット: // If BulkRetrieveNext() fails.
if ((status = btrieveFile->BulkRetrieveNext(&btrieveBulkRetrieveAttributes, &btrieveBulkRetrieveResult)) != Btrieve::STATUS_CODE_NO_ERROR)
{
printf("Error: BtrieveFile::BulkRetrieveNext():%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.

◆ BulkRetrievePrevious()

Btrieve::StatusCode BtrieveFile::BulkRetrievePrevious	(	BtrieveBulkRetrieveAttributes *	bulkRetrieveAttributes,
		BtrieveBulkRetrieveResult *	bulkRetrieveResult,
		Btrieve::LockMode	lockMode = `Btrieve::LOCK_MODE_NONE`
	)

前の一括取得。

引数

[in]	bulkRetrieveAttributes	一括取得属性。
[out]	bulkRetrieveResult	一括取得結果。
[in]	lockMode	ロックモード。

カーソル: カーソルが確立されている必要があります。カーソルは、最後に調べたレコードから後方へ移動されます。

現在のオフセット: 現在のオフセットは破棄されます。

戻り値

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

参照: Btrieve::StatusCodeToString

◆ GetCursorPosition()

long long BtrieveFile::GetCursorPosition ( )

カーソル位置を取得します。

覚え書き: このメソッドの署名は PSQL v13 R2 で変更されました。

スニペット: // If GetCursorPosition() fails.
if ((cursorPosition = btrieveFile->GetCursorPosition()) == -1)
{
status = btrieveFile->GetLastStatusCode();
printf("Error: BtrieveFile::GetCursorPosition():%d:%s.\n", status, Btrieve::StatusCodeToString(status));
goto leave;
}

カーソル: カーソルは影響を受けませんが、確立されている必要があります。

現在のオフセット: 現在のオフセットは影響を受けません。

戻り値

>= 0	カーソル位置。
-1	エラーが発生しました。エラーに関連する Btrieve::StatusCode を特定するには、BtrieveFile::GetLastStatusCode を使用します。

各種例:: bpercentage.cpp.

◆ GetInformation()

Btrieve::StatusCode BtrieveFile::GetInformation ( BtrieveFileInformation * btrieveFileInformation )

ファイル情報を取得します。

引数

[out] btrieveFileInformation ファイル情報。

スニペット: // If GetInformation() fails.
if ((status = btrieveFile->GetInformation(&btrieveFileInformation)) != Btrieve::STATUS_CODE_NO_ERROR)
{
printf("Error: BtrieveFile::GetInformation():%d:%s.\n", status, Btrieve::StatusCodeToString(status));
goto leave;
}

カーソル: カーソルは影響を受けません。

現在のオフセット: 現在のオフセットは影響を受けません。

戻り値

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

参照: Btrieve::StatusCodeToString

各種例:: bfileattributes.cpp, bfileinformation.cpp.

◆ GetLastStatusCode()

Btrieve::StatusCode BtrieveFile::GetLastStatusCode ( )

最新のステータスコードを取得します。

覚え書き: このメソッドは、ステータスコードを返さない以下のメソッドでの使用を目的としています。

スニペット: // If RecordRetrieve() fails.
if (btrieveFile->RecordRetrieve(Btrieve::COMPARISON_EQUAL, Btrieve::INDEX_1, (char *)key, sizeof(*key), (char *)&record, sizeof(record)) != sizeof(record))
{
status = btrieveFile->GetLastStatusCode();
printf("Error: BtrieveFile::RecordRetrieve():%d:%s.\n", status, Btrieve::StatusCodeToString(status));
goto leave;
}

カーソル: カーソルは影響を受けません。

現在のオフセット: 現在のオフセットは影響を受けません。

戻り値

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

参照: Btrieve::StatusCodeToString

各種例:: bfilter.cpp, bindexattributes.cpp, block.cpp, bpercentage.cpp, btest.cpp, btestappend.cpp, btestbulk.cpp, btestchunk.cpp, btestvlr.cpp, Test_BTRV2.cpp.

◆ GetNumerator() [1/2]

int BtrieveFile::GetNumerator	(	long long	cursorPosition,
		int	denominator
	)

分母に対して、ファイル内のカーソル位置がある場所に最も近似する分子を取得します。

覚え書き: このメソッドの署名は PSQL v13 R2 で変更されました。

引数

[in]	cursorPosition	カーソル位置。
[in]	denominator	分母。

スニペット: // If GetNumerator() fails.
if ((numerator = btrieveFile->GetNumerator(cursorPosition, NUMBER_OF_RECORDS)) == -1)
{
status = btrieveFile->GetLastStatusCode();
printf("Error: BtrieveFile::GetNumerator():%d:%s.\n", status, Btrieve::StatusCodeToString(status));
goto leave;
}

カーソル: カーソルは影響を受けません。

現在のオフセット: 現在のオフセットは影響を受けません。

戻り値

>= 0	分子。0 から分母までで返されます。
-1	エラーが発生しました。エラーに関連する Btrieve::StatusCode を特定するには、BtrieveFile::GetLastStatusCode を使用します。

各種例:: bpercentage.cpp.

◆ GetNumerator() [2/2]

int BtrieveFile::GetNumerator	(	Btrieve::Index	index,
		const char *	key,
		int	keyLength,
		int	denominator
	)

分母に対して、インデックス内のキーがある場所に最も近似する分子を取得します。

引数

[in]	index	インデックス。
[in]	key	キー。
[in]	keyLength	キーの長さ。
[in]	denominator	分母。

スニペット: // If GetNumerator() fails.
if ((numerator = btrieveFile->GetNumerator(Btrieve::INDEX_1, (char *)&key, sizeof(key), NUMBER_OF_RECORDS)) == -1)
{
status = btrieveFile->GetLastStatusCode();
printf("Error: BtrieveFile::GetNumerator():%d:%s.\n", status, Btrieve::StatusCodeToString(status));
goto leave;
}

カーソル: カーソルは影響を受けません。

現在のオフセット: 現在のオフセットは影響を受けません。

戻り値

>= 0	分子。0 から分母までで返されます。
-1	エラーが発生しました。エラーに関連する Btrieve::StatusCode を特定するには、BtrieveFile::GetLastStatusCode を使用します。

◆ GetPercentage() [1/2]

int BtrieveFile::GetPercentage ( long long cursorPosition )

ファイル内のカーソル位置がある場所に最も近似するパーセンテージを取得します。

覚え書き: このメソッドの署名は PSQL v13 R2 で変更されました。

引数

[in] cursorPosition カーソル位置。

スニペット: // If GetPercentage() fails.
if ((percentage = btrieveFile->GetPercentage(cursorPosition)) == -1)
{
status = btrieveFile->GetLastStatusCode();
printf("Error: BtrieveFile::GetPercentage():%d:%s.\n", status, Btrieve::StatusCodeToString(status));
goto leave;
}

カーソル: カーソルは影響を受けません。

現在のオフセット: 現在のオフセットは影響を受けません。

戻り値

>= 0	パーセンテージ。0 から 10,000（0% から 100.00% に相当）で返されます。
-1	エラーが発生しました。エラーに関連する Btrieve::StatusCode を特定するには、BtrieveFile::GetLastStatusCode を使用します。

各種例:: bpercentage.cpp.

◆ GetPercentage() [2/2]

int BtrieveFile::GetPercentage	(	Btrieve::Index	index,
		const char *	key,
		int	keyLength
	)

指定されたインデックス内のキーがある場所に最も近似するパーセンテージを取得します。

引数

[in]	index	インデックス。
[in]	key	キー。
[in]	keyLength	キーの長さ。

スニペット: // If GetPercentage() fails.
if ((percentage = btrieveFile->GetPercentage(Btrieve::INDEX_1, (char *)&key, sizeof(key))) == -1)
{
status = btrieveFile->GetLastStatusCode();
printf("Error: BtrieveFile::GetPercentage():%d:%s.\n", status, Btrieve::StatusCodeToString(status));
goto leave;
}

カーソル: カーソルは影響を受けません。

現在のオフセット: 現在のオフセットは影響を受けません。

戻り値

>= 0	パーセンテージ。0 から 10,000（0% から 100.00% に相当）で返されます。
-1	エラーが発生しました。エラーに関連する Btrieve::StatusCode を特定するには、BtrieveFile::GetLastStatusCode を使用します。

◆ IndexCreate()

Btrieve::StatusCode BtrieveFile::IndexCreate ( BtrieveIndexAttributes * btrieveIndexAttributes )

インデックスを作成します。

引数

[in] btrieveIndexAttributes インデックス属性。

スニペット: // If IndexCreate() fails.
if ((status = btrieveFile->IndexCreate(&btrieveIndexAttributes)) != Btrieve::STATUS_CODE_NO_ERROR)
{
printf("Error: BtrieveFile::IndexCreate():%d:%s.\n", status, Btrieve::StatusCodeToString(status));
goto leave;
}

カーソル: カーソルは影響を受けません。

現在のオフセット: 現在のオフセットは影響を受けません。

戻り値

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

参照: Btrieve::StatusCodeToString

各種例:: bfilter.cpp, bindexattributes.cpp, block.cpp, bpercentage.cpp, btest.cpp, btestvlr.cpp, Test_BTRV2.cpp.

◆ IndexDrop()

Btrieve::StatusCode BtrieveFile::IndexDrop ( Btrieve::Index index )

インデックスを削除します。

引数

[in] index インデックス。

カーソル: カーソルインデックスが削除された場合、カーソルは破棄されます。そうでない場合、カーソルは影響を受けません。

現在のオフセット: 現在のオフセットは影響を受けません。

戻り値

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

参照: Btrieve::StatusCodeToString

◆ KeyRetrieve()

Btrieve::StatusCode BtrieveFile::KeyRetrieve	(	Btrieve::Comparison	comparison,
		Btrieve::Index	index,
		const char *	key,
		int	keyLength
	)

指定された比較、インデックス、およびキーを使用して、キーを取得します。

引数

[in]	comparison	比較。Btrieve::COMPARISON_NOT_EQUAL はサポートされていません。
[in]	index	インデックス。
[in]	key	キー。
[in]	keyLength	キーの長さ。

スニペット: // If KeyRetrieve() fails.
if ((status = btrieveFile->KeyRetrieve(Btrieve::COMPARISON_EQUAL, Btrieve::INDEX_1, (char *)key, sizeof(*key))) == Btrieve::STATUS_CODE_NO_ERROR)
{
printf("%u is prime.\n", *key);
goto leave;
}
if (status == Btrieve::STATUS_CODE_KEY_VALUE_NOT_FOUND)
{
printf("%u is not prime.\n", *key);
status = Btrieve::STATUS_CODE_NO_ERROR;
goto leave;
}
printf("Error: BtrieveClient::KeyRetrieve():%d:%s.\n", status, Btrieve::StatusCodeToString(status));

カーソル: カーソルが確立されます。

現在のオフセット: 現在のオフセットは破棄されます。

戻り値

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

参照: Btrieve::StatusCodeToString

各種例:: bkeyonly.cpp.

◆ KeyRetrieveFirst()

Btrieve::StatusCode BtrieveFile::KeyRetrieveFirst	(	Btrieve::Index	index,
		char *	key,
		int	keySize
	)

先頭のキーを取得します。

引数

[in]	index	インデックス。
[out]	key	キー。
[in]	keySize	キーサイズ。

カーソル: カーソルが確立されます。

現在のオフセット: 現在のオフセットは破棄されます。

戻り値

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

参照: Btrieve::StatusCodeToString

◆ KeyRetrieveLast()

Btrieve::StatusCode BtrieveFile::KeyRetrieveLast	(	Btrieve::Index	index,
		char *	key,
		int	keySize
	)

末尾のキーを取得します。

引数

[in]	index	インデックス。
[out]	key	キー。
[in]	keySize	キーサイズ。

カーソル: カーソルが確立されます。

現在のオフセット: 現在のオフセットは破棄されます。

戻り値

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

参照: Btrieve::StatusCodeToString

◆ KeyRetrieveNext()

Btrieve::StatusCode BtrieveFile::KeyRetrieveNext	(	char *	key,
		int	keySize
	)

次にあるキーを取得します。

引数

[out]	key	キー。
[in]	keySize	キーサイズ。

カーソル: カーソルが確立されている必要があります。カーソルは 1 つ前方のキーに移動されます。

現在のオフセット: 現在のオフセットは破棄されます。

戻り値

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

参照: Btrieve::StatusCodeToString

◆ KeyRetrievePrevious()

Btrieve::StatusCode BtrieveFile::KeyRetrievePrevious	(	char *	key,
		int	keySize
	)

前にあるキーを取得します。

引数

[out]	key	キー。
[in]	keySize	キーサイズ。

カーソル: カーソルが確立されている必要があります。カーソルは 1 つ後方のキーに移動されます。

現在のオフセット: 現在のオフセットは破棄されます。

戻り値

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

参照: Btrieve::StatusCodeToString

◆ RecordAppendChunk()

Btrieve::StatusCode BtrieveFile::RecordAppendChunk	(	const char *	chunk,
		int	chunkLength
	)

レコードチャンクを追加します。

引数

[in]	chunk	チャンク。
[in]	chunkLength	チャンクの長さ。

スニペット: // If RecordAppendChunk() fails.
if ((status = btrieveFile->RecordAppendChunk((char *)&chunk, sizeof(chunk))) != Btrieve::STATUS_CODE_NO_ERROR)
{
printf("Error: BtrieveFile::RecordAppendChunk():%d:%s.\n", status, Btrieve::StatusCodeToString(status));
goto leave;
}

カーソル: カーソルは影響を受けませんが、確立されている必要があります。

現在のオフセット: 現在のオフセットは、追加されたチャンクの末尾に確立されます。

戻り値

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

参照: Btrieve::StatusCodeToString

各種例:: btestappend.cpp.

◆ RecordCreate()

Btrieve::StatusCode BtrieveFile::RecordCreate	(	char *	record,
		int	recordLength
	)

レコードを作成します。

覚え書き: このメソッドの署名は PSQL v13 R2 で変更されました。

引数

[in,out]	record	レコード。現在のレコードに Btrieve::DATA_TYPE_AUTOINCREMENT キーまたは Btrieve::DATA_TYPE_AUTOTIMESTAMP キーのセグメントが含まれている場合、渡されるレコードは変更される可能性があります。
[in]	recordLength	レコード長。レコード長は、Btrieve::MAXIMUM_RECORD_LENGTH に制限されています。Btrieve::MAXIMUM_RECORD_LENGTH よりも長いレコードを作成する方法については、BtrieveFile::RecordAppendChunk を参照してください。

スニペット: // If RecordCreate() fails.
if ((status = btrieveFile->RecordCreate((char *)&record, sizeof(record))) != Btrieve::STATUS_CODE_NO_ERROR)
{
printf("Error: BtrieveFile::RecordCreate():%d:%s.\n", status, Btrieve::StatusCodeToString(status));
goto leave;
}

カーソル: カーソルは影響を受けません。

現在のオフセット: 現在のオフセットは影響を受けません。

戻り値

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

参照: Btrieve::StatusCodeToString

各種例:: bfilter.cpp, bindexattributes.cpp, bkeyonly.cpp, block.cpp, bpercentage.cpp, btest.cpp, btestappend.cpp, btestchunk.cpp, btestvlr.cpp, Test_BTRV2.cpp.

◆ RecordDelete()

Btrieve::StatusCode BtrieveFile::RecordDelete ( )

レコードを削除します。

スニペット: // If RecordDelete() fails.
if ((status = btrieveFile->RecordDelete()) != Btrieve::STATUS_CODE_NO_ERROR)
{
printf("Error: BtrieveFile::RecordDelete():%d:%s.\n", status, Btrieve::StatusCodeToString(status));
goto leave;
}

カーソル: カーソルは影響を受けませんが、確立されている必要があります。

現在のオフセット: 現在のオフセットは破棄されます。

戻り値

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

参照: Btrieve::StatusCodeToString

各種例:: bkeyonly.cpp.

◆ RecordRetrieve()

int BtrieveFile::RecordRetrieve	(	Btrieve::Comparison	comparison,
		Btrieve::Index	index,
		const char *	key,
		int	keyLength,
		char *	record,
		int	recordSize,
		Btrieve::LockMode	lockMode = `Btrieve::LOCK_MODE_NONE`
	)

指定された比較、インデックス、およびキーを使用して、レコードを取得します。

覚え書き: このメソッドは Btrieve::StatusCode を返しません。詳細については、以下を参照してください。

引数

[in]	comparison	比較。Btrieve::COMPARISON_NOT_EQUAL はサポートされていません。
[in]	index	インデックス。
[in]	key	キー。
[in]	keyLength	キーの長さ。
[out]	record	レコード。
[in]	recordSize	レコードサイズ。
[in]	lockMode	ロックモード。

スニペット: // If RecordRetrieve() fails.
if (btrieveFile->RecordRetrieve(Btrieve::COMPARISON_EQUAL, Btrieve::INDEX_1, (char *)key, sizeof(*key), (char *)&record, sizeof(record)) != sizeof(record))
{
status = btrieveFile->GetLastStatusCode();
printf("Error: BtrieveFile::RecordRetrieve():%d:%s.\n", status, Btrieve::StatusCodeToString(status));
goto leave;
}

カーソル: カーソルが確立されます。

現在のオフセット: 現在のオフセットは破棄されます。

戻り値

>= 0 読み取られるバイト数。読み取られるバイト数は、Btrieve::MAXIMUM_RECORD_LENGTH に制限されています。長さが Btrieve::MAXIMUM_RECORD_LENGTH より大きいレコードの取得については、BtrieveFile::RecordRetrieveChunk を参照してください。要求されたレコードサイズが現在のレコードの長さより小さい場合、BtrieveFile::GetLastStatusCode は Btrieve::STATUS_CODE_DATALENGTH_ERROR を返します。

-1 エラーが発生しました。エラーに関連する Btrieve::StatusCode を特定するには、BtrieveFile::GetLastStatusCode を使用します。

各種例:: bkeyonly.cpp, btest.cpp, btestvlr.cpp.

◆ RecordRetrieveByCursorPosition()

int BtrieveFile::RecordRetrieveByCursorPosition	(	Btrieve::Index	index,
		long long	cursorPosition,
		char *	record,
		int	recordSize,
		Btrieve::LockMode	lockMode = `Btrieve::LOCK_MODE_NONE`
	)

カーソル位置によってレコードを取得します。

覚え書き: このメソッドは Btrieve::StatusCode を返しません。詳細については、以下を参照してください。; このメソッドの署名は PSQL v13 R2 で変更されました。

引数

[in]	index	インデックスまたは Btrieve::INDEX_NONE。
[in]	cursorPosition	カーソル位置。
[out]	record	レコード。
[in]	recordSize	レコードサイズ。
[in]	lockMode	ロックモード。

スニペット: // If RecordRetrieveByCursorPosition() fails.
if (btrieveFile->RecordRetrieveByCursorPosition(Btrieve::INDEX_1, cursorPosition, (char *)&record, sizeof(record)) != sizeof(record))
{
printf("Error: BtrieveFileAttributes::RecordRetrieveByCursorPosition():%d:%s.\n", status, Btrieve::StatusCodeToString(status));
goto leave;
}

カーソル: カーソルが確立されます。

現在のオフセット: 現在のオフセットは破棄されます。

戻り値

>= 0 読み取られるバイト数。読み取られるバイト数は、Btrieve::MAXIMUM_RECORD_LENGTH に制限されています。長さが Btrieve::MAXIMUM_RECORD_LENGTH より大きいレコードの取得については、BtrieveFile::RecordRetrieveChunk を参照してください。要求されたレコードサイズが現在のレコードの長さより小さい場合、BtrieveFile::GetLastStatusCode は Btrieve::STATUS_CODE_DATALENGTH_ERROR を返します。

-1 エラーが発生しました。エラーに関連する Btrieve::StatusCode を特定するには、BtrieveFile::GetLastStatusCode を使用します。

各種例:: bpercentage.cpp.

◆ RecordRetrieveByFraction()

int BtrieveFile::RecordRetrieveByFraction	(	Btrieve::Index	index,
		int	numerator,
		int	denominator,
		char *	record,
		int	recordSize,
		Btrieve::LockMode	lockMode = `Btrieve::LOCK_MODE_NONE`
	)

分数によってレコードを取得します。

覚え書き: このメソッドは Btrieve::StatusCode を返しません。詳細については、以下を参照してください。

引数

[in]	index	インデックスまたは Btrieve::INDEX_NONE。
[in]	numerator	分子。0 から分母までで指定します。
[in]	denominator	分母。
[out]	record	レコード。
[in]	recordSize	レコードサイズ。
[in]	lockMode	ロックモード。

スニペット: // If RecordRetrieveByFraction() fails.
if (btrieveFile->RecordRetrieveByFraction(Btrieve::INDEX_1, NUMBER_OF_RECORDS / 2, NUMBER_OF_RECORDS, (char *)&record, sizeof(record)) != sizeof(record))
{
status = btrieveFile->GetLastStatusCode();
printf("Error: BtrieveFile::RecordRetrieveByFraction():%d:%s.\n", status, Btrieve::StatusCodeToString(status));
goto leave;
}

カーソル: カーソルが確立されます。

現在のオフセット: 現在のオフセットは破棄されます。

戻り値

>= 0 読み取られるバイト数。読み取られるバイト数は、Btrieve::MAXIMUM_RECORD_LENGTH に制限されています。長さが Btrieve::MAXIMUM_RECORD_LENGTH より大きいレコードの取得については、BtrieveFile::RecordRetrieveChunk を参照してください。要求されたレコードサイズが現在のレコードの長さより小さい場合、BtrieveFile::GetLastStatusCode は Btrieve::STATUS_CODE_DATALENGTH_ERROR を返します。

-1 エラーが発生しました。エラーに関連する Btrieve::StatusCode を特定するには、BtrieveFile::GetLastStatusCode を使用します。

各種例:: bpercentage.cpp.

◆ RecordRetrieveByPercentage()

int BtrieveFile::RecordRetrieveByPercentage	(	Btrieve::Index	index,
		int	percentage,
		char *	record,
		int	recordSize,
		Btrieve::LockMode	lockMode = `Btrieve::LOCK_MODE_NONE`
	)

パーセンテージによってレコードを取得します。

覚え書き: このメソッドは Btrieve::StatusCode を返しません。詳細については、以下を参照してください。

引数

[in]	index	インデックスまたは Btrieve::INDEX_NONE。
[in]	percentage	パーセンテージ。0 から 10,000（0% から 100.00% に相当）で指定します。
[out]	record	レコード。
[in]	recordSize	レコードサイズ。
[in]	lockMode	ロックモード。

スニペット: // If RecordRetrieveByPercentage() fails.
if (btrieveFile->RecordRetrieveByPercentage(Btrieve::INDEX_1, 5000, (char *)&record, sizeof(record)) != sizeof(record))
{
status = btrieveFile->GetLastStatusCode();
printf("Error: BtrieveFile::RecordRetrieveByPercentage():%d:%s.\n", status, Btrieve::StatusCodeToString(status));
goto leave;
}

カーソル: カーソルが確立されます。

現在のオフセット: 現在のオフセットは破棄されます。

戻り値

>= 0 読み取られるバイト数。読み取られるバイト数は、Btrieve::MAXIMUM_RECORD_LENGTH に制限されています。長さが Btrieve::MAXIMUM_RECORD_LENGTH より大きいレコードの取得については、BtrieveFile::RecordRetrieveChunk を参照してください。要求されたレコードサイズが現在のレコードの長さより小さい場合、BtrieveFile::GetLastStatusCode は Btrieve::STATUS_CODE_DATALENGTH_ERROR を返します。

-1 エラーが発生しました。エラーに関連する Btrieve::StatusCode を特定するには、BtrieveFile::GetLastStatusCode を使用します。

各種例:: bpercentage.cpp.

◆ RecordRetrieveChunk() [1/2]

int BtrieveFile::RecordRetrieveChunk	(	int	offset,
		int	length,
		char *	chunk,
		int	chunkSize,
		Btrieve::LockMode	lockMode = `Btrieve::LOCK_MODE_NONE`
	)

レコードチャンクを取得します。

覚え書き: このメソッドは Btrieve::StatusCode を返しません。詳細については、以下を参照してください。

引数

[in]	offset	オフセット。
[in]	length	長さ。
[out]	chunk	チャンク。
[in]	chunkSize	チャンクサイズ。
[in]	lockMode	ロックモード。

スニペット: // If RecordRetrieveChunk() fails.
if (btrieveFile->RecordRetrieveChunk(0, sizeof(chunk), (char *)&chunk, sizeof(chunk)) != sizeof(chunk))
{
status = btrieveFile->GetLastStatusCode();
printf("Error: BtrieveFile::RecordRetrieveChunk():%d:%s.\n", status, Btrieve::StatusCodeToString(status));
goto leave;
}

カーソル: カーソルは影響を受けませんが、確立されている必要があります。

現在のオフセット: 現在のオフセットは、取得されたチャンクの末尾に確立されます。

戻り値

>= 0	読み取られるバイト数。複数のチャンクを取得できます。
-1	エラーが発生しました。エラーに関連する Btrieve::StatusCode を特定するには、BtrieveFile::GetLastStatusCode を使用します。

各種例:: btestappend.cpp, btestchunk.cpp.

◆ RecordRetrieveChunk() [2/2]

int BtrieveFile::RecordRetrieveChunk	(	int	length,
		char *	chunk,
		int	chunkSize,
		Btrieve::LockMode	lockMode = `Btrieve::LOCK_MODE_NONE`
	)

現在のオフセットからレコードチャンクを取得します。

覚え書き: このメソッドは Btrieve::StatusCode を返しません。詳細については、以下を参照してください。

引数

[in]	length	長さ。
[out]	chunk	チャンク。
[in]	chunkSize	チャンクサイズ。
[in]	lockMode	ロックモード。

スニペット: // If RecordRetrieveChunk() fails.
if (btrieveFile->RecordRetrieveChunk(sizeof(chunk), (char *)&chunk, sizeof(chunk)) != sizeof(chunk))
{
status = btrieveFile->GetLastStatusCode();
printf("Error: BtrieveFile::RecordRetrieveChunk():%d:%s.\n", status, Btrieve::StatusCodeToString(status));
goto leave;
}

カーソル: カーソルは影響を受けませんが、確立されている必要があります。

現在のオフセット: 現在のオフセットは確立されている必要があり、取得されたチャンクの末尾へ移動されます。

戻り値

>= 0	読み取られるバイト数。複数のチャンクを取得できます。
-1	エラーが発生しました。エラーに関連する Btrieve::StatusCode を特定するには、BtrieveFile::GetLastStatusCode を使用します。

◆ RecordRetrieveFirst()

int BtrieveFile::RecordRetrieveFirst	(	Btrieve::Index	index,
		char *	record,
		int	recordSize,
		Btrieve::LockMode	lockMode = `Btrieve::LOCK_MODE_NONE`
	)

先頭のレコードを取得します。

覚え書き: このメソッドは Btrieve::StatusCode を返しません。詳細については、以下を参照してください。

引数

[in]	index	インデックスまたは Btrieve::INDEX_NONE。
[out]	record	レコード。
[in]	recordSize	レコードサイズ。
[in]	lockMode	ロックモード。

スニペット: // If RecordRetrieveFirst() fails.
if (btrieveFile->RecordRetrieveFirst(Btrieve::INDEX_NONE, (char *)&record, sizeof(record)) != sizeof(record))
{
status = btrieveFile->GetLastStatusCode();
printf("Error: BtrieveFile::RecordRetrieveFirst():%d:%s.\n", status, Btrieve::StatusCodeToString(status));
goto leave;
}

カーソル: カーソルが確立されます。

現在のオフセット: 現在のオフセットは破棄されます。

戻り値

>= 0 読み取られるバイト数。読み取られるバイト数は、Btrieve::MAXIMUM_RECORD_LENGTH に制限されています。長さが Btrieve::MAXIMUM_RECORD_LENGTH より大きいレコードの取得については、BtrieveFile::RecordRetrieveChunk を参照してください。要求されたレコードサイズが現在のレコードの長さより小さい場合、BtrieveFile::GetLastStatusCode は Btrieve::STATUS_CODE_DATALENGTH_ERROR を返します。

-1 エラーが発生しました。エラーに関連する Btrieve::StatusCode を特定するには、BtrieveFile::GetLastStatusCode を使用します。

各種例:: bfilter.cpp, bindexattributes.cpp, block.cpp, bpercentage.cpp, btestappend.cpp, btestbulk.cpp, btestchunk.cpp.

◆ RecordRetrieveLast()

int BtrieveFile::RecordRetrieveLast	(	Btrieve::Index	index,
		char *	record,
		int	recordSize,
		Btrieve::LockMode	lockMode = `Btrieve::LOCK_MODE_NONE`
	)

末尾のレコードを取得します。

覚え書き: このメソッドは Btrieve::StatusCode を返しません。詳細については、以下を参照してください。

引数

[in]	index	インデックスまたは Btrieve::INDEX_NONE。
[out]	record	レコード。
[in]	recordSize	レコードサイズ。
[in]	lockMode	ロックモード。

スニペット: // If RecordRetrieveLast() fails.
if (btrieveFile->RecordRetrieveLast(Btrieve::INDEX_1, (char *)&record, sizeof(record)) != sizeof(record))
{
status = btrieveFile->GetLastStatusCode();
printf("Error: BtrieveFile::RecordRetrieveLast():%d:%s.\n", status, Btrieve::StatusCodeToString(status));
goto leave;
}

カーソル: カーソルが確立されます。

現在のオフセット: 現在のオフセットは破棄されます。

戻り値

>= 0 読み取られるバイト数。読み取られるバイト数は、Btrieve::MAXIMUM_RECORD_LENGTH に制限されています。長さが Btrieve::MAXIMUM_RECORD_LENGTH より大きいレコードの取得については、BtrieveFile::RecordRetrieveChunk を参照してください。要求されたレコードサイズが現在のレコードの長さより小さい場合、BtrieveFile::GetLastStatusCode は Btrieve::STATUS_CODE_DATALENGTH_ERROR を返します。

-1 エラーが発生しました。エラーに関連する Btrieve::StatusCode を特定するには、BtrieveFile::GetLastStatusCode を使用します。

各種例:: bpercentage.cpp, Test_BTRV2.cpp.

◆ RecordRetrieveNext()

int BtrieveFile::RecordRetrieveNext	(	char *	record,
		int	recordSize,
		Btrieve::LockMode	lockMode = `Btrieve::LOCK_MODE_NONE`
	)

次にあるレコードを取得します。

覚え書き: このメソッドは Btrieve::StatusCode を返しません。詳細については、以下を参照してください。

引数

[out]	record	レコード。
[in]	recordSize	レコードサイズ。
[in]	lockMode	ロックモード。

スニペット: // If RecordRetrieveNext() fails.
if (btrieveFile->RecordRetrieveNext((char *)&record, sizeof(record)) != sizeof(record))
{
status = btrieveFile->GetLastStatusCode();
printf("Error: BtrieveFile::RecordRetrieveNext():%d:%s.\n", status, Btrieve::StatusCodeToString(status));
goto leave;
}
}

カーソル: カーソルが確立されている必要があります。カーソルは 1 つ前方のレコードに移動されます。

現在のオフセット: 現在のオフセットは破棄されます。

戻り値

>= 0 読み取られるバイト数。読み取られるバイト数は、Btrieve::MAXIMUM_RECORD_LENGTH に制限されています。長さが Btrieve::MAXIMUM_RECORD_LENGTH より大きいレコードの取得については、BtrieveFile::RecordRetrieveChunk を参照してください。要求されたレコードサイズが現在のレコードの長さより小さい場合、BtrieveFile::GetLastStatusCode は Btrieve::STATUS_CODE_DATALENGTH_ERROR を返します。

-1 エラーが発生しました。エラーに関連する Btrieve::StatusCode を特定するには、BtrieveFile::GetLastStatusCode を使用します。

各種例:: bindexattributes.cpp.

◆ RecordRetrievePrevious()

int BtrieveFile::RecordRetrievePrevious	(	char *	record,
		int	recordSize,
		Btrieve::LockMode	lockMode = `Btrieve::LOCK_MODE_NONE`
	)

前にあるレコードを取得します。

覚え書き: このメソッドは Btrieve::StatusCode を返しません。詳細については、以下を参照してください。

引数

[out]	record	レコード。
[in]	recordSize	レコードサイズ。
[in]	lockMode	ロックモード。

カーソル: カーソルが確立されている必要があります。カーソルは 1 つ後方のレコードに移動されます。

現在のオフセット: 現在のオフセットは破棄されます。

戻り値

>= 0 読み取られるバイト数。読み取られるバイト数は、Btrieve::MAXIMUM_RECORD_LENGTH に制限されています。長さが Btrieve::MAXIMUM_RECORD_LENGTH より大きいレコードの取得については、BtrieveFile::RecordRetrieveChunk を参照してください。要求されたレコードサイズが現在のレコードの長さより小さい場合、BtrieveFile::GetLastStatusCode は Btrieve::STATUS_CODE_DATALENGTH_ERROR を返します。

-1 エラーが発生しました。エラーに関連する Btrieve::StatusCode を特定するには、BtrieveFile::GetLastStatusCode を使用します。

◆ RecordTruncate() [1/2]

Btrieve::StatusCode BtrieveFile::RecordTruncate ( int offset )

レコードを切り詰めます。

引数

[in] offset オフセット。

カーソル: カーソルは影響を受けませんが、確立されている必要があります。

現在のオフセット: 現在のオフセットは、レコードの末尾に確立されます。

戻り値

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

◆ RecordTruncate() [2/2]

Btrieve::StatusCode BtrieveFile::RecordTruncate ( )

現在のオフセットでレコードを切り詰めます。

カーソル: カーソルは影響を受けませんが、確立されている必要があります。

現在のオフセット: 現在のオフセットは確立されている必要があり、変更されません。

戻り値

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

◆ RecordUnlock()

Btrieve::StatusCode BtrieveFile::RecordUnlock ( Btrieve::UnlockMode unlockMode )

レコード（複数可）のロックを解除します。

引数

[in] unlockMode ロック解除モード。

スニペット: // If RecordUnlock() fails.
if ((status = btrieveFile->RecordUnlock(Btrieve::UNLOCK_MODE_SINGLE)) != Btrieve::STATUS_CODE_NO_ERROR)
{
printf("Error: BtrieveFile::RecordUnlock():%d:%s.\n", status, Btrieve::StatusCodeToString(status));
goto leave;
}

カーソル: カーソルは影響を受けません。

現在のオフセット: 現在のオフセットは影響を受けません。

戻り値

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

参照: Btrieve::StatusCodeToString

各種例:: block.cpp.

◆ RecordUpdate()

Btrieve::StatusCode BtrieveFile::RecordUpdate	(	const char *	record,
		int	recordLength
	)

レコードを更新します。

引数

[in]	record	レコード。
[in]	recordLength	レコード長。レコード長は、Btrieve::MAXIMUM_RECORD_LENGTH に制限されています。Btrieve::MAXIMUM_RECORD_LENGTH より長いレコードを更新する方法については、BtrieveFile::RecordUpdateChunk を参照してください。

スニペット: status = btrieveFile.RecordUpdate((char *)&record, sizeof(record));

カーソル: カーソルは影響を受けませんが、確立されている必要があります。

現在のオフセット: 現在のオフセットは影響を受けません。

戻り値

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

参照: Btrieve::StatusCodeToString

各種例:: block.cpp.

◆ RecordUpdateChunk() [1/2]

Btrieve::StatusCode BtrieveFile::RecordUpdateChunk	(	int	offset,
		const char *	chunk,
		int	chunkLength
	)

レコードチャンクを更新します。

引数

[in]	offset	オフセット。
[in]	chunk	チャンク。
[in]	chunkLength	チャンクの長さ。

スニペット: // If RecordUpdateChunk() fails.
if ((status = btrieveFile->RecordUpdateChunk(0, (char *)&chunk, sizeof(chunk))) != Btrieve::STATUS_CODE_NO_ERROR)
{
printf("Error: BtrieveFile::RecordUpdateChunk():%d:%s.\n", status, Btrieve::StatusCodeToString(status));
goto leave;
}

カーソル: カーソルは影響を受けませんが、確立されている必要があります。

現在のオフセット: 現在のオフセットは、更新されたチャンクの末尾に確立されます。

戻り値

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

各種例:: btestchunk.cpp.

◆ RecordUpdateChunk() [2/2]

Btrieve::StatusCode BtrieveFile::RecordUpdateChunk	(	const char *	chunk,
		int	chunkLength
	)

現在のオフセットでレコードチャンクを更新します。

引数

[in]	chunk	チャンク。
[in]	chunkLength	チャンクの長さ。

スニペット: // If RecordUpdateChunk() fails.
if ((status = btrieveFile->RecordUpdateChunk((char *)&chunk, sizeof(chunk))) != Btrieve::STATUS_CODE_NO_ERROR)
{
printf("Error: BtrieveFile::RecordUpdateChunk():%d:%s.\n", status, Btrieve::StatusCodeToString(status));
goto leave;
}

カーソル: カーソルは影響を受けませんが、確立されている必要があります。

現在のオフセット: 現在のオフセットは確立されている必要があり、更新されたチャンクの末尾へ移動されます。

戻り値

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

◆ SetOwner()

Btrieve::StatusCode BtrieveFile::SetOwner	(	Btrieve::OwnerMode	ownerMode,
		const char *	ownerName = `NULL`,
		const char *	ownerNameAgain = `NULL`,
		bool	useLongOwnerName = `true`
	)

オーナーを設定します。

引数

[in]	ownerMode	オーナーモード。
[in]	ownerName	オーナーネーム。
[in]	ownerNameAgain	オーナーネーム（確認）。
[in]	useLongOwnerName	長いオーナーネームを使用する。

説明: オーナーモードのデフォルト値は Btrieve::OWNER_MODE_NONE です。

カーソル: カーソルは影響を受けません。

現在のオフセット: 現在のオフセットは影響を受けません。

戻り値

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

参照: Btrieve::StatusCodeToString

◆ UnlockCursorPosition()

Btrieve::StatusCode BtrieveFile::UnlockCursorPosition ( long long cursorPosition )

カーソル位置のロックを解除します。

覚え書き: このメソッドの署名は PSQL v13 R2 で変更されました。

引数

[in] cursorPosition カーソル位置。

カーソル: カーソルは影響を受けません。

現在のオフセット: 現在のオフセットは影響を受けません。

戻り値

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

参照: Btrieve::StatusCodeToString

公開メンバ関数

詳解

構築子と解体子

◆ BtrieveFile()

◆ ~BtrieveFile()

関数詳解

◆ BulkCreate()

◆ BulkRetrieveNext()

◆ BulkRetrievePrevious()

◆ GetCursorPosition()

◆ GetInformation()

◆ GetLastStatusCode()

◆ GetNumerator() [1/2]

◆ GetNumerator() [2/2]

◆ GetPercentage() [1/2]

◆ GetPercentage() [2/2]

◆ IndexCreate()

◆ IndexDrop()

◆ KeyRetrieve()

◆ KeyRetrieveFirst()

◆ KeyRetrieveLast()

◆ KeyRetrieveNext()

◆ KeyRetrievePrevious()

◆ RecordAppendChunk()

◆ RecordCreate()

◆ RecordDelete()

◆ RecordRetrieve()

◆ RecordRetrieveByCursorPosition()

◆ RecordRetrieveByFraction()

◆ RecordRetrieveByPercentage()

◆ RecordRetrieveChunk() [1/2]

◆ RecordRetrieveChunk() [2/2]

◆ RecordRetrieveFirst()

◆ RecordRetrieveLast()

◆ RecordRetrieveNext()

◆ RecordRetrievePrevious()

◆ RecordTruncate() [1/2]

◆ RecordTruncate() [2/2]

◆ RecordUnlock()

◆ RecordUpdate()

◆ RecordUpdateChunk() [1/2]

◆ RecordUpdateChunk() [2/2]

◆ SetOwner()

◆ UnlockCursorPosition()