• My Pages
  • Comments
  • Add Link
  • Subscribe
  • Subscribe User
  • Edit (GUI)
  • Edit (Text)
  • Rename Page
  • Copy Page
  • Load Page
  • Save Page
  • Delete Page
  • Attachments
  • Check Spelling
  • Diffs
  • Info
  • Revert to this revision
  • XML
  • Render as Docbook
  • Print View
  • Raw Text
  • Delete Cache
  • Like Pages
  • Local Site Map
  • Remove Spam
  • Package Pages
  • Sync Pages

    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.

    Functions

    Function

    Type

    Description

    abs

    int

    Computes and returns an absolute value for the number specified by the parameter val.

    acos

    int

    Computes and returns the arc cosine of the number specified in the parameter val, in radians.

    asin

    int

    Computes and returns the arc sine for the number specified in the parameter val, in radians.

    atan

    int

    Computes and returns the value, in radians, of the angle whose tangent is specified in the parameter val.

    atan2

    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).

    ceil

    int

    Returns the ceiling of the specified number or expression.

    cos

    int

    Computes and returns the cosine of the specified angle in radians.

    exp

    int

    Returns the value of the base of the natural logarithm (e), to the power of the exponent specified in the parameter x.

    floor

    int

    Returns the floor of the number or expression specified in the parameter val.

    log

    int

    Returns the natural logarithm of the parameter val.

    max

    int

    Evaluates val1 and val2 (or more values) and returns the largest value.

    min

    int

    Evaluates val1 and val2 (or more values) and returns the smallest value.

    pow

    int

    Computes and returns base to the power of pow.

    random

    int

    Returns a pseudo-random number n, where 0 <= n < 1.

    round

    int

    Rounds the value of the parameter val up or down to the nearest integer and returns the value.

    sin

    int

    Computes and returns the sine of the specified angle in radians.

    sqrt

    int

    Computes and returns the square root of the specified number.

    tan

    int

    Computes and returns the tangent of the specified angle.

    abs

    Usage: abs(number)

    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: acos(number.decimal)

    Computes and returns the arc cosine of the number specified in the parameter val, in radians.

    Example:

    • echo acos(0.75)

    Result:

    • (City Name) - 0.7227342478134157 (City Name) - Script stopped

    asin

    Usage: asin(number.decimal)

    Computes and returns the arc sine for the number specified in the parameter val, in radians.

    Example:

    • echo asin(0.75)

    Result:

    • (City Name) - 0.848062078981481 (City Name) - Script stopped

    atan

    Usage: atan(Number)

    Computes and returns the value, in radians, of the angle whose tangent is specified in the parameter val.

    Example:

    • echo atan(7)

    Result:

    • (City Name) - 1.4288992721907328 (City Name) - Script stopped

    atan2

    Usage: atan2(FirstNumber, SecondNumber)

    Returns a string comprising the characters represented by the Unicode character codes in the parameters.

    Example:

    • echo atan2(7,3)

    Result:

    • (City Name) - 1.1659045405098132 (City Name) - Script stopped

    ceil

    Usage: ceil(Number.Decimal)

    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:

    • (City Name) - 5 (City Name) - Script stopped

    cos

    Usage: cos(angle)

    Computes and returns the cosine of the specified angle in radians.

    Example:

    • echo cos(7)

    Result:

    • (City Name) - 0.7539022543433046 (City Name) - Script stopped

    exp

    Usage: exp(number)

    Returns the value of the base of the natural logarithm (e), to the power of the exponent specified in the parameter x.

    Example:

    • echo exp(7)

    Result:

    • (City Name) - 1096.633158428458 (City Name) - Script stopped

    floor

    Usage: floor(Number.decimal)

    Returns the floor of the number or expression specified in the parenthesis... 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:

    • (City Name) - 1234 (City Name) - Script stopped

    pow

    Usage: pow(base, exponent)

    Computes and returns base to the power of pow.

    Example:

    • echo pow(7, 3)

    Result:

    • (City Name) - 343 (City Name) - Script stopped

    max

    Usage: max(FirstValue, SecondValue)

    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: min(FirstValue, SecondValue)

    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

    random

    Usage: random()

    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: round(number.decimal,[optional] places)

    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: sin(angle)

    Computes and returns the sine of the specified angle in radians.

    Example:

    • echo sin(3)

    Result:

    • (City Name) - 0.1411200080598672 (City Name) - Script stopped

    sqrt

    Usage: sqrt(number)

    Computes and returns the square root of the specified number.

    Example:

    • echo sqrt(16)

    Result:

    • (City Name) - 4 (City Name) - Script stopped

    tan

    Usage: tan(angle)

    Computes and returns the tangent of the specified angle.

    Example:

    • echo tan(4)

    Result:

    • (City Name) - 1.1578212823495775

    (City Name) - Script stopped



    CategoryFunctions

    Math (last edited 2015-02-13 20:59:39 by LKD70)