<?xml version="1.0" encoding="UTF-8"?>
<!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" lang="en" xml:lang="en">
<head>
<title>Soprano.QueryResultIterator</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<link rel="stylesheet" type="text/css" href="../common/doxygen.css" />
<link rel="stylesheet" media="screen" type="text/css" title="KDE Colors" href="../common/kde.css" />
</head>
<body>
<div id="container">
<div id="header">
<div id="header_top">
<div>
<div>
<img alt ="" src="../common/top-kde.jpg"/>
KDE 4.4 PyKDE API Reference
</div>
</div>
</div>
<div id="header_bottom">
<div id="location">
<ul>
<li>KDE's Python API</li>
</ul>
</div>
<div id="menu">
<ul>
<li><a href="../modules.html">Overview</a></li>
<li><a href="http://techbase.kde.org/Development/Languages/Python">PyKDE Home</a></li>
<li><a href="http://kde.org/family/">Sitemap</a></li>
<li><a href="http://kde.org/contact/">Contact Us</a></li>
</ul>
</div>
</div>
</div>
<div id="body_wrapper">
<div id="body">
<div id="right">
<div class="content">
<div id="main">
<div class="clearer"> </div>
<h1>QueryResultIterator Class Reference</h1>
<code>from PyKDE4.soprano import *</code>
<p>
Subclasses: <a href="../soprano/Soprano.Client.DBusQueryResultIterator.html">Soprano.Client.DBusQueryResultIterator</a><br />
Namespace: Soprano.QueryResultIterator<br />
<h2>Detailed Description</h2>
<p>\class QueryResultIterator queryresultiterator.h Soprano/QueryResultIterator
</p>
<p>
An iterator for query results.
</p>
<p>
%Query results in %Soprano are wrapped in a QueryResultIterator.
</p>
<p>
%Query iterators are returned by Model.executeQuery(). In contrast to
NodeIterator or StatementIterator %QueryResultIterator has a set of different
access methods for the current dataset which can be one of three things:
</p>
<p>
<li> A Statement: Graph query results are represented as a stream of statements. </li>
See also currentStatement() and iterateStatements().
<li> A BindingSet: Tuple query results are represented by a set of variable bindings </li>
according to the variables used in the query. The bindings can be accessed as a set
through the normal Iterator method current() or separately through #binding(int) const or
#binding(const QString&) const.
<li> A boolean value: This is a special case in which the query was a boolean query </li>
(a SPARQL ASK query). In this case there is nothing to iterate but only a single
boolean value which can be accessed through boolValue().
</p>
<p>
<b>Example:</b>
</p>
<p>
<pre class="fragment">
QueryResultIterator it = model->executeQuery( someGraphQuery );
while( it.next() ) {
doSomething( it.currentStatement() );
}
QueryResultIterator it2 = model->executeQuery( someTupleQuery );
while( it.next() ) {
doSomethingElse( it.currentBindings() );
doSomethingCompletelyDifferent( it.binding( "x" ) );
doSomethingEntirelyDifferent( it.binding( 0 ) );
}
</pre>
</p>
<p>
Many backends do lock the underlying Model during iteration. Thus,
it is always a good idea to cache the results if they are to be used
to modify the model to prevent a deadlock:
</p>
<p>
<pre class="fragment">
Soprano.QueryResultIterator it = model->executeQuery( someTupleQuery );
QList<BindingSet> allBindings = it.allBindings();
Q_FOREACH( Soprano.BindingSet bs, allBindings ) {
modifyTheModel( model, bs );
}
</pre>
</p>
<p>
Iterators have to be closed.
This can either be achieved by deleting the iterator, finishing it (next() does return <b>false),</b>
or calling close(). Before that other operations on the Model may block.
</p>
<p>
Iterators are not thread-safe. Two threads using the same iterator may result
in undefined behaviour and even crashes. An iterator needs to be closed by the
same thread that opened it (except if the iterator contains special code to handle such
a situation.)
</p>
<p>
<dl class="warning" compact><dt><b>Warning:</b></dt><dd> Be aware that iterators in Soprano are shared objects which means
that copies of one iterator object work on the same data.
</dd></dl> </p>
<p>
For further details on %Soprano iterators see Iterator.
</p>
<p>
<dl class="author" compact><dt><b>Author:</b></dt><dd> Daniele Galdi <daniele.galdi@gmail.com><br>Sebastian Trueg <trueg@kde.org> </dd></dl>
</p>
<table border="0" cellpadding="0" cellspacing="0"><tr><td colspan="2"><br><h2>Methods</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#QueryResultIterator">__init__</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#QueryResultIterator">__init__</a> (self, <a href="../soprano/Soprano.QueryResultIterator.html">Soprano.QueryResultIterator</a> a0)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#QueryResultIterator">__init__</a> (self, <a href="../soprano/Soprano.QueryResultIteratorBackend.html">Soprano.QueryResultIteratorBackend</a> qr)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">[<a href="../soprano/Soprano.BindingSet.html">Soprano.BindingSet</a>] </td><td class="memItemRight" valign="bottom"><a class="el" href="#allBindings">allBindings</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">[<a href="../soprano/Soprano.BindingSet.html">Soprano.BindingSet</a>] </td><td class="memItemRight" valign="bottom"><a class="el" href="#allElements">allElements</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="../soprano/Soprano.Node.html">Soprano.Node</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#binding">binding</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> name)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="../soprano/Soprano.Node.html">Soprano.Node</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#binding">binding</a> (self, int offset)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="#bindingCount">bindingCount</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstringlist.html">QStringList</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#bindingNames">bindingNames</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#boolValue">boolValue</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#close">close</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="../soprano/Soprano.BindingSet.html">Soprano.BindingSet</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#current">current</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="../soprano/Soprano.BindingSet.html">Soprano.BindingSet</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#currentBindings">currentBindings</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="../soprano/Soprano.Statement.html">Soprano.Statement</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#currentStatement">currentStatement</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#isBinding">isBinding</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#isBool">isBool</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#isGraph">isGraph</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#isValid">isValid</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="../soprano/Soprano.NodeIterator.html">Soprano.NodeIterator</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#iterateBindings">iterateBindings</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> variableName)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="../soprano/Soprano.NodeIterator.html">Soprano.NodeIterator</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#iterateBindings">iterateBindings</a> (self, int offset)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="../soprano/Soprano.StatementIterator.html">Soprano.StatementIterator</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#iterateStatements">iterateStatements</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="../soprano/Soprano.StatementIterator.html">Soprano.StatementIterator</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#iterateStatementsFromBindings">iterateStatementsFromBindings</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> subjectBindingName, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> predicateBindingName, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> objectBindingName, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> contextBindingName=QString(), <a href="../soprano/Soprano.Statement.html">Soprano.Statement</a> templateStatement=Soprano.Statement())</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#next">next</a> (self)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="../soprano/Soprano.Node.html">Soprano.Node</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#operator []">operator []</a> (self, int offset)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="../soprano/Soprano.Node.html">Soprano.Node</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#operator []">operator []</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> name)</td></tr>
</table>
<hr><h2>Method Documentation</h2><a class="anchor" name="QueryResultIterator"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">__init__</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Copy constructor. Copies of iterators share their data.
</p></div></div><a class="anchor" name="QueryResultIterator"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">__init__</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../soprano/Soprano.QueryResultIterator.html">Soprano.QueryResultIterator</a> </td>
<td class="paramname"><em>a0</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Copy constructor. Copies of iterators share their data.
</p></div></div><a class="anchor" name="QueryResultIterator"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">__init__</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../soprano/Soprano.QueryResultIteratorBackend.html">Soprano.QueryResultIteratorBackend</a> </td>
<td class="paramname"><em>qr</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Create a new QueryResultIterator which uses qr as backend.
QueryResultIterator will take ownership of the QueryResultIteratorBackend.
</p></div></div><a class="anchor" name="allBindings"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">[<a href="../soprano/Soprano.BindingSet.html">Soprano.BindingSet</a>] allBindings</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Convenience method that collects all binding sets that are left
in the iterator.
</p></div></div><a class="anchor" name="allElements"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">[<a href="../soprano/Soprano.BindingSet.html">Soprano.BindingSet</a>] allElements</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"></div></div><a class="anchor" name="binding"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="../soprano/Soprano.Node.html">Soprano.Node</a> binding</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td>
<td class="paramname"><em>name</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Get the current binding for a variable by index.
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>offset</em> </td><td> The index of the requested variable.
</td></tr>
</table></dl>
<p> This method does only make sense for tuple queries.
</p>
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd> The binding for the requested variable or and invalid
node if offset is out of bounds, i.e. bigger or equal to bindingCount().
</dd></dl>
</p></div></div><a class="anchor" name="binding"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="../soprano/Soprano.Node.html">Soprano.Node</a> binding</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>offset</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Get the current binding for a variable by index.
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>offset</em> </td><td> The index of the requested variable.
</td></tr>
</table></dl>
<p> This method does only make sense for tuple queries.
</p>
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd> The binding for the requested variable or and invalid
node if offset is out of bounds, i.e. bigger or equal to bindingCount().
</dd></dl>
</p></div></div><a class="anchor" name="bindingCount"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">int bindingCount</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>The number of bindings in this query result.
</p>
<p>
This method does only make sense for tuple queries.
</p>
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd> The number of bindings.
</dd></dl>
</p></div></div><a class="anchor" name="bindingNames"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstringlist.html">QStringList</a> bindingNames</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>This method does only make sense for tuple queries.
</p>
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd> The names of the bound variables in this query result.
</dd></dl>
</p></div></div><a class="anchor" name="boolValue"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">bool boolValue</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>This method does only make sense for boolean queries.
</p>
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd> The result of a boolean query (SPARQL ASK).
</dd></dl> </p>
<p>
\sa isBool()
</p></div></div><a class="anchor" name="close"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"> close</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"></div></div><a class="anchor" name="current"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="../soprano/Soprano.BindingSet.html">Soprano.BindingSet</a> current</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"></div></div><a class="anchor" name="currentBindings"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="../soprano/Soprano.BindingSet.html">Soprano.BindingSet</a> currentBindings</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Convenience method that puts all current bindings into one map.
This method does only make sense for tuple queries.
</p></div></div><a class="anchor" name="currentStatement"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="../soprano/Soprano.Statement.html">Soprano.Statement</a> currentStatement</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Retrieve the current Statement after a call to next.
This method does only make sense for graph queries.
</p></div></div><a class="anchor" name="isBinding"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">bool isBinding</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Check if this is a tuple result.
</p>
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd> <b>true</b> if this result refers to a tuple query, i.e. currentBindings(),
binding(), bindingCount(), bindingNames(), and allBindings() return valid values.
</dd></dl>
</p></div></div><a class="anchor" name="isBool"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">bool isBool</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Check if this is a boolean result.
</p>
<p>
There is no need to call next() for boolean results. However, for internal reasons
backends need to always return <b>true</b> for boolean queries.
</p>
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd> <b>true</b> if this result refers to a boolean query (SPARQL ASK), i.e.
boolValue() returns a valid value.
</dd></dl>
</p></div></div><a class="anchor" name="isGraph"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">bool isGraph</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Check if this is a graph result.
</p>
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd> <b>true</b> if this result refers to a graph query, i.e. currentStatement()
and iterateStatements() return valid values.
</dd></dl>
</p></div></div><a class="anchor" name="isValid"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">bool isValid</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"></div></div><a class="anchor" name="iterateBindings"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="../soprano/Soprano.NodeIterator.html">Soprano.NodeIterator</a> iterateBindings</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td>
<td class="paramname"><em>variableName</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Convenience method that creates an iterator over one column of bindings in this query result.
This method does only make sense for tuple queries.
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>offset</em> </td><td> The index of the requested variable.
</td></tr>
</table></dl>
<p> <dl class="warning" compact><dt><b>Warning:</b></dt><dd> The new iterator is just a wrapper around this one. Thus, changing it will also
change this one.
</dd></dl> </p>
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd> A wrapper iterator over one column in a tuple query or an invalid iterator
if offset is out of bounds, i.e. bigger or equal to bindingCount().
</dd></dl>
</p></div></div><a class="anchor" name="iterateBindings"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="../soprano/Soprano.NodeIterator.html">Soprano.NodeIterator</a> iterateBindings</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>offset</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Convenience method that creates an iterator over one column of bindings in this query result.
This method does only make sense for tuple queries.
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>offset</em> </td><td> The index of the requested variable.
</td></tr>
</table></dl>
<p> <dl class="warning" compact><dt><b>Warning:</b></dt><dd> The new iterator is just a wrapper around this one. Thus, changing it will also
change this one.
</dd></dl> </p>
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd> A wrapper iterator over one column in a tuple query or an invalid iterator
if offset is out of bounds, i.e. bigger or equal to bindingCount().
</dd></dl>
</p></div></div><a class="anchor" name="iterateStatements"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="../soprano/Soprano.StatementIterator.html">Soprano.StatementIterator</a> iterateStatements</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"><p>Convenience method that creates an iterator over the statements in this query result.
This method does only make sense for graph queries.
</p>
<p>
<dl class="warning" compact><dt><b>Warning:</b></dt><dd> The new iterator is just a wrapper around this one. Thus, changing it will also
change this one.
</dd></dl> </p>
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd> A wrapper iterator over the statements in a graph query.
</dd></dl>
</p></div></div><a class="anchor" name="iterateStatementsFromBindings"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="../soprano/Soprano.StatementIterator.html">Soprano.StatementIterator</a> iterateStatementsFromBindings</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td>
<td class="paramname"><em>subjectBindingName</em>, </td>
</tr>
<tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td>
<td class="paramname"><em>predicateBindingName</em>, </td>
</tr>
<tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td>
<td class="paramname"><em>objectBindingName</em>, </td>
</tr>
<tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td>
<td class="paramname"><em>contextBindingName=QString()</em>, </td>
</tr>
<tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="../soprano/Soprano.Statement.html">Soprano.Statement</a> </td>
<td class="paramname"><em>templateStatement=Soprano.Statement()</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Convenience method that creates an iterator over statements constructed from the values of the
provided bindings.
</p>
<p>
The typical usage would be with a query as follows:
</p>
<p>
<pre class="fragment">
Soprano.StatementIterator it =
model->executeQuery( "select * where { graph ?c { ?s ?p ?o . } }" )
.iterateStatementsFromBindings( "s", "p", "o", "c" );
</pre>
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>subjectBindingName</em> </td><td> The name of the binding that will be used to set the subject of the
constructed statements.
</td></tr> </table></dl>
<p> </p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>predicateBindingName</em> </td><td> The name of the binding that will be used to set the predicate of the
constructed statements.
</td></tr> </table></dl>
<p> </p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>objectBindingName</em> </td><td> The name of the binding that will be used to set the object of the
constructed statements.
</td></tr> </table></dl>
<p> </p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>contextBindingName</em> </td><td> The name of the binding that will be used to set the context of the
constructed statements.
</td></tr> </table></dl>
<p> </p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>templateStatement</em> </td><td> If any of the provided binding names is empty the corresponding nodes
in the resulting statements will be filled by templateStatement.
</td></tr>
</table></dl>
<p> <dl class="warning" compact><dt><b>Warning:</b></dt><dd> The new iterator is just a wrapper around this one. Thus, changing it will also
change this one.
</dd></dl> </p>
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd> A wrapper iterator over statements constructed from the specified bindings.
</dd></dl> </p>
<p>
<dl class="since" compact><dt><b>Since:</b></dt><dd> 2.2
</dd></dl>
</p></div></div><a class="anchor" name="next"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname">bool next</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname"><em>self</em> )</td>
<td width="100%"> </td>
</tr>
</table>
</div>
<div class="memdoc"></div></div><a class="anchor" name="operator []"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="../soprano/Soprano.Node.html">Soprano.Node</a> operator []</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>offset</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Get the current binding for a variable.
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>name</em> </td><td> The name of the requested variable.
</td></tr>
</table></dl>
<p> This is equivalent to binding(const QString&) const.
</p>
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd> The binding for the requested variable or and invalid
node if the bindings do not contain the variable.
</dd></dl> </p>
<p>
<dl class="since" compact><dt><b>Since:</b></dt><dd> 2.2
</dd></dl>
</p></div></div><a class="anchor" name="operator []"></a>
<div class="memitem">
<div class="memproto">
<table class="memname"><tr>
<td class="memname"><a href="../soprano/Soprano.Node.html">Soprano.Node</a> operator []</td>
<td>(</td>
<td class="paramtype"> <em>self</em>, </td>
<td class="paramname"></td>
</tr><tr>
<td class="memname"></td>
<td></td>
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td>
<td class="paramname"><em>name</em></td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td>
<td></td>
<td width="100%"> </td>
</tr></table>
</div>
<div class="memdoc"><p>Get the current binding for a variable.
</p>
<p>
</p><dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td></td><td valign="top"><em>name</em> </td><td> The name of the requested variable.
</td></tr>
</table></dl>
<p> This is equivalent to binding(const QString&) const.
</p>
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd> The binding for the requested variable or and invalid
node if the bindings do not contain the variable.
</dd></dl> </p>
<p>
<dl class="since" compact><dt><b>Since:</b></dt><dd> 2.2
</dd></dl>
</p></div></div>
</div>
</div>
</div>
<div id="left">
<div class="menu_box">
<div class="nav_list">
<ul>
<li><a href="../allclasses.html">Full Index</a></li>
</ul>
</div>
<a name="cp-menu" /><div class="menutitle"><div>
<h2 id="cp-menu-project">Modules</h2>
</div></div>
<div class="nav_list">
<ul><li><a href="../akonadi/index.html">akonadi</a></li>
<li><a href="../dnssd/index.html">dnssd</a></li>
<li><a href="../kdecore/index.html">kdecore</a></li>
<li><a href="../kdeui/index.html">kdeui</a></li>
<li><a href="../khtml/index.html">khtml</a></li>
<li><a href="../kio/index.html">kio</a></li>
<li><a href="../knewstuff/index.html">knewstuff</a></li>
<li><a href="../kparts/index.html">kparts</a></li>
<li><a href="../kutils/index.html">kutils</a></li>
<li><a href="../nepomuk/index.html">nepomuk</a></li>
<li><a href="../phonon/index.html">phonon</a></li>
<li><a href="../plasma/index.html">plasma</a></li>
<li><a href="../polkitqt/index.html">polkitqt</a></li>
<li><a href="../solid/index.html">solid</a></li>
<li><a href="../soprano/index.html">soprano</a></li>
</ul></div></div>
</div>
</div>
<div class="clearer"/>
</div>
<div id="end_body"></div>
</div>
<div id="footer"><div id="footer_text">
This documentation is maintained by <a href="mailto:simon@simonzone.com">Simon Edwards</a>.<br />
KDE<sup>®</sup> and <a href="../images/kde_gear_black.png">the K Desktop Environment<sup>®</sup> logo</a> are registered trademarks of <a href="http://ev.kde.org/" title="Homepage of the KDE non-profit Organization">KDE e.V.</a> |
<a href="http://www.kde.org/contact/impressum.php">Legal</a>
</div></div>
</body>
</html>
distrib
>
Mandriva
>
current
>
i586
>
media
>
main-updates
>
by-pkgid
>
b77dda48f87d4eda8cc559e40c49a652
>
files
>
1171
