asiSetDesignVarList

asiSetDesignVarList(
o_session 
l_designVarList 
)
=> l_designVarList

Description

Sets the design variable list for a session.

This function is used to set the design variable list (a list of (varName, varVal) pairs) for a session, stripping of any invalid varName (the one that does not match the regular expression ^[a-zA-Z_][a-zA-Z_0-9]*$).

Arguments

o_session	Simulator session object.
l_designVarList	List of design variables you want to use. The list should be comprised of one or more 2 element sub-lists of the following format: ("variableName" "value") If the list is ’nil’, all design variables will be removed from the current session.

Value Returned

l_designVarList

Returns the list of design variables for the session.

Example

varList = ’(("var1" "100") ("var2" "ABC"))

asiSetDesignVarList(asiGetCurrentSession() varList)

=> (("var2" "ABC") ("var1" "100"))

Here, var1 & var2 are valid variable names starting with a-z or A-Z characters.

If you want add more design variables you can use asiAddDesignVarList:

varList = ’(("1var1" "100") ("var3" "ABC"))

asiAddDesignVarList(asiGetCurrentSession() varList)

=>*Error* asiSetDesignVarList: bad name "1var1", not added

=> (("var3" "ABC") ("var2" "ABC") ("var1" "100"))

Here var3 is a valid variable name and therefore gets added to the design variable list, but 1var1 is discarded as it is not a valid variable name (not starting with a-z or A-Z character).

Return to top