String Constant Operator (@)

InstallShield 2016 » InstallScript Language Reference

String entries enable you to access text strings for a given language from within your InstallScript code. That is, to keep the InstallScript code for your installation completely separate from any language-specific strings that you may want to display during the installation, you can refer to each string by using its string identifier. When you use string identifiers in your InstallScript, you must precede them with the at sign (@).

The String Editor view shows the collection of language-independent identifiers and corresponding language-specific values for your project. To learn more, see Localizing the End-User Interface.

When you build a project that includes an InstallScript file (.rul) and the InstallScript code contains one or more references to string entries that use the @ operator, InstallShield validates the string entries at build time. If a string identifier in the project’s InstallScript file is not defined in String Editor view, InstallShield displays build warning -7174.

Note • The @ operator is case-insensitive when it comes to string identifiers. Therefore, when you use a string identifier in your script, you do not necessarily need to match the case of the string identifier that is specified in the String Editor view. However, mixing case may prevent InstallShield from matching the string entries in the script to the corresponding string entries in the String Editor view at build time. Therefore, it is recommended that you use uppercase for all instances of string identifiers.

Tip • As an alternative to the @ operator, you can use the LoadStringFromStringTable function if you want to provide your own missing string error handling.

See Also

LoadStringFromStringTable

Using String Entries in InstallShield

Open topic with navigation