4.3.94 ctdbFirstTable

---

Get the first table in a database dictionary.

Declaration

CTDBRET ctdbFirstTable(CTHANDLE Handle, pTEXT Name, VRLEN NameSize,

pTEXT Path, VRLEN PathSize)

Description

ctdbFirstTable gets the first table in a database dictionary.

Handle [in] the database handle.
Name [out] receives the table name.
NameSize [in] the Name size in bytes.
Path [out] receives the table path.
PathSize [in] the Path size in bytes.

ctdbFirstTable, in conjunction with ctdbNextTable, may be used to obtain the names of all tables available to this Database. ctdbGetTableCount may be used to retrieve the total number of tables in the database.

Returns

ctdbFirstTable returns CTDBRET_OK on success, or the c-tree Plus error code on failure.

Example

ctdbFirstTable(hDB, t_name, sizeof(t_name), t_path, sizeof (t_path));

do

{ printf("\ntable name: %s", t_name); }

while (ctdbNextTable(hDB, t_name, sizeof(t_name), t_path,

sizeof(t_path)) == CTDBRET_OK);

See also

ctdbFirstDatabase, ctdbNextTable, ctdbFindTable, ctdbGetTableCount