= (assign) Configuration File Directive

The = directive assigns values to local variables. The first appearance of a local variable in a configuration file must be on the left of the equal sign in an assignment directive.

This diagram shows the syntax of the assign directive:

The assignment directive has the following parameters:

local_variable
This parameter must be a local variable. You cannot assign values to environment variables, option groups, or source groups.

expression
This parameter determines whether the variable has a string value or a numeric value. It can be a simple data element or it can contain a combination of data elements and operators.

If the expression is a string and it contains a number, the number is converted to a string when the expression is evaluated. Similarly a string that appears in an arithmetic expression is converted, if possible, to a number. All expressions are valid if they can be evaluated. The following table shows how some mixed-type expressions are evaluated:

Expression Type Value
23 "AB" string "23ab"
"23" + 1 arithmetic 24

string_list
You can also assign a list of comma separated strings to a local variable. For example the following directive defines the variable myfiles to represent three source files:

myfiles = "a.cpp", "b.cpp", "c.cpp"



Configuration Files
How Configuration Files Are Processed


Change a Build Setup
Build


Configuration File Directives
Build Options