ListAppendFromArray

InstallShield 2026 » InstallScript Language Reference

Project: This information applies to InstallScript projects.

The ListAppendFromArray function appends the elements in the array that is specified by varSource to the list that is specified by listResult.

Syntax

ListAppendFromArray ( listResult, varSource, bString );

Parameters

ListAppendFromArray Parameters
Parameter	Description
listResult	Specifies the name of a list. The list identified by listResult must already have been initialized by a call to ListCreate.
varSource	Specifies the array to append to the list.
bString	Set this parameter to TRUE if varSource is a string array and listResult is a string list; set this parameter to FALSE if varSource is a number array and listResult is a number list.

Return Values

ListAppendFromArray Return Values
Return Value	Description
>= 0	The new number of elements in the list.
< ISERR_SUCCESS	Indicates that the function was unable to append the array to the list.

Comments

The array and list types must match (that is, both be string or both be numeric) or the function will fail. If necessary, convert the data appropriately by calling ListConvertNumToStr or ListConvertStrToNum before calling ListAppendToArray.