SQLiteCpp/doc/html/class_s_q_lite_1_1_statement.html
2013-03-10 20:57:10 +01:00

1043 lines
62 KiB
HTML

<!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"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.3.1"/>
<title>SQLiteC++: SQLite::Statement Class Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="navtree.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="resize.js"></script>
<script type="text/javascript" src="navtree.js"></script>
<script type="text/javascript">
$(document).ready(initResizable);
$(window).load(resizeHeight);
</script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/search.js"></script>
<script type="text/javascript">
$(document).ready(function() { searchBox.OnSelectItem(0); });
</script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td style="padding-left: 0.5em;">
<div id="projectname">SQLiteC++
&#160;<span id="projectnumber">0.5.0</span>
</div>
<div id="projectbrief">SQLiteC++ is a smart and easy to use C++ SQLite3 wrapper.</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.3.1 -->
<script type="text/javascript">
var searchBox = new SearchBox("searchBox", "search",false,'Search');
</script>
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main&#160;Page</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>
<li>
<div id="MSearchBox" class="MSearchBoxInactive">
<span class="left">
<img id="MSearchSelect" src="search/mag_sel.png"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
alt=""/>
<input type="text" id="MSearchField" value="Search" accesskey="S"
onfocus="searchBox.OnSearchFieldFocus(true)"
onblur="searchBox.OnSearchFieldFocus(false)"
onkeyup="searchBox.OnSearchFieldChange(event)"/>
</span><span class="right">
<a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
</span>
</div>
</li>
</ul>
</div>
<div id="navrow2" class="tabs2">
<ul class="tablist">
<li><a href="annotated.html"><span>Class&#160;List</span></a></li>
<li><a href="classes.html"><span>Class&#160;Index</span></a></li>
<li><a href="inherits.html"><span>Class&#160;Hierarchy</span></a></li>
<li><a href="functions.html"><span>Class&#160;Members</span></a></li>
</ul>
</div>
</div><!-- top -->
<div id="side-nav" class="ui-resizable side-nav-resizable">
<div id="nav-tree">
<div id="nav-tree-contents">
<div id="nav-sync" class="sync"></div>
</div>
</div>
<div id="splitbar" style="-moz-user-select:none;"
class="ui-resizable-handle">
</div>
</div>
<script type="text/javascript">
$(document).ready(function(){initNavTree('class_s_q_lite_1_1_statement.html','');});
</script>
<div id="doc-content">
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
onkeydown="return searchBox.OnSearchSelectKey(event)">
<a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(0)"><span class="SelectionMark">&#160;</span>All</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(1)"><span class="SelectionMark">&#160;</span>Classes</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(2)"><span class="SelectionMark">&#160;</span>Namespaces</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(3)"><span class="SelectionMark">&#160;</span>Files</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(4)"><span class="SelectionMark">&#160;</span>Functions</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(5)"><span class="SelectionMark">&#160;</span>Friends</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(6)"><span class="SelectionMark">&#160;</span>Macros</a></div>
<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0"
name="MSearchResults" id="MSearchResults">
</iframe>
</div>
<div class="header">
<div class="summary">
<a href="#nested-classes">Classes</a> &#124;
<a href="#pub-methods">Public Member Functions</a> &#124;
<a href="class_s_q_lite_1_1_statement-members.html">List of all members</a> </div>
<div class="headertitle">
<div class="title">SQLite::Statement Class Reference</div> </div>
</div><!--header-->
<div class="contents">
<p>RAII encapsulation of a prepared <a class="el" href="namespace_s_q_lite.html">SQLite</a> <a class="el" href="class_s_q_lite_1_1_statement.html" title="RAII encapsulation of a prepared SQLite Statement.">Statement</a>.
<a href="class_s_q_lite_1_1_statement.html#details">More...</a></p>
<p><code>#include &lt;<a class="el" href="_statement_8h_source.html">Statement.h</a>&gt;</code></p>
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="nested-classes"></a>
Classes</h2></td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">class &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_s_q_lite_1_1_statement_1_1_ptr.html">Ptr</a></td></tr>
<tr class="memdesc:"><td class="mdescLeft">&#160;</td><td class="mdescRight">Shared pointer to the sqlite3_stmt <a class="el" href="namespace_s_q_lite.html">SQLite</a> <a class="el" href="class_s_q_lite_1_1_statement.html" title="RAII encapsulation of a prepared SQLite Statement.">Statement</a> Object. <a href="class_s_q_lite_1_1_statement_1_1_ptr.html#details">More...</a><br/></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2">&#160;</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-methods"></a>
Public Member Functions</h2></td></tr>
<tr class="memitem:ab17c2c71de7224fcdf2252603e463cb9"><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_s_q_lite_1_1_statement.html#ab17c2c71de7224fcdf2252603e463cb9">Statement</a> (<a class="el" href="class_s_q_lite_1_1_database.html">Database</a> &amp;aDatabase, const char *apQuery)</td></tr>
<tr class="memdesc:ab17c2c71de7224fcdf2252603e463cb9"><td class="mdescLeft">&#160;</td><td class="mdescRight">Compile and register the SQL query for the provided <a class="el" href="namespace_s_q_lite.html">SQLite</a> <a class="el" href="class_s_q_lite_1_1_database.html" title="RAII management of a SQLite Database Connection.">Database</a> Connection. <a href="#ab17c2c71de7224fcdf2252603e463cb9">More...</a><br/></td></tr>
<tr class="separator:ab17c2c71de7224fcdf2252603e463cb9"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a5ca54a9bf0fba1af2a077c8fe5579f00"><td class="memItemLeft" align="right" valign="top">virtual&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_s_q_lite_1_1_statement.html#a5ca54a9bf0fba1af2a077c8fe5579f00">~Statement</a> (void) throw ()</td></tr>
<tr class="memdesc:a5ca54a9bf0fba1af2a077c8fe5579f00"><td class="mdescLeft">&#160;</td><td class="mdescRight">Finalize and unregister the SQL query from the <a class="el" href="namespace_s_q_lite.html">SQLite</a> <a class="el" href="class_s_q_lite_1_1_database.html" title="RAII management of a SQLite Database Connection.">Database</a> Connection. <a href="#a5ca54a9bf0fba1af2a077c8fe5579f00">More...</a><br/></td></tr>
<tr class="separator:a5ca54a9bf0fba1af2a077c8fe5579f00"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:aef7da8a8dd11f1604d10aab9a025cb54"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_s_q_lite_1_1_statement.html#aef7da8a8dd11f1604d10aab9a025cb54">reset</a> (void)</td></tr>
<tr class="memdesc:aef7da8a8dd11f1604d10aab9a025cb54"><td class="mdescLeft">&#160;</td><td class="mdescRight">Reset the statement to make it ready for a new execution. <a href="#aef7da8a8dd11f1604d10aab9a025cb54">More...</a><br/></td></tr>
<tr class="separator:aef7da8a8dd11f1604d10aab9a025cb54"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a265f4a381704d7ce94855d49db2c52e9"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_s_q_lite_1_1_statement.html#a265f4a381704d7ce94855d49db2c52e9">bind</a> (const int aIndex, const int &amp;aValue)</td></tr>
<tr class="memdesc:a265f4a381704d7ce94855d49db2c52e9"><td class="mdescLeft">&#160;</td><td class="mdescRight">Bind an int value to a parameter "?", "?NNN", ":VVV", "@VVV" or "$VVV" in the SQL prepared statement (aIndex &gt;= 1) <a href="#a265f4a381704d7ce94855d49db2c52e9">More...</a><br/></td></tr>
<tr class="separator:a265f4a381704d7ce94855d49db2c52e9"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a4a89af0c77c2ae7af1bcdebeabeda2f4"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_s_q_lite_1_1_statement.html#a4a89af0c77c2ae7af1bcdebeabeda2f4">bind</a> (const int aIndex, const sqlite3_int64 &amp;aValue)</td></tr>
<tr class="memdesc:a4a89af0c77c2ae7af1bcdebeabeda2f4"><td class="mdescLeft">&#160;</td><td class="mdescRight">Bind a 64bits int value to a parameter "?", "?NNN", ":VVV", "@VVV" or "$VVV" in the SQL prepared statement (aIndex &gt;= 1) <a href="#a4a89af0c77c2ae7af1bcdebeabeda2f4">More...</a><br/></td></tr>
<tr class="separator:a4a89af0c77c2ae7af1bcdebeabeda2f4"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:adbf6beb2c6bbf7caaebb673691e8a0e5"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_s_q_lite_1_1_statement.html#adbf6beb2c6bbf7caaebb673691e8a0e5">bind</a> (const int aIndex, const double &amp;aValue)</td></tr>
<tr class="memdesc:adbf6beb2c6bbf7caaebb673691e8a0e5"><td class="mdescLeft">&#160;</td><td class="mdescRight">Bind a double (64bits float) value to a parameter "?", "?NNN", ":VVV", "@VVV" or "$VVV" in the SQL prepared statement (aIndex &gt;= 1) <a href="#adbf6beb2c6bbf7caaebb673691e8a0e5">More...</a><br/></td></tr>
<tr class="separator:adbf6beb2c6bbf7caaebb673691e8a0e5"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:af0e1944016ab0181a2ecdb91e3d9c8d5"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_s_q_lite_1_1_statement.html#af0e1944016ab0181a2ecdb91e3d9c8d5">bind</a> (const int aIndex, const std::string &amp;aValue)</td></tr>
<tr class="memdesc:af0e1944016ab0181a2ecdb91e3d9c8d5"><td class="mdescLeft">&#160;</td><td class="mdescRight">Bind a string value to a parameter "?", "?NNN", ":VVV", "@VVV" or "$VVV" in the SQL prepared statement (aIndex &gt;= 1) <a href="#af0e1944016ab0181a2ecdb91e3d9c8d5">More...</a><br/></td></tr>
<tr class="separator:af0e1944016ab0181a2ecdb91e3d9c8d5"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a386a979e8500d9ffd84cdd2052557905"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_s_q_lite_1_1_statement.html#a386a979e8500d9ffd84cdd2052557905">bind</a> (const int aIndex, const char *apValue)</td></tr>
<tr class="memdesc:a386a979e8500d9ffd84cdd2052557905"><td class="mdescLeft">&#160;</td><td class="mdescRight">Bind a text value to a parameter "?", "?NNN", ":VVV", "@VVV" or "$VVV" in the SQL prepared statement (aIndex &gt;= 1) <a href="#a386a979e8500d9ffd84cdd2052557905">More...</a><br/></td></tr>
<tr class="separator:a386a979e8500d9ffd84cdd2052557905"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a65c31113619573cd8fca4d6d86e95b17"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_s_q_lite_1_1_statement.html#a65c31113619573cd8fca4d6d86e95b17">bind</a> (const int aIndex, const void *apValue, const int aSize)</td></tr>
<tr class="memdesc:a65c31113619573cd8fca4d6d86e95b17"><td class="mdescLeft">&#160;</td><td class="mdescRight">Bind a binary blob value to a parameter "?", "?NNN", ":VVV", "@VVV" or "$VVV" in the SQL prepared statement (aIndex &gt;= 1) <a href="#a65c31113619573cd8fca4d6d86e95b17">More...</a><br/></td></tr>
<tr class="separator:a65c31113619573cd8fca4d6d86e95b17"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:af5fb758ef7fd97ea9f841fdda68987e0"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_s_q_lite_1_1_statement.html#af5fb758ef7fd97ea9f841fdda68987e0">bind</a> (const int aIndex)</td></tr>
<tr class="memdesc:af5fb758ef7fd97ea9f841fdda68987e0"><td class="mdescLeft">&#160;</td><td class="mdescRight">Bind a NULL value to a parameter "?", "?NNN", ":VVV", "@VVV" or "$VVV" in the SQL prepared statement (aIndex &gt;= 1) <a href="#af5fb758ef7fd97ea9f841fdda68987e0">More...</a><br/></td></tr>
<tr class="separator:af5fb758ef7fd97ea9f841fdda68987e0"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a81c1dd90c065a6b4dc3914318ca16dab"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_s_q_lite_1_1_statement.html#a81c1dd90c065a6b4dc3914318ca16dab">bind</a> (const char *apName, const int &amp;aValue)</td></tr>
<tr class="memdesc:a81c1dd90c065a6b4dc3914318ca16dab"><td class="mdescLeft">&#160;</td><td class="mdescRight">Bind an int value to a named parameter "?NNN", ":VVV", "@VVV" or "$VVV" in the SQL prepared statement (aIndex &gt;= 1) <a href="#a81c1dd90c065a6b4dc3914318ca16dab">More...</a><br/></td></tr>
<tr class="separator:a81c1dd90c065a6b4dc3914318ca16dab"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ae40a2152f867c62f456661924b37ae4b"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_s_q_lite_1_1_statement.html#ae40a2152f867c62f456661924b37ae4b">bind</a> (const char *apName, const sqlite3_int64 &amp;aValue)</td></tr>
<tr class="memdesc:ae40a2152f867c62f456661924b37ae4b"><td class="mdescLeft">&#160;</td><td class="mdescRight">Bind a 64bits int value to a named parameter "?NNN", ":VVV", "@VVV" or "$VVV" in the SQL prepared statement (aIndex &gt;= 1) <a href="#ae40a2152f867c62f456661924b37ae4b">More...</a><br/></td></tr>
<tr class="separator:ae40a2152f867c62f456661924b37ae4b"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a4c43ccd2bf97f739e460c2badb97b8ab"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_s_q_lite_1_1_statement.html#a4c43ccd2bf97f739e460c2badb97b8ab">bind</a> (const char *apName, const double &amp;aValue)</td></tr>
<tr class="memdesc:a4c43ccd2bf97f739e460c2badb97b8ab"><td class="mdescLeft">&#160;</td><td class="mdescRight">Bind a double (64bits float) value to a named parameter "?NNN", ":VVV", "@VVV" or "$VVV" in the SQL prepared statement (aIndex &gt;= 1) <a href="#a4c43ccd2bf97f739e460c2badb97b8ab">More...</a><br/></td></tr>
<tr class="separator:a4c43ccd2bf97f739e460c2badb97b8ab"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a34f6445bf7a421efedf39a94459a099b"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_s_q_lite_1_1_statement.html#a34f6445bf7a421efedf39a94459a099b">bind</a> (const char *apName, const std::string &amp;aValue)</td></tr>
<tr class="memdesc:a34f6445bf7a421efedf39a94459a099b"><td class="mdescLeft">&#160;</td><td class="mdescRight">Bind a string value to a named parameter "?NNN", ":VVV", "@VVV" or "$VVV" in the SQL prepared statement (aIndex &gt;= 1) <a href="#a34f6445bf7a421efedf39a94459a099b">More...</a><br/></td></tr>
<tr class="separator:a34f6445bf7a421efedf39a94459a099b"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a921dbcb0e1df45cf5af9960517bb5faf"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_s_q_lite_1_1_statement.html#a921dbcb0e1df45cf5af9960517bb5faf">bind</a> (const char *apName, const char *apValue)</td></tr>
<tr class="memdesc:a921dbcb0e1df45cf5af9960517bb5faf"><td class="mdescLeft">&#160;</td><td class="mdescRight">Bind a text value to a named parameter "?NNN", ":VVV", "@VVV" or "$VVV" in the SQL prepared statement (aIndex &gt;= 1) <a href="#a921dbcb0e1df45cf5af9960517bb5faf">More...</a><br/></td></tr>
<tr class="separator:a921dbcb0e1df45cf5af9960517bb5faf"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a71bbd153c6235c9b89a275ead80ea2ee"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_s_q_lite_1_1_statement.html#a71bbd153c6235c9b89a275ead80ea2ee">bind</a> (const char *apName, const void *apValue, const int aSize)</td></tr>
<tr class="memdesc:a71bbd153c6235c9b89a275ead80ea2ee"><td class="mdescLeft">&#160;</td><td class="mdescRight">Bind a binary blob value to a named parameter "?NNN", ":VVV", "@VVV" or "$VVV" in the SQL prepared statement (aIndex &gt;= 1) <a href="#a71bbd153c6235c9b89a275ead80ea2ee">More...</a><br/></td></tr>
<tr class="separator:a71bbd153c6235c9b89a275ead80ea2ee"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a949c6cb4d2620376d6afaf4c55e4b3e7"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_s_q_lite_1_1_statement.html#a949c6cb4d2620376d6afaf4c55e4b3e7">bind</a> (const char *apName)</td></tr>
<tr class="memdesc:a949c6cb4d2620376d6afaf4c55e4b3e7"><td class="mdescLeft">&#160;</td><td class="mdescRight">Bind a NULL value to a named parameter "?NNN", ":VVV", "@VVV" or "$VVV" in the SQL prepared statement (aIndex &gt;= 1) <a href="#a949c6cb4d2620376d6afaf4c55e4b3e7">More...</a><br/></td></tr>
<tr class="separator:a949c6cb4d2620376d6afaf4c55e4b3e7"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:aa7f29464b5fbe4b8da92d769e52472d8"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_s_q_lite_1_1_statement.html#aa7f29464b5fbe4b8da92d769e52472d8">executeStep</a> (void)</td></tr>
<tr class="memdesc:aa7f29464b5fbe4b8da92d769e52472d8"><td class="mdescLeft">&#160;</td><td class="mdescRight">Execute a step of the prepared query to fetch one row of results. <a href="#aa7f29464b5fbe4b8da92d769e52472d8">More...</a><br/></td></tr>
<tr class="separator:aa7f29464b5fbe4b8da92d769e52472d8"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a6d78e0ae6321bc695d21f1bada8bbadb"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_s_q_lite_1_1_statement.html#a6d78e0ae6321bc695d21f1bada8bbadb">exec</a> (void)</td></tr>
<tr class="memdesc:a6d78e0ae6321bc695d21f1bada8bbadb"><td class="mdescLeft">&#160;</td><td class="mdescRight">Execute a one-step query with no expected result. <a href="#a6d78e0ae6321bc695d21f1bada8bbadb">More...</a><br/></td></tr>
<tr class="separator:a6d78e0ae6321bc695d21f1bada8bbadb"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a5b7c9372b9023a86e7242d47052f06f7"><td class="memItemLeft" align="right" valign="top"><a class="el" href="class_s_q_lite_1_1_column.html">Column</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_s_q_lite_1_1_statement.html#a5b7c9372b9023a86e7242d47052f06f7">getColumn</a> (const int aIndex)</td></tr>
<tr class="memdesc:a5b7c9372b9023a86e7242d47052f06f7"><td class="mdescLeft">&#160;</td><td class="mdescRight">Return a copie of the column data specified by its index. <a href="#a5b7c9372b9023a86e7242d47052f06f7">More...</a><br/></td></tr>
<tr class="separator:a5b7c9372b9023a86e7242d47052f06f7"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a03790608e4b945d12605e1cadf2fd9d9"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_s_q_lite_1_1_statement.html#a03790608e4b945d12605e1cadf2fd9d9">isColumnNull</a> (const int aIndex) const </td></tr>
<tr class="memdesc:a03790608e4b945d12605e1cadf2fd9d9"><td class="mdescLeft">&#160;</td><td class="mdescRight">Test if the column value is NULL. <a href="#a03790608e4b945d12605e1cadf2fd9d9">More...</a><br/></td></tr>
<tr class="separator:a03790608e4b945d12605e1cadf2fd9d9"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ab6e3b57d2b6e909b3852b927801e36d6"><td class="memItemLeft" align="right" valign="top">const std::string &amp;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_s_q_lite_1_1_statement.html#ab6e3b57d2b6e909b3852b927801e36d6">getQuery</a> (void) const </td></tr>
<tr class="memdesc:ab6e3b57d2b6e909b3852b927801e36d6"><td class="mdescLeft">&#160;</td><td class="mdescRight">Return the UTF-8 SQL Query. <a href="#ab6e3b57d2b6e909b3852b927801e36d6">More...</a><br/></td></tr>
<tr class="separator:ab6e3b57d2b6e909b3852b927801e36d6"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a97dcdc3e791836250f707fdf77fde4a4"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_s_q_lite_1_1_statement.html#a97dcdc3e791836250f707fdf77fde4a4">getColumnCount</a> (void) const </td></tr>
<tr class="memdesc:a97dcdc3e791836250f707fdf77fde4a4"><td class="mdescLeft">&#160;</td><td class="mdescRight">Return the number of columns in the result set returned by the prepared statement. <a href="#a97dcdc3e791836250f707fdf77fde4a4">More...</a><br/></td></tr>
<tr class="separator:a97dcdc3e791836250f707fdf77fde4a4"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a28e4f907c6455cd2bda8e6baa5856a40"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_s_q_lite_1_1_statement.html#a28e4f907c6455cd2bda8e6baa5856a40">isOk</a> (void) const </td></tr>
<tr class="memdesc:a28e4f907c6455cd2bda8e6baa5856a40"><td class="mdescLeft">&#160;</td><td class="mdescRight">true when a row has been fetched with <a class="el" href="class_s_q_lite_1_1_statement.html#aa7f29464b5fbe4b8da92d769e52472d8" title="Execute a step of the prepared query to fetch one row of results.">executeStep()</a> <a href="#a28e4f907c6455cd2bda8e6baa5856a40">More...</a><br/></td></tr>
<tr class="separator:a28e4f907c6455cd2bda8e6baa5856a40"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a387067802ddcb66baa9e38a2d6cbae85"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_s_q_lite_1_1_statement.html#a387067802ddcb66baa9e38a2d6cbae85">isDone</a> (void) const </td></tr>
<tr class="memdesc:a387067802ddcb66baa9e38a2d6cbae85"><td class="mdescLeft">&#160;</td><td class="mdescRight">true when the last <a class="el" href="class_s_q_lite_1_1_statement.html#aa7f29464b5fbe4b8da92d769e52472d8" title="Execute a step of the prepared query to fetch one row of results.">executeStep()</a> had no more row to fetch <a href="#a387067802ddcb66baa9e38a2d6cbae85">More...</a><br/></td></tr>
<tr class="separator:a387067802ddcb66baa9e38a2d6cbae85"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a06f6b6916121f22c60d791dbbb1c4ace"><td class="memItemLeft" align="right" valign="top">const char *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_s_q_lite_1_1_statement.html#a06f6b6916121f22c60d791dbbb1c4ace">errmsg</a> (void) const </td></tr>
<tr class="memdesc:a06f6b6916121f22c60d791dbbb1c4ace"><td class="mdescLeft">&#160;</td><td class="mdescRight">Return UTF-8 encoded English language explanation of the most recent error. <a href="#a06f6b6916121f22c60d791dbbb1c4ace">More...</a><br/></td></tr>
<tr class="separator:a06f6b6916121f22c60d791dbbb1c4ace"><td class="memSeparator" colspan="2">&#160;</td></tr>
</table>
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
<div class="textblock"><p>RAII encapsulation of a prepared <a class="el" href="namespace_s_q_lite.html">SQLite</a> <a class="el" href="class_s_q_lite_1_1_statement.html" title="RAII encapsulation of a prepared SQLite Statement.">Statement</a>. </p>
<p>A <a class="el" href="class_s_q_lite_1_1_statement.html" title="RAII encapsulation of a prepared SQLite Statement.">Statement</a> is a compiled SQL query ready to be executed step by step to provide results one row at a time.</p>
<p>Resource Acquisition Is Initialization (RAII) means that the <a class="el" href="class_s_q_lite_1_1_statement.html" title="RAII encapsulation of a prepared SQLite Statement.">Statement</a> is compiled in the constructor and finalized in the destructor, so that there is no need to worry about memory management or the validity of the underlying <a class="el" href="namespace_s_q_lite.html">SQLite</a> <a class="el" href="class_s_q_lite_1_1_statement.html" title="RAII encapsulation of a prepared SQLite Statement.">Statement</a>. </p>
<p>Definition at line <a class="el" href="_statement_8h_source.html#l00032">32</a> of file <a class="el" href="_statement_8h_source.html">Statement.h</a>.</p>
</div><h2 class="groupheader">Constructor &amp; Destructor Documentation</h2>
<a class="anchor" id="ab17c2c71de7224fcdf2252603e463cb9"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">SQLite::Statement::Statement </td>
<td>(</td>
<td class="paramtype"><a class="el" href="class_s_q_lite_1_1_database.html">Database</a> &amp;&#160;</td>
<td class="paramname"><em>aDatabase</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char *&#160;</td>
<td class="paramname"><em>apQuery</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Compile and register the SQL query for the provided <a class="el" href="namespace_s_q_lite.html">SQLite</a> <a class="el" href="class_s_q_lite_1_1_database.html" title="RAII management of a SQLite Database Connection.">Database</a> Connection. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramdir">[in]</td><td class="paramname">aDatabase</td><td>the <a class="el" href="namespace_s_q_lite.html">SQLite</a> <a class="el" href="class_s_q_lite_1_1_database.html" title="RAII management of a SQLite Database Connection.">Database</a> Connection </td></tr>
<tr><td class="paramdir">[in]</td><td class="paramname">apQuery</td><td>an UTF-8 encoded query string</td></tr>
</table>
</dd>
</dl>
<p><a class="el" href="class_s_q_lite_1_1_exception.html" title="Encapsulation of the error message from SQLite3, based on std::runtime_error.">Exception</a> is thrown in case of error, then the <a class="el" href="class_s_q_lite_1_1_statement.html" title="RAII encapsulation of a prepared SQLite Statement.">Statement</a> object is NOT constructed. </p>
<p>Definition at line <a class="el" href="_statement_8cpp_source.html#l00019">19</a> of file <a class="el" href="_statement_8cpp_source.html">Statement.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a5ca54a9bf0fba1af2a077c8fe5579f00"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">SQLite::Statement::~Statement </td>
<td>(</td>
<td class="paramtype">void&#160;</td>
<td class="paramname"></td><td>)</td>
<td> throw ()</td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">virtual</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Finalize and unregister the SQL query from the <a class="el" href="namespace_s_q_lite.html">SQLite</a> <a class="el" href="class_s_q_lite_1_1_database.html" title="RAII management of a SQLite Database Connection.">Database</a> Connection. </p>
<p>Definition at line <a class="el" href="_statement_8cpp_source.html#l00030">30</a> of file <a class="el" href="_statement_8cpp_source.html">Statement.cpp</a>.</p>
</div>
</div>
<h2 class="groupheader">Member Function Documentation</h2>
<a class="anchor" id="a265f4a381704d7ce94855d49db2c52e9"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void SQLite::Statement::bind </td>
<td>(</td>
<td class="paramtype">const int&#160;</td>
<td class="paramname"><em>aIndex</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const int &amp;&#160;</td>
<td class="paramname"><em>aValue</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Bind an int value to a parameter "?", "?NNN", ":VVV", "@VVV" or "$VVV" in the SQL prepared statement (aIndex &gt;= 1) </p>
<p>Definition at line <a class="el" href="_statement_8cpp_source.html#l00045">45</a> of file <a class="el" href="_statement_8cpp_source.html">Statement.cpp</a>.</p>
<p><div class="dynheader">
Here is the caller graph for this function:</div>
<div class="dyncontent">
<div class="center"><img src="class_s_q_lite_1_1_statement_a265f4a381704d7ce94855d49db2c52e9_icgraph.png" border="0" usemap="#class_s_q_lite_1_1_statement_a265f4a381704d7ce94855d49db2c52e9_icgraph" alt=""/></div>
<map name="class_s_q_lite_1_1_statement_a265f4a381704d7ce94855d49db2c52e9_icgraph" id="class_s_q_lite_1_1_statement_a265f4a381704d7ce94855d49db2c52e9_icgraph">
<area shape="rect" id="node2" href="class_s_q_lite_1_1_database.html#a672bdb55f1fe7be6f9498bbab1a3f740" title="Shortcut to test if a table exists." alt="" coords="217,5,415,32"/>
</map>
</div>
</p>
</div>
</div>
<a class="anchor" id="a4a89af0c77c2ae7af1bcdebeabeda2f4"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void SQLite::Statement::bind </td>
<td>(</td>
<td class="paramtype">const int&#160;</td>
<td class="paramname"><em>aIndex</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const sqlite3_int64 &amp;&#160;</td>
<td class="paramname"><em>aValue</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Bind a 64bits int value to a parameter "?", "?NNN", ":VVV", "@VVV" or "$VVV" in the SQL prepared statement (aIndex &gt;= 1) </p>
<p>Definition at line <a class="el" href="_statement_8cpp_source.html#l00052">52</a> of file <a class="el" href="_statement_8cpp_source.html">Statement.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="adbf6beb2c6bbf7caaebb673691e8a0e5"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void SQLite::Statement::bind </td>
<td>(</td>
<td class="paramtype">const int&#160;</td>
<td class="paramname"><em>aIndex</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const double &amp;&#160;</td>
<td class="paramname"><em>aValue</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Bind a double (64bits float) value to a parameter "?", "?NNN", ":VVV", "@VVV" or "$VVV" in the SQL prepared statement (aIndex &gt;= 1) </p>
<p>Definition at line <a class="el" href="_statement_8cpp_source.html#l00059">59</a> of file <a class="el" href="_statement_8cpp_source.html">Statement.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="af0e1944016ab0181a2ecdb91e3d9c8d5"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void SQLite::Statement::bind </td>
<td>(</td>
<td class="paramtype">const int&#160;</td>
<td class="paramname"><em>aIndex</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const std::string &amp;&#160;</td>
<td class="paramname"><em>aValue</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Bind a string value to a parameter "?", "?NNN", ":VVV", "@VVV" or "$VVV" in the SQL prepared statement (aIndex &gt;= 1) </p>
<dl class="section note"><dt>Note</dt><dd>This uses the SQLITE_TRANSIENT flag, making a copy of the data, for <a class="el" href="namespace_s_q_lite.html">SQLite</a> internal use </dd></dl>
<p>Definition at line <a class="el" href="_statement_8cpp_source.html#l00066">66</a> of file <a class="el" href="_statement_8cpp_source.html">Statement.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a386a979e8500d9ffd84cdd2052557905"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void SQLite::Statement::bind </td>
<td>(</td>
<td class="paramtype">const int&#160;</td>
<td class="paramname"><em>aIndex</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char *&#160;</td>
<td class="paramname"><em>apValue</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Bind a text value to a parameter "?", "?NNN", ":VVV", "@VVV" or "$VVV" in the SQL prepared statement (aIndex &gt;= 1) </p>
<dl class="section note"><dt>Note</dt><dd>This uses the SQLITE_TRANSIENT flag, making a copy of the data, for <a class="el" href="namespace_s_q_lite.html">SQLite</a> internal use </dd></dl>
<p>Definition at line <a class="el" href="_statement_8cpp_source.html#l00073">73</a> of file <a class="el" href="_statement_8cpp_source.html">Statement.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a65c31113619573cd8fca4d6d86e95b17"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void SQLite::Statement::bind </td>
<td>(</td>
<td class="paramtype">const int&#160;</td>
<td class="paramname"><em>aIndex</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const void *&#160;</td>
<td class="paramname"><em>apValue</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const int&#160;</td>
<td class="paramname"><em>aSize</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Bind a binary blob value to a parameter "?", "?NNN", ":VVV", "@VVV" or "$VVV" in the SQL prepared statement (aIndex &gt;= 1) </p>
<dl class="section note"><dt>Note</dt><dd>This uses the SQLITE_TRANSIENT flag, making a copy of the data, for <a class="el" href="namespace_s_q_lite.html">SQLite</a> internal use </dd></dl>
<p>Definition at line <a class="el" href="_statement_8cpp_source.html#l00080">80</a> of file <a class="el" href="_statement_8cpp_source.html">Statement.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="af5fb758ef7fd97ea9f841fdda68987e0"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void SQLite::Statement::bind </td>
<td>(</td>
<td class="paramtype">const int&#160;</td>
<td class="paramname"><em>aIndex</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Bind a NULL value to a parameter "?", "?NNN", ":VVV", "@VVV" or "$VVV" in the SQL prepared statement (aIndex &gt;= 1) </p>
<p>Definition at line <a class="el" href="_statement_8cpp_source.html#l00087">87</a> of file <a class="el" href="_statement_8cpp_source.html">Statement.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a81c1dd90c065a6b4dc3914318ca16dab"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void SQLite::Statement::bind </td>
<td>(</td>
<td class="paramtype">const char *&#160;</td>
<td class="paramname"><em>apName</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const int &amp;&#160;</td>
<td class="paramname"><em>aValue</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Bind an int value to a named parameter "?NNN", ":VVV", "@VVV" or "$VVV" in the SQL prepared statement (aIndex &gt;= 1) </p>
<p>Definition at line <a class="el" href="_statement_8cpp_source.html#l00095">95</a> of file <a class="el" href="_statement_8cpp_source.html">Statement.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="ae40a2152f867c62f456661924b37ae4b"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void SQLite::Statement::bind </td>
<td>(</td>
<td class="paramtype">const char *&#160;</td>
<td class="paramname"><em>apName</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const sqlite3_int64 &amp;&#160;</td>
<td class="paramname"><em>aValue</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Bind a 64bits int value to a named parameter "?NNN", ":VVV", "@VVV" or "$VVV" in the SQL prepared statement (aIndex &gt;= 1) </p>
<p>Definition at line <a class="el" href="_statement_8cpp_source.html#l00103">103</a> of file <a class="el" href="_statement_8cpp_source.html">Statement.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a4c43ccd2bf97f739e460c2badb97b8ab"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void SQLite::Statement::bind </td>
<td>(</td>
<td class="paramtype">const char *&#160;</td>
<td class="paramname"><em>apName</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const double &amp;&#160;</td>
<td class="paramname"><em>aValue</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Bind a double (64bits float) value to a named parameter "?NNN", ":VVV", "@VVV" or "$VVV" in the SQL prepared statement (aIndex &gt;= 1) </p>
<p>Definition at line <a class="el" href="_statement_8cpp_source.html#l00111">111</a> of file <a class="el" href="_statement_8cpp_source.html">Statement.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a34f6445bf7a421efedf39a94459a099b"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void SQLite::Statement::bind </td>
<td>(</td>
<td class="paramtype">const char *&#160;</td>
<td class="paramname"><em>apName</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const std::string &amp;&#160;</td>
<td class="paramname"><em>aValue</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Bind a string value to a named parameter "?NNN", ":VVV", "@VVV" or "$VVV" in the SQL prepared statement (aIndex &gt;= 1) </p>
<dl class="section note"><dt>Note</dt><dd>This uses the SQLITE_TRANSIENT flag, making a copy of the data, for <a class="el" href="namespace_s_q_lite.html">SQLite</a> internal use </dd></dl>
<p>Definition at line <a class="el" href="_statement_8cpp_source.html#l00119">119</a> of file <a class="el" href="_statement_8cpp_source.html">Statement.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a921dbcb0e1df45cf5af9960517bb5faf"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void SQLite::Statement::bind </td>
<td>(</td>
<td class="paramtype">const char *&#160;</td>
<td class="paramname"><em>apName</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char *&#160;</td>
<td class="paramname"><em>apValue</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Bind a text value to a named parameter "?NNN", ":VVV", "@VVV" or "$VVV" in the SQL prepared statement (aIndex &gt;= 1) </p>
<dl class="section note"><dt>Note</dt><dd>This uses the SQLITE_TRANSIENT flag, making a copy of the data, for <a class="el" href="namespace_s_q_lite.html">SQLite</a> internal use </dd></dl>
<p>Definition at line <a class="el" href="_statement_8cpp_source.html#l00127">127</a> of file <a class="el" href="_statement_8cpp_source.html">Statement.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a71bbd153c6235c9b89a275ead80ea2ee"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void SQLite::Statement::bind </td>
<td>(</td>
<td class="paramtype">const char *&#160;</td>
<td class="paramname"><em>apName</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const void *&#160;</td>
<td class="paramname"><em>apValue</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const int&#160;</td>
<td class="paramname"><em>aSize</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Bind a binary blob value to a named parameter "?NNN", ":VVV", "@VVV" or "$VVV" in the SQL prepared statement (aIndex &gt;= 1) </p>
<dl class="section note"><dt>Note</dt><dd>This uses the SQLITE_TRANSIENT flag, making a copy of the data, for <a class="el" href="namespace_s_q_lite.html">SQLite</a> internal use </dd></dl>
<p>Definition at line <a class="el" href="_statement_8cpp_source.html#l00135">135</a> of file <a class="el" href="_statement_8cpp_source.html">Statement.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a949c6cb4d2620376d6afaf4c55e4b3e7"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void SQLite::Statement::bind </td>
<td>(</td>
<td class="paramtype">const char *&#160;</td>
<td class="paramname"><em>apName</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Bind a NULL value to a named parameter "?NNN", ":VVV", "@VVV" or "$VVV" in the SQL prepared statement (aIndex &gt;= 1) </p>
<p>Definition at line <a class="el" href="_statement_8cpp_source.html#l00143">143</a> of file <a class="el" href="_statement_8cpp_source.html">Statement.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a06f6b6916121f22c60d791dbbb1c4ace"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">const char* SQLite::Statement::errmsg </td>
<td>(</td>
<td class="paramtype">void&#160;</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Return UTF-8 encoded English language explanation of the most recent error. </p>
<p>Definition at line <a class="el" href="_statement_8h_source.html#l00245">245</a> of file <a class="el" href="_statement_8h_source.html">Statement.h</a>.</p>
</div>
</div>
<a class="anchor" id="a6d78e0ae6321bc695d21f1bada8bbadb"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int SQLite::Statement::exec </td>
<td>(</td>
<td class="paramtype">void&#160;</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Execute a one-step query with no expected result. </p>
<p>This method is useful for any kind of statements other than the Data Query Language (DQL) "SELECT" :</p>
<ul>
<li>Data Definition Language (DDL) statements "CREATE", "ALTER" and "DROP"</li>
<li>Data Manipulation Language (DML) statements "INSERT", "UPDATE" and "DELETE"</li>
<li>Data Control Language (DCL) statements "GRANT", "REVOKE", "COMMIT" and "ROLLBACK"</li>
</ul>
<p>It is similar to <a class="el" href="class_s_q_lite_1_1_database.html#a0158bf527b79317679c9cf1e6daf1c43" title="Shortcut to execute one or multiple statements without results.">Database::exec()</a>, but using a precompiled statement, it adds :</p>
<ul>
<li>the ability to <a class="el" href="class_s_q_lite_1_1_statement.html#a265f4a381704d7ce94855d49db2c52e9" title="Bind an int value to a parameter &quot;?&quot;, &quot;?NNN&quot;, &quot;:VVV&quot;, &quot;@VVV&quot; or &quot;$VVV&quot; in the SQL prepared statement ...">bind()</a> arguments to it (best way to insert data),</li>
<li>reusing it allows for better performances (efficent for multiple insersion).</li>
</ul>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="class_s_q_lite_1_1_statement.html#aa7f29464b5fbe4b8da92d769e52472d8" title="Execute a step of the prepared query to fetch one row of results.">executeStep()</a> execute a step of the prepared query to fetch one row of results </dd>
<dd>
<a class="el" href="class_s_q_lite_1_1_database.html#a0158bf527b79317679c9cf1e6daf1c43" title="Shortcut to execute one or multiple statements without results.">Database::exec()</a> is a shortcut to execute one or multiple statements without results</dd></dl>
<dl class="section return"><dt>Returns</dt><dd>number of row modified by this SQL statement (INSERT, UPDATE or DELETE)</dd></dl>
<dl class="exception"><dt>Exceptions</dt><dd>
<table class="exception">
<tr><td class="paramname"><a class="el" href="class_s_q_lite_1_1_exception.html" title="Encapsulation of the error message from SQLite3, based on std::runtime_error.">SQLite::Exception</a></td><td>in case of error, or if row of results are returned ! </td></tr>
</table>
</dd>
</dl>
<p>Definition at line <a class="el" href="_statement_8cpp_source.html#l00182">182</a> of file <a class="el" href="_statement_8cpp_source.html">Statement.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="aa7f29464b5fbe4b8da92d769e52472d8"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool SQLite::Statement::executeStep </td>
<td>(</td>
<td class="paramtype">void&#160;</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Execute a step of the prepared query to fetch one row of results. </p>
<p>While true is returned, a row of results is available, and can be accessed thru the <a class="el" href="class_s_q_lite_1_1_statement.html#a5b7c9372b9023a86e7242d47052f06f7" title="Return a copie of the column data specified by its index.">getColumn()</a> method</p>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="class_s_q_lite_1_1_statement.html#a6d78e0ae6321bc695d21f1bada8bbadb" title="Execute a one-step query with no expected result.">exec()</a> execute a one-step prepared statement with no expected result </dd>
<dd>
<a class="el" href="class_s_q_lite_1_1_database.html#a0158bf527b79317679c9cf1e6daf1c43" title="Shortcut to execute one or multiple statements without results.">Database::exec()</a> is a shortcut to execute one or multiple statements without results</dd></dl>
<dl class="section return"><dt>Returns</dt><dd>- true (SQLITE_ROW) if there is another row ready : you can call getColumn(N) to get it then you have to call <a class="el" href="class_s_q_lite_1_1_statement.html#aa7f29464b5fbe4b8da92d769e52472d8" title="Execute a step of the prepared query to fetch one row of results.">executeStep()</a> again to fetch more rows until the query is finished<ul>
<li>false (SQLITE_DONE) if the query has finished executing : there is no (more) row of result (case of a query with no result, or after N rows fetched successfully)</li>
</ul>
</dd></dl>
<dl class="exception"><dt>Exceptions</dt><dd>
<table class="exception">
<tr><td class="paramname"><a class="el" href="class_s_q_lite_1_1_exception.html" title="Encapsulation of the error message from SQLite3, based on std::runtime_error.">SQLite::Exception</a></td><td>in case of error </td></tr>
</table>
</dd>
</dl>
<p>Definition at line <a class="el" href="_statement_8cpp_source.html#l00152">152</a> of file <a class="el" href="_statement_8cpp_source.html">Statement.cpp</a>.</p>
<p><div class="dynheader">
Here is the caller graph for this function:</div>
<div class="dyncontent">
<div class="center"><img src="class_s_q_lite_1_1_statement_aa7f29464b5fbe4b8da92d769e52472d8_icgraph.png" border="0" usemap="#class_s_q_lite_1_1_statement_aa7f29464b5fbe4b8da92d769e52472d8_icgraph" alt=""/></div>
<map name="class_s_q_lite_1_1_statement_aa7f29464b5fbe4b8da92d769e52472d8_icgraph" id="class_s_q_lite_1_1_statement_aa7f29464b5fbe4b8da92d769e52472d8_icgraph">
<area shape="rect" id="node2" href="class_s_q_lite_1_1_database.html#ac828a49fab425564e65c95ff1fd03c74" title="Shortcut to execute a one step query and fetch the first column of the result." alt="" coords="192,5,397,32"/>
<area shape="rect" id="node3" href="class_s_q_lite_1_1_database.html#a672bdb55f1fe7be6f9498bbab1a3f740" title="Shortcut to test if a table exists." alt="" coords="195,56,394,83"/>
</map>
</div>
</p>
</div>
</div>
<a class="anchor" id="a5b7c9372b9023a86e7242d47052f06f7"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="class_s_q_lite_1_1_column.html">Column</a> SQLite::Statement::getColumn </td>
<td>(</td>
<td class="paramtype">const int&#160;</td>
<td class="paramname"><em>aIndex</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Return a copie of the column data specified by its index. </p>
<p>Can be used to access the data of the current row of result when applicable, while the <a class="el" href="class_s_q_lite_1_1_statement.html#aa7f29464b5fbe4b8da92d769e52472d8" title="Execute a step of the prepared query to fetch one row of results.">executeStep()</a> method returns true.</p>
<p>Throw an exception if there is no row to return a <a class="el" href="class_s_q_lite_1_1_column.html" title="Encapsulation of a Column in a row of the result pointed by the prepared Statement.">Column</a> from :</p>
<ul>
<li>before any <a class="el" href="class_s_q_lite_1_1_statement.html#aa7f29464b5fbe4b8da92d769e52472d8" title="Execute a step of the prepared query to fetch one row of results.">executeStep()</a> call</li>
<li>after the last <a class="el" href="class_s_q_lite_1_1_statement.html#aa7f29464b5fbe4b8da92d769e52472d8" title="Execute a step of the prepared query to fetch one row of results.">executeStep()</a> returned false</li>
<li><p class="startli">after a <a class="el" href="class_s_q_lite_1_1_statement.html#aef7da8a8dd11f1604d10aab9a025cb54" title="Reset the statement to make it ready for a new execution.">reset()</a> call</p>
<p class="startli">Throw an exception if the specified index is out of the [0, <a class="el" href="class_s_q_lite_1_1_statement.html#a97dcdc3e791836250f707fdf77fde4a4" title="Return the number of columns in the result set returned by the prepared statement.">getColumnCount()</a>) range.</p>
</li>
</ul>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramdir">[in]</td><td class="paramname">aIndex</td><td>Index of the column, starting at 0</td></tr>
</table>
</dd>
</dl>
<dl class="section note"><dt>Note</dt><dd>This method is no more const, starting in v0.5, which reflects the fact that the returned <a class="el" href="class_s_q_lite_1_1_column.html" title="Encapsulation of a Column in a row of the result pointed by the prepared Statement.">Column</a> object will share the ownership of the underlying sqlite3_stmt.</dd></dl>
<dl class="section warning"><dt>Warning</dt><dd>The resulting <a class="el" href="class_s_q_lite_1_1_column.html" title="Encapsulation of a Column in a row of the result pointed by the prepared Statement.">Column</a> object must not be memorized "as-is". Is is only a wrapper arround the current result row, so it is only valid while the row from the <a class="el" href="class_s_q_lite_1_1_statement.html" title="RAII encapsulation of a prepared SQLite Statement.">Statement</a> remains valid, that is only until next <a class="el" href="class_s_q_lite_1_1_statement.html#aa7f29464b5fbe4b8da92d769e52472d8" title="Execute a step of the prepared query to fetch one row of results.">executeStep()</a> call. Thus, you should instead extract immediately its data (getInt(), getText()...) and use or copy this data for any later usage. </dd></dl>
<p>Definition at line <a class="el" href="_statement_8cpp_source.html#l00216">216</a> of file <a class="el" href="_statement_8cpp_source.html">Statement.cpp</a>.</p>
<p><div class="dynheader">
Here is the caller graph for this function:</div>
<div class="dyncontent">
<div class="center"><img src="class_s_q_lite_1_1_statement_a5b7c9372b9023a86e7242d47052f06f7_icgraph.png" border="0" usemap="#class_s_q_lite_1_1_statement_a5b7c9372b9023a86e7242d47052f06f7_icgraph" alt=""/></div>
<map name="class_s_q_lite_1_1_statement_a5b7c9372b9023a86e7242d47052f06f7_icgraph" id="class_s_q_lite_1_1_statement_a5b7c9372b9023a86e7242d47052f06f7_icgraph">
<area shape="rect" id="node2" href="class_s_q_lite_1_1_database.html#ac828a49fab425564e65c95ff1fd03c74" title="Shortcut to execute a one step query and fetch the first column of the result." alt="" coords="192,5,397,32"/>
<area shape="rect" id="node3" href="class_s_q_lite_1_1_database.html#a672bdb55f1fe7be6f9498bbab1a3f740" title="Shortcut to test if a table exists." alt="" coords="195,56,394,83"/>
</map>
</div>
</p>
</div>
</div>
<a class="anchor" id="a97dcdc3e791836250f707fdf77fde4a4"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">int SQLite::Statement::getColumnCount </td>
<td>(</td>
<td class="paramtype">void&#160;</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Return the number of columns in the result set returned by the prepared statement. </p>
<p>Definition at line <a class="el" href="_statement_8h_source.html#l00230">230</a> of file <a class="el" href="_statement_8h_source.html">Statement.h</a>.</p>
</div>
</div>
<a class="anchor" id="ab6e3b57d2b6e909b3852b927801e36d6"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">const std::string&amp; SQLite::Statement::getQuery </td>
<td>(</td>
<td class="paramtype">void&#160;</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Return the UTF-8 SQL Query. </p>
<p>Definition at line <a class="el" href="_statement_8h_source.html#l00225">225</a> of file <a class="el" href="_statement_8h_source.html">Statement.h</a>.</p>
</div>
</div>
<a class="anchor" id="a03790608e4b945d12605e1cadf2fd9d9"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool SQLite::Statement::isColumnNull </td>
<td>(</td>
<td class="paramtype">const int&#160;</td>
<td class="paramname"><em>aIndex</em></td><td>)</td>
<td> const</td>
</tr>
</table>
</div><div class="memdoc">
<p>Test if the column value is NULL. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramdir">[in]</td><td class="paramname">aIndex</td><td>Index of the column, starting at 0</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>true if the column value is NULL </dd></dl>
<p>Definition at line <a class="el" href="_statement_8cpp_source.html#l00232">232</a> of file <a class="el" href="_statement_8cpp_source.html">Statement.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a387067802ddcb66baa9e38a2d6cbae85"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">bool SQLite::Statement::isDone </td>
<td>(</td>
<td class="paramtype">void&#160;</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>true when the last <a class="el" href="class_s_q_lite_1_1_statement.html#aa7f29464b5fbe4b8da92d769e52472d8" title="Execute a step of the prepared query to fetch one row of results.">executeStep()</a> had no more row to fetch </p>
<p>Definition at line <a class="el" href="_statement_8h_source.html#l00240">240</a> of file <a class="el" href="_statement_8h_source.html">Statement.h</a>.</p>
</div>
</div>
<a class="anchor" id="a28e4f907c6455cd2bda8e6baa5856a40"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">bool SQLite::Statement::isOk </td>
<td>(</td>
<td class="paramtype">void&#160;</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>true when a row has been fetched with <a class="el" href="class_s_q_lite_1_1_statement.html#aa7f29464b5fbe4b8da92d769e52472d8" title="Execute a step of the prepared query to fetch one row of results.">executeStep()</a> </p>
<p>Definition at line <a class="el" href="_statement_8h_source.html#l00235">235</a> of file <a class="el" href="_statement_8h_source.html">Statement.h</a>.</p>
</div>
</div>
<a class="anchor" id="aef7da8a8dd11f1604d10aab9a025cb54"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void SQLite::Statement::reset </td>
<td>(</td>
<td class="paramtype">void&#160;</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Reset the statement to make it ready for a new execution. </p>
<p>Definition at line <a class="el" href="_statement_8cpp_source.html#l00036">36</a> of file <a class="el" href="_statement_8cpp_source.html">Statement.cpp</a>.</p>
</div>
</div>
<hr/>The documentation for this class was generated from the following files:<ul>
<li>src/<a class="el" href="_statement_8h_source.html">Statement.h</a></li>
<li>src/<a class="el" href="_statement_8cpp_source.html">Statement.cpp</a></li>
</ul>
</div><!-- contents -->
</div><!-- doc-content -->
<!-- start footer part -->
<div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
<ul>
<li class="navelem"><a class="el" href="namespace_s_q_lite.html">SQLite</a></li><li class="navelem"><a class="el" href="class_s_q_lite_1_1_statement.html">Statement</a></li>
<li class="footer">Generated on Sun Mar 10 2013 18:17:22 for SQLiteC++ by
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.8.3.1 </li>
</ul>
</div>
</body>
</html>