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.
All parameters may contain symbolic references; these are resolved before the function is applied. See Examples below.
- String to search for replacements.
- Substring to replace in string.
- Replacement string for each occurrence of find.
Here are some usage examples for this function:
- <$strsubst(C:\Program Files\InstallMate\Bin\Tin.exe, .exe, .ini)>
- Returns C:\Program Files\InstallMate\Bin\Tin.ini from the literal path.
- <$strsubst(<INSTALLDIR>\Bin\Tin.exe, \, |)>
- Returns C:|Program Files|InstallMate|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.