autodoc.git
/
onepage.xml
version
»
Context lines:
10
20
40
80
file
none
3
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->promise_query("SELECT 42")->max_records(10); Sql.Promise q2 = db->promise_query("SELECT :foo::INT", (["foo":2]));</p> <p> array(Concurrent.Future) all = ({ q1, q2 })->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>