dbListTables(3dba)

dbListTables -- list the tables in a database

Synopsis

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

#include <eelsdba.h>

DBResult *dbListTables(DBConn *conn);

Description

dbListTables returns a pointer to a list of the tables in a database.

The descriptions of the tables can be retrieved by subsequent calls to dbGetNextRow(3dba).

NOTE: When the application has finished using the pointer returned by dbListTables, it should call dbFreeResult(3dba) to free the memory associated with the DBResult structure.

Arguments

conn: (Input) A database connection that was returned by a previous call to dbConnect(3dba).

Return values

If successful, dbListTables returns a pointer to a DBResult structure. Otherwise it returns NULL.

Diagnostics

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

References

dbConnect(3dba), dbFreeResult(3dba), dbGetError(3dba), dbGetNextRow(3dba), Intro(3dba)