INCLAN: Variable substitutions

From CYANA Wiki
Jump to navigation Jump to search

There are several ways to insert the value of a variable or the result value of an expression into the command line:

Basic substitutions

Substitutions of the form $variable or %variable insert the complete value of the variable (without trailing blanks) into the command line. Substitutions with “$” differ from those with “%” only if the value of the variable starts and ends with single quotes, i.e. if it is a FORTRAN-77 character constant: with “%” the delimiting single quotes are retained in the substitution, with “$” they are removed. A variable name that is immediately followed by a letter, digit, or underscore character must be enclosed in curly braces: “{$variable}”.

x:=4.6; y:=2.0; sum=x+y; t:=a sum        # set variables
print "This is $t: $x + $y = $sum"       # substitute values
This is a sum: 4.6 + 2.0 = 6.60000

s:=’$t’                           # create a Fortran string from a normal variable
print "\$s = $s; \%s = %s"        # with and without single quotes
$s = a sum, %s = ’a sum’ 
 
print "{$t}mer"
a summer

All substitutions in the command line proceed from right to left. This allows, for example, composition of a variable name from the values of other variables before it is used in a substitution:

command list_param                # user-defined command list_param
  do i 1 nparam
    print "Parameter $i: $p$i"    # $p$i inserts the value of the i-th command line	
                                  # parameter (p1, p2,…).
  end do
end
list_param 17 second last         # call list_param
Parameter 1: 17
Parameter 2: second
Parameter 3: last

Fortran format

Substitutions of the form $variable(format) or %variable(format) are used to format integer or real values of variables according to a FORTRAN-77 format. A format that contains the letter “I” or “i” applies to integer numbers, all other formats to real numbers.

 x:=4.6; y:=2.0; sum=x+y
 print "$x + $y = $sum(E12.3)"
 4.6 + 2.0 =    0.660E+01

Substring

Substitutions of the form $variable(n:m) or %variable(n:m), where n and m are positive integer expressions, are used to substitute with the substring between character positions n and m of the value of a variable. Substring expressions can also appear on the left hand side of assignment statements.

t:=a sum
print "another $t(3:5)"
another sum
t(3:):=program		 # Assignment to a substring
print "$t"
a program

List element

If the value of a variable is a comma-separated list, “ $variable(n)” or “%variable(n)”, where n is a positive integer expression, substitute with the n-th element of this list.

s:=17,28,,56,"This is the end"
do i 1 length(’s’)		 # Length returns the number of elements
  print "Element $i: $s(i)"
end do
Element 1: 17
Element 2: 28
Element 3:
Element 4: 56
Element 5: This is the end

Function call

$function” or “%function” substitute with the result value of a function without parameters, “$function(parameters)” or “%function(parameters)” substitute with the result value of a function with parameters. If there are several parameters, they are separated by commas.

x=2.5; print "log(x)= $log(x)"
log(x) = 0.916291

Expression

“${expression}” or “%{expression}” substitute with the result value of an expression. x=2.5; y=10.0; print "x/y = ${x/y}" x/y = 0.25