autodoc.git / onepage.xml

version» Context lines:

autodoc.git/onepage.xml:144670:   </text></group><group><seealso/><text><p><ref resolved='predef::Sql.Connection'>Sql.Connection</ref>, <ref resolved='predef::Sql.Sql'>Sql.Sql()</ref>, <ref resolved='predef::__builtin.Sql.Result'>Result</ref></p>   </text></group></doc>   <docgroup homogen-name='big_query' homogen-type='method'><doc><text><p>Send an SQL query synchronously to the SQL-server and return    the results in untyped mode.</p>   </text><group><param name='q'/><text><p>Query to send to the SQL-server. This can either be a string with the    query, or a previously compiled query (see <ref resolved='predef::__builtin.Sql.Connection.compile_query'>compile_query()</ref>).</p>   </text></group><group><returns/><text><p>The result is returned as an <ref resolved='predef::Sql.Result'>Sql.Result</ref> object in untyped    mode. This allows for having some more info about the result as    well as processing the result in a streaming fashion, although the    result itself wasn't obtained streamingly from the server.</p> - <p> Returns <expr>0</expr> if the query didn't return any result -  (e.g. <tt>INSERT</tt> or similar).</p> +    </text></group><group><throws/><text><p>Throws an exception if the query fails.</p>   <p> Called by other variants of <ref resolved='predef::__builtin.Sql.Connection.big_query'>big_query()</ref> after they have processed    their extra arguments.</p>   <p> This prototype function is the base variant and is intended to be    overloaded by actual drivers.</p>   </text></group><group><note/><text><p>Despite the name, this function is not only useful for "big"    queries. It typically has less overhead than <ref resolved='predef::__builtin.Sql.Connection.query'>query</ref> also for    ones that return only a few rows.</p>   </text></group><group><seealso/><text><p><ref resolved='predef::__builtin.Sql.Connection.query'>query</ref>, <ref resolved='predef::__builtin.Sql.Connection.streaming_query'>streaming_query</ref></p>   </text></group></doc> - <method name='big_query'> + <method name='big_query'><modifiers><variant/></modifiers>   <arguments><argument name='q'><type><or><object resolved='predef::__builtin.Sql.Connection.big_query'/><string/></or></type></argument></arguments> - <returntype><or><int/><object resolved='predef::__builtin.Sql.Result'>.Result</object></or></returntype> + <returntype><object resolved='predef::__builtin.Sql.Result'>.Result</object></returntype>   </method>   </docgroup>   <docgroup homogen-name='big_query' homogen-type='method'><doc><text><p>Send an SQL query synchronously to the SQL-server and return    the results in untyped mode.</p>   </text><group><param name='q'/><text><p>Query to send to the SQL-server. This can either be a string with the    query, or a previously compiled query (see <ref resolved='predef::__builtin.Sql.Connection.compile_query'>compile_query()</ref>).</p>   </text></group><group><param name='bindings'/><text><p>A mapping containing bindings of variables used in the query.    A variable is identified by a colon (:) followed by a name or number.    Each index in the mapping corresponds to one such variable, and the    value for that index is substituted (quoted) into the query wherever    the variable is used.</p>   <code><text><p>res = query("SELECT foo FROM bar WHERE gazonk=:baz",    ([":baz":"value"]));</p>   </text></code><p>Binary values (BLOBs) may need to be placed in multisets.</p>   </text></group><group><returns/><text><p>The result is returned as an <ref resolved='predef::Sql.Result'>Sql.Result</ref> object in untyped    mode. This allows for having some more info about the result as    well as processing the result in a streaming fashion, although the    result itself wasn't obtained streamingly from the server.</p> - <p> Returns <expr>0</expr> if the query didn't return any result -  (e.g. <tt>INSERT</tt> or similar).</p> +    </text></group><group><throws/><text><p>Throws an exception if the query fails.</p>   <p> Calls the base variant of <ref resolved='predef::__builtin.Sql.Connection.big_query'>big_query()</ref> after having inserted    the bindings into the query (using <ref resolved='predef::__builtin.Sql.Connection.emulate_bindings'>emulate_bindings()</ref>).</p>   <p> Drivers that actually support bindings should overload this    variant in addition to the base variant.</p>   </text></group><group><note/><text><p>Despite the name, this function is not only useful for "big"    queries. It typically has less overhead than <ref resolved='predef::__builtin.Sql.Connection.query'>query</ref> also for    ones that return only a few rows.</p>   </text></group><group><seealso/><text><p><ref resolved='predef::__builtin.Sql.Connection.query'>query</ref>, <ref resolved='predef::__builtin.Sql.Connection.emulate_bindings'>emulate_bindings</ref>, <ref resolved='predef::__builtin.Sql.Connection.streaming_query'>streaming_query</ref></p>   </text></group></doc>   <method name='big_query'><modifiers><variant/></modifiers>   <arguments><argument name='q'><type><or><object resolved='predef::__builtin.Sql.Connection.big_query'/><string/></or></type></argument><argument name='bindings'><type><mapping><indextype><or><string/><int/></or></indextype><valuetype><mixed/></valuetype></mapping></type></argument></arguments> - <returntype><or><int/><object resolved='predef::__builtin.Sql.Result'>.Result</object></or></returntype> + <returntype><object resolved='predef::__builtin.Sql.Result'>.Result</object></returntype>   </method>   </docgroup>   <docgroup homogen-name='big_query' homogen-type='method'><doc><text><p>Send an SQL query synchronously to the SQL-server and return    the results in untyped mode.</p>   </text><group><param name='q'/><text><p>Query to send to the SQL-server. This can either be a string with the    query, or a previously compiled query (see <ref resolved='predef::__builtin.Sql.Connection.compile_query'>compile_query()</ref>).</p>   </text></group><group><param name='extraarg'/><param name='extraargs'/><text><p>Arguments as you would use in sprintf. They are automatically    quoted.</p>   <code><text><p>res = query("select foo from bar where gazonk=%s","value");</p>   </text></code><p>The result is returned as an <ref resolved='predef::Sql.Result'>Sql.Result</ref> object in untyped    mode. This allows for having some more info about the result as    well as processing the result in a streaming fashion, although the -  result itself wasn't obtained streamingly from the server. Returns -  <expr>0</expr> if the query didn't return any result (e.g. <tt>INSERT</tt> -  or similar).</p> +  result itself wasn't obtained streamingly from the server.</p>   <p> The default implementation normalizes <ref resolved='predef::__builtin.Sql.Connection.big_query.q'>q</ref> and <ref resolved='predef::__builtin.Sql.Connection.big_query.extraargs'>extraargs</ref> to    use the bindings mapping (via <ref resolved='predef::__builtin.Sql.Connection.handle_extraargs'>handle_extraargs()</ref>), and calls    one of the other variants of <ref resolved='predef::__builtin.Sql.Connection.big_query'>big_query()</ref> with the result.</p>   </text></group><group><note/><text><p>Despite the name, this function is not only useful for "big"    queries. It typically has less overhead than <ref resolved='predef::__builtin.Sql.Connection.query'>query</ref> also for    ones that return only a few rows.</p>   </text></group><group><seealso/><text><p><ref resolved='predef::__builtin.Sql.Connection.query'>query</ref>, <ref resolved='predef::__builtin.Sql.Connection.handle_extraargs'>handle_extraargs</ref>, <ref resolved='predef::__builtin.Sql.Connection.streaming_query'>streaming_query</ref></p>   </text></group></doc>   <method name='big_query'><modifiers><variant/></modifiers>   <arguments><argument name='q'><type><or><object resolved='predef::__builtin.Sql.Connection.big_query'/><string/></or></type></argument><argument name='extraarg'><type><or><string/><multiset/><int/><float/><object resolved='predef::__builtin.Sql.Connection.big_query'/></or></type></argument><argument name='extraargs'><type><varargs><or><string/><multiset/><int/><float/><object resolved='predef::__builtin.Sql.Connection.big_query'/></or></varargs></type></argument></arguments> - <returntype><or><int/><object resolved='predef::__builtin.Sql.Result'>.Result</object></or></returntype> + <returntype><object resolved='predef::__builtin.Sql.Result'>.Result</object></returntype>   </method>   </docgroup>   <docgroup homogen-name='big_typed_query' homogen-type='method'><doc><text><p>Send an SQL query synchronously to the SQL-server and return    the results in typed mode.</p>   <p> For the argument, please see the <ref resolved='predef::__builtin.Sql.Connection.big_query'>big_query()</ref> function.</p>   <p> The result is returned as an <ref resolved='predef::Sql.Result'>Sql.Result</ref> object in typed    mode. This allows for having some more info about the result as    well as processing the result in a streaming fashion, although the -  result itself wasn't obtained streamingly from the server. Returns -  <expr>0</expr> if the query didn't return any result (e.g. <tt>INSERT</tt> -  or similar).</p> +  result itself wasn't obtained streamingly from the server.</p>   </text><group><note/><text><p>Typed mode is not supported by all sql databases. If not    supported, an error is thrown.</p>   </text></group><group><note/><text><p>Despite the name, this function is not only useful for "big"    queries. It typically has less overhead than <ref resolved='predef::__builtin.Sql.Connection.typed_query'>typed_query</ref> also    for ones that return only a few rows.</p>   <p> Called by <ref resolved='predef::__builtin.Sql.Connection.big_typed_query'>big_typed_query()</ref> after it has processed any bindings.</p> - <p> This prototype function is intended for overriding by drivers.</p> + <p> Drivers should override this prototype function.</p>   </text></group><group><seealso/><text><p><ref resolved='predef::__builtin.Sql.Connection.query'>query</ref>, <ref resolved='predef::__builtin.Sql.Connection.typed_query'>typed_query</ref>, <ref resolved='predef::__builtin.Sql.Connection.big_query'>big_query</ref>, <ref resolved='predef::__builtin.Sql.Connection.streaming_query'>streaming_query</ref></p>   </text></group></doc> - <method name='big_typed_query'> + <method name='big_typed_query'><modifiers><variant/></modifiers>   <arguments><argument name='q'><type><or><object resolved='predef::__builtin.Sql.Connection.big_typed_query'/><string/></or></type></argument></arguments> - <returntype><or><int/><object resolved='predef::__builtin.Sql.Result'>.Result</object></or></returntype> + <returntype><object resolved='predef::__builtin.Sql.Result'>.Result</object></returntype>   </method>   </docgroup>   <docgroup homogen-name='big_typed_query' homogen-type='method'><doc><text><p>Send an SQL query synchronously to the SQL-server and return    the results in typed mode.</p>   <p> For the arguments, please see the <ref resolved='predef::__builtin.Sql.Connection.big_query'>big_query()</ref> function.</p>   <p> The result is returned as an <ref resolved='predef::Sql.Result'>Sql.Result</ref> object in typed    mode. This allows for having some more info about the result as    well as processing the result in a streaming fashion, although the -  result itself wasn't obtained streamingly from the server. Returns -  <expr>0</expr> if the query didn't return any result (e.g. <tt>INSERT</tt> -  or similar).</p> +  result itself wasn't obtained streamingly from the server.</p>   </text><group><note/><text><p>Typed mode is not supported by all sql databases. If not    supported, an error is thrown.</p>   </text></group><group><note/><text><p>Despite the name, this function is not only useful for "big"    queries. It typically has less overhead than <ref resolved='predef::__builtin.Sql.Connection.typed_query'>typed_query</ref> also    for ones that return only a few rows.</p>   <p> Called by <ref resolved='predef::__builtin.Sql.Connection.big_typed_query'>big_typed_query()</ref> after it has processed any bindings.</p>   </text></group><group><seealso/><text><p><ref resolved='predef::__builtin.Sql.Connection.query'>query</ref>, <ref resolved='predef::__builtin.Sql.Connection.typed_query'>typed_query</ref>, <ref resolved='predef::__builtin.Sql.Connection.big_query'>big_query</ref>, <ref resolved='predef::__builtin.Sql.Connection.streaming_query'>streaming_query</ref></p>   </text></group></doc>   <method name='big_typed_query'><modifiers><variant/></modifiers>   <arguments><argument name='q'><type><or><object resolved='predef::__builtin.Sql.Connection.big_typed_query'/><string/></or></type></argument><argument name='bindings'><type><mapping><indextype><or><string/><int/></or></indextype><valuetype><mixed/></valuetype></mapping></type></argument></arguments> - <returntype><or><int/><object resolved='predef::__builtin.Sql.Result'>.Result</object></or></returntype> + <returntype><object resolved='predef::__builtin.Sql.Result'>.Result</object></returntype>   </method>   </docgroup>   <docgroup homogen-name='big_typed_query' homogen-type='method'><doc><text><p>Send an SQL query synchronously to the SQL-server and return    the results in typed mode.</p>   <p> For the arguments, please see the <ref resolved='predef::__builtin.Sql.Connection.big_query'>big_query()</ref> function.</p>   <p> The result is returned as an <ref resolved='predef::Sql.Result'>Sql.Result</ref> object in typed    mode. This allows for having some more info about the result as    well as processing the result in a streaming fashion, although the -  result itself wasn't obtained streamingly from the server. Returns -  <expr>0</expr> if the query didn't return any result (e.g. <tt>INSERT</tt> -  or similar).</p> +  result itself wasn't obtained streamingly from the server.</p>   </text><group><note/><text><p>Typed mode is not supported by all sql databases. If not    supported, an error is thrown.</p>   </text></group><group><note/><text><p>Despite the name, this function is not only useful for "big"    queries. It typically has less overhead than <ref resolved='predef::__builtin.Sql.Connection.typed_query'>typed_query</ref> also    for ones that return only a few rows.</p>   </text></group><group><seealso/><text><p><ref resolved='predef::__builtin.Sql.Connection.query'>query</ref>, <ref resolved='predef::__builtin.Sql.Connection.typed_query'>typed_query</ref>, <ref resolved='predef::__builtin.Sql.Connection.big_query'>big_query</ref>, <ref resolved='predef::__builtin.Sql.Connection.streaming_query'>streaming_query</ref></p>   </text></group></doc>   <method name='big_typed_query'><modifiers><variant/></modifiers>   <arguments><argument name='q'><type><or><object resolved='predef::__builtin.Sql.Connection.big_typed_query'/><string/></or></type></argument><argument name='extraarg'><type><or><string/><multiset/><int/><float/><object resolved='predef::__builtin.Sql.Connection.big_typed_query'/></or></type></argument><argument name='extraargs'><type><varargs><or><string/><multiset/><int/><float/><object resolved='predef::__builtin.Sql.Connection.big_typed_query'/></or></varargs></type></argument></arguments> - <returntype><or><int/><object resolved='predef::__builtin.Sql.Result'>.Result</object></or></returntype> + <returntype><object resolved='predef::__builtin.Sql.Result'>.Result</object></returntype>   </method>   </docgroup>   <docgroup homogen-name='case_convert' homogen-type='variable'><doc><text><p>Convert all field names in mappings to <ref resolved='predef::lower_case'>lower_case</ref>.    Only relevant to databases which only implement <ref resolved='predef::__builtin.Sql.Connection.big_query'>big_query()</ref>,    and use upper/mixed-case fieldnames (eg Oracle).</p>   <int><group><value>0</value><text><p>No (default)</p>   </text></group><group><value>1</value><text><p>Yes</p>   </text></group></int>   </text></doc>   <variable name='case_convert'><type><int><min>0</min><max>1</max></int></type></variable>
autodoc.git/onepage.xml:145134:   </text></group><group><seealso/><text><p><ref resolved='predef::__builtin.Sql.Connection.is_open'>is_open()</ref></p>   </text></group></doc>   <method name='ping'>   <arguments/>   <returntype><int/></returntype>   </method>   </docgroup>   <docgroup homogen-name='promise_query' homogen-type='method'><doc><text><p>Sends a typed query to the database asynchronously.</p>   </text><group><returns/><text><p>An <ref resolved='predef::Sql.Promise'>Sql.Promise</ref> object which can be used to obtain    an <ref resolved='predef::Sql.FutureResult'>Sql.FutureResult</ref> object to evaluate the query.</p> - </text></group><group><seealso/><text><p><ref resolved='predef::__builtin.Sql.Connection.big_typed_query'>big_typed_query()</ref>, <ref resolved='predef::Sql.Promise'>Sql.Promise</ref>, <ref resolved='predef::Sql.FutureResult'>Sql.FutureResult</ref></p> + </text></group><group><seealso/><text><p><ref resolved='predef::__builtin.Sql.Connection.streaming_typed_query'>streaming_typed_query()</ref>, <ref resolved='predef::Sql.Promise'>Sql.Promise</ref>, <ref resolved='predef::Sql.FutureResult'>Sql.FutureResult</ref></p>   </text></group><group><param name='map_cb'/><text><p>Callback function which is called for every row returned.    First parameter is the row, second parameter is the result object    being processed, and the third parameter is the array of result rows    already collected so far. The function should return the modified    version of the row that needs to be stored, or it should return    <expr>0</expr> to discard the row.</p>   </text></group><group><example/><text><code><text><p>Sql.Connection db = Sql.Connection("...");    Sql.Promise q1 = db-&gt;promise_query("SELECT 42")-&gt;max_records(10);    Sql.Promise q2 = db-&gt;promise_query("SELECT :foo::INT", (["foo":2]));</p>   <p> array(Concurrent.Future) all = ({ q1, q2 })-&gt;future();</p>
autodoc.git/onepage.xml:145277:   <arguments/>   <returntype><string/></returntype>   </method>   </docgroup>   <docgroup homogen-name='streaming_query' homogen-type='method'><doc><text><p>Send an SQL query synchronously to the SQL-server and return    the results streaming in untyped mode.</p>   <p> For the arguments, please see the <ref>low_big_query()</ref> function.</p>   <p> The result is returned as a streaming <ref resolved='predef::Sql.Result'>Sql.Result</ref> object in    untyped mode. This allows for having results larger than the    available memory, and returning some more info about the result. -  Returns <expr>0</expr> if the query didn't return any result (e.g. -  INSERT or similar). For the other arguments, they are the same as +  For the other arguments, they are the same as    for the <ref resolved='predef::__builtin.Sql.Connection.query'>query()</ref> function.</p>   <p> Called by <ref resolved='predef::__builtin.Sql.Connection.streaming_query'>streaming_query()</ref> after it has processed any bindings.</p> - <p> This variant function is intended for overriding by drivers.</p> + <p> Drivers should override this prototype function.</p>   </text><group><note/><text><p>Streaming operation is not supported by all sql databases.    The default implementation falls back to calling <ref resolved='predef::__builtin.Sql.Connection.big_query'>big_query()</ref>.</p>   </text></group><group><seealso/><text><p><ref resolved='predef::__builtin.Sql.Connection.big_query'>big_query</ref>, <ref resolved='predef::__builtin.Sql.Connection.streaming_typed_query'>streaming_typed_query</ref></p>   </text></group></doc> - <method name='streaming_query'> + <method name='streaming_query'><modifiers><variant/></modifiers>   <arguments><argument name='q'><type><or><object resolved='predef::__builtin.Sql.Connection.streaming_query'/><string/></or></type></argument></arguments> - <returntype><or><int/><object resolved='predef::__builtin.Sql.Result'>.Result</object></or></returntype> + <returntype><object resolved='predef::__builtin.Sql.Result'>.Result</object></returntype>   </method>   </docgroup>   <docgroup homogen-name='streaming_query' homogen-type='method'><doc><text><p>Send an SQL query synchronously to the SQL-server and return    the results streaming in untyped mode.</p>   <p> For the arguments, please see the <ref>low_big_query()</ref> function.</p>   <p> The result is returned as a streaming <ref resolved='predef::Sql.Result'>Sql.Result</ref> object in    untyped mode. This allows for having results larger than the    available memory, and returning some more info about the result. -  Returns <expr>0</expr> if the query didn't return any result (e.g. -  INSERT or similar). For the other arguments, they are the same as +  For the other arguments, they are the same as    for the <ref resolved='predef::__builtin.Sql.Connection.query'>query()</ref> function.</p>   <p> Called by <ref resolved='predef::__builtin.Sql.Connection.streaming_query'>streaming_query()</ref> after it has processed any bindings.</p> - <p> This variant function is intended for overriding by drivers that -  actually implement bindings.</p> + <p> Drivers that implement bindings should override this prototype function.</p>   </text><group><note/><text><p>Streaming operation is not supported by all sql databases.    The default implementation falls back to calling <ref resolved='predef::__builtin.Sql.Connection.big_query'>big_query()</ref>.</p>   </text></group><group><seealso/><text><p><ref resolved='predef::__builtin.Sql.Connection.big_query'>big_query</ref>, <ref resolved='predef::__builtin.Sql.Connection.streaming_typed_query'>streaming_typed_query</ref></p>   </text></group></doc>   <method name='streaming_query'><modifiers><variant/></modifiers>   <arguments><argument name='q'><type><or><object resolved='predef::__builtin.Sql.Connection.streaming_query'/><string/></or></type></argument><argument name='bindings'><type><mapping><indextype><string/></indextype><valuetype><mixed/></valuetype></mapping></type></argument></arguments> - <returntype><or><int/><object resolved='predef::__builtin.Sql.Result'>.Result</object></or></returntype> + <returntype><object resolved='predef::__builtin.Sql.Result'>.Result</object></returntype>   </method>   </docgroup>   <docgroup homogen-name='streaming_query' homogen-type='method'><doc><text><p>Send an SQL query synchronously to the SQL-server and return    the results streaming in untyped mode.</p>   <p> For the arguments, please see the <ref resolved='predef::__builtin.Sql.Connection.query'>query()</ref> function.</p>   <p> The result is returned as a streaming <ref resolved='predef::Sql.Result'>Sql.Result</ref> object in    untyped mode. This allows for having results larger than the    available memory, and returning some more info about the result. -  Returns <expr>0</expr> if the query didn't return any result (e.g. -  INSERT or similar). For the other arguments, they are the same as +  For the other arguments, they are the same as    for the <ref resolved='predef::__builtin.Sql.Connection.query'>query()</ref> function.</p>   </text><group><note/><text><p>Streaming operation is not supported by all sql databases.    If not supported, this function will fall back to calling    <ref resolved='predef::__builtin.Sql.Connection.big_query'>big_query()</ref>.</p>   </text></group><group><seealso/><text><p><ref resolved='predef::__builtin.Sql.Connection.big_query'>big_query</ref>, <ref resolved='predef::__builtin.Sql.Connection.streaming_typed_query'>streaming_typed_query</ref></p>   </text></group></doc>   <method name='streaming_query'><modifiers><variant/></modifiers>   <arguments><argument name='q'><type><or><object resolved='predef::__builtin.Sql.Connection.streaming_query'/><string/></or></type></argument><argument name='extraarg'><type><or><string/><multiset/><int/><float/><object resolved='predef::__builtin.Sql.Connection.streaming_query'/></or></type></argument><argument name='extraargs'><type><varargs><or><string/><multiset/><int/><float/><object resolved='predef::__builtin.Sql.Connection.streaming_query'/></or></varargs></type></argument></arguments> - <returntype><or><int/><object resolved='predef::__builtin.Sql.Result'>.Result</object></or></returntype> + <returntype><object resolved='predef::__builtin.Sql.Result'>.Result</object></returntype>   </method>   </docgroup>   <docgroup homogen-name='streaming_typed_query' homogen-type='method'><doc><text><p>Send an SQL query synchronously to the SQL-server and return    the results streaming in typed mode.</p>   <p> For the arguments, please see the <ref resolved='predef::__builtin.Sql.Connection.query'>query()</ref> function.</p>   <p> The result is returned as a streaming <ref resolved='predef::Sql.Result'>Sql.Result</ref> object in    typed mode. This allows for having results larger than the -  available memory, and returning some more info about the result. -  Returns <expr>0</expr> if the query didn't return any result (e.g. -  INSERT or similar).</p> +  available memory, and returning some more info about the result.</p>   <p> Called by <ref resolved='predef::__builtin.Sql.Connection.streaming_query'>streaming_query()</ref> after it has processed any bindings.</p> - <p> This function is intended for overriding by drivers.</p> + <p> Drivers should override this prototype function.</p>   </text><group><note/><text><p>Neither streaming operation nor typed results are supported    by all sql databases. The default implentation falls back to    calling <ref resolved='predef::__builtin.Sql.Connection.big_typed_query'>big_typed_query()</ref>.</p>   </text></group><group><seealso/><text><p><ref resolved='predef::__builtin.Sql.Connection.streaming_query'>streaming_query</ref>, <ref resolved='predef::__builtin.Sql.Connection.big_typed_query'>big_typed_query</ref></p>   </text></group></doc> - <method name='streaming_typed_query'> + <method name='streaming_typed_query'><modifiers><variant/></modifiers>   <arguments><argument name='q'><type><or><object resolved='predef::__builtin.Sql.Connection.streaming_typed_query'/><string/></or></type></argument></arguments> - <returntype><or><int/><object resolved='predef::__builtin.Sql.Result'>.Result</object></or></returntype> + <returntype><object resolved='predef::__builtin.Sql.Result'>.Result</object></returntype>   </method>   </docgroup>   <docgroup homogen-name='streaming_typed_query' homogen-type='method'><doc><text><p>Send an SQL query synchronously to the SQL-server and return    the results streaming in typed mode.</p>   <p> For the arguments, please see the <ref resolved='predef::__builtin.Sql.Connection.query'>query()</ref> function.</p>   <p> The result is returned as a streaming <ref resolved='predef::Sql.Result'>Sql.Result</ref> object in    typed mode. This allows for having results larger than the -  available memory, and returning some more info about the result. -  Returns <expr>0</expr> if the query didn't return any result (e.g. -  INSERT or similar).</p> +  available memory, and returning some more info about the result.</p>   <p> Called by <ref resolved='predef::__builtin.Sql.Connection.streaming_query'>streaming_query()</ref> after it has processed any bindings.</p> - <p> This function is intended for overriding by drivers.</p> + <p> Drivers should override this prototype function.</p>   </text><group><note/><text><p>Neither streaming operation nor typed results are supported    by all sql databases. The default implentation falls back to    calling <ref>low_big_typed_query()</ref>.</p>   </text></group><group><seealso/><text><p><ref resolved='predef::__builtin.Sql.Connection.streaming_query'>streaming_query</ref>, <ref resolved='predef::__builtin.Sql.Connection.big_typed_query'>big_typed_query</ref></p>   </text></group></doc>   <method name='streaming_typed_query'><modifiers><variant/></modifiers>   <arguments><argument name='q'><type><or><object resolved='predef::__builtin.Sql.Connection.streaming_typed_query'/><string/></or></type></argument><argument name='bindings'><type><mapping><indextype><or><string/><int/></or></indextype><valuetype><mixed/></valuetype></mapping></type></argument></arguments> - <returntype><or><int/><object resolved='predef::__builtin.Sql.Result'>.Result</object></or></returntype> + <returntype><object resolved='predef::__builtin.Sql.Result'>.Result</object></returntype>   </method>   </docgroup>   <docgroup homogen-name='streaming_typed_query' homogen-type='method'><doc><text><p>Send an SQL query synchronously to the SQL-server and return    the results streaming in typed mode.</p>   <p> For the arguments, please see the <ref resolved='predef::__builtin.Sql.Connection.query'>query()</ref> function.</p>   <p> The result is returned as a streaming <ref resolved='predef::Sql.Result'>Sql.Result</ref> object in    typed mode. This allows for having results larger than the -  available memory, and returning some more info about the result. -  Returns <expr>0</expr> if the query didn't return any result (e.g. -  INSERT or similar).</p> +  available memory, and returning some more info about the result.</p>   </text><group><note/><text><p>Neither streaming operation nor typed results are supported    by all sql databases. If not supported, this function will    fall back to calling <ref resolved='predef::__builtin.Sql.Connection.big_typed_query'>big_typed_query()</ref>.</p>   </text></group><group><seealso/><text><p><ref resolved='predef::__builtin.Sql.Connection.streaming_query'>streaming_query</ref>, <ref resolved='predef::__builtin.Sql.Connection.big_typed_query'>big_typed_query</ref></p>   </text></group></doc>   <method name='streaming_typed_query'><modifiers><variant/></modifiers>   <arguments><argument name='q'><type><or><object resolved='predef::__builtin.Sql.Connection.streaming_typed_query'/><string/></or></type></argument><argument name='extraarg'><type><or><string/><multiset/><int/><float/><object resolved='predef::__builtin.Sql.Connection.streaming_typed_query'/></or></type></argument><argument name='extraargs'><type><varargs><or><string/><multiset/><int/><float/><object resolved='predef::__builtin.Sql.Connection.streaming_typed_query'/></or></varargs></type></argument></arguments> - <returntype><or><int/><object resolved='predef::__builtin.Sql.Result'>.Result</object></or></returntype> + <returntype><object resolved='predef::__builtin.Sql.Result'>.Result</object></returntype>   </method>   </docgroup>   <docgroup homogen-name='typed_query' homogen-type='method'><doc><text><p>Send an SQL query synchronously to the SQL-server and return    the results in typed mode.</p>   <p> For the arguments, please see the <ref resolved='predef::__builtin.Sql.Connection.query'>query()</ref> function.</p>   </text><group><returns/><text><p>Returns one of the following on success:</p>   <mixed><group><type><array><valuetype><mapping><indextype><string/></indextype><valuetype><mixed/></valuetype></mapping></valuetype></array></type><text><p>The result as an array of mappings indexed on the name of    the columns. The values have the appropriate native pike    types where they fit the SQL data types - see the class doc    for details on typed mode.</p>