Difference between revisions of "Control Structures"
(→else) |
m (→Subs) |
||
| Line 51: | Line 51: | ||
{{Note|In EasyUO 1.4 it is not possible to nest if commands and use else. The method around this limitation is to use an additional if to test for the opposite condition. In EasyUO 1.5, if and else can be safely nested however.}} | {{Note|In EasyUO 1.4 it is not possible to nest if commands and use else. The method around this limitation is to use an additional if to test for the opposite condition. In EasyUO 1.5, if and else can be safely nested however.}} | ||
| + | |||
==for== | ==for== | ||
| Line 63: | Line 64: | ||
The loop starts by assigning the ''from_value'' to the variable, runs the statement(s) inside the code block. The variable is then incremented or decremented as required for the variable to be one integer value closer to the ''to_value''. The statement inside the code block is executed after each and every iteration of the variable. | The loop starts by assigning the ''from_value'' to the variable, runs the statement(s) inside the code block. The variable is then incremented or decremented as required for the variable to be one integer value closer to the ''to_value''. The statement inside the code block is executed after each and every iteration of the variable. | ||
| − | + | ||
| + | {{Note|In EasyUO 1.4, brackets are required to be used with a for statement, even if the code block consists only of a single statement. As of EasyUO 1.5, if the code to be executed with a for statement is only a single statement, the braces are optional.}} | ||
| + | |||
==Subs== | ==Subs== | ||
| Line 77: | Line 80: | ||
If parameters were added to the calling gosub command they will be present in the variables %1, %2, and so on. The variable %0 holds the number of parameters passed. As all variables are in the global scope, the %0, %1, %2.. will be overwritten if you call another sub from inside a sub. | If parameters were added to the calling gosub command they will be present in the variables %1, %2, and so on. The variable %0 holds the number of parameters passed. As all variables are in the global scope, the %0, %1, %2.. will be overwritten if you call another sub from inside a sub. | ||
| − | |||
| − | '' | + | {{Note| |
| − | This has been fixed in EasyUO 1.5 however. | + | *Do not GOTO out of a sub, always use return! EasyUO will probably not crash but it is '''very''' bad programming style. |
| + | *Inline comments do not work with the sub command in EasyUO 1.4. | ||
| + | This has been fixed in EasyUO 1.5 however.}} | ||
| + | |||
===gosub=== | ===gosub=== | ||
Revision as of 14:06, 28 August 2005
Contents
if
The “if” construct, one of the most important features of many languages including EasyUO, allows for conditional execution of code fragments. The basic syntax of the command is:
If ( expression )
{ statement }
As described in the section about Expressions, expression is evaluated as a Boolean value. If it evaluates to #true the statement will be executed.
The following code fragment will display a message box with the phrase "a is greater than b" if the value in the variable %a is greater than the value in the variable %b:
set %a 1 set %b 0 if %a > %b display ok a is greater than b halt
Often you would want to have more than one statement executed conditionally. Of course, there is no need to wrap each statement in an “if” clause. Instead, you can group several statements into a code block by using braces. For example, this code would display a message box with the phrase "a is greater than b" if the vaule in the variable %a is greater than the value in the variable %b, and would then assign the value of %a into the variable %b:
set %a 10
set %b 2
if %a > %b
{
display ok a is greater than b
set %b %a
}
halt
“if” statements can be nested indefinitely within other “if” statements, which provides you with complete flexibility for conditional execution of the various parts of your script.
else
Often you would want to execute a statement or code block if a certain condition is met, and a different statement or code block if the condition is not met. This is the purpose of the else statement. Else extends an “if” statement to execute a statement or code block only in the instance that the expression of the previous if statement evaluates to #false. For example, the following code would display a is bigger than b if %a is bigger than %b, and a is NOT bigger than b otherwise:
set %a 10
set %b 20
if %a > %b
{
display ok a is greater than b
}
else
{
display ok a is less than b
}
halt
| Note: | In EasyUO 1.4 it is not possible to nest if commands and use else. The method around this limitation is to use an additional if to test for the opposite condition. In EasyUO 1.5, if and else can be safely nested however. |
for
The “for” loop is a loop that iterates a variable either up or down upon execution of the code block that it controls. The code block is executed with each iteration until the second value is reached.
for variable from_value to_value
{
statement
}
The loop starts by assigning the from_value to the variable, runs the statement(s) inside the code block. The variable is then incremented or decremented as required for the variable to be one integer value closer to the to_value. The statement inside the code block is executed after each and every iteration of the variable.
| Note: | In EasyUO 1.4, brackets are required to be used with a for statement, even if the code block consists only of a single statement. As of EasyUO 1.5, if the code to be executed with a for statement is only a single statement, the braces are optional. |
Subs
The term sub is short for subroutine. Subs are an important feature of the EasyUO script, that will make your scripts more logically structured, easier to read, and will make you have to write less code.
A basic sub definition starts with a sub statement followed by the subs name (sub names are case insensitive), a number of script lines and ends with a return statement.
sub testSub ... return
If parameters were added to the calling gosub command they will be present in the variables %1, %2, and so on. The variable %0 holds the number of parameters passed. As all variables are in the global scope, the %0, %1, %2.. will be overwritten if you call another sub from inside a sub.
| Note: |
This has been fixed in EasyUO 1.5 however. |
gosub
The gosub command transfers the execution to a sub with the name given by the parameter.
gosub sub_name
Parameters can be added after the sub name. They will be transfered in the variables %1, %2, and so on. The variable %0 holds the number of parameters passed.
return
The return command transfers the execution back to where the sub was called using gosub.
return
goto
The goto command moves the execution to another part of the script. The destination point is given by a label.
goto label_name
Labels
A label specifies a point in the code where you can goto to.
label_name:
