Size: 5673
Comment:
|
Size: 6190
Comment:
|
Deletions are marked like this. | Additions are marked like this. |
Line 31: | Line 31: |
Line 32: | Line 35: |
'''Usage:''' | '''Usage:''' Computes and returns an absolute value for the number specified by the parameter val. '''Example:''' echo abs(-123456) echo abs(123456) '''Result:''' 123456 123456 . = acos = '''Usage:''' Computes and returns the arc cosine of the number specified in the parameter val, in radians. '''Example:''' . '''Result:''' . = asin = '''Usage:''' Computes and returns the arc sine for the number specified in the parameter val, in radians. '''Example:''' . '''Result:''' . = atan = '''Usage:''' Computes and returns the value, in radians, of the angle whose tangent is specified in the parameter val. '''Example:''' . '''Result:''' . = atan2 = '''Usage:''' |
Line 37: | Line 98: |
. '''Result:''' . = acos = '''Usage:''' Returns a string comprising the characters represented by the Unicode character codes in the parameters. '''Example:''' . '''Result:''' . = asin = '''Usage:''' Returns a string comprising the characters represented by the Unicode character codes in the parameters. '''Example:''' . '''Result:''' . = atan = '''Usage:''' Returns a string comprising the characters represented by the Unicode character codes in the parameters. '''Example:''' . '''Result:''' . = atan2 = '''Usage:''' Returns a string comprising the characters represented by the Unicode character codes in the parameters. '''Example:''' . '''Result:''' |
. '''Result:''' |
Line 87: | Line 106: |
'''Usage:''' Returns a string comprising the characters represented by the Unicode character codes in the parameters. '''Example:''' . '''Result:''' . |
'''Usage:''' Returns the ceiling of the specified number or expression. Basically this means return the number rounded up to next whole number '''Example:''' echo ceil(4.1) '''Result:''' 5 |
Line 98: | Line 121: |
'''Usage:''' Returns a string comprising the characters represented by the Unicode character codes in the parameters. '''Example:''' . '''Result:''' |
'''Usage:''' Computes and returns the cosine of the specified angle in radians. '''Example:''' . '''Result:''' |
Line 109: | Line 134: |
'''Usage:''' Returns a string comprising the characters represented by the Unicode character codes in the parameters. '''Example:''' . '''Result:''' |
'''Usage:''' Returns the value of the base of the natural logarithm (e), to the power of the exponent specified in the parameter x. '''Example:''' . '''Result:''' |
Line 120: | Line 147: |
'''Usage:''' Returns a string comprising the characters represented by the Unicode character codes in the parameters. '''Example:''' . '''Result:''' |
'''Usage:''' Returns the floor of the number or expression specified in the paraenthesis... Floor is the whole number part, without the decimals. Basically means chop the decimal portion of the number off. '''Example: echo floor(1234.56)''' . '''Result: 1234''' |
Line 131: | Line 160: |
'''Usage:''' Returns a string comprising the characters represented by the Unicode character codes in the parameters. '''Example:''' . '''Result:''' |
'''Usage:''' Returns the natural logarithm of the parameter val. '''Example:''' . '''Result:''' |
Line 142: | Line 173: |
'''Usage:''' Returns a string comprising the characters represented by the Unicode character codes in the parameters. '''Example:''' . '''Result:''' |
'''Usage:''' Evaluates val1 and val2 (or more values) and returns the largest value. '''Example:''' echo max( city.troop.scouter, 100k ) '''Result:''' If city.troop.scouter (the current number of scouts in the city) < 100k, then max( city.troop.scouter, 100k ) will return the number of scouts in city. If city.troop.scouter >= 100k then it will return 100000 |
Line 153: | Line 188: |
'''Usage:''' Returns a string comprising the characters represented by the Unicode character codes in the parameters. '''Example:''' . '''Result:''' |
'''Usage:''' Evaluates val1 and val2 (or more values) and returns the smallest value. '''Example:''' echo min(city.resource.food.amount,99999999) . '''Result:''' this will return whichever is smaller, 99,999,999 or the current amount of food in the city |
Line 164: | Line 205: |
'''Usage:''' Returns a string comprising the characters represented by the Unicode character codes in the parameters. '''Example:''' . '''Result:''' |
'''Usage:''' Computes and returns base to the power of pow. '''Example:''' . '''Result:''' |
Line 175: | Line 218: |
'''Usage:''' Returns a string comprising the characters represented by the Unicode character codes in the parameters. '''Example:''' . '''Result:''' |
'''Usage:''' Returns a pseudo-random number n, where 0 <= n < 1. '''Example:''' echo round(random*10) . '''Result:''' a random number between 0 and 9 |
Line 186: | Line 235: |
'''Usage:''' Returns a string comprising the characters represented by the Unicode character codes in the parameters. '''Example:''' . '''Result:''' . |
'''Usage:''' Rounds the value of the parameter val up or down to the nearest integer and returns the value. Optional argument to specify precision (or number of decimal places). '''Example:''' echo round(6.66666666666666666666) echo round(6.66666666666666666666,1) echo round(6.66666666666666666666,2) echo round(6.66666666666666666666,3) . '''Result:''' 7 6.7 6.67 6.667 |
Line 197: | Line 256: |
'''Usage:''' Returns a string comprising the characters represented by the Unicode character codes in the parameters. '''Example:''' . '''Result:''' |
'''Usage:''' Computes and returns the sine of the specified angle in radians. '''Example:''' . '''Result:''' |
Line 208: | Line 269: |
'''Usage:''' Returns a string comprising the characters represented by the Unicode character codes in the parameters. '''Example:''' . '''Result:''' |
'''Usage:''' Computes and returns the square root of the specified number. '''Example:''' . '''Result:''' |
Line 219: | Line 282: |
'''Usage:''' Returns a string comprising the characters represented by the Unicode character codes in the parameters. '''Example:''' . '''Result:''' |
'''Usage:''' Computes and returns the tangent of the specified angle. '''Example:''' . '''Result:''' |
Line 230: | Line 295: |
ScriptBasicSyntax | ScriptSyntax |
The following functions can be used to perform arithmetic on objects and variables.
These should be written in the following formats:
variable.method(arguments), example - ...
object.method(arguments), example - ...
Click each method name in the table below for more details of it, with examples.
Methods
Method |
Type |
Description |
|
|
int |
Computes and returns an absolute value for the number specified by the parameter val. |
|||
int |
Computes and returns the arc cosine of the number specified in the parameter val, in radians. |
|||
int |
Computes and returns the arc sine for the number specified in the parameter val, in radians. |
|||
int |
Computes and returns the value, in radians, of the angle whose tangent is specified in the parameter val. |
|||
int |
Computes and returns the angle of the point y/x in radians, when measured counterclockwise from a circle's x axis (where 0,0 represents the center of the circle). |
|||
int |
Returns the ceiling of the specified number or expression. |
|||
int |
Computes and returns the cosine of the specified angle in radians. |
|||
int |
Returns the value of the base of the natural logarithm (e), to the power of the exponent specified in the parameter x. |
|||
int |
Returns the floor of the number or expression specified in the parameter val. |
|||
int |
Returns the natural logarithm of the parameter val. |
|||
int |
Evaluates val1 and val2 (or more values) and returns the largest value. |
|||
int |
Evaluates val1 and val2 (or more values) and returns the smallest value. |
|||
int |
Computes and returns base to the power of pow. |
|||
int |
Returns a pseudo-random number n, where 0 <= n < 1. |
|||
int |
Rounds the value of the parameter val up or down to the nearest integer and returns the value. |
|||
int |
Computes and returns the sine of the specified angle in radians. |
|||
int |
Computes and returns the square root of the specified number. |
|||
int |
Computes and returns the tangent of the specified angle. |
abs
Usage:
Computes and returns an absolute value for the number specified by the parameter val.
Example:
echo abs(-123456)
echo abs(123456)
Result:
123456
123456
acos
Usage:
Computes and returns the arc cosine of the number specified in the parameter val, in radians.
Example:
Result:
asin
Usage:
Computes and returns the arc sine for the number specified in the parameter val, in radians.
Example:
Result:
atan
Usage:
Computes and returns the value, in radians, of the angle whose tangent is specified in the parameter val.
Example:
Result:
atan2
Usage:
Returns a string comprising the characters represented by the Unicode character codes in the parameters.
Example:
Result:
ceil
Usage:
Returns the ceiling of the specified number or expression. Basically this means return the number rounded up to next whole number
Example:
echo ceil(4.1)
Result:
5
cos
Usage:
Computes and returns the cosine of the specified angle in radians.
Example:
Result:
exp
Usage:
Returns the value of the base of the natural logarithm (e), to the power of the exponent specified in the parameter x.
Example:
Result:
floor
Usage:
Returns the floor of the number or expression specified in the paraenthesis... Floor is the whole number part, without the decimals. Basically means chop the decimal portion of the number off.
Example: echo floor(1234.56)
Result: 1234
log
Usage:
Returns the natural logarithm of the parameter val.
Example:
Result:
max
Usage:
Evaluates val1 and val2 (or more values) and returns the largest value.
Example:
echo max( city.troop.scouter, 100k )
Result:
If city.troop.scouter (the current number of scouts in the city) < 100k, then max( city.troop.scouter, 100k ) will return the number of scouts in city. If city.troop.scouter >= 100k then it will return 100000
min
Usage:
Evaluates val1 and val2 (or more values) and returns the smallest value.
Example:
echo min(city.resource.food.amount,99999999)
Result:
this will return whichever is smaller, 99,999,999 or the current amount of food in the city
pow
Usage:
Computes and returns base to the power of pow.
Example:
Result:
random
Usage:
Returns a pseudo-random number n, where 0 <= n < 1.
Example:
echo round(random*10)
Result:
a random number between 0 and 9
round
Usage:
Rounds the value of the parameter val up or down to the nearest integer and returns the value. Optional argument to specify precision (or number of decimal places).
Example:
echo round(6.66666666666666666666) echo round(6.66666666666666666666,1) echo round(6.66666666666666666666,2) echo round(6.66666666666666666666,3)
Result:
7 6.7 6.67 6.667
sin
Usage:
Computes and returns the sine of the specified angle in radians.
Example:
Result:
sqrt
Usage:
Computes and returns the square root of the specified number.
Example:
Result:
tan
Usage:
Computes and returns the tangent of the specified angle.
Example:
Result: