dmCreateCellCategory

dmCreateCellCategory( 
g_libOrCatId 
t_categoryName 
l_cellList 
) 
=> t / nil

Description

Creates a cell category and adds all specified cells to the category.

Supplied for compatibility. The equivalent functionality using the ddCat API would be

catId = ddCatOpen( libOrCatId categoryName "w" ) 
when( catId 
    foreach( i cellList 
     ddCatAddItem( catId i~>name "cell" ) 
 ) 
 ddCatSave( catId ) 
 ddCatClose( catId ) 
)

Using the ddCat API is more efficient because the categories are implemented using check-point files that must be locked against access by other users. The above lines of code explicitly gets a lock (the ddCatOpen) and frees the lock (the ddCatClose).

The DFII-DM function accepted a list of cell IDs. For forward compatibility, the implementation of this function accepts a list of cell IDs or cell names.

Arguments

g_libOrCatId	ID of the library or cell category to be created.
t_categoryName	Name of the category to be created.
l_cellList	List of cells to be added to the category.

Value Returned

`t`	The category is created.
`nil`	The category cannot be created.

Return to top

Virtuoso Studio Design Environment SKILL ReferenceProduct Version IC23.1, November 2023