<HTML><HEAD><TITLE>Built-In Commands - if manual page</TITLE></HEAD><BODY> <H3><A NAME="M2">NAME</A></H3> if - Execute scripts conditionally <H3><A NAME="M3">SYNOPSIS</A></H3> <B>if </B><I>expr1 </I>?<B>then</B>? <I>body1 </I><B>elseif </B><I>expr2 </I>?<B>then</B>? <I>body2</I> <B>elseif</B> ... ?<B>else</B>? ?<I>bodyN</I>?<BR> <H3><A NAME="M4">DESCRIPTION</A></H3> The <I>if</I> command evaluates <I>expr1</I> as an expression (in the same way that <B><A HREF="../TkCmd/expr.htm">expr</A></B> evaluates its argument). The value of the expression must be a boolean (a numeric value, where 0 is false and anything is true, or a string value such as <B>true</B> or <B>yes</B> for true and <B>false</B> or <B>no</B> for false); if it is true then <I>body1</I> is executed by passing it to the Tcl interpreter. Otherwise <I>expr2</I> is evaluated as an expression and if it is true then <B>body2</B> is executed, and so on. If none of the expressions evaluates to true then <I>bodyN</I> is executed. The <B>then</B> and <B>else</B> arguments are optional ``noise words'' to make the command easier to read. There may be any number of <B>elseif</B> clauses, including zero. <I>BodyN</I> may also be omitted as long as <B>else</B> is omitted too. The return value from the command is the result of the body script that was executed, or an empty string if none of the expressions was non-zero and there was no <I>bodyN</I>. <H3><A NAME="M5">SEE ALSO</A></H3> <B><A HREF="../TkCmd/expr.htm">expr</A></B>, <B><A HREF="../TkCmd/for.htm">for</A></B>, <B><A HREF="../TkCmd/foreach.htm">foreach</A></B> <H3><A NAME="M6">KEYWORDS</A></H3> <A href="../Keywords/B.htm#boolean">boolean</A>, <A href="../Keywords/C.htm#conditional">conditional</A>, <A href="../Keywords/E.htm#else">else</A>, <A href="../Keywords/F.htm#false">false</A>, <A href="../Keywords/I.htm#if">if</A>, <A href="../Keywords/T.htm#true">true</A> <HR><PRE> <A HREF="../copyright.htm">Copyright</A> © 1993 The Regents of the University of California. <A HREF="../copyright.htm">Copyright</A> © 1994-1996 Sun Microsystems, Inc. <A HREF="../copyright.htm">Copyright</A> © 1995-1997 Roger E. Critchlow Jr.</PRE> </BODY></HTML>