Difference between revisions of "OpenDBX/C API/odbx row fetch"

From Linuxnetworks
< OpenDBX‎ | C API
Jump to: navigation, search
(Description:)
(Description:)
Line 6: Line 6:
 
= Description: =
 
= Description: =
  
Retrieves the next row of a result set returned by odbx_result(). You must fetch all rows from a result set. Otherwise - depending on the backend - an error may occur after calling odbx_result() the next time or the outstanding results will be returned.
+
Retrieves a row of the result set returned by [[OpenDBX_result|odbx_result()]]. Until this function is invoked, no row and no field data is available via [[OpenDBX_field_length|odbx_field_length()]] and [[OpenDBX_field_value|odbx_field_value()]] and you must fetch all rows from a result set until zero is returned. Otherwise - depending on the backend - an error may occur after calling [[OpenDBX_result|odbx_result()]] the next time or the outstanding rows will be returned within the next result.
  
 
= Parameters: =
 
= Parameters: =

Revision as of 18:12, 5 June 2006


int odbx_row_fetch(
    odbx_result_t* result )

Description:

Retrieves a row of the result set returned by odbx_result(). Until this function is invoked, no row and no field data is available via odbx_field_length() and odbx_field_value() and you must fetch all rows from a result set until zero is returned. Otherwise - depending on the backend - an error may occur after calling odbx_result() the next time or the outstanding rows will be returned within the next result.

Parameters:

  • result: Object created by odbx_result()

Return values:

  • One on success
  • Zero if no more rows are available
  • Less than zero if an error occured

Errors:

  • -ODBX_ERR_PARAM: Parameter or its content is invalid



Back to Overview