Long

extern class java.lang.Longextends Numberimplements Comparable<Null<Int64>>Available in java function new( param1 : Int64 ) : Void function compareTo( param1 : Null<Int64> ) : IntCompares two {@code Long} objects numerically.
@param anotherLong the {@code Long} to be compared. @return the value {@code 0} if this {@code Long} is equal to the argument {@code Long}; a value less than {@code 0} if this {@code Long} is numerically less than the argument {@code Long}; and a value greater than {@code 0} if this {@code Long} is numerically greater than the argument {@code Long} (signed comparison). @since 1.2
function equals( param1 : Dynamic ) : BoolCompares this object to the specified object. The result is {@code true} if and only if the argument is not {@code null} and is a {@code Long} object that contains the same {@code long} value as this object.
param   obj   the object to compare with. return {@code true} if the objects are the same; {@code false} otherwise.
function hashCode() : IntReturns a hash code for this {@code Long}. The result is the exclusive OR of the two halves of the primitive {@code long} value held by this {@code Long} object. That is, the hashcode is the value of the expression:
<blockquote> {@code (int)(this.longValue()^(this.longValue()>>>32))} </blockquote>
@return a hash code value for this object.
function toString() : StringReturns a {@code String} object representing this {@code Long}'s value. The value is converted to signed decimal representation and returned as a string, exactly as if the {@code long} value were given as an argument to the {@link java.lang.Long#toString(long)} method.
@return a string representation of the value of this object in base&nbsp;10.
static var MAX_VALUE(default,null) : Int64 static var MIN_VALUE(default,null) : Int64 static var SIZE(default,null) : IntThe number of bits used to represent a {@code long} value in two's complement binary form.
@since 1.5
static var TYPE : Class<Null<Int64>>The {@code Class} instance representing the primitive type {@code long}.
@since JDK1.1
static function _toString( param1 : Int64, param2 : Int ) : StringReturns a string representation of the first argument in the radix specified by the second argument.
<p>If the radix is smaller than {@code Character.MIN_RADIX} or larger than {@code Character.MAX_RADIX}, then the radix {@code 10} is used instead.
<p>If the first argument is negative, the first element of the result is the ASCII minus sign {@code '-'} (
'&#92;u002d'
). If the first argument is not negative, no sign character appears in the result.
<p>The remaining characters of the result represent the magnitude of the first argument. If the magnitude is zero, it is represented by a single zero character {@code '0'} (
'&#92;u0030'
); otherwise, the first character of the representation of the magnitude will not be the zero character. The following ASCII characters are used as digits:
<blockquote> {@code 0123456789abcdefghijklmnopqrstuvwxyz} </blockquote>
These are
'&#92;u0030'
through
'&#92;u0039'
and
'&#92;u0061'
through
'&#92;u007a'
. If {@code radix} is <var>N</var>, then the first <var>N</var> of these characters are used as radix-<var>N</var> digits in the order shown. Thus, the digits for hexadecimal (radix 16) are {@code 0123456789abcdef}. If uppercase letters are desired, the {@link java.lang.String#toUpperCase()} method may be called on the result:
<blockquote> {@code Long.toString(n, 16).toUpperCase()} </blockquote>
@param i a {@code long} to be converted to a string. param   radix   the radix to use in the string representation. return a string representation of the argument in the specified radix. @see java.lang.Character#MAX_RADIX @see java.lang.Character#MIN_RADIX
static function bitCount( param1 : Int64 ) : IntReturns the number of one-bits in the two's complement binary representation of the specified {@code long} value. This function is sometimes referred to as the <i>population count</i>.
@return the number of one-bits in the two's complement binary representation of the specified {@code long} value. @since 1.5
static function compare( param1 : Int64, param2 : Int64 ) : IntCompares two {@code long} values numerically. The value returned is identical to what would be returned by: <pre> Long.valueOf(x).compareTo(Long.valueOf(y)) </pre>
@param x the first {@code long} to compare @param y the second {@code long} to compare @return the value {@code 0} if {@code x == y}; a value less than {@code 0} if {@code x < y}; and a value greater than {@code 0} if {@code x > y} @since 1.7
static function decode( param1 : String ) : Null<Int64>Decodes a {@code String} into a {@code Long}. Accepts decimal, hexadecimal, and octal numbers given by the following grammar:
<blockquote> <dl> <dt><i>DecodableString:</i> <dd><i>Sign<sub>opt</sub> DecimalNumeral</i> <dd><i>Sign<sub>opt</sub></i> {@code 0x} <i>HexDigits</i> <dd><i>Sign<sub>opt</sub></i> {@code 0X} <i>HexDigits</i> <dd><i>Sign<sub>opt</sub></i> {@code #} <i>HexDigits</i> <dd><i>Sign<sub>opt</sub></i> {@code 0} <i>OctalDigits</i> <p> <dt><i>Sign:</i> <dd>{@code -} <dd>{@code +} </dl> </blockquote>
<i>DecimalNumeral</i>, <i>HexDigits</i>, and <i>OctalDigits</i> are as defined in section 3.10.1 of <cite>The Java&trade; Language Specification</cite>, except that underscores are not accepted between digits.
<p>The sequence of characters following an optional sign and/or radix specifier ("{@code 0x}", "{@code 0X}", "{@code #}", or leading zero) is parsed as by the {@code Long.parseLong} method with the indicated radix (10, 16, or 8). This sequence of characters must represent a positive value or a {@link NumberFormatException} will be thrown. The result is negated if first character of the specified {@code String} is the minus sign. No whitespace characters are permitted in the {@code String}.
@param nm the {@code String} to decode. @return a {@code Long} object holding the {@code long} value represented by {@code nm} @throws NumberFormatException if the {@code String} does not contain a parsable {@code long}. @see java.lang.Long#parseLong(String, int) @since 1.2
static function getLong( param1 : String ) : Null<Int64>Determines the {@code long} value of the system property with the specified name.
<p>The first argument is treated as the name of a system property. System properties are accessible through the {@link java.lang.System#getProperty(java.lang.String)} method. The string value of this property is then interpreted as a {@code long} value and a {@code Long} object representing this value is returned. Details of possible numeric formats can be found with the definition of {@code getProperty}.
<p>If there is no property with the specified name, if the specified name is empty or {@code null}, or if the property does not have the correct numeric format, then {@code null} is returned.
<p>In other words, this method returns a {@code Long} object equal to the value of:
<blockquote> {@code getLong(nm, null)} </blockquote>
param   nm   property name. return the {@code Long} value of the property. @see java.lang.System#getProperty(java.lang.String) @see java.lang.System#getProperty(java.lang.String, java.lang.String)
static function highestOneBit( param1 : Int64 ) : Int64Returns a {@code long} value with at most a single one-bit, in the position of the highest-order ("leftmost") one-bit in the specified {@code long} value. Returns zero if the specified value has no one-bits in its two's complement binary representation, that is, if it is equal to zero.
@return a {@code long} value with a single one-bit, in the position of the highest-order one-bit in the specified value, or zero if the specified value is itself equal to zero. @since 1.5
static function lowestOneBit( param1 : Int64 ) : Int64Returns a {@code long} value with at most a single one-bit, in the position of the lowest-order ("rightmost") one-bit in the specified {@code long} value. Returns zero if the specified value has no one-bits in its two's complement binary representation, that is, if it is equal to zero.
@return a {@code long} value with a single one-bit, in the position of the lowest-order one-bit in the specified value, or zero if the specified value is itself equal to zero. @since 1.5
static function numberOfLeadingZeros( param1 : Int64 ) : IntReturns the number of zero bits preceding the highest-order ("leftmost") one-bit in the two's complement binary representation of the specified {@code long} value. Returns 64 if the specified value has no one-bits in its two's complement representation, in other words if it is equal to zero.
<p>Note that this method is closely related to the logarithm base 2. For all positive {@code long} values x: <ul> <li>floor(log<sub>2</sub>(x)) = {@code 63 - numberOfLeadingZeros(x)} <li>ceil(log<sub>2</sub>(x)) = {@code 64 - numberOfLeadingZeros(x - 1)} </ul>
@return the number of zero bits preceding the highest-order ("leftmost") one-bit in the two's complement binary representation of the specified {@code long} value, or 64 if the value is equal to zero. @since 1.5
static function numberOfTrailingZeros( param1 : Int64 ) : IntReturns the number of zero bits following the lowest-order ("rightmost") one-bit in the two's complement binary representation of the specified {@code long} value. Returns 64 if the specified value has no one-bits in its two's complement representation, in other words if it is equal to zero.
@return the number of zero bits following the lowest-order ("rightmost") one-bit in the two's complement binary representation of the specified {@code long} value, or 64 if the value is equal to zero. @since 1.5
static function parseLong( param1 : String, param2 : Int ) : Int64 static function reverse( param1 : Int64 ) : Int64Returns the value obtained by reversing the order of the bits in the two's complement binary representation of the specified {@code long} value.
@return the value obtained by reversing order of the bits in the specified {@code long} value. @since 1.5
static function reverseBytes( param1 : Int64 ) : Int64Returns the value obtained by reversing the order of the bytes in the two's complement representation of the specified {@code long} value.
@return the value obtained by reversing the bytes in the specified {@code long} value. @since 1.5
static function rotateLeft( param1 : Int64, param2 : Int ) : Int64Returns the value obtained by rotating the two's complement binary representation of the specified {@code long} value left by the specified number of bits. (Bits shifted out of the left hand, or high-order, side reenter on the right, or low-order.)
<p>Note that left rotation with a negative distance is equivalent to right rotation: {@code rotateLeft(val, -distance) == rotateRight(val, distance)}. Note also that rotation by any multiple of 64 is a no-op, so all but the last six bits of the rotation distance can be ignored, even if the distance is negative: {@code rotateLeft(val, distance) == rotateLeft(val, distance & 0x3F)}.
@return the value obtained by rotating the two's complement binary representation of the specified {@code long} value left by the specified number of bits. @since 1.5
static function rotateRight( param1 : Int64, param2 : Int ) : Int64Returns the value obtained by rotating the two's complement binary representation of the specified {@code long} value right by the specified number of bits. (Bits shifted out of the right hand, or low-order, side reenter on the left, or high-order.)
<p>Note that right rotation with a negative distance is equivalent to left rotation: {@code rotateRight(val, -distance) == rotateLeft(val, distance)}. Note also that rotation by any multiple of 64 is a no-op, so all but the last six bits of the rotation distance can be ignored, even if the distance is negative: {@code rotateRight(val, distance) == rotateRight(val, distance & 0x3F)}.
@return the value obtained by rotating the two's complement binary representation of the specified {@code long} value right by the specified number of bits. @since 1.5
static function signum( param1 : Int64 ) : IntReturns the signum function of the specified {@code long} value. (The return value is -1 if the specified value is negative; 0 if the specified value is zero; and 1 if the specified value is positive.)
@return the signum function of the specified {@code long} value. @since 1.5
static function toBinaryString( param1 : Int64 ) : StringReturns a string representation of the {@code long} argument as an unsigned integer in base&nbsp;2.
<p>The unsigned {@code long} value is the argument plus 2<sup>64</sup> if the argument is negative; otherwise, it is equal to the argument. This value is converted to a string of ASCII digits in binary (base&nbsp;2) with no extra leading {@code 0}s. If the unsigned magnitude is zero, it is represented by a single zero character {@code '0'} (
'&#92;u0030'
); otherwise, the first character of the representation of the unsigned magnitude will not be the zero character. The characters {@code '0'} (
'&#92;u0030'
) and {@code '1'} (
'&#92;u0031'
) are used as binary digits.
@param i a {@code long} to be converted to a string. @return the string representation of the unsigned {@code long} value represented by the argument in binary (base&nbsp;2). @since JDK 1.0.2
static function toHexString( param1 : Int64 ) : StringReturns a string representation of the {@code long} argument as an unsigned integer in base&nbsp;16.
<p>The unsigned {@code long} value is the argument plus 2<sup>64</sup> if the argument is negative; otherwise, it is equal to the argument. This value is converted to a string of ASCII digits in hexadecimal (base&nbsp;16) with no extra leading {@code 0}s. If the unsigned magnitude is zero, it is represented by a single zero character {@code '0'} (
'&#92;u0030'
); otherwise, the first character of the representation of the unsigned magnitude will not be the zero character. The following characters are used as hexadecimal digits:
<blockquote> {@code 0123456789abcdef} </blockquote>
These are the characters
'&#92;u0030'
through
'&#92;u0039'
and
'&#92;u0061'
through
'&#92;u0066'
. If uppercase letters are desired, the {@link java.lang.String#toUpperCase()} method may be called on the result:
<blockquote> {@code Long.toHexString(n).toUpperCase()} </blockquote>
@param i a {@code long} to be converted to a string. @return the string representation of the unsigned {@code long} value represented by the argument in hexadecimal (base&nbsp;16). @since JDK 1.0.2
static function toOctalString( param1 : Int64 ) : StringReturns a string representation of the {@code long} argument as an unsigned integer in base&nbsp;8.
<p>The unsigned {@code long} value is the argument plus 2<sup>64</sup> if the argument is negative; otherwise, it is equal to the argument. This value is converted to a string of ASCII digits in octal (base&nbsp;8) with no extra leading {@code 0}s.
<p>If the unsigned magnitude is zero, it is represented by a single zero character {@code '0'} (
'&#92;u0030'
); otherwise, the first character of the representation of the unsigned magnitude will not be the zero character. The following characters are used as octal digits:
<blockquote> {@code 01234567} </blockquote>
These are the characters
'&#92;u0030'
through
'&#92;u0037'
.
@param i a {@code long} to be converted to a string. @return the string representation of the unsigned {@code long} value represented by the argument in octal (base&nbsp;8). @since JDK 1.0.2
static function valueOf( param1 : String, param2 : Int ) : Null<Int64>Returns a {@code Long} object holding the value extracted from the specified {@code String} when parsed with the radix given by the second argument. The first argument is interpreted as representing a signed {@code long} in the radix specified by the second argument, exactly as if the arguments were given to the {@link #parseLong(java.lang.String, int)} method. The result is a {@code Long} object that represents the {@code long} value specified by the string.
<p>In other words, this method returns a {@code Long} object equal to the value of:
<blockquote> {@code new Long(Long.parseLong(s, radix))} </blockquote>
param      s       the string to be parsed param radix the radix to be used in interpreting {@code s} @return a {@code Long} object holding the value represented by the string argument in the specified radix. @throws NumberFormatException If the {@code String} does not contain a parsable {@code long}.
version #18639, modified 2013-05-08 10:55:18 by api
0 comment