BtrieveBulkRetrieveResult Class Reference

The Btrieve bulk retrieve result class. More...

#include <btrieveCpp.h>

Public Member Functions
	BtrieveBulkRetrieveResult ()
	~BtrieveBulkRetrieveResult ()
Btrieve::StatusCode	GetLastStatusCode ()
	Get the last status code. More...
int	GetRecord (int recordNumber, char *record, int recordSize)
	Get the record. More...
int	GetRecordCount ()
	Get the record count. More...
long long	GetRecordCursorPosition (int recordNumber)
	Get the record cursor position. More...
int	GetRecordLength (int recordNumber)
	Get the record length. More...

Detailed Description

The Btrieve bulk retrieve result class.

Examples:

bfilter.cpp, and btestbulk.cpp.

Constructor & Destructor Documentation

BtrieveBulkRetrieveResult()

BtrieveBulkRetrieveResult::BtrieveBulkRetrieveResult

(

)

Snippet

   BtrieveBulkRetrieveResult btrieveBulkRetrieveResult;

~BtrieveBulkRetrieveResult()

BtrieveBulkRetrieveResult::~BtrieveBulkRetrieveResult

(

)

Member Function Documentation

GetLastStatusCode()

Btrieve::StatusCode BtrieveBulkRetrieveResult::GetLastStatusCode

(

)

Get the last status code.

Note

This method is intended for use following methods which don't return a status code.

Snippet

   // If GetRecord() fails.
   if (btrieveBulkRetrieveResult.GetRecord(1, (char *)&record, sizeof(record)) != sizeof(record))
   {
      status = btrieveBulkRetrieveResult.GetLastStatusCode();
      printf("Error: BtrieveBulkRetrieveResult::GetRecord():%d:%s.\n", status, Btrieve::StatusCodeToString(status));
      goto leave;
   }

Return values

= Btrieve::STATUS_CODE_NO_ERROR	Success.
!= Btrieve::STATUS_CODE_NO_ERROR	An error has occurred.

See also

Btrieve::StatusCodeToString

Examples:

bfilter.cpp, and btestbulk.cpp.

GetRecord()

int BtrieveBulkRetrieveResult::GetRecord	(	int	recordNumber,
		char *	record,
		int	recordSize
	)

Get the record.

Note

This method doesn't return a Btrieve::StatusCode. See below for more information.

Parameters

[in]	recordNumber	The record number.
[out]	record	The record.
[in]	recordSize	The record size.

Snippet

   // If GetRecord() fails.
   if (btrieveBulkRetrieveResult.GetRecord(1, (char *)&record, sizeof(record)) != sizeof(record))
   {
      status = btrieveBulkRetrieveResult.GetLastStatusCode();
      printf("Error: BtrieveBulkRetrieveResult::GetRecord():%d:%s.\n", status, Btrieve::StatusCodeToString(status));
      goto leave;
   }

Return values

>= 0	The number of bytes read. The number of bytes read is limited to Btrieve::MAXIMUM_RECORD_LENGTH. See BtrieveFile::RecordRetrieveChunk for retrieving records greater than Btrieve::MAXIMUM_RECORD_LENGTH in length.
-1	An error has occurred. Use BtrieveBulkRetrieveResult::GetLastStatusCode to determine the Btrieve::StatusCode associated with any error.

Examples:

bfilter.cpp, and btestbulk.cpp.

GetRecordCount()

int BtrieveBulkRetrieveResult::GetRecordCount

(

)

Get the record count.

Snippet

   // If GetRecordCount() fails.
   if ((i = btrieveBulkRetrieveResult.GetRecordCount()) != 1)
   {
      status = btrieveBulkRetrieveResult.GetLastStatusCode();
      printf("Error: BtrieveBulkRetrieveResult::GetRecordCount():%d:%s.\n", status, Btrieve::StatusCodeToString(status));
      goto leave;
   }

Return values

>= 0	The record count.
-1	An error has occurred. Use BtrieveBulkRetrieveResult::GetLastStatusCode to determine the Btrieve::StatusCode associated with any error.

Examples:

bfilter.cpp, and btestbulk.cpp.

GetRecordCursorPosition()

long long BtrieveBulkRetrieveResult::GetRecordCursorPosition

(

int

recordNumber

)

Get the record cursor position.

Note

The signature for this method changed in PSQL v13 R2.

Parameters

[in]

recordNumber

The record number.

Snippet

   // If GetRecordCursorPosition() fails.
   if ((cursorPosition = btrieveBulkRetrieveResult.GetRecordCursorPosition(1)) < 0)
   {
      status = btrieveBulkRetrieveResult.GetLastStatusCode();
      printf("Error: BtrieveBulkRetrieveResult::GetRecordCursorPosition():%d:%s.\n", status, Btrieve::StatusCodeToString(status));
      goto leave;
   }

Return values

>= 0	The record cursor position.
-1	An error has occurred. Use BtrieveBulkRetrieveResult::GetLastStatusCode to determine the Btrieve::StatusCode associated with any error.

Examples:

bfilter.cpp, and btestbulk.cpp.

GetRecordLength()

int BtrieveBulkRetrieveResult::GetRecordLength

(

int

recordNumber

)

Get the record length.

Parameters

[in]

recordNumber

The record number.

Snippet

   // If GetRecordLength() fails.
   if ((i = btrieveBulkRetrieveResult.GetRecordLength(1)) != sizeof(record))
   {
      status = btrieveBulkRetrieveResult.GetLastStatusCode();
      printf("Error: BtrieveBulkRetrieveResult::GetRecordLength():%d:%s.\n", status, Btrieve::StatusCodeToString(status));
      goto leave;
   }

Return values

>= 0	The record length.
-1	An error has occurred. Use BtrieveBulkRetrieveResult::GetLastStatusCode to determine the Btrieve::StatusCode associated with any error.

Examples:

bfilter.cpp, and btestbulk.cpp.