gdmNextFromSpecList

gdmNextFromSpecList(
q_gdmSpecList
)
=> G_gdmSpecId / nil

Description

Takes a gdmSpecList object and returns a gdmSpec object from it. The first time you call this function, it returns the first gdmSpec object in the gdmSpecList. Each successive call gets the next gdmSpec object.

Use this function with the gdmResetSpecList function. You must call gdmResetSpecList before the first call to gdmNextFromSpecList, otherwise the results may not be accurate.

Arguments

q_gdmSpecList

The gdmSpecList object from which the function returns gdmSpec objects. This object is the return value of the gdmCreateSpecList function.

Value Returned

G_gdmSpecId	The ID of the next gdmSpec object from the gdmSpecList object.
nil	The function failed.

Examples

Use gdmResetSpecList and gdmNextFromSpecList in the following way:

specList = gdmCreateSpecList()
spec = gdmCreateSpec( "mylib" "topcell" "schematic" nil "CDBA" )
gdmAddSpecToSpecList( spec specList )
gdmResetSpecList( specList )
while( nextSpec = gdmNextFromSpecList( specList ) 
      println( gdmInspectSpec( nextSpec "CDBA" ))
     )

Related Topics

gdmResetSpecList

Return to top