Navigation:  Scripting > System Scripts >

System Script Loop Support Functions

Previous pageReturn to chapter overviewNext page

The following functions are useful when one or more steps need to be repeated once for each line of a file, record in a database, etc., or to implement a stack construct within a build.

 

Note: In Visual Build v7 and later, the Loop action should be used instead of these functions.

 

vbld_AddDelimValue(macroName, value): Creates a new temporary macro with the value or adds a string to the end of the given temporary macro, separating each value with a Tab character delimiter, and returns the updated value.

 

vbld_NextDelimValue(macroName): Given the name of a macro containing Tab-delimited strings (populated via vbld_AddDelimValue), removes the first delimited string from the macro and returns or returns Null if the macro does not exist.

 

vbld_PushDelimValue(macroName, value): Creates a new temporary macro with the value or adds a string to the end of the given temporary macro, separating each value with a Tab character delimiter, and returns the updated value.

 

vbld_PopDelimValue(macroName): Given the name of a macro containing Tab-delimited strings (populated via vbld_AddDelimValue), removes the last delimited string from the macro and returns or returns Null if the macro does not exist.