dbFindMemInstByName

dbFindMemInstByName( 
d_cellView 
t_name 
) 
=> ( d_inst x_index ) / nil 

Description

Retrieves an instance or mosaic and returns its member index.

Unlike the dbFindAnyInstByName function described earlier, dbFindMemInstByName returns not only the instance dbObject, but also the member index of the instance to which the name applies. This member index is applicable to iterated instances.

Arguments

d_cellView	Name of cellview.
t_name	Name of the instance.

Value Returned

d_inst x_index	The dbObject and the member index of the instance as a list.
nil	The instance or mosaic is not retrieved.

Examples

inst = dbCreateInst(cvSch cvSym "myInst" list(0 0) "R0" 2) 
dbFindMemInstByName(cvSch "myInst") => (db:<dbId#> 0)
dbFindMemInstByName(cvSch "myInst<1>") => nil

inst = dbCreateInst(cvSch cvSym "myInst" list(0 0) "R0") 
dbFindMemInstByName(cvSch "myInst") => (db:<dbId#> 0)
dbFindMemInstByName(cvSch "myInst<1>") => nil

inst = dbCreateInst(cvSch cvSym "m<0:3>" list(0 0) "R0") 
dbFindMemInstByName(cvSch "m<0>") => (db:<dbId#> 0)
dbFindMemInstByName(cvSch "m<1>") => (db:<dbId#> 1)
dbFindMemInstByName(cvSch "m<3>") => (db:<dbId#> 3)
dbFindMemInstByName(cvSch "m<4>") => nil
dbFindMemInstByName(cvSch "m") => nil

inst = dbCreateInst(cvSch cvSym "m<3>" list(0 0) "R0") 
dbFindMemInstByName(cvSch "m<0>") => nil
dbFindMemInstByName(cvSch "m") => nil
dbFindMemInstByName(cvSch "m<2>") => nil
dbFindMemInstByName(cvSch "m<3>") => (db:<dbId#> 0)

Return to top