<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>Kyoto Cabinet: kyotocabinet::CacheDB::Cursor Class Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.6.3 -->
<div class="navigation" id="top">
<div class="tabs">
<ul>
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li class="current"><a href="annotated.html"><span>Classes</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
</ul>
</div>
<div class="tabs">
<ul>
<li><a href="annotated.html"><span>Class List</span></a></li>
<li><a href="classes.html"><span>Class Index</span></a></li>
<li><a href="hierarchy.html"><span>Class Hierarchy</span></a></li>
<li><a href="functions.html"><span>Class Members</span></a></li>
</ul>
</div>
<div class="navpath"><a class="el" href="namespacekyotocabinet.html">kyotocabinet</a>::<a class="el" href="classkyotocabinet_1_1CacheDB.html">CacheDB</a>::<a class="el" href="classkyotocabinet_1_1CacheDB_1_1Cursor.html">Cursor</a>
</div>
</div>
<div class="contents">
<h1>kyotocabinet::CacheDB::Cursor Class Reference</h1><!-- doxytag: class="kyotocabinet::CacheDB::Cursor" --><!-- doxytag: inherits="kyotocabinet::BasicDB::Cursor" -->
<p><a class="el" href="classkyotocabinet_1_1CacheDB_1_1Cursor.html" title="Cursor to indicate a record.">Cursor</a> to indicate a record.
<a href="#_details">More...</a></p>
<p><code>#include <kccachedb.h></code></p>
<p><a href="classkyotocabinet_1_1CacheDB_1_1Cursor-members.html">List of all members.</a></p>
<table border="0" cellpadding="0" cellspacing="0">
<tr><td colspan="2"><h2>Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classkyotocabinet_1_1CacheDB_1_1Cursor.html#a3bc6f2b2a03fe2f026f87d9c1d2c0fa4">Cursor</a> (<a class="el" href="classkyotocabinet_1_1CacheDB.html">CacheDB</a> *db)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Constructor. <a href="#a3bc6f2b2a03fe2f026f87d9c1d2c0fa4"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="classkyotocabinet_1_1CacheDB_1_1Cursor.html#a8b67ecadd10bef6445e2feb1ef40771a">~Cursor</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Destructor. <a href="#a8b67ecadd10bef6445e2feb1ef40771a"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classkyotocabinet_1_1CacheDB_1_1Cursor.html#aadf8106bae01dc6751227a180cafa961">accept</a> (<a class="el" href="classkyotocabinet_1_1DB_1_1Visitor.html">Visitor</a> *visitor, bool writable=true, bool step=false)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Accept a visitor to the current record. <a href="#aadf8106bae01dc6751227a180cafa961"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classkyotocabinet_1_1CacheDB_1_1Cursor.html#aa72a1b7f65e5e848cbcd683a54adcdd3">jump</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Jump the cursor to the first record for forward scan. <a href="#aa72a1b7f65e5e848cbcd683a54adcdd3"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classkyotocabinet_1_1CacheDB_1_1Cursor.html#aaf84c6fa4298d5382def5293abfffe25">jump</a> (const char *kbuf, size_t ksiz)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Jump the cursor to a record for forward scan. <a href="#aaf84c6fa4298d5382def5293abfffe25"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classkyotocabinet_1_1CacheDB_1_1Cursor.html#a1d4cce3ed58fe9b52550ccdc64d1d004">jump</a> (const std::string &key)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Jump the cursor to a record for forward scan. <a href="#a1d4cce3ed58fe9b52550ccdc64d1d004"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classkyotocabinet_1_1CacheDB_1_1Cursor.html#aab96a44524b402431358d3d44d71bc81">jump_back</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Jump the cursor to the last record for backward scan. <a href="#aab96a44524b402431358d3d44d71bc81"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classkyotocabinet_1_1CacheDB_1_1Cursor.html#a95fce8986442fce9647cb3e54e4a2eb7">jump_back</a> (const char *kbuf, size_t ksiz)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Jump the cursor to a record for backward scan. <a href="#a95fce8986442fce9647cb3e54e4a2eb7"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classkyotocabinet_1_1CacheDB_1_1Cursor.html#ad7a1312532a0709e99fb63be9fc42d2e">jump_back</a> (const std::string &key)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Jump the cursor to a record for backward scan. <a href="#ad7a1312532a0709e99fb63be9fc42d2e"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classkyotocabinet_1_1CacheDB_1_1Cursor.html#a31e009c3df7d4baf4cde3a2b3367fa6a">step</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Step the cursor to the next record. <a href="#a31e009c3df7d4baf4cde3a2b3367fa6a"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classkyotocabinet_1_1CacheDB_1_1Cursor.html#a19f77d1a2fe78560d5ee4078c86445a0">step_back</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Step the cursor to the previous record. <a href="#a19f77d1a2fe78560d5ee4078c86445a0"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classkyotocabinet_1_1CacheDB.html">CacheDB</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classkyotocabinet_1_1CacheDB_1_1Cursor.html#a53297e2dc505eca116e97e5419686279">db</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the database object. <a href="#a53297e2dc505eca116e97e5419686279"></a><br/></td></tr>
<tr><td colspan="2"><h2>Friends</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a30ec58953e80cf8caa138c774b99798d"></a><!-- doxytag: member="kyotocabinet::CacheDB::Cursor::CacheDB" ref="a30ec58953e80cf8caa138c774b99798d" args="" -->
class </td><td class="memItemRight" valign="bottom"><b>CacheDB</b></td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p><a class="el" href="classkyotocabinet_1_1CacheDB_1_1Cursor.html" title="Cursor to indicate a record.">Cursor</a> to indicate a record. </p>
<hr/><h2>Constructor & Destructor Documentation</h2>
<a class="anchor" id="a3bc6f2b2a03fe2f026f87d9c1d2c0fa4"></a><!-- doxytag: member="kyotocabinet::CacheDB::Cursor::Cursor" ref="a3bc6f2b2a03fe2f026f87d9c1d2c0fa4" args="(CacheDB *db)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">kyotocabinet::CacheDB::Cursor::Cursor </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classkyotocabinet_1_1CacheDB.html">CacheDB</a> * </td>
<td class="paramname"> <em>db</em></td>
<td> ) </td>
<td><code> [explicit]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Constructor. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>db</em> </td><td>the container database object. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a8b67ecadd10bef6445e2feb1ef40771a"></a><!-- doxytag: member="kyotocabinet::CacheDB::Cursor::~Cursor" ref="a8b67ecadd10bef6445e2feb1ef40771a" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual kyotocabinet::CacheDB::Cursor::~Cursor </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Destructor. </p>
<p>Reimplemented from <a class="el" href="classkyotocabinet_1_1BasicDB_1_1Cursor.html#a0e93160f1599c0063b6db4226216cfb3">kyotocabinet::BasicDB::Cursor</a>.</p>
</div>
</div>
<hr/><h2>Member Function Documentation</h2>
<a class="anchor" id="aadf8106bae01dc6751227a180cafa961"></a><!-- doxytag: member="kyotocabinet::CacheDB::Cursor::accept" ref="aadf8106bae01dc6751227a180cafa961" args="(Visitor *visitor, bool writable=true, bool step=false)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool kyotocabinet::CacheDB::Cursor::accept </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classkyotocabinet_1_1DB_1_1Visitor.html">Visitor</a> * </td>
<td class="paramname"> <em>visitor</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>writable</em> = <code>true</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>step</em> = <code>false</code></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Accept a visitor to the current record. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>visitor</em> </td><td>a visitor object. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>writable</em> </td><td>true for writable operation, or false for read-only operation. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>step</em> </td><td>true to move the cursor to the next record, or false for no move. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>true on success, or false on failure. </dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>The operation for each record is performed atomically and other threads accessing the same record are blocked. To avoid deadlock, any database operation must not be performed in this function. </dd></dl>
<p>Implements <a class="el" href="classkyotocabinet_1_1DB_1_1Cursor.html#af19b3472aeec03686a074dae416c8ed3">kyotocabinet::DB::Cursor</a>.</p>
</div>
</div>
<a class="anchor" id="aa72a1b7f65e5e848cbcd683a54adcdd3"></a><!-- doxytag: member="kyotocabinet::CacheDB::Cursor::jump" ref="aa72a1b7f65e5e848cbcd683a54adcdd3" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool kyotocabinet::CacheDB::Cursor::jump </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Jump the cursor to the first record for forward scan. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>true on success, or false on failure. </dd></dl>
<p>Implements <a class="el" href="classkyotocabinet_1_1DB_1_1Cursor.html#a9b7e9982b948d66a4d2a0295229ac4c1">kyotocabinet::DB::Cursor</a>.</p>
</div>
</div>
<a class="anchor" id="aaf84c6fa4298d5382def5293abfffe25"></a><!-- doxytag: member="kyotocabinet::CacheDB::Cursor::jump" ref="aaf84c6fa4298d5382def5293abfffe25" args="(const char *kbuf, size_t ksiz)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool kyotocabinet::CacheDB::Cursor::jump </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>kbuf</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">size_t </td>
<td class="paramname"> <em>ksiz</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Jump the cursor to a record for forward scan. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>kbuf</em> </td><td>the pointer to the key region. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>ksiz</em> </td><td>the size of the key region. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>true on success, or false on failure. </dd></dl>
<p>Implements <a class="el" href="classkyotocabinet_1_1DB_1_1Cursor.html#af5ce800de2275a5e912265fd9afc896d">kyotocabinet::DB::Cursor</a>.</p>
</div>
</div>
<a class="anchor" id="a1d4cce3ed58fe9b52550ccdc64d1d004"></a><!-- doxytag: member="kyotocabinet::CacheDB::Cursor::jump" ref="a1d4cce3ed58fe9b52550ccdc64d1d004" args="(const std::string &key)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool kyotocabinet::CacheDB::Cursor::jump </td>
<td>(</td>
<td class="paramtype">const std::string & </td>
<td class="paramname"> <em>key</em></td>
<td> ) </td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Jump the cursor to a record for forward scan. </p>
<dl class="note"><dt><b>Note:</b></dt><dd>Equal to the original <a class="el" href="classkyotocabinet_1_1CacheDB_1_1Cursor.html#aa72a1b7f65e5e848cbcd683a54adcdd3" title="Jump the cursor to the first record for forward scan.">Cursor::jump</a> method except that the parameter is std::string. </dd></dl>
<p>Implements <a class="el" href="classkyotocabinet_1_1DB_1_1Cursor.html#a3b38a11631f37d104209e5feade154b4">kyotocabinet::DB::Cursor</a>.</p>
</div>
</div>
<a class="anchor" id="aab96a44524b402431358d3d44d71bc81"></a><!-- doxytag: member="kyotocabinet::CacheDB::Cursor::jump_back" ref="aab96a44524b402431358d3d44d71bc81" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool kyotocabinet::CacheDB::Cursor::jump_back </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Jump the cursor to the last record for backward scan. </p>
<dl class="note"><dt><b>Note:</b></dt><dd>This is a dummy implementation for compatibility. </dd></dl>
<p>Implements <a class="el" href="classkyotocabinet_1_1DB_1_1Cursor.html#a65452f182db3cd688885c460a761fa9c">kyotocabinet::DB::Cursor</a>.</p>
</div>
</div>
<a class="anchor" id="a95fce8986442fce9647cb3e54e4a2eb7"></a><!-- doxytag: member="kyotocabinet::CacheDB::Cursor::jump_back" ref="a95fce8986442fce9647cb3e54e4a2eb7" args="(const char *kbuf, size_t ksiz)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool kyotocabinet::CacheDB::Cursor::jump_back </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>kbuf</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">size_t </td>
<td class="paramname"> <em>ksiz</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Jump the cursor to a record for backward scan. </p>
<dl class="note"><dt><b>Note:</b></dt><dd>This is a dummy implementation for compatibility. </dd></dl>
<p>Implements <a class="el" href="classkyotocabinet_1_1DB_1_1Cursor.html#a4456015ac4c0248aebcabb03e195e860">kyotocabinet::DB::Cursor</a>.</p>
</div>
</div>
<a class="anchor" id="ad7a1312532a0709e99fb63be9fc42d2e"></a><!-- doxytag: member="kyotocabinet::CacheDB::Cursor::jump_back" ref="ad7a1312532a0709e99fb63be9fc42d2e" args="(const std::string &key)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool kyotocabinet::CacheDB::Cursor::jump_back </td>
<td>(</td>
<td class="paramtype">const std::string & </td>
<td class="paramname"> <em>key</em></td>
<td> ) </td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Jump the cursor to a record for backward scan. </p>
<dl class="note"><dt><b>Note:</b></dt><dd>This is a dummy implementation for compatibility. </dd></dl>
<p>Implements <a class="el" href="classkyotocabinet_1_1DB_1_1Cursor.html#a9d392717ad801064a36220a91f907c1d">kyotocabinet::DB::Cursor</a>.</p>
</div>
</div>
<a class="anchor" id="a31e009c3df7d4baf4cde3a2b3367fa6a"></a><!-- doxytag: member="kyotocabinet::CacheDB::Cursor::step" ref="a31e009c3df7d4baf4cde3a2b3367fa6a" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool kyotocabinet::CacheDB::Cursor::step </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Step the cursor to the next record. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>true on success, or false on failure. </dd></dl>
<p>Implements <a class="el" href="classkyotocabinet_1_1DB_1_1Cursor.html#a312228bd858d3091e32b65f1128faab4">kyotocabinet::DB::Cursor</a>.</p>
</div>
</div>
<a class="anchor" id="a19f77d1a2fe78560d5ee4078c86445a0"></a><!-- doxytag: member="kyotocabinet::CacheDB::Cursor::step_back" ref="a19f77d1a2fe78560d5ee4078c86445a0" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool kyotocabinet::CacheDB::Cursor::step_back </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Step the cursor to the previous record. </p>
<dl class="note"><dt><b>Note:</b></dt><dd>This is a dummy implementation for compatibility. </dd></dl>
<p>Implements <a class="el" href="classkyotocabinet_1_1DB_1_1Cursor.html#a1eb720a41b9bad81f3dd6621870133d5">kyotocabinet::DB::Cursor</a>.</p>
</div>
</div>
<a class="anchor" id="a53297e2dc505eca116e97e5419686279"></a><!-- doxytag: member="kyotocabinet::CacheDB::Cursor::db" ref="a53297e2dc505eca116e97e5419686279" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classkyotocabinet_1_1CacheDB.html">CacheDB</a>* kyotocabinet::CacheDB::Cursor::db </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get the database object. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>the database object. </dd></dl>
<p>Implements <a class="el" href="classkyotocabinet_1_1BasicDB_1_1Cursor.html#a79e3904e5b10ed3d356545ed4259160e">kyotocabinet::BasicDB::Cursor</a>.</p>
</div>
</div>
</div>
<hr class="footer"/><address style="text-align: right;"><small>Generated on Mon Jan 3 13:02:27 2011 for Kyoto Cabinet by
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.3 </small></address>
</body>
</html>
