Class: Toybox.Lang.Long

Inherits:

Toybox.Lang.Object

• Toybox.Lang.Object
• Toybox.Lang.Long

Overview

Long represents a 64-bit signed integer.

To use a Long value in Monkey C add 'l' to the end of the number.

Example:

var myLong = 9000l;

Since:

API Level 1.0.0

Instance Method Summary

• abs() as Lang.Long

  Get the absolute value of a Long.

• compareTo(other as Lang.Object) as Lang.Number

  Compare the numeric value of self to some other numeric value.

• equals(other as Lang.Object or Null) as Lang.Boolean

  Test if an Object instance is equal to another instance of an Object.

• format(format as Lang.String) as Lang.String

  Format a Long using a formatting String.

• toDouble() as Lang.Double

  Convert a Long to a Double.

• toFloat() as Lang.Float

  Convert a Long to a Float.

• toLong() as Lang.Long

  Convert a Long to a Long.

• toNumber() as Lang.Number

  Convert a Long to a Number.

• toString() as Lang.String

  Convert a Long to a String.

Instance Method Details

abs() as Lang.Long

Get the absolute value of a Long.

Returns:

• Lang.Long —

  The absolute value of the Long

Since:

API Level 1.0.0

compareTo(other as Lang.Object) as Lang.Number

Compare the numeric value of self to some other numeric value.

Parameters:

• other — (Lang.Object) —

  The right hand side of a comparison.

Returns:

• Lang.Number —

  A negative value if self is less than other, zero if the objects are equivalent, and a positive value if self is greater than other.

Since:

API Level 5.0.0

Throws:

• (Lang.UnexpectedTypeException) —

  Thrown if other is not of type Numeric, Boolean, or Char.

equals(other as Lang.Object or Null) as Lang.Boolean

Test if an Object instance is equal to another instance of an Object.

Parameters:

• other — (Lang.Object) —

  The Object to test against

Returns:

• Lang.Boolean —

  true if the Objects are equal, otherwise false

Since:

API Level 1.3.0

format(format as Lang.String) as Lang.String

Format a Long using a formatting String.

The formatting string is similar to that available in printf from the C stdio library, though the length option is not available:

    "%[flags][width][.precision]specifier"

specifiers

• d or i - signed decimal integer

• e - scientific notation (mantissa/exponent) using 'e' character

• E - scientific notation (mantissa/exponent) using 'E' character

• f - decimal floating point

• o - signed octal

• u - unsigned decimal integer

• x - unsigned hexadecimal integer

• X - unsigned hexadecimal integer (capital letters)

flags

• + - Prepends the result with a plus or minus sign ('+' or '-'), including positive numbers. By default, only negative numbers are preceded with a '-' sign.

• 0 - Left-pads the number with zeros (0) instead of spaces, where padding is specified (see width sub-specifier).

width

supports only numbers (* is not supported)

.precision

supports only numbers (* is not supported)

Returns:

• Lang.String —

  A formatted String

Since:

API Level 1.0.0

toDouble() as Lang.Double

Convert a Long to a Double.

Returns:

• Lang.Double —

  A Double representation of the Long

Since:

API Level 1.0.0

toFloat() as Lang.Float

Convert a Long to a Float.

Returns:

• Lang.Float —

  A Float representation of the Long

Since:

API Level 1.0.0

toLong() as Lang.Long

Convert a Long to a Long.

Returns:

• Lang.Long —

  A Long representation of the Long

Since:

API Level 1.0.0

toNumber() as Lang.Number

Convert a Long to a Number.

Returns:

• Lang.Number —

  A Number representation of the Long

Since:

API Level 1.0.0

toString() as Lang.String

Convert a Long to a String.

Returns:

• Lang.String —

  A String representation of the Long

Since:

API Level 1.0.0