Programmer Guide/Command Reference/COND: Difference between revisions
From STX Wiki
Jump to navigationJump to search
No edit summary |
No edit summary |
||
| Line 3: | Line 3: | ||
==Usage== | ==Usage== | ||
<code>[ <var>target</var> := ] COND [[Programmer_Guide/Introduction#Conditional_Expressions|condition]] ? <var>expr1</var> : <var>expr2</var></code> | <code>[ <var>target</var> := ] COND [[Programmer_Guide/Introduction#Conditional_Expressions|condition]] ? <var>expr1</var> : <var>expr2</var></code> | ||
;<var>target</ | ;<var>target</var>: is a normal assignment target, usually the name of an {{STX}} variable, e.g. <code>#var</code>. If no target is specified, a conditional execution is performed. | ||
;<var>condition</var>: is a [[Programmer_Guide/Introduction#Conditional_Expressions|conditional expression]] like used with the <code>[[Programmer_Guide/Command_Reference|IF]]</code> statement and the miscellaneous conditional [[Programmer_Guide/Introduction#Control_Commands|control commands]]. | ;<var>condition</var>: is a [[Programmer_Guide/Introduction#Conditional_Expressions|conditional expression]] like used with the <code>[[Programmer_Guide/Command_Reference|IF]]</code> statement and the miscellaneous conditional [[Programmer_Guide/Introduction#Control_Commands|control commands]]. | ||
::*Note that with conditional {{STX}} expressions there must always be intervening whitespaces between operators and their arguments (unless the argument is quoted). So, both <code>$#a == 7</code> and <code>'$#a'=='7'</code> are valid expression, whereas <code>$#a==7</code> is not. | ::*Note that with conditional {{STX}} expressions there must always be intervening whitespaces between operators and their arguments (unless the argument is quoted). So, both <code>$#a == 7</code> and <code>'$#a'=='7'</code> are valid expression, whereas <code>$#a==7</code> is not. | ||
;< | ;<var>expr1</var> and <var>expr2</var>: Both <code>expr1</code> and <code>expr2</code> may be any expressions that may be normally used in an assignment, with the only exception all control commands. If, at runtime, the conditional expression <var>condition</var> evaluates to truth, the value determined by the first expression, <var>expr1</var>, will be assigned to <code>''target''</code>. If <code>condition</code> evaluates to falsehood, it will be the second expression, <code>''expr2''</code>, that gets assigned to target. | ||
You may use any {{STX}} [[Programmer_Guide/Introduction#Conditional_Expressions|conditional expression]] you like for <code>''condition''</code> with the exception of conditions themselves containing the <code>COND</code> keyword. Equally, there is no restriction on <code>''expr1''</code> and <code>''expr2''</code>, except that they must not be built up from <code>COND</code> expressions themselves, either. It is even (and also) possible to use inline function calls (<code>$(...)</code>), nesting them as deeply as one feels inclined to. | You may use any {{STX}} [[Programmer_Guide/Introduction#Conditional_Expressions|conditional expression]] you like for <code>''condition''</code> with the exception of conditions themselves containing the <code>COND</code> keyword. Equally, there is no restriction on <code>''expr1''</code> and <code>''expr2''</code>, except that they must not be built up from <code>COND</code> expressions themselves, either. It is even (and also) possible to use inline function calls (<code>$(...)</code>), nesting them as deeply as one feels inclined to. | ||
Revision as of 15:39, 27 April 2011
The COND command performs a conditional assignment.
Usage
[ target := ] COND condition ? expr1 : expr2
- target
- is a normal assignment target, usually the name of an STx variable, e.g.
#var. If no target is specified, a conditional execution is performed. - condition
- is a conditional expression like used with the
IFstatement and the miscellaneous conditional control commands.- Note that with conditional STx expressions there must always be intervening whitespaces between operators and their arguments (unless the argument is quoted). So, both
$#a == 7and'$#a'=='7'are valid expression, whereas$#a==7is not.
- Note that with conditional STx expressions there must always be intervening whitespaces between operators and their arguments (unless the argument is quoted). So, both
- expr1 and expr2
- Both
expr1andexpr2may be any expressions that may be normally used in an assignment, with the only exception all control commands. If, at runtime, the conditional expression condition evaluates to truth, the value determined by the first expression, expr1, will be assigned totarget. Ifconditionevaluates to falsehood, it will be the second expression,expr2, that gets assigned to target.
You may use any STx conditional expression you like for condition with the exception of conditions themselves containing the COND keyword. Equally, there is no restriction on expr1 and expr2, except that they must not be built up from COND expressions themselves, either. It is even (and also) possible to use inline function calls ($(...)), nesting them as deeply as one feels inclined to.
Notes
- The
CONDcommand is processed by the loader, and is therefore not available in the command line interface. - The
CONDcommand may not contain a nestedCONDcommand.
Examples
#min := cond $#a < $#b ? $#a : $#b // calculate minimum of #a and #b #abs := cond $#a < 0 ? num -$#a : $#a // calculate absolute value of #a #abs := cond $#a < 0 ? eval $#a*(-1) : $#a // an alternative to the above #absdiff := cond $#a > $#b ? eval $#a-$#b : eval $#b-$#a // absolute difference #len := cond $(length $#a) > 0 ? length $#a : length $#b // length of #a or, if empty, of #b
See the file conditional_assignment.sts for further working examples.
