dbCreateNet

dbCreateNet( 
d_cellView 
t_name 
[ d_parentNet ] 
) 
=> d_net / nil 

Description

Creates a new net in a cellview. If the net already exists, returns nil.

To create a child net, the d_parentNet object must not be nil. If t_name is an empty string or nil, the name of the parent net is used. t_name can be a unique name, such as "net1" or, a hierarchy name, such as "moduleA`moduleB`Net2" with at least one hierarchy delimiter (`). However, if you specify a hierarchy name, the d_parentNet object must be nil.

To create a new top-level net, t_name must be specified as a valid name string and d_parentNet is either nil or unspecified.

Arguments

d_cellView	Cellview the net is created within.
t_name	Name of the net. For a child net, it can be an empty string or nil.
d_parentNet	To create a new top-level net, d_parentNet is either nil or unspecified. To create a child net, the d_parentNet object must not be nil.

Value Returned

d_net	A new net in the cellview, if one does not already exist.
nil	The net is not created or the net already exists.

Examples

Creates a top-level net.

parentNet = dbCreateNet(cellview "net")

hierNet = dbCreateNet(cellview "moduleA`moduleB`hierNet")

Creates a child net.

childNet = dbCreateNet(cellview "childNet" parentNet)

Related Topics

Connectivity Creation and Modification Functions

Return to top