$strsubst function

$strsubst(string,find,subst)

The $strsubst function replaces all occurrences of find in string by subst. If string is empty, the result is an empty string; if find is empty, the result is a copy of string; if subst is empty, all occurrences of find are removed from string. The search for find is case-insensitive.

Windows Installer does not support symbolic functions; if you use this function during an MSI build, you will get diagnostic message BLD:U0010 and the result is undefined.

Parameters

All parameters may contain symbolic references; these are resolved before the function is applied. See Examples below.

string

String to search for replacements.

find

Substring to replace in string.

subst

Replacement string for each occurrence of find.

Examples

Here are some usage examples for this function:

<$strsubst(C:\Program Files\Tarma ExpertInstall\Bin\Tin.exe, .exe, .ini)>

Returns C:\Program Files\Tarma ExpertInstall\Bin\Tin.ini from the literal path.

<$strsubst(<INSTALLDIR>\Bin\Tin.exe, \, |)>

Returns C:|Program Files|Tarma ExpertInstall|Bin|Tin.exe from the symbolic path, assuming that <INSTALLDIR> resolves to the appropriate folder path.

<$strsubst(<#Tin_alias>, in, out)>

Returns C:\Program Files\Tarma outstaller 3\Bout\Tout.exe from the file alias path, assuming that Tin_alias is the file alias for the Tin.exe executable.

<$strsubst(<#Tin_alias>, ` `,)>

Returns C:\ProgramFiles\TarmaInstaller3\Bin\Tin.ini from the file alias path, assuming that Tin_alias is the file alias for the Tin.exe executable. Note the use of `backquotes` to specify the space character, and the empty third parameter.