Tkrzw
Public Member Functions | Friends | List of all members
tkrzw::StdTreeDBM::Iterator Class Referencefinal

Iterator for each record. More...

#include <tkrzw_dbm_std.h>

Public Member Functions

 ~Iterator ()
 Destructor. More...
 
 Iterator (const Iterator &rhs)=delete
 Copy and assignment are disabled. More...
 
Iteratoroperator= (const Iterator &rhs)=delete
 
Status First () override
 Initializes the iterator to indicate the first record. More...
 
Status Last () override
 Initializes the iterator to indicate the last record. More...
 
Status Jump (std::string_view key) override
 Initializes the iterator to indicate a specific record. More...
 
Status JumpLower (std::string_view key, bool inclusive=false) override
 Initializes the iterator to indicate the last record whose key is lower than a given key. More...
 
Status JumpUpper (std::string_view key, bool inclusive=false) override
 Initializes the iterator to indicate the first record whose key is upper than a given key. More...
 
Status Next () override
 Moves the iterator to the next record. More...
 
Status Previous () override
 Moves the iterator to the previous record. More...
 
Status Process (RecordProcessor *proc, bool writable) override
 Processes the current record with a processor. More...
 
- Public Member Functions inherited from tkrzw::DBM::Iterator
virtual Status Process (RecordLambdaType rec_lambda, bool writable)
 Processes the current record with a lambda function. More...
 
virtual Status Get (std::string *key=nullptr, std::string *value=nullptr)
 Gets the key and the value of the current record of the iterator. More...
 
virtual std::string GetKey (std::string_view default_value="")
 Gets the key of the current record, in a simple way. More...
 
virtual std::string GetValue (std::string_view default_value="")
 Gets the value of the current record, in a simple way. More...
 
virtual Status Set (std::string_view value, std::string *old_key=nullptr, std::string *old_value=nullptr)
 Sets the value of the current record. More...
 
virtual Status Remove (std::string *old_key=nullptr, std::string *old_value=nullptr)
 Removes the current record. More...
 
virtual Status Step (std::string *key=nullptr, std::string *value=nullptr)
 Gets the current record and moves the iterator to the next record. More...
 

Friends

class StdTreeDBM
 

Detailed Description

Iterator for each record.

When the database is updated, some iterators may or may not be invalided. Operations with invalidated iterators fails gracefully with NOT_FOUND_ERROR. One iterator cannot be shared by multiple threads.

Constructor & Destructor Documentation

◆ ~Iterator()

tkrzw::StdTreeDBM::Iterator::~Iterator ( )
virtual

Destructor.

Reimplemented from tkrzw::DBM::Iterator.

◆ Iterator()

tkrzw::StdTreeDBM::Iterator::Iterator ( const Iterator rhs)
explicitdelete

Copy and assignment are disabled.

Member Function Documentation

◆ First()

Status tkrzw::StdTreeDBM::Iterator::First ( )
overridevirtual

Initializes the iterator to indicate the first record.

Returns
The result status.

Even if there's no record, the operation doesn't fail.

Implements tkrzw::DBM::Iterator.

◆ Last()

Status tkrzw::StdTreeDBM::Iterator::Last ( )
overridevirtual

Initializes the iterator to indicate the last record.

Returns
The result status.

Even if there's no record, the operation doesn't fail.

Implements tkrzw::DBM::Iterator.

◆ Jump()

Status tkrzw::StdTreeDBM::Iterator::Jump ( std::string_view  key)
overridevirtual

Initializes the iterator to indicate a specific record.

Parameters
keyThe key of the record to look for.
Returns
The result status.

This database is ordered so it supports "lower bound" jump. If there's no record with the same key, the iterator refers to the first record whose key is greater than the given key.

Implements tkrzw::DBM::Iterator.

◆ JumpLower()

Status tkrzw::StdTreeDBM::Iterator::JumpLower ( std::string_view  key,
bool  inclusive = false 
)
overridevirtual

Initializes the iterator to indicate the last record whose key is lower than a given key.

Parameters
keyThe key to compare with.
inclusiveIf true, the considtion is inclusive: equal to or lower than the key.
Returns
The result status.

Even if there's no matching record, the operation doesn't fail.

Implements tkrzw::DBM::Iterator.

◆ JumpUpper()

Status tkrzw::StdTreeDBM::Iterator::JumpUpper ( std::string_view  key,
bool  inclusive = false 
)
overridevirtual

Initializes the iterator to indicate the first record whose key is upper than a given key.

Parameters
keyThe key to compare with.
inclusiveIf true, the considtion is inclusive: equal to or upper than the key.
Returns
The result status.

Even if there's no matching record, the operation doesn't fail. If the inclusive parameter is true, this method is the same as Jump(key).

Implements tkrzw::DBM::Iterator.

◆ Next()

Status tkrzw::StdTreeDBM::Iterator::Next ( )
overridevirtual

Moves the iterator to the next record.

Returns
The result status.

If the current record is missing, the operation fails. Even if there's no next record, the operation doesn't fail.

Implements tkrzw::DBM::Iterator.

◆ Previous()

Status tkrzw::StdTreeDBM::Iterator::Previous ( )
overridevirtual

Moves the iterator to the previous record.

Returns
The result status.

If the current record is missing, the operation fails. Even if there's no previous previous record, the operation doesn't fail.

Implements tkrzw::DBM::Iterator.

◆ Process()

Status tkrzw::StdTreeDBM::Iterator::Process ( RecordProcessor proc,
bool  writable 
)
overridevirtual

Processes the current record with a processor.

Parameters
procThe pointer to the processor object.
writableTrue if the processor can edit the record.
Returns
The result status.

If the current record exists, the ProcessFull of the processor is called. Otherwise, this method fails and no method of the processor is called. If the current record is removed, the iterator is moved to the next record.

Implements tkrzw::DBM::Iterator.