dbCheckParentChild

dbCheckParentChild(
d_cellViewId
[ g_remove ]
)
=> t /nil

Description

Checks the specified cellview for parent-child groups with no child members. The function optionally lets you remove these groups from the cellview.

Parent-child groups with no child members can result from different edit actions. For example, they can get created if you delete the markers created in layout or schematic explicitly or after fixing the related issue.

Arguments

d_cellViewId	Database ID of the cellview to check.
g_remove	A Boolean value that when set to t, removes any parent-child group with no child members. The default is nil, which means that no parent-child groups are removed.

Value Returned

t	The cellview has no parent-child groups without a child member. When g_remove is specified, the parent-child groups that have no child member are removed.
nil	The operation failed.

Examples

In this example, the parent-child group is created by setting and unsetting the parent attribute on a database ID object.

Create a wire and a label associated with the wire

line = dbCreateLine(cellviewId ("wire" "drawing") list(0:0 20:0))

label = dbCreateLabel(cellViewId ("text" "drawing") list(4 0) "Line from 0 to 20"

                      "centerCenter" "R0" "stick" 0.5)

label~>parent = line

Here, line is the parent and label is the child. By removing the child, label, from the parent, line, the parent-child group still exists but it no longer contains any child members.

label~>parent = nil

dbCheckParentChild(cellview)

*WARNING* (DB-220838): dbCheckParentChild: Found parent/child group on parent object 'line' with no child member.

Related Topics

Figure Creation and Retrieval Functions

Return to top