Changes

<p>In the The query mode of the [[Clients]] allows you to bind external variables to a query can be send to and evaluate the server and executedquery in an iterative manner. For this you have to call the The <code>query()</code> functionof the <code>Session</code> with your defined query. This will return instance returns a new query objectwhich comes with an forward-only iterator to get each result of the query.Furthermore it is possible to bind variables to the query using the <code>bind()</code> functionof the query objectinstance.</p>

<p>The query execution works as follows:</p>

#Create a new session instance with hostname, port, username and password.#Call the <code>query()</code> function of the session with the query as argument your XQuery expression to get your a query object.#Optionally bind variables to the query with one of the <code>bind()</code> functionfunctions.#Initialize query output Optionally bind a value to the context item via <code>initcontext()</code>.#Iterate through the query object with the <code>more()</code> and <code>next()</code> functions. If # As an error occursalternative, an exception is throwncall <code>execute()</code> to get the whole result at a time.# <code>info()</code> gives you information on query evaluation.# <code>options()</code> returns the query serialization parameters.#Close Don't forget to close the query with <code>close()</code>. ==PHP Example== #Create a session objectTaken from our [https://github.com/BaseXdb/basex-api/blob/master/src/main/php/QueryBindExample.php repository]:  <codesyntaxhighlight lang="php">Session <?php/* * This example shows how queries can be executed in an iterative manner. * Documentation: http://basex.org/api * * (C) BaseX Team 2005-15, BSD License */include("BaseXClient.php"); try { // create session $session = new Session("localhost", 1984, "admin", "admin");< try { //code> #Define a query and create a query object:<br/><pre classinstance $input ="brush:java">String q = "'declare variable $name external; '. 'for $i in 1 to 10 return element { $name } { $i }"'; &#10;Query $query = $session.->query(q$input);<  //pre> bind variable#Call the bind method of your $query object:<br/-><pre class="brush:java">query.bind("$name", "Numbernumber");<  //pre> print result#Call the init method of your print $query object:<br/-><pre class=execute()."brush:java\n";  // close query instance $query->print query.initclose();<  } catch (Exception $e) { //preprint exception print $e-> getMessage(); }#Iterate through the query object:<br //close session $session-><pre class="brush:java">whileclose(query.more); } catch (Exception $e)) { // print exception print query.next$e->getMessage();</pre}?>#Close your query object:<br/syntaxhighlight><pre class =Changelog="brush ;Version 7.2 * Added:java">print query.close{{Code|context();</pre>}} function