4.3.89 ctdbFindTable

---

Find a table in a database dictionary.

Declaration

CTDBRET ctdbFindTable(CTHANDLE Handle, pTEXT Name, pTEXT Path,

VRLEN PathSize)

Description

ctdbFindTable finds a table in a database dictionary. Use ctdbFindTableByUID to find a table by its unique identifier. Use ctdbFindActiveTable to locate an active table by name, and return its handle.

Handle [in] the database handle.
Name [in] the string with the table name to lookup in the database.
Path [out] receives the table path.
PathSize [in] the path size in bytes.

ctdbFirstTable and ctdbNextTable may be used to obtain the names of all tables available to this Database.

Returns

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

Example

eRet=ctdbFindTable(hDbase, tb_name, tb_path, sizeof (tb_path));

See also

ctdbAllocDatabase, ctdbFindTableByUID, ctdbFirstTable, ctdbNextTable