an S4 object that inherits from DBIResult.
The result set can be used with
dbFetch() to extract records.
Once you have finished using a result, make sure to clear it
An error is raised when issuing a query over a closed
or invalid connection,
if the syntax of the query is invalid,
or if the query is not a non-
The following argument is not part of the
(to improve compatibility across backends)
but is part of the DBI specification:
It must be provided as named arguments. See the "Specification" sections for details on its usage.
No warnings occur under normal conditions.
When done, the DBIResult object must be cleared with a call to
Failure to clear the result set leads to a warning
when the connection is closed.
If the backend supports only one open result set per connection,
issuing a second query invalidates an already open result set
and raises a warning.
The newly opened result set is valid
and must be cleared with
param argument allows passing query parameters, see
dbBind() for details.