![]() |
Btrieve 2
|
Btrieve ファイル クラス。 [詳解]
#include <btrieveCpp.h>
公開メンバ関数 | |
BtrieveFile () | |
~BtrieveFile () | |
Btrieve::StatusCode | BulkCreate (BtrieveBulkCreatePayload *btrieveBulkCreatePayload, BtrieveBulkCreateResult *btrieveBulkCreateResult) |
一括作成。 | |
Btrieve::StatusCode | BulkDeleteNext (BtrieveBulkDeleteAttributes *bulkDeleteAttributes, BtrieveBulkDeleteResult *bulkDeleteResult) |
次の一括削除。 | |
Btrieve::StatusCode | BulkDeletePrevious (BtrieveBulkDeleteAttributes *bulkDeleteAttributes, BtrieveBulkDeleteResult *bulkDeleteResult) |
前の一括削除。 | |
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 (Btrieve::Index index, const char *key, int keyLength, int denominator) |
分母に対して、インデックス内のキーがある場所に最も近似する分子を取得します。 | |
int | GetNumerator (long long cursorPosition, int denominator) |
分母に対して、ファイル内のカーソル位置がある場所に最も近似する分子を取得します。 | |
int | GetPercentage (Btrieve::Index index, const char *key, int keyLength) |
指定されたインデックス内のキーがある場所に最も近似するパーセンテージを取得します。 | |
int | GetPercentage (long long cursorPosition) |
ファイル内のカーソル位置がある場所に最も近似するパーセンテージを取得します。 | |
long long | GetRecordCreateTime () |
レコードの作成時刻を取得します。 | |
long long | GetRecordUpdateTime () |
レコードの更新時刻を取得します。 | |
Btrieve::StatusCode | IndexCreate (BtrieveIndexAttributes *btrieveIndexAttributes) |
インデックスを作成します。 | |
Btrieve::StatusCode | IndexDrop (Btrieve::Index index) |
インデックスを削除します。 | |
Btrieve::StatusCode | KeyRetrieve (Btrieve::Comparison comparison, Btrieve::Index index, 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 () |
レコードを削除します。 | |
Btrieve::StatusCode | RecordDeleteChunk (int chunkLength) |
現在のオフセットでレコード チャンクを削除します。 | |
Btrieve::StatusCode | RecordDeleteChunk (int offset, int chunkLength) |
レコード チャンクを削除します。 | |
Btrieve::StatusCode | RecordInsertChunk (const char *chunk, int chunkLength) |
現在のオフセットでレコード チャンクを挿入します。 | |
Btrieve::StatusCode | RecordInsertChunk (int offset, const char *chunk, int chunkLength) |
レコード チャンクを挿入します。 | |
int | RecordRetrieve (Btrieve::Comparison comparison, Btrieve::Index index, char *key, int keyLength, char *record, int recordSize, Btrieve::LockMode lockMode=Btrieve::LOCK_MODE_NONE) |
指定された比較、インデックス、およびキーを使用して、レコードを取得します。 | |
int | RecordRetrieveByCursorPosition (Btrieve::Index index, long long cursorPosition, char *key, int keySize, 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 *key, int keySize, 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 *key, int keySize, 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 length, char *chunk, int chunkSize, 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 | RecordRetrieveFirst (Btrieve::Index index, char *key, int keySize, char *record, int recordSize, 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 *key, int keySize, 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 *key, int keySize, 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 *key, int keySize, 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 () |
現在のオフセットでレコードを切り詰めます。 | |
Btrieve::StatusCode | RecordTruncate (int offset) |
レコードを切り詰めます。 | |
Btrieve::StatusCode | RecordUnlock (Btrieve::UnlockMode unlockMode) |
レコード(複数可)のロックを解除します。 | |
Btrieve::StatusCode | RecordUpdate (const char *record, int recordLength) |
レコードを更新します。 | |
Btrieve::StatusCode | RecordUpdateChunk (const char *chunk, int chunkLength) |
現在のオフセットでレコード チャンクを更新します。 | |
Btrieve::StatusCode | RecordUpdateChunk (int offset, 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 ファイル内のレコードを取得、更新、および削除するためには、カーソルが確立されている必要があります。カーソルを確立するために使用されるメソッドの中には、次のものがあります。
確立されると、カーソルはファイル内のレコードをスキャンできるようになります。ファイル中をスキャンするために使用されるメソッドの中には、次のものがあります。
カーソルを繰り返し再確立することができます。
BtrieveFile::BtrieveFile | ( | ) |
BtrieveFile::~BtrieveFile | ( | ) |
Btrieve::StatusCode BtrieveFile::BulkCreate | ( | BtrieveBulkCreatePayload * | btrieveBulkCreatePayload, |
BtrieveBulkCreateResult * | btrieveBulkCreateResult ) |
一括作成。
[in] | btrieveBulkCreatePayload | 一括作成ペイロード。 |
[out] | btrieveBulkCreateResult | 一括作成結果。 |
= Btrieve::STATUS_CODE_NO_ERROR | 成功。 |
!= Btrieve::STATUS_CODE_NO_ERROR | エラーが発生しました。 |
Btrieve::StatusCode BtrieveFile::BulkDeleteNext | ( | BtrieveBulkDeleteAttributes * | bulkDeleteAttributes, |
BtrieveBulkDeleteResult * | bulkDeleteResult ) |
次の一括削除。
[in] | bulkDeleteAttributes | 一括削除属性。 |
[out] | bulkDeleteResult | 一括削除結果。 |
= Btrieve::STATUS_CODE_END_OF_FILE | 成功。 0 件以上のレコードが削除されました。指定された一括削除属性に一致するレコードはこれ以上ありません。 |
= Btrieve::STATUS_CODE_NO_ERROR | 成功。 1 件以上のレコードが削除されました。指定された一括削除属性に一致するレコードがさらに存在する可能性があります。 |
それ以外 | エラーが発生しました。 |
Btrieve::StatusCode BtrieveFile::BulkDeletePrevious | ( | BtrieveBulkDeleteAttributes * | bulkDeleteAttributes, |
BtrieveBulkDeleteResult * | bulkDeleteResult ) |
前の一括削除。
[in] | bulkDeleteAttributes | 一括削除属性。 |
[out] | bulkDeleteResult | 一括削除結果。 |
= Btrieve::STATUS_CODE_END_OF_FILE | 成功。 0 件以上のレコードが削除されました。指定された一括削除属性に一致するレコードはこれ以上ありません。 |
= Btrieve::STATUS_CODE_NO_ERROR | 成功。 1 件以上のレコードが削除されました。指定された一括削除属性に一致するレコードがさらに存在する可能性があります。 |
それ以外 | エラーが発生しました。 |
Btrieve::StatusCode BtrieveFile::BulkRetrieveNext | ( | BtrieveBulkRetrieveAttributes * | bulkRetrieveAttributes, |
BtrieveBulkRetrieveResult * | bulkRetrieveResult, | ||
Btrieve::LockMode | lockMode = Btrieve::LOCK_MODE_NONE ) |
次の一括取得。
[in] | bulkRetrieveAttributes | 一括取得属性。 |
[out] | bulkRetrieveResult | 一括取得結果。 |
[in] | lockMode | ロック モード。 |
= Btrieve::STATUS_CODE_END_OF_FILE | 成功。 0 件以上のレコードが取得されました。指定された一括取得属性に一致するレコードはこれ以上ありません。 |
= Btrieve::STATUS_CODE_NO_ERROR | 成功。 1 件以上のレコードが取得されました。指定された一括取得属性に一致するレコードがさらに存在する可能性があります。 |
それ以外 | エラーが発生しました。 |
Btrieve::StatusCode BtrieveFile::BulkRetrievePrevious | ( | BtrieveBulkRetrieveAttributes * | bulkRetrieveAttributes, |
BtrieveBulkRetrieveResult * | bulkRetrieveResult, | ||
Btrieve::LockMode | lockMode = Btrieve::LOCK_MODE_NONE ) |
前の一括取得。
[in] | bulkRetrieveAttributes | 一括取得属性。 |
[out] | bulkRetrieveResult | 一括取得結果。 |
[in] | lockMode | ロック モード。 |
= Btrieve::STATUS_CODE_END_OF_FILE | 成功。 0 件以上のレコードが取得されました。指定された一括取得属性に一致するレコードはこれ以上ありません。 |
= Btrieve::STATUS_CODE_NO_ERROR | 成功。 1 件以上のレコードが取得されました。指定された一括取得属性に一致するレコードがさらに存在する可能性があります。 |
それ以外 | エラーが発生しました。 |
long long BtrieveFile::GetCursorPosition | ( | ) |
カーソル位置を取得します。
>= 0 | カーソル位置。 |
-1 | エラーが発生しました。 エラーに関連する Btrieve::StatusCode を特定するには BtrieveFile::GetLastStatusCode を使用します。 |
Btrieve::StatusCode BtrieveFile::GetInformation | ( | BtrieveFileInformation * | btrieveFileInformation | ) |
ファイル情報を取得します。
[out] | btrieveFileInformation | ファイル情報。 |
= Btrieve::STATUS_CODE_NO_ERROR | 成功。 |
!= Btrieve::STATUS_CODE_NO_ERROR | エラーが発生しました。 |
Btrieve::StatusCode BtrieveFile::GetLastStatusCode | ( | ) |
最新のステータス コードを取得します。
= Btrieve::STATUS_CODE_NO_ERROR | 成功。 |
!= Btrieve::STATUS_CODE_NO_ERROR | エラーが発生しました。 |
int BtrieveFile::GetNumerator | ( | Btrieve::Index | index, |
const char * | key, | ||
int | keyLength, | ||
int | denominator ) |
分母に対して、インデックス内のキーがある場所に最も近似する分子を取得します。
[in] | index | インデックス。 |
[in] | key | キー。 |
[in] | keyLength | キーの長さ。 |
[in] | denominator | 分母。 |
>= 0 | 分子。0 から分母までで返されます。 |
-1 | エラーが発生しました。 エラーに関連する Btrieve::StatusCode を特定するには BtrieveFile::GetLastStatusCode を使用します。 |
int BtrieveFile::GetNumerator | ( | long long | cursorPosition, |
int | denominator ) |
分母に対して、ファイル内のカーソル位置がある場所に最も近似する分子を取得します。
[in] | cursorPosition | カーソル位置。 |
[in] | denominator | 分母。 |
>= 0 | 分子。0 から分母までで返されます。 |
-1 | エラーが発生しました。 エラーに関連する Btrieve::StatusCode を特定するには BtrieveFile::GetLastStatusCode を使用します。 |
int BtrieveFile::GetPercentage | ( | Btrieve::Index | index, |
const char * | key, | ||
int | keyLength ) |
指定されたインデックス内のキーがある場所に最も近似するパーセンテージを取得します。
[in] | index | インデックス。 |
[in] | key | キー。 |
[in] | keyLength | キーの長さ。 |
>= 0 | パーセンテージ。0 から 10,000(0% から 100.00% に相当)で返されます。 |
-1 | エラーが発生しました。 エラーに関連する Btrieve::StatusCode を特定するには BtrieveFile::GetLastStatusCode を使用します。 |
int BtrieveFile::GetPercentage | ( | long long | cursorPosition | ) |
ファイル内のカーソル位置がある場所に最も近似するパーセンテージを取得します。
[in] | cursorPosition | カーソル位置。 |
>= 0 | パーセンテージ。0 から 10,000(0% から 100.00% に相当)で返されます。 |
-1 | エラーが発生しました。 エラーに関連する Btrieve::StatusCode を特定するには BtrieveFile::GetLastStatusCode を使用します。 |
long long BtrieveFile::GetRecordCreateTime | ( | ) |
レコードの作成時刻を取得します。
> 0 | レコードの作成時刻(Btrieve TIMESTAMP)。 |
= 0 | レコードの作成時刻を入手できません。ファイルがシステム データを使って作成されたかを確認してください。 BtrieveFileAttributes::SetSystemDataMode を参照してください。 |
-1 | エラーが発生しました。 エラーに関連する Btrieve::StatusCode を特定するには BtrieveFile::GetLastStatusCode を使用します。 |
long long BtrieveFile::GetRecordUpdateTime | ( | ) |
レコードの更新時刻を取得します。
> 0 | レコードの更新時刻(Btrieve TIMESTAMP)。 |
= 0 | レコードの更新時刻を入手できません。ファイルがシステム データ バージョン 2 を使って作成されたかを確認してください。 BtrieveFileAttributes::SetSystemDataMode を参照してください。 |
-1 | エラーが発生しました。 エラーに関連する Btrieve::StatusCode を特定するには BtrieveFile::GetLastStatusCode を使用します。 |
Btrieve::StatusCode BtrieveFile::IndexCreate | ( | BtrieveIndexAttributes * | btrieveIndexAttributes | ) |
インデックスを作成します。
[in] | btrieveIndexAttributes | インデックス属性。 |
= Btrieve::STATUS_CODE_NO_ERROR | 成功。 |
!= Btrieve::STATUS_CODE_NO_ERROR | エラーが発生しました。 |
Btrieve::StatusCode BtrieveFile::IndexDrop | ( | Btrieve::Index | index | ) |
インデックスを削除します。
[in] | index | インデックス。 |
= Btrieve::STATUS_CODE_NO_ERROR | 成功。 |
!= Btrieve::STATUS_CODE_NO_ERROR | エラーが発生しました。 |
Btrieve::StatusCode BtrieveFile::KeyRetrieve | ( | Btrieve::Comparison | comparison, |
Btrieve::Index | index, | ||
char * | key, | ||
int | keyLength ) |
指定された比較、インデックス、およびキーを使用して、キーを取得します。
[in] | comparison | 比較。 Btrieve::COMPARISON_NOT_EQUAL はサポートされていません。 |
[in] | index | インデックス。 |
[in,out] | key | キー。 |
[in] | keyLength | キーの長さ。 |
= Btrieve::STATUS_CODE_NO_ERROR | 成功。 |
!= Btrieve::STATUS_CODE_NO_ERROR | エラーが発生しました。 |
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::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::StatusCode BtrieveFile::KeyRetrieveNext | ( | char * | key, |
int | keySize ) |
次にあるキーを取得します。
[out] | key | キー。 |
[in] | keySize | キー サイズ。 |
= Btrieve::STATUS_CODE_NO_ERROR | 成功。 |
!= Btrieve::STATUS_CODE_NO_ERROR | エラーが発生しました。 |
Btrieve::StatusCode BtrieveFile::KeyRetrievePrevious | ( | char * | key, |
int | keySize ) |
前にあるキーを取得します。
[out] | key | キー。 |
[in] | keySize | キー サイズ。 |
= Btrieve::STATUS_CODE_NO_ERROR | 成功。 |
!= Btrieve::STATUS_CODE_NO_ERROR | エラーが発生しました。 |
Btrieve::StatusCode BtrieveFile::RecordAppendChunk | ( | const char * | chunk, |
int | chunkLength ) |
レコード チャンクを追加します。
[in] | chunk | チャンク。 |
[in] | chunkLength | チャンクの長さ。 |
= Btrieve::STATUS_CODE_NO_ERROR | 成功。 |
!= Btrieve::STATUS_CODE_NO_ERROR | エラーが発生しました。 |
Btrieve::StatusCode BtrieveFile::RecordCreate | ( | char * | record, |
int | recordLength ) |
レコードを作成します。
[in,out] | record | レコード。現在のレコードに Btrieve::DATA_TYPE_AUTOINCREMENT キーまたは Btrieve::DATA_TYPE_AUTOTIMESTAMP キーのセグメントが含まれている場合、渡されるレコードは変更される可能性があります。 |
[in] | recordLength | レコード長。レコード長は Btrieve::MAXIMUM_RECORD_LENGTH バイトに制限されています。 Btrieve::MAXIMUM_RECORD_LENGTH よりも長いレコードを作成する方法については BtrieveFile::RecordAppendChunk を参照してください。 |
= Btrieve::STATUS_CODE_NO_ERROR | 成功。 |
!= Btrieve::STATUS_CODE_NO_ERROR | エラーが発生しました。 |
Btrieve::StatusCode BtrieveFile::RecordDelete | ( | ) |
レコードを削除します。
= Btrieve::STATUS_CODE_NO_ERROR | 成功。 |
!= Btrieve::STATUS_CODE_NO_ERROR | エラーが発生しました。 |
Btrieve::StatusCode BtrieveFile::RecordDeleteChunk | ( | int | chunkLength | ) |
現在のオフセットでレコード チャンクを削除します。
[in] | chunkLength | チャンクの長さ。 |
= Btrieve::STATUS_CODE_NO_ERROR | 成功。 |
!= Btrieve::STATUS_CODE_NO_ERROR | エラーが発生しました。 |
Btrieve::StatusCode BtrieveFile::RecordDeleteChunk | ( | int | offset, |
int | chunkLength ) |
レコード チャンクを削除します。
[in] | offset | オフセット。offset が -1 の場合は、現在のオフセットが使用されます。offset は、レコードの可変長部分内にある必要があります。 |
[in] | chunkLength | チャンクの長さ。 |
= Btrieve::STATUS_CODE_NO_ERROR | 成功。 |
!= Btrieve::STATUS_CODE_NO_ERROR | エラーが発生しました。 |
Btrieve::StatusCode BtrieveFile::RecordInsertChunk | ( | const char * | chunk, |
int | chunkLength ) |
現在のオフセットでレコード チャンクを挿入します。
[in] | chunk | チャンク。 |
[in] | chunkLength | チャンクの長さ。 |
= Btrieve::STATUS_CODE_NO_ERROR | 成功。 |
!= Btrieve::STATUS_CODE_NO_ERROR | エラーが発生しました。 |
Btrieve::StatusCode BtrieveFile::RecordInsertChunk | ( | int | offset, |
const char * | chunk, | ||
int | chunkLength ) |
レコード チャンクを挿入します。
[in] | offset | オフセット。offset が -1 の場合は、現在のオフセットが使用されます。offset は、レコードの可変長部分内にある必要があります。 |
[in] | chunk | チャンク。 |
[in] | chunkLength | チャンクの長さ。 |
= Btrieve::STATUS_CODE_NO_ERROR | 成功。 |
!= Btrieve::STATUS_CODE_NO_ERROR | エラーが発生しました。 |
int BtrieveFile::RecordRetrieve | ( | Btrieve::Comparison | comparison, |
Btrieve::Index | index, | ||
char * | key, | ||
int | keyLength, | ||
char * | record, | ||
int | recordSize, | ||
Btrieve::LockMode | lockMode = Btrieve::LOCK_MODE_NONE ) |
指定された比較、インデックス、およびキーを使用して、レコードを取得します。
[in] | comparison | 比較。 Btrieve::COMPARISON_NOT_EQUAL はサポートされていません。 |
[in] | index | インデックス。 |
[in,out] | key | キー。 |
[in] | keyLength | キーの長さ。 |
[out] | record | レコード。 |
[in] | recordSize | レコード サイズ。 |
[in] | lockMode | ロック モード。 |
>= 0 | 読み取られるバイト数。読み取られるバイト数は Btrieve::MAXIMUM_RECORD_LENGTH に制限されています。 長さが Btrieve::MAXIMUM_RECORD_LENGTH より大きいレコードの取得については BtrieveFile::RecordRetrieveChunk を参照してください。 要求されたレコード サイズが現在のレコードの長さより小さい場合、 BtrieveFile::GetLastStatusCode は Btrieve::STATUS_CODE_DATALENGTH_ERROR を返します。 |
-1 | エラーが発生しました。 エラーに関連する Btrieve::StatusCode を特定するには BtrieveFile::GetLastStatusCode を使用します。 |
int BtrieveFile::RecordRetrieveByCursorPosition | ( | Btrieve::Index | index, |
long long | cursorPosition, | ||
char * | key, | ||
int | keySize, | ||
char * | record, | ||
int | recordSize, | ||
Btrieve::LockMode | lockMode = Btrieve::LOCK_MODE_NONE ) |
カーソル位置によってレコードを取得します。
[in] | index | インデックスまたは Btrieve::INDEX_NONE |
[in] | cursorPosition | カーソル位置。 |
[out] | key | キー。 |
[in] | keySize | キー サイズ。 |
[out] | record | レコード。 |
[in] | recordSize | レコード サイズ。 |
[in] | lockMode | ロック モード。 |
>= 0 | 読み取られるバイト数。読み取られるバイト数は Btrieve::MAXIMUM_RECORD_LENGTH に制限されています。 長さが Btrieve::MAXIMUM_RECORD_LENGTH より大きいレコードの取得については BtrieveFile::RecordRetrieveChunk を参照してください。 要求されたレコード サイズが現在のレコードの長さより小さい場合、 BtrieveFile::GetLastStatusCode は Btrieve::STATUS_CODE_DATALENGTH_ERROR を返します。 |
-1 | エラーが発生しました。 エラーに関連する Btrieve::StatusCode を特定するには BtrieveFile::GetLastStatusCode を使用します。 |
int BtrieveFile::RecordRetrieveByCursorPosition | ( | Btrieve::Index | index, |
long long | cursorPosition, | ||
char * | record, | ||
int | recordSize, | ||
Btrieve::LockMode | lockMode = Btrieve::LOCK_MODE_NONE ) |
カーソル位置によってレコードを取得します。
[in] | index | インデックスまたは Btrieve::INDEX_NONE |
[in] | cursorPosition | カーソル位置。 |
[out] | record | レコード。 |
[in] | recordSize | レコード サイズ。 |
[in] | lockMode | ロック モード。 |
>= 0 | 読み取られるバイト数。読み取られるバイト数は Btrieve::MAXIMUM_RECORD_LENGTH に制限されています。 長さが Btrieve::MAXIMUM_RECORD_LENGTH より大きいレコードの取得については BtrieveFile::RecordRetrieveChunk を参照してください。 要求されたレコード サイズが現在のレコードの長さより小さい場合、 BtrieveFile::GetLastStatusCode は Btrieve::STATUS_CODE_DATALENGTH_ERROR を返します。 |
-1 | エラーが発生しました。 エラーに関連する Btrieve::StatusCode を特定するには BtrieveFile::GetLastStatusCode を使用します。 |
int BtrieveFile::RecordRetrieveByFraction | ( | Btrieve::Index | index, |
int | numerator, | ||
int | denominator, | ||
char * | key, | ||
int | keySize, | ||
char * | record, | ||
int | recordSize, | ||
Btrieve::LockMode | lockMode = Btrieve::LOCK_MODE_NONE ) |
分数によってレコードを取得します。
[in] | index | インデックスまたは Btrieve::INDEX_NONE |
[in] | numerator | 分子。0 から分母までで指定します。 |
[in] | denominator | 分母。 |
[out] | key | キー。 |
[in] | keySize | キー サイズ。 |
[out] | record | レコード。 |
[in] | recordSize | レコード サイズ。 |
[in] | lockMode | ロック モード。 |
>= 0 | 読み取られるバイト数。読み取られるバイト数は Btrieve::MAXIMUM_RECORD_LENGTH に制限されています。 長さが Btrieve::MAXIMUM_RECORD_LENGTH より大きいレコードの取得については BtrieveFile::RecordRetrieveChunk を参照してください。 要求されたレコード サイズが現在のレコードの長さより小さい場合、 BtrieveFile::GetLastStatusCode は Btrieve::STATUS_CODE_DATALENGTH_ERROR を返します。 |
-1 | エラーが発生しました。 エラーに関連する Btrieve::StatusCode を特定するには BtrieveFile::GetLastStatusCode を使用します。 |
int BtrieveFile::RecordRetrieveByFraction | ( | Btrieve::Index | index, |
int | numerator, | ||
int | denominator, | ||
char * | record, | ||
int | recordSize, | ||
Btrieve::LockMode | lockMode = Btrieve::LOCK_MODE_NONE ) |
分数によってレコードを取得します。
[in] | index | インデックスまたは Btrieve::INDEX_NONE |
[in] | numerator | 分子。0 から分母までで指定します。 |
[in] | denominator | 分母。 |
[out] | record | レコード。 |
[in] | recordSize | レコード サイズ。 |
[in] | lockMode | ロック モード。 |
>= 0 | 読み取られるバイト数。読み取られるバイト数は Btrieve::MAXIMUM_RECORD_LENGTH に制限されています。 長さが Btrieve::MAXIMUM_RECORD_LENGTH より大きいレコードの取得については BtrieveFile::RecordRetrieveChunk を参照してください。 要求されたレコード サイズが現在のレコードの長さより小さい場合、 BtrieveFile::GetLastStatusCode は Btrieve::STATUS_CODE_DATALENGTH_ERROR を返します。 |
-1 | エラーが発生しました。 エラーに関連する Btrieve::StatusCode を特定するには BtrieveFile::GetLastStatusCode を使用します。 |
int BtrieveFile::RecordRetrieveByPercentage | ( | Btrieve::Index | index, |
int | percentage, | ||
char * | key, | ||
int | keySize, | ||
char * | record, | ||
int | recordSize, | ||
Btrieve::LockMode | lockMode = Btrieve::LOCK_MODE_NONE ) |
パーセンテージによってレコードを取得します。
[in] | index | インデックスまたは Btrieve::INDEX_NONE |
[in] | percentage | パーセンテージ。0 から 10,000(0% から 100.00% に相当)で指定します。 |
[out] | key | キー。 |
[in] | keySize | キー サイズ。 |
[out] | record | レコード。 |
[in] | recordSize | レコード サイズ。 |
[in] | lockMode | ロック モード。 |
>= 0 | 読み取られるバイト数。読み取られるバイト数は Btrieve::MAXIMUM_RECORD_LENGTH に制限されています。 長さが Btrieve::MAXIMUM_RECORD_LENGTH より大きいレコードの取得については BtrieveFile::RecordRetrieveChunk を参照してください。 要求されたレコード サイズが現在のレコードの長さより小さい場合、 BtrieveFile::GetLastStatusCode は Btrieve::STATUS_CODE_DATALENGTH_ERROR を返します。 |
-1 | エラーが発生しました。 エラーに関連する Btrieve::StatusCode を特定するには BtrieveFile::GetLastStatusCode を使用します。 |
int BtrieveFile::RecordRetrieveByPercentage | ( | Btrieve::Index | index, |
int | percentage, | ||
char * | record, | ||
int | recordSize, | ||
Btrieve::LockMode | lockMode = Btrieve::LOCK_MODE_NONE ) |
パーセンテージによってレコードを取得します。
[in] | index | インデックスまたは Btrieve::INDEX_NONE |
[in] | percentage | パーセンテージ。0 から 10,000(0% から 100.00% に相当)で指定します。 |
[out] | record | レコード。 |
[in] | recordSize | レコード サイズ。 |
[in] | lockMode | ロック モード。 |
>= 0 | 読み取られるバイト数。読み取られるバイト数は Btrieve::MAXIMUM_RECORD_LENGTH に制限されています。 長さが Btrieve::MAXIMUM_RECORD_LENGTH より大きいレコードの取得については BtrieveFile::RecordRetrieveChunk を参照してください。 要求されたレコード サイズが現在のレコードの長さより小さい場合、 BtrieveFile::GetLastStatusCode は Btrieve::STATUS_CODE_DATALENGTH_ERROR を返します。 |
-1 | エラーが発生しました。 エラーに関連する Btrieve::StatusCode を特定するには BtrieveFile::GetLastStatusCode を使用します。 |
int BtrieveFile::RecordRetrieveChunk | ( | int | length, |
char * | chunk, | ||
int | chunkSize, | ||
Btrieve::LockMode | lockMode = Btrieve::LOCK_MODE_NONE ) |
現在のオフセットからレコード チャンクを取得します。
[in] | length | 長さ。 |
[out] | chunk | チャンク。 |
[in] | chunkSize | チャンク サイズ。 |
[in] | lockMode | ロック モード。 |
>= 0 | 読み取られるバイト数。 複数のチャンクを取得できます。 |
-1 | エラーが発生しました。 エラーに関連する Btrieve::StatusCode を特定するには BtrieveFile::GetLastStatusCode を使用します。 |
int BtrieveFile::RecordRetrieveChunk | ( | int | offset, |
int | length, | ||
char * | chunk, | ||
int | chunkSize, | ||
Btrieve::LockMode | lockMode = Btrieve::LOCK_MODE_NONE ) |
レコード チャンクを取得します。
[in] | offset | オフセット。offset が -1 の場合は、現在のオフセットが使用されます。 |
[in] | length | 長さ。 |
[out] | chunk | チャンク。 |
[in] | chunkSize | チャンク サイズ。 |
[in] | lockMode | ロック モード。 |
>= 0 | 読み取られるバイト数。 複数のチャンクを取得できます。 |
-1 | エラーが発生しました。 エラーに関連する Btrieve::StatusCode を特定するには BtrieveFile::GetLastStatusCode を使用します。 |
int BtrieveFile::RecordRetrieveFirst | ( | Btrieve::Index | index, |
char * | key, | ||
int | keySize, | ||
char * | record, | ||
int | recordSize, | ||
Btrieve::LockMode | lockMode = Btrieve::LOCK_MODE_NONE ) |
先頭のレコードを取得します。
[in] | index | インデックスまたは Btrieve::INDEX_NONE |
[out] | key | キー。 |
[in] | keySize | キー サイズ。 |
[out] | record | レコード。 |
[in] | recordSize | レコード サイズ。 |
[in] | lockMode | ロック モード。 |
>= 0 | 読み取られるバイト数。読み取られるバイト数は Btrieve::MAXIMUM_RECORD_LENGTH に制限されています。 長さが Btrieve::MAXIMUM_RECORD_LENGTH より大きいレコードの取得については BtrieveFile::RecordRetrieveChunk を参照してください。 要求されたレコード サイズが現在のレコードの長さより小さい場合、 BtrieveFile::GetLastStatusCode は Btrieve::STATUS_CODE_DATALENGTH_ERROR を返します。 |
-1 | エラーが発生しました。 エラーに関連する Btrieve::StatusCode を特定するには BtrieveFile::GetLastStatusCode を使用します。 |
int BtrieveFile::RecordRetrieveFirst | ( | Btrieve::Index | index, |
char * | record, | ||
int | recordSize, | ||
Btrieve::LockMode | lockMode = Btrieve::LOCK_MODE_NONE ) |
先頭のレコードを取得します。
[in] | index | インデックスまたは Btrieve::INDEX_NONE |
[out] | record | レコード。 |
[in] | recordSize | レコード サイズ。 |
[in] | lockMode | ロック モード。 |
>= 0 | 読み取られるバイト数。読み取られるバイト数は Btrieve::MAXIMUM_RECORD_LENGTH に制限されています。 長さが Btrieve::MAXIMUM_RECORD_LENGTH より大きいレコードの取得については BtrieveFile::RecordRetrieveChunk を参照してください。 要求されたレコード サイズが現在のレコードの長さより小さい場合、 BtrieveFile::GetLastStatusCode は Btrieve::STATUS_CODE_DATALENGTH_ERROR を返します。 |
-1 | エラーが発生しました。 エラーに関連する Btrieve::StatusCode を特定するには BtrieveFile::GetLastStatusCode を使用します。 |
int BtrieveFile::RecordRetrieveLast | ( | Btrieve::Index | index, |
char * | key, | ||
int | keySize, | ||
char * | record, | ||
int | recordSize, | ||
Btrieve::LockMode | lockMode = Btrieve::LOCK_MODE_NONE ) |
末尾のレコードを取得します。
[in] | index | インデックスまたは Btrieve::INDEX_NONE |
[out] | key | キー。 |
[in] | keySize | キー サイズ。 |
[out] | record | レコード。 |
[in] | recordSize | レコード サイズ。 |
[in] | lockMode | ロック モード。 |
>= 0 | 読み取られるバイト数。読み取られるバイト数は Btrieve::MAXIMUM_RECORD_LENGTH に制限されています。 長さが Btrieve::MAXIMUM_RECORD_LENGTH より大きいレコードの取得については BtrieveFile::RecordRetrieveChunk を参照してください。 要求されたレコード サイズが現在のレコードの長さより小さい場合、 BtrieveFile::GetLastStatusCode は Btrieve::STATUS_CODE_DATALENGTH_ERROR を返します。 |
-1 | エラーが発生しました。 エラーに関連する Btrieve::StatusCode を特定するには BtrieveFile::GetLastStatusCode を使用します。 |
int BtrieveFile::RecordRetrieveLast | ( | Btrieve::Index | index, |
char * | record, | ||
int | recordSize, | ||
Btrieve::LockMode | lockMode = Btrieve::LOCK_MODE_NONE ) |
末尾のレコードを取得します。
[in] | index | インデックスまたは Btrieve::INDEX_NONE |
[out] | record | レコード。 |
[in] | recordSize | レコード サイズ。 |
[in] | lockMode | ロック モード。 |
>= 0 | 読み取られるバイト数。読み取られるバイト数は Btrieve::MAXIMUM_RECORD_LENGTH に制限されています。 長さが Btrieve::MAXIMUM_RECORD_LENGTH より大きいレコードの取得については BtrieveFile::RecordRetrieveChunk を参照してください。 要求されたレコード サイズが現在のレコードの長さより小さい場合、 BtrieveFile::GetLastStatusCode は Btrieve::STATUS_CODE_DATALENGTH_ERROR を返します。 |
-1 | エラーが発生しました。 エラーに関連する Btrieve::StatusCode を特定するには BtrieveFile::GetLastStatusCode を使用します。 |
int BtrieveFile::RecordRetrieveNext | ( | char * | key, |
int | keySize, | ||
char * | record, | ||
int | recordSize, | ||
Btrieve::LockMode | lockMode = Btrieve::LOCK_MODE_NONE ) |
次にあるレコードを取得します。
[out] | key | キー。 |
[in] | keySize | キー サイズ。 |
[out] | record | レコード。 |
[in] | recordSize | レコード サイズ。 |
[in] | lockMode | ロック モード。 |
>= 0 | 読み取られるバイト数。読み取られるバイト数は Btrieve::MAXIMUM_RECORD_LENGTH に制限されています。 長さが Btrieve::MAXIMUM_RECORD_LENGTH より大きいレコードの取得については BtrieveFile::RecordRetrieveChunk を参照してください。 要求されたレコード サイズが現在のレコードの長さより小さい場合、 BtrieveFile::GetLastStatusCode は Btrieve::STATUS_CODE_DATALENGTH_ERROR を返します。 |
-1 | エラーが発生しました。 エラーに関連する Btrieve::StatusCode を特定するには BtrieveFile::GetLastStatusCode を使用します。 |
int BtrieveFile::RecordRetrieveNext | ( | char * | record, |
int | recordSize, | ||
Btrieve::LockMode | lockMode = Btrieve::LOCK_MODE_NONE ) |
次にあるレコードを取得します。
[out] | record | レコード。 |
[in] | recordSize | レコード サイズ。 |
[in] | lockMode | ロック モード。 |
>= 0 | 読み取られるバイト数。読み取られるバイト数は Btrieve::MAXIMUM_RECORD_LENGTH に制限されています。 長さが Btrieve::MAXIMUM_RECORD_LENGTH より大きいレコードの取得については BtrieveFile::RecordRetrieveChunk を参照してください。 要求されたレコード サイズが現在のレコードの長さより小さい場合、 BtrieveFile::GetLastStatusCode は Btrieve::STATUS_CODE_DATALENGTH_ERROR を返します。 |
-1 | エラーが発生しました。 エラーに関連する Btrieve::StatusCode を特定するには BtrieveFile::GetLastStatusCode を使用します。 |
int BtrieveFile::RecordRetrievePrevious | ( | char * | key, |
int | keySize, | ||
char * | record, | ||
int | recordSize, | ||
Btrieve::LockMode | lockMode = Btrieve::LOCK_MODE_NONE ) |
前にあるレコードを取得します。
[out] | key | キー。 |
[in] | keySize | キー サイズ。 |
[out] | record | レコード。 |
[in] | recordSize | レコード サイズ。 |
[in] | lockMode | ロック モード。 |
>= 0 | 読み取られるバイト数。読み取られるバイト数は Btrieve::MAXIMUM_RECORD_LENGTH に制限されています。 長さが Btrieve::MAXIMUM_RECORD_LENGTH より大きいレコードの取得については BtrieveFile::RecordRetrieveChunk を参照してください。 要求されたレコード サイズが現在のレコードの長さより小さい場合、 BtrieveFile::GetLastStatusCode は Btrieve::STATUS_CODE_DATALENGTH_ERROR を返します。 |
-1 | エラーが発生しました。 エラーに関連する Btrieve::StatusCode を特定するには BtrieveFile::GetLastStatusCode を使用します。 |
int BtrieveFile::RecordRetrievePrevious | ( | char * | record, |
int | recordSize, | ||
Btrieve::LockMode | lockMode = Btrieve::LOCK_MODE_NONE ) |
前にあるレコードを取得します。
[out] | record | レコード。 |
[in] | recordSize | レコード サイズ。 |
[in] | lockMode | ロック モード。 |
>= 0 | 読み取られるバイト数。読み取られるバイト数は Btrieve::MAXIMUM_RECORD_LENGTH に制限されています。 長さが Btrieve::MAXIMUM_RECORD_LENGTH より大きいレコードの取得については BtrieveFile::RecordRetrieveChunk を参照してください。 要求されたレコード サイズが現在のレコードの長さより小さい場合、 BtrieveFile::GetLastStatusCode は Btrieve::STATUS_CODE_DATALENGTH_ERROR を返します。 |
-1 | エラーが発生しました。 エラーに関連する Btrieve::StatusCode を特定するには BtrieveFile::GetLastStatusCode を使用します。 |
Btrieve::StatusCode BtrieveFile::RecordTruncate | ( | ) |
現在のオフセットでレコードを切り詰めます。
= Btrieve::STATUS_CODE_NO_ERROR | 成功。 |
!= Btrieve::STATUS_CODE_NO_ERROR | エラーが発生しました。 |
Btrieve::StatusCode BtrieveFile::RecordTruncate | ( | int | offset | ) |
レコードを切り詰めます。
[in] | offset | オフセット。offset が -1 の場合は、現在のオフセットが使用されます。 |
= Btrieve::STATUS_CODE_NO_ERROR | 成功。 |
!= Btrieve::STATUS_CODE_NO_ERROR | エラーが発生しました。 |
Btrieve::StatusCode BtrieveFile::RecordUnlock | ( | Btrieve::UnlockMode | unlockMode | ) |
レコード(複数可)のロックを解除します。
[in] | unlockMode | ロック解除モード。 |
= Btrieve::STATUS_CODE_NO_ERROR | 成功。 |
!= Btrieve::STATUS_CODE_NO_ERROR | エラーが発生しました。 |
Btrieve::StatusCode BtrieveFile::RecordUpdate | ( | const char * | record, |
int | recordLength ) |
レコードを更新します。
[in] | record | レコード。 |
[in] | recordLength | レコード長。レコード長は Btrieve::MAXIMUM_RECORD_LENGTH バイトに制限されています。 Btrieve::MAXIMUM_RECORD_LENGTH より長いレコードを更新する方法については BtrieveFile::RecordUpdateChunk を参照してください。 |
= Btrieve::STATUS_CODE_NO_ERROR | 成功。 |
!= Btrieve::STATUS_CODE_NO_ERROR | エラーが発生しました。 |
Btrieve::StatusCode BtrieveFile::RecordUpdateChunk | ( | const char * | chunk, |
int | chunkLength ) |
現在のオフセットでレコード チャンクを更新します。
[in] | chunk | チャンク。 |
[in] | chunkLength | チャンクの長さ。 |
= Btrieve::STATUS_CODE_NO_ERROR | 成功。 |
!= Btrieve::STATUS_CODE_NO_ERROR | エラーが発生しました。 |
Btrieve::StatusCode BtrieveFile::RecordUpdateChunk | ( | int | offset, |
const char * | chunk, | ||
int | chunkLength ) |
レコード チャンクを更新します。
[in] | offset | オフセット。offset が -1 の場合は、現在のオフセットが使用されます。 |
[in] | chunk | チャンク。 |
[in] | chunkLength | チャンクの長さ。 |
= Btrieve::STATUS_CODE_NO_ERROR | 成功。 |
!= Btrieve::STATUS_CODE_NO_ERROR | エラーが発生しました。 |
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::STATUS_CODE_NO_ERROR | 成功。 |
!= Btrieve::STATUS_CODE_NO_ERROR | エラーが発生しました。 |
Btrieve::StatusCode BtrieveFile::UnlockCursorPosition | ( | long long | cursorPosition | ) |
カーソル位置のロックを解除します。
[in] | cursorPosition | カーソル位置。 |
= Btrieve::STATUS_CODE_NO_ERROR | 成功。 |
!= Btrieve::STATUS_CODE_NO_ERROR | エラーが発生しました。 |