| Database Independent Abstraction Layer for C: libdbi Programmer's Guide | ||
|---|---|---|
| Prev | Chapter 7. libdbi API Reference | Next |
Returns the connection belonging to the specified result object.
Result: The target query result.
The connection belonging to the target query result.If an error occurs, the return value is NULL, and the error number is set to DBI_ERROR_BADPTR.
Frees the result's query, disables all stored field bindings, and releases internally stored variables.
Result: The target query result.
-1 on failure, zero on success. If a failure was caused by the database client library, the error number is set to the database engine-specific nonzero error code.
Jump to a specific row in a result set.
Result: The target query result.
rowidx: The ordinal number of the row to seek to. The first row is at position 1, not zero.
1 if successful, or 0 if there was an error. In the latter case, the error number is one of DBI_ERROR_BADPTR, DBI_ERROR_BADIDX, or a database engine-specific nonzero value.
Jump to the first row in a result set.
Result: The target query result.
1 if successful, or 0 if there was an error. In the latter case, the error number is one of DBI_ERROR_BADPTR, DBI_ERROR_BADIDX, or a database engine-specific nonzero value.
Jump to the last row in a result set.
Result: The target query result.
1 if successful, or 0 if there was an error. In the latter case, the error number is one of DBI_ERROR_BADPTR, DBI_ERROR_BADIDX, or a database engine-specific nonzero value.
Jump to the previous row in a result set.
Result: The target query result.
1 if successful, or 0 if there is an error. In the latter case, the error number is one of DBI_ERROR_BADPTR, DBI_ERROR_BADIDX, or a database engine-specific nonzero value.
Jump to the next row in a result set.
Result: The target query result.
1 if successful, or 0 if there was an error. In the latter case, the error number is one of DBI_ERROR_BADPTR, DBI_ERROR_BADIDX, or a database engine-specific nonzero value.
Returns the ordinal number of the current row in the specified result set.
Result: The target query result.
The ordinal number of the row, or 0 if there was an error. The first row has the number 1. In case of an error, the error number is DBI_ERROR_BADPTR.
Returns the number of rows in the specified result set.
Result: The target query result.
The number of rows in the result set, which may be 0 if the query did not return any datasets, or DBI_ROW_ERROR in case of an error. In that case, the error number is DBI_ERROR_BADPTR.
Returns the number of rows in the specified result set that were actually modified. Note that not all database servers support this, in which case it will always be zero. See the documentation for each specific driver for details.
Result: The target query result.
The number of modified rows in the result set which may be 0 if no row was affected by the previous query. Also returns 0 if the database engine does not support this feature. The return value will be DBI_ROW_ERROR in case of an error. In case of an error, the error number is DBI_ERROR_BADPTR.