Cell Table

(int) CellTabAdd(cellname, expand)
This function is used to add cell names to the cell table for the current symbol table. The cellname must match a name in the global string table, which includes all cells read into memory or referenced by a CHD in memory.

If the boolean argument expand is nonzero, and the name matches a cell in the main database, the cell and all of the cells in its hierarchy will be added to the table, otherwise only the named cell will be added. It is not an error to add the same cell more than once, duplicates will be ignored.

If the UseCellTab variable is set, when a Cell Hierarchy Digest (CHD) is used to process a cell hierarchy for anything other than reading cells into the main database, cells listed in the cell table will override cells of the same name in the CHD. Thus, for example, one can substitute modified versions of cells as a layout file is being written.

The return value is 1 if all goes well, 0 if the table is not initialized or the cell is not found.

(int) CellTabCheck(cellname)
This function returns 1 if cellname is in the current cell table. If the cellname is valid but cellname is not in the table, 0 is returned. If the cellname is invalid (not a known cell name) or the cell table is uninitialized, the return value is -1.

(int) CellTabRemove(cellname)
If cellname is found in the current cell table, it will be removed. If the name was found in the table and removed, the return value is 1, otherwise the function returns 0.

(stringlist_handle) CellTabList()
This function returns a handle to a list of cell name strings obtained from the current cell table. If the table is empty, a scalar 0 is returned.

(int) CellTabClear()
This function will clear the current cell table. The function always returns 1.