"execute" Statements are functions which you can call within the "execute" section of a RoBOTL program. Statements are used to create new robots, place worlds, etc.
Statements can be used singularly, or in groups. The "execute" Statements are:
Assignment statements set a given variable equal to some expression. This statement can only modify the defined global variables.
The Do-While statement is much like the While statement, except the loop is executed first, and then the expression is checked.
The If-Else conditional statement is one of the basics in modern programming. If the given Expression is true (defined as a non-zero value), then the first set of Statements are executed. If the expression is false (a value of zero), the statements are ignored.
If the optional '"Else" Statements' section is added, the statements following the "else" is executed if the first expression is false. This might sound a little confusing, but this example should help:
define {
DefineGlobalInteger true = 1;
DefineGlobalInteger false = 0;
}
execute {
if ( true ) // Always going to execute the statements.
[statements]
if ( false ) // Never going to execute the statements.
[statements 1]
else [statements 2] /* Since false is never true,
statements 2 will be executed. */
}
Usage: Iterate Expression "times" Statements
The iterate statement allows you to have some set of statements repeated for a specific number of times, specified by Expression. For instance:
This statement will add 4 to the initial value in variable. (Note: This is a random example, and the overall effect can be achieved using a more efficient statement such as 'variable = variable + 4;'.)
Usage: New Robot Type Robot Name [ "at" Coordinates ] ";"
The New statement is used to create a new robot in the world of RoBOTL. The robot will be of type Robot Type, and be named Robot Name, using the above statement layout. By default, robots are placed at the bottom-left corner of the map (coordinates (0, 0)), but with the optional '"at" Coordinates' after the Robot Name, you can place the robot anywhere on the map.
The place statement is used to lay a world (as defined with the WorldEntity "define" statement) onto the RoBOTL map. By default, the world is placed with it's lower left corner at (0, 0). You can change this by using the optional '"at" Coordinates'.
Note: If there is no conflict when placing parts of the world (overlapping objects in a square), the Rules of Placement are followed.
The Tell Statement is used to give instructions to a specific robot, identified as Robot Name above. You can not tell a robot which is turned off to do anything.
The Remove statement will remove the named robot from the map.
If you wish to turn all of the robots on the map off, use this statement.
If you wish to turn all of the robots on the map on, you can use this statement.
Note: Robots who are damaged (by hitting an object) and are turned off can NOT be re-activated by the turnon statement.
Usage: While Expression Statements
This statement will execute the given statements as long as the expression is true. Note that the expression is checked before the first time through the while loop, so if the expression is initially false, the loop is ignored.