dbCreateNamedSubNet

dbCreateNamedSubNet(
d_parentNet
t_subNetName
)
=> t_subnetId / nil

Description

Creates a subnet with the specified name. The behavior is different from dbCreateNet because when a root net ID is specified. dbCreateNameSubNet creates an explicitly named scalar net with the specified subnet name.

The following restrictions apply:

• The specified d_parentNetId must be a single-bit net.
• The d_parentNetId must be a scalar net, which means that it cannot be a bus-bit name.
• The d_parentNetId cannot have any subnets with the specified subnet name.
• The t_subNetName must be a scalar net, which means that it cannot be a bus-bit name.
• A net in the cellview cannot exist with the subnet name.

Arguments

d_parentNetId	Database ID of the root net with which the subnet will be associated. The d_parentNetId also provides the cellview in which the new net is created.
t_subNetName	Name for the new subnet.

Value Returned

t_subnetId	Name of the subnet that is created with the parent net as its root net.
nil	The subnet could not be created or the subnet already exists.

Examples

In the following example, generating nets in the cellview cv creates the named nets a and sn2. Generating the subnets of net a creates subnets sn1 and sn2.

rootNet = dbCreateNet(cv "a")

Create subnet sn1.

 subNet1 = dbCreateNet(cv "sn1" rootNet)

Create subnet sn2.

 subNet2 = dbCreateNamedSubNet(rootNet "sn2")

cv~>nets~>name

("a" "sn2")

rootNet~>subnet~>name

("sn1" "sn2)

Related Topics

dbCreateNet

Connectivity Creation and Modification Functions

Return to top