SYNOPSIS

\*(T<#include <opendbx/api.h>\*(T>

\*(T<int odbx_row_fetch\*(T> \kx \*(T<(odbx_result_t* result);\*(T>

DESCRIPTION

Retrieves the values of a row from the current result set returned by \*(T<odbx_result\*(T>(). Until this function is invoked, no row and field data is available via \*(T<odbx_field_length\*(T>() or \*(T<odbx_field_value\*(T>() and these functions will return zero respectively NULL.

Moreover, it is necessary to fetch all rows from a result set until zero is returned indicating that no more rows are available. Otherwise - depending on the backend - an error may occur after calling \*(T<odbx_result\*(T>() the next time or the outstanding rows will be returned within the next result.

\*(T<odbx_row_fetch\*(T>() requires a valid \*(T<result\*(T> object which was created by \*(T<odbx_result\*(T>(). It must not have been feed to \*(T<odbx_result_finish\*(T>() before.

RETURN VALUE

\*(T<odbx_row_fetch\*(T>() will return \*(T<ODBX_ROW_NEXT\*(T> ("1") as long as rows are available from the result set. After the last row has been made available, further calls to this function will return \*(T<ODBX_ROW_DONE\*(T> ("0") indicating that the result set doesn't contain more rows. The named constants are available since OpenDBX 1.3.2 and the numbers in brackets have to be used instead if a previous release is is the basis for the application development.

In case of an error, values less than zero are returned encodeing the reason why the error occurred.

ERRORS

-\*(T<ODBX_ERR_PARAM\*(T>

The \*(T<result\*(T> parameter is either NULL or the object is invalid. This is usually the case if result has been already feed to \*(T<odbx_result_finish\*(T>().

RELATED TO odbx_row_fetch…

\*(T<odbx_column_count\*(T>(), \*(T<odbx_column_name\*(T>(), \*(T<odbx_column_type\*(T>(), \*(T<odbx_error\*(T>(), \*(T<odbx_error_type\*(T>(), \*(T<odbx_field_length\*(T>(), \*(T<odbx_field_value\*(T>(), \*(T<odbx_result\*(T>()