hdbSetObjBindRule
hdbSetObjBindRule(
h_configId
g_specifier
g_rule
)
=> t / nil
Description
Sets or deletes a binding rule on a cell, instance, or occurrence (path). You can set the following binding rules: library list, view list, binding, or stop point.
Arguments
|
h_configId
|
The ID of the configuration that is opened in write or append mode; the return value of hdbOpen.
|
|
g_specifier
|
A list of lists specifying the cell, instance, or occurrence on which to set the binding rule.
|
|
|
To set a binding rule on a cell, specify a list that contains a single list of four elements:
((lib cell nil nil))
|
|
|
Here,
-
Value of lib is a string or
nil to indicate that the library list should be used to locate the specified cell. -
cell is a required string.
Example:
(("lib1" "cell1" nil nil))
Sets a binding rule on the cell lib1.cell1.
|
|
|
To set a binding rule on an instance, specify a list that contains a single list of four elements:
((lib cell view instance))
|
|
|
Here,
-
Value of lib is a string or
nil to indicate that the library list should be used to locate the specified cell. -
cell is a required string
-
Value of view is a string or
nil to indicate that the view should be determined using the view list. -
instance is a required string.
Example:
(("lib1" "cell1" "view1" "inst1"))
Sets a binding rule on instance (lib1.cell1.view1).inst1.
|
|
|
To set a binding rule on an occurrence, specify a list of lists, each of which must have a library, cell, view, and instance. The list specifies the path to the occurrence, beginning with the top design.
((lib cell view inst) (lib cell view inst) ...)
|
|
g_rule
|
One of the following rules:
|
|
Rule
|
Specified as ...
|
|
Library list
|
(’hdbcLibListRule ("lib1" "lib2" "lib3" ...))
|
|
View list
|
(’hdbcViewListRule ("view1" "view2" "view3" ...))
|
|
Binding
|
(’hdbcBindingRule ("lib "cell" "view"))
where lib, cell, or view can also be nil. For example:
(’hdbcBindingRule ("lib1 "cell1" "view1")) (’hdbcBindingRule (nil "cell1" "view1")) (’hdbcBindingRule (nil nil "view1"))
Note: When setting a binding rule on an occurrence (path), all fields must be specified in the rule. For example,
rule = list (’hdbcBindingRule list ("worklib" "subsub" "schematic2"))
|
|
Stop list
|
(’hdbcStopRule t)
|
|
|
To delete a rule, specify nil as the second element of the list. For example: (’hdbcStopRule nil)
|
Value Returned
|
t
|
The binding is set or deleted.
|
|
nil
|
There was an error.
|
Examples
hdbSetObjBindRule(myConfigID list(list("lib1" "cell1" nil nil)) list(’hdbcStopRule t))
To set a binding rule on an occurrence, the specifier for the path list could be specified as:
spec= list(list ("worklib" "top" "schematic" "IO") list("worklib" "sub" "schematic" "IO")
and the corresponding rule could be defined as:
rule= list(’hdbcBindingRule list ("worklib" "subsub" "schematic2")
Related Topics
Hierarchy Database Functions
Occurrence Property Functions
Parent/Child Database Functions
Return to top