Command
	set

Purpose
	Sets value of a variable.

Aliases
	set

Syntax
	set $<variable_name> = <value>

Options
	None

Arguments
	<variable_name>	The name of the variable whose value is to be assigned.

	<value>	The value that is to be assigned to the variable. <value> can be a
		constant, variable, an inline command, a function call, an expression
		or any combination of these.

Stream Input	
	Ignored.

Stream Output
	None.

Stream Error
	Any errors are listed here.

Description
	This command assigns the value <value> to the variable whose name is <variable_name>.

	If inline commands are used, either by themselves or as part of expression,
	its stream output is used.

	When the type of variable does not match the type of value, the value is automatically
	converted toward higher operability. To see details of automatic type conversions, see
	help page on conversion.
		
Restrictions
	If the type of the variable is of lower operability than the type of the value or expression,
	an error is produced. In that case, explicit type conversion may be used. See help page on
	conversion for more details.

	Stream redirection is preferred over inline commands for variable assignment. For example,
	for a str variable s, instead of 

	set $s={ lex "1" $text }

	the following is preferred.

	lex "1" $text > $s

Valid Examples
	var int i
	set $i=5
	Will set the value of variable $i to 5.

	var str s
	set $s="Hello World"
	echo $s
	Will produce the output
	
	Hello World


Invalid Examples
	var int i
	...
	var str s
	set $s=$i+5
	Will produce an error. The type of expression $i+5 is int. The type of $s is str.
	Type str has lower operability than type int. Automatic conversion from int to str
	is not possible.
	
See Also
echo
stream
conversion
make
constant