dbGetNextRow(3dba)

dbGetNextRow -- return a row from a result table based on row and column index

Synopsis

cc [flag ...] file ... -kthread -leels [library] ...

#include <eelsdba.h>

DBRow *dbGetNextRow(DBresult *result);

Description

dbGetNextRow returns a pointer to a row (DBRow structure) from a database. The row contains the values and description of the columns requested in a previous successful SQL query.

When an application has finished using the pointer returned by this routine, it should call dbFreeRow(3dba) to free the memory associated with the DBRow structure.

Arguments

result: (Input) A pointer to a DBResult structure returned from a previous call to dbQuery(3dba).

Return values

If successful, dbGetNextRow returns a pointer to a DBRow structure. Otherwise, it returns NULL.

Diagnostics

An application can call dbGetError(3dba) to obtain the error message returned from the database.

References

dbFreeRow(3dba), dbGetError(3dba), dbQuery(3dba), Intro(3dba)