Copyright Digital Equipment Corp. All rights reserved.

IF_and_IFDEFINED

 cDEC$ IF
 cDEC$ IF DEFINED

 The IF and IF DEFINED directives specify a conditional compilation
 construct.  IF tests whether a logical expression is .TRUE.  or
 .FALSE..  IF DEFINED tests whether a symbol has been defined.

 The directive-initiated construct takes the following form:

 cDEC$ IF (expr) [or cDEC$ IF DEFINED (name)]
    block
 [cDEC$ ELSE IF (expr)
    block]...
 [cDEC$ ELSE 
    block]
 cDEC$ ENDIF 

   c        Is one of the following: C (or c), !, or *.

   exp      A logical expression that evaluates to .TRUE. 
            or .FALSE.. 

   name     Is the name of a symbol to be tested for definition.

   block    Are executable statements that are compiled (or not)
            depending on the value of logical expressions in 
            the IF directive construct. 

 The IF and IF DEFINED directive constructs end with an ENDIF
 directive and can contain one or more ELSEIF directives and at most
 one ELSE directive.  If the logical condition within a directive
 evaluates to .TRUE.  at compilation, and all preceding conditions
 in the IF construct evaluate to .FALSE., then the statements
 contained in the directive block are compiled.

 A "name" can be defined with a DEFINE directive, and can optionally
 be assigned an integer value.  If the symbol has been defined, with
 or without being assigned a value, IF DEFINED (name) evaluates to
 .TRUE.; otherwise, it evaluates to .FALSE..

 If the logical condition in the IF or IF DEFINED directive is
 .TRUE., statements within the IF or IF DEFINED block are compiled.
 If the condition is .FALSE., control transfers to the next ELSEIF
 or ELSE directive, if any.

 If the logical expression in an ELSEIF directive is .TRUE.,
 statements within the ELSEIF block are compiled.  If the expression
 is .FALSE., control transfers to the next ELSEIF or ELSE directive,
 if any.

 If control reaches an ELSE directive because all previous logical
 conditions in the IF construct evaluated to .FALSE., the statements
 in an ELSE block are compiled unconditionally.

 You can use any Fortran logical or relational operator or symbol in
 the logical expression of the directive.  The logical expression
 can be as complex as you like, but the whole directive must fit on
 one line.

 For compatibility, each directive in the construct can begin with
 the prefix !MS$ instead of cDEC$.

 Examples:

 Consider the following:

 ! When the following code is compiled and run, 
 !  the output depends on whether one of the expressions 
 !  tests .TRUE.; or all test .FALSE.

 !DEC$ DEFINE flag=3
 !DEC$ IF (flag .LT. 2)
    WRITE (*,*) "This is compiled if flag less than 2."
 !DEC$ ELSEIF (flag >= 8)
    WRITE (*,*) "Or this compiled if flag greater than &
                 or equal to 8."
 !DEC$ ELSE
    WRITE (*,*) "Or this compiled if all preceding &
                 conditions .FALSE."
 !DEC$ ENDIF
 END