Single-statement conditionals may omit the curly braces.
"variable" and every "value" can be expressions as complex as wanted, as long as their end result is always of the same datatype. NO silent conversion is done, so the following will generate an error:
Putting a break in each case isn't mandatory. If no break is placed on the path taken, once the last line of the case is reached, execution simply goes on, and will execute (will "fall-through") the content of the next case/default.
The default value of a switch structure's parameter is true. This means that if switch has no parameter, it is the same as submitting switch (true) [...]. Each case is then evaluated as a boolean expression, like a string of if-then statements.
The default doesn't need to be the last statement (which is useful when using the aforementioned fall-through mechanic). If the default is placed early (e.g. as the first statement), it will NOT have priority over the other cases; if the value submitted to the switch matches one of the cases, execution will jump to it, even if placed after the default.
Putting a break at the end of the switch is generally considered good practice, but achieves nothing.
try / finally
Block1 is executed as normal, and then block2 is executed regardless of whether block1 finished normally, generated an error, or encountered a 'return', 'break', or 'continue' statement.
Single-statement static declarations may omit the curly braces.
Keep in mind that when using imports, a static call will only apply to the script that imports it.
- If foo.ash has a static variable, but bar.ash imports foo.ash, KoLmafia will keep separate values for both foo.ash and bar.ash.
- If bar.ash is changed, its static variable is reset, but not foo.ash's.
- If foo.ash is changed, both scripts' variables are reset.
This is similar to the do...while loop, but only ends the loop when the
boolean expression evaluates to
Above is the general case. You don't need to specify whether it's going up or down - although doing so by using upto or downto does allow a runtime check to make sure you didn't screw up.
If you don't specify "c", it defaults to incrementing/decrementing by 1. The first iteration is at a and the last is at b (that is to say, it goes from a to b, inclusive).
a, b and c are automatically converted to integers. You can't use floats here.
Assigns each key in the supplied map or slice to "
key" and iterates through the map. Due to how maps are handled,
foreach is guaranteed to iterate through the map in sorted order.
So the output is
15 test true
For a multidimensional map, instead of nesting
foreach statements two iterators can be used inline.
This is identical to:
You can also directly specify the value stored in the map by specifying one more variable than the number of keys in the map:
See the page for Data Structures for more information on aggregates.
Continuation & Exiting
Like many languages with looping structures, ASH supports the break and continue statements. All looping structures (for, while, repeat until, and foreach) support these statements.
Breaks out of the smallest enclosing loop. In a switch statement, breaks out of the switch statement. Execution resumes at the first statement after the end of the loop/switch statement.
Continues on to the next iteration of the loop (skipping any statements in this iteration that occur after the continue statement). In a switch statement, continue is allowed if the switch is inside a loop, and acts as any other continue.
Exits the function and returns the value following the return statement, if specified. Note that the value's datatype must match that of the function itself (void functions can only use return by itself). If in a switch statement, don't place a break after a return!
Exits the script. Using return when in main() achieves the same effect. Note that while this will end the current script, it will not stop automation.