$darkmode
Defines the record iterator class for Table-based iterators. More...
Public Member Functions | |
constructor (AbstractDatasource ds, *hash< auto > where_cond, hash< auto > select_options) | |
Creates the iterator. More... | |
auto | memberGate (string key) |
Returns the value of the given field in the current record, if the iterator is valid. More... | |
bool | next () |
Moves the current position to the next element; returns False if there are no more elements. More... | |
![]() | |
constructor (bool release_transaction, AbstractSQLStatement stmt) | |
creates the iterator More... | |
destructor () | |
rolls back the transaction if a transaction lock was acquired in the constructor and keepTransactionLock() was not called | |
*hash< string, AbstractDataField > | getRecordType () |
Returns the record description, if available. More... | |
hash< auto > | getValue () |
Returns a single record if the iterator is valid. More... | |
keepTransactionLock () | |
Ensures that no rollback is performed when the object is destroyed. | |
bool | next () |
Increments the row pointer when retrieving rows from a select statement; returns True if there is a row to retrieve, False if not. More... | |
bool | valid () |
Returns True if the iterator is valid. More... | |
Static Protected Member Functions | |
static AbstractSQLStatement | prepareStatement (AbstractSQLStatement stmt, hash< auto > select_options) |
Prepares the AbstractSQLStatement object for the iterator. | |
Protected Attributes | |
*hash< auto > | where_cond |
search conditions | |
![]() | |
bool | release_transaction |
release the transaction with a rollback in the destructor? | |
AbstractSQLStatement | stmt |
the statement being iterated | |
Defines the record iterator class for Table-based iterators.
DbDataProvider::DbSelectRecordIterator::constructor | ( | AbstractDatasource | ds, |
*hash< auto > | where_cond, | ||
hash< auto > | select_options | ||
) |
Creates the iterator.
ds | the datasource to use |
where_cond | the search conditions to apply to the result set from the SQL |
search_options | search options; assumed to have already been processed for validity before this call; contains:
|
auto DbDataProvider::DbSelectRecordIterator::memberGate | ( | string | key | ) |
Returns the value of the given field in the current record, if the iterator is valid.
key | the name of the field |
FIELD-ERROR | invalid or unknown field name |
bool DbDataProvider::DbSelectRecordIterator::next | ( | ) |
Moves the current position to the next element; returns False if there are no more elements.
This method will return True again after it returns False once if the object being iterated is not empty, otherwise it will always return False. The iterator object should not be used after this method returns False