Documentation Home
MySQL 9.3 C API Developer Guide
Download this Manual
PDF (US Ltr) - 1.4Mb
PDF (A4) - 1.4Mb


5.4.69 mysql_row_seek()

MYSQL_ROW_OFFSETmysql_row_seek(MYSQL_RES *result,               MYSQL_ROW_OFFSET offset)

Description

Sets the row cursor to an arbitrary row in a query result set. Theoffset value is a row offset, typically a value returned frommysql_row_tell() or frommysql_row_seek(). This value is not a row number; to seek to a row within a result set by number, usemysql_data_seek() instead.

This function requires that the result set structure contains the entire result of the query, somysql_row_seek() may be used only in conjunction withmysql_store_result(), not withmysql_use_result().

Return Values

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

Errors

None.