next up previous contents index
Next: Symbol Tables Up: Main Functions 1 Previous: Cell Info   Contents   Index

Database

Clear(cellname)
If cellname is not empty, any matching cell and all its descendents are cleared from the database, unless they are referenced by another cell not being cleared. If cellname is null or empty, the entire database is cleared. This function is obviously very dangerous.

ClearAll(clear_tech)
This will clear all cells from the present symbol table, clear and delete any other symbol tables that may be defined, and revert the layer database. If the boolean argument is nonzero, layers read from the technology file will be cleared, otherwise the layer database is reverted to the state just after the technology file was read. This function does not automatically open a new cell. This is for server mode, to give the system a good scrubbing between jobs.

(int) IsCellInMem(cellname)
This function returns 1 if the string cellname is the name of a cell in the current symbol table, 0 otherwise. If the string contains a path prefix, it will be ignored, and the last (filename) component used for the test.

(int) IsFileInMem(filename)
This will compare the string filename to the source file names saved with top-level cells in the current symbol table. If filename is a full path, the function returns 1 if an exact match is found. If filename is not rooted, the function returns 1 if the last path component matches. In either case, 0 is returned if no match is seen.

(int) NumCellsInMem()
This function returns an integer giving the number of cells in the current symbol table.

(stringlist_handle) ListCellsInMem(options_str)
This function returns a handle to a list of strings, sorted alphabetically, giving the names of cells found in the current symbol table.

A fairly extensive filtering capability is available, which is configured through a string passed as the argument. If 0 is passed, or the options string is null or empty, all cells will be listed.

The string consists of a space-separated list of keywords, each of which represents a condition for filtering. The cells listed will be the logical AND of all option clauses. The keysords are described with the Cell List Filter panel in 9.4.2.

(stringlist_handle) ListTopCellsInMem()
This function returns a handle to a list of strings, sorted alphabetically, giving the names of top-level cells in the current symbol table. These are the cells that are not used as subcells, in either physical or electrical mode.

(stringlist_handle) ListModCellsInMem()
This function returns a handle to a list of strings, sorted alphabetically, giving the names of modified cells in the current symbol table. A cell is modified if the contents have changed since the cell was read or last written to disk.

(stringlist_handle) ListTopFilesInMem()
This function returns a handle to a list of strings, alphabetically sorted, giving the source file names of the top-level cells in the current symbol table.


next up previous contents index
Next: Symbol Tables Up: Main Functions 1 Previous: Cell Info   Contents   Index
Stephen R. Whiteley 2022-05-28