MySQL :: MySQL 8.4 C API Developer Guide :: 7.4.1 mysql_fetch_row_nonblocking() (original) (raw)

7.4.1 mysql_fetch_row_nonblocking()

enum net_async_status
mysql_fetch_row_nonblocking(MYSQL_RES *result,
                            MYSQL_ROW *row)

Description

mysql_fetch_row_nonblocking() is used similarly tomysql_fetch_row(). For details about the latter, see Section 5.4.22, “mysql_fetch_row()”. The two functions differ as follows:

• mysql_fetch_row() returns a MYSQL_ROW value containing the next row, or NULL. The meaning of aNULL return depends on which function was called precedingmysql_fetch_row():
  • When used aftermysql_store_result() ormysql_store_result_nonblocking(),mysql_fetch_row() returns NULL if there are no more rows to retrieve.
  • When used aftermysql_use_result(),mysql_fetch_row() returns NULL if there are no more rows to retrieve or an error occurred.
• mysql_fetch_row_nonblocking() returns an enum net_async_status status indicator and takes a second row argument that provides a pointer to aMYSQL_ROW value. When the return status is NET_ASYNC_COMPLETE, therow argument is a pointer to aMYSQL_ROW value containing the next row, or NULL. The meaning ofNULL depends on which function was called precedingmysql_fetch_row_nonblocking():
  • When used aftermysql_store_result() ormysql_store_result_nonblocking(), the row argument isNULL if there are no more rows to retrieve.
  • When used aftermysql_use_result(), the row argument isNULL if there are no more rows to retrieve or an error occurred.

mysql_fetch_row_nonblocking() was added in MySQL 8.0.16.