kyotocabinet::BasicDB::Cursor Class Reference

Interface of cursor to indicate a record. More...

#include <kcdb.h>

Public Member Functions
virtual	~Cursor ()
	Destructor.
bool	set_value (const char *vbuf, size_t vsiz, bool step=false)
	Set the value of the current record.
bool	set_value_str (const std::string &value, bool step=false)
	Set the value of the current record.
bool	remove ()
	Remove the current record.
char *	get_key (size_t *sp, bool step=false)
	Get the key of the current record.
std::string *	get_key (bool step=false)
	Get the key of the current record.
char *	get_value (size_t *sp, bool step=false)
	Get the value of the current record.
std::string *	get_value (bool step=false)
	Get the value of the current record.
char *	get (size_t ksp, const char vbp, size_t vsp, bool step=false)
	Get a pair of the key and the value of the current record.
std::pair< std::string, std::string > *	get_pair (bool step=false)
	Get a pair of the key and the value of the current record.
virtual BasicDB *	db ()=0
	Get the database object.
Error	error ()
	Get the last happened error.

Detailed Description

Interface of cursor to indicate a record.

Constructor & Destructor Documentation

virtual kyotocabinet::BasicDB::Cursor::~Cursor ( ) [virtual]

Destructor.

Reimplemented from kyotocabinet::DB::Cursor.

Reimplemented in kyotocabinet::CacheDB::Cursor, kyotocabinet::DirDB::Cursor, kyotocabinet::HashDB::Cursor, kyotocabinet::PlantDB< BASEDB, DBTYPE >::Cursor, kyotocabinet::PolyDB::Cursor, kyotocabinet::ProtoDB< STRMAP, DBTYPE >::Cursor, and kyotocabinet::StashDB::Cursor.

Member Function Documentation

bool kyotocabinet::BasicDB::Cursor::set_value	(	const char *	vbuf,
		size_t	vsiz,
		bool	step = `false`
	)			`[virtual]`

Set the value of the current record.

Parameters:

	vbuf	the pointer to the value region.
	vsiz	the size of the value region.
	step	true to move the cursor to the next record, or false for no move.

Returns:: true on success, or false on failure.

Implements kyotocabinet::DB::Cursor.

bool kyotocabinet::BasicDB::Cursor::set_value_str	(	const std::string &	value,
		bool	step = `false`
	)			`[virtual]`

Set the value of the current record.

Note:: Equal to the original Cursor::set_value method except that the parameter is std::string.

Implements kyotocabinet::DB::Cursor.

bool kyotocabinet::BasicDB::Cursor::remove ( ) [virtual]

Remove the current record.

Returns:: true on success, or false on failure.

Note:: If no record corresponds to the key, false is returned. The cursor is moved to the next record implicitly.

Implements kyotocabinet::DB::Cursor.

char* kyotocabinet::BasicDB::Cursor::get_key	(	size_t *	sp,
		bool	step = `false`
	)			`[virtual]`

Get the key of the current record.

Parameters:

	sp	the pointer to the variable into which the size of the region of the return value is assigned.
	step	true to move the cursor to the next record, or false for no move.

Returns:: the pointer to the key region of the current record, or NULL on failure.

Note:: If the cursor is invalidated, NULL is returned. Because an additional zero code is appended at the end of the region of the return value, the return value can be treated as a C-style string. Because the region of the return value is allocated with the the new[] operator, it should be released with the delete[] operator when it is no longer in use.

Implements kyotocabinet::DB::Cursor.

std::string* kyotocabinet::BasicDB::Cursor::get_key ( bool step = false ) [virtual]

Get the key of the current record.

Note:: Equal to the original Cursor::key method except that the parameter and the return value are std::string.

Implements kyotocabinet::DB::Cursor.

char* kyotocabinet::BasicDB::Cursor::get_value	(	size_t *	sp,
		bool	step = `false`
	)			`[virtual]`

Get the value of the current record.

Parameters:

	sp	the pointer to the variable into which the size of the region of the return value is assigned.
	step	true to move the cursor to the next record, or false for no move.

Returns:: the pointer to the value region of the current record, or NULL on failure.

Note:: If the cursor is invalidated, NULL is returned. Because an additional zero code is appended at the end of the region of the return value, the return value can be treated as a C-style string. Because the region of the return value is allocated with the the new[] operator, it should be released with the delete[] operator when it is no longer in use.

Implements kyotocabinet::DB::Cursor.

std::string* kyotocabinet::BasicDB::Cursor::get_value ( bool step = false ) [virtual]

Get the value of the current record.

Note:: Equal to the original Cursor::value method except that the parameter and the return value are std::string.

Implements kyotocabinet::DB::Cursor.

char* kyotocabinet::BasicDB::Cursor::get	(	size_t *	ksp,
		const char **	vbp,
		size_t *	vsp,
		bool	step = `false`
	)			`[virtual]`

Get a pair of the key and the value of the current record.

Parameters:

	ksp	the pointer to the variable into which the size of the region of the return value is assigned.
	vbp	the pointer to the variable into which the pointer to the value region is assigned.
	vsp	the pointer to the variable into which the size of the value region is assigned.
	step	true to move the cursor to the next record, or false for no move.

Returns:: the pointer to the key region, or NULL on failure.

Note:: If the cursor is invalidated, NULL is returned. Because an additional zero code is appended at the end of each region of the key and the value, each region can be treated as a C-style string. The return value should be deleted explicitly by the caller with the detele[] operator.

Implements kyotocabinet::DB::Cursor.

std::pair<std::string, std::string>* kyotocabinet::BasicDB::Cursor::get_pair ( bool step = false ) [virtual]

Get a pair of the key and the value of the current record.