MySQL :: MySQL 8.0 C API Developer Guide :: 6.4.24 mysql_stmt_row_seek() (original) (raw)

6.4.24 mysql_stmt_row_seek()

MYSQL_ROW_OFFSET
mysql_stmt_row_seek(MYSQL_STMT *stmt,
                    MYSQL_ROW_OFFSET offset)

Description

Sets the row cursor to an arbitrary row in a statement result set. The offset value is a row offset that should be a value returned frommysql_stmt_row_tell() or frommysql_stmt_row_seek(). This value is not a row number; if you want to seek to a row within a result set by number, usemysql_stmt_data_seek() instead.

This function requires that the result set structure contains the entire result of the query, somysql_stmt_row_seek() may be used only in conjunction withmysql_stmt_store_result().

Return Values

The previous value of the row cursor. This value may be passed to a subsequent call tomysql_stmt_row_seek().

Errors

None.