@if Statement (Windows Scripting - JScript)

Article
07/17/2015

Conditionally executes a group of statements, depending on the value of an expression.

Syntax

@if (
   condition1
)
   text1
[@elif (
   condition2
)
   text2]
[@else
   text3]
@end

Arguments

condition1, condition2
Optional. An expression that can be coerced into a Boolean expression.
text1
Optional. Text to be parsed if condition1 is true.
text2
Optional. Text to be parsed if condition1 is false and condition2 is true.
text3
Optional. Text to be parsed if both condition1 and condition2 are false.

Remarks

When you write an @if statement, you do not have to place each clause on a separate line. You can use multiple @elif clauses. However, all @elif clauses must come before an @else clause.

The @if statement is typically used to determine which text among several options should be used for text output.

It is not common to use conditional compilation variables in scripts written for ASP or ASP.NET pages or command-line programs. This is because the capabilities of the compilers can be determined by using other methods.

When you write a script for a Web page, always add conditional compilation code in comments. This enables hosts that do not support conditional compilation to ignore it.

The following example illustrates the use of the **@if...@elif…@else...@end** statement.

/*@cc_on @*/
/*@
    document.write("JScript version: " + @_jscript_version + ".");
    document.write("<br />");
    @if (@_win32)
        document.write("Running on a 32-bit version of Windows.");
    @elif (@_win16)
        document.write("Running on a 16-bit version of Windows.");
    @else
        document.write("Running on a different operating system.");
    @end
@*/

Requirements

Version 3

Change History

Date	History	Reason
March 2009	Modified remarks and example.	Information enhancement.

March 2009

Modified remarks and example.

Information enhancement.