LongUtil

java.lang.Object
- jsimple.util.LongUtil

```
public final class LongUtil
extends java.lang.Object
```
The wrapper for the primitive type long.
As with the specification, this implementation relies on code laid out in Henry S. Warren, Jr.'s Hacker's Delight, (Addison Wesley, 2002) as well as The Aggregate's Magic Algorithms.

Since:

1.0

See Also:

Number

Field Summary

Fields
Modifier and Type Field and Description

static long MAX_VALUE
Constant for the maximum long value, 2⁶³-1.

static long MIN_VALUE
Constant for the minimum long value, -2⁶³.

Fields
Modifier and Type	Field and Description
`static long`	`MAX_VALUE` Constant for the maximum `long` value, 2⁶³-1.
`static long`	`MIN_VALUE` Constant for the minimum `long` value, -2⁶³.

Constructor Summary

Constructors
Constructor and Description

LongUtil()

Constructors
Constructor and Description
`LongUtil()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static int`	`bitCount(long lng)` Counts the number of 1 bits in the specified long value; this is also referred to as population count.
`static long`	`decode(java.lang.String string)` Parses the specified string and returns a `long` if the string can be decoded into a long value.
`static long`	`highestOneBit(long lng)` Determines the highest (leftmost) bit of the specified long value that is 1 and returns the bit mask value for that bit.
`static long`	`lowestOneBit(long lng)` Determines the lowest (rightmost) bit of the specified long value that is 1 and returns the bit mask value for that bit.
`static int`	`numberOfLeadingZeros(long lng)` Determines the number of leading zeros in the specified long value prior to the `highest one bit`.
`static int`	`numberOfTrailingZeros(long lng)` Determines the number of trailing zeros in the specified long value after the `lowest one bit`.
`static long`	`parseLong(java.lang.String string)` Parses the specified string as a signed decimal long value.
`static long`	`parseLong(java.lang.String string, int radix)` Parses the specified string as a signed long value using the specified radix.
`static long`	`reverse(long lng)` Reverses the order of the bits of the specified long value.
`static long`	`reverseBytes(long lng)` Reverses the order of the bytes of the specified long value.
`static long`	`rotateLeft(long lng, int distance)` Rotates the bits of the specified long value to the left by the specified number of bits.
`static long`	`rotateRight(long lng, int distance)` Rotates the bits of the specified long value to the right by the specified number of bits.
`static java.lang.String`	`toBinaryString(long l)` Converts the specified long value into its binary string representation.
`static java.lang.String`	`toHexString(long l)` Converts the specified long value into its hexadecimal string representation.
`static java.lang.String`	`toString(long l)` Converts the specified long value into its decimal string representation.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - MAX_VALUE
```
public static final long MAX_VALUE
```
    Constant for the maximum long value, 2⁶³-1.
    
    See Also:
    
    Constant Field Values
  - MIN_VALUE
```
public static final long MIN_VALUE
```
    Constant for the minimum long value, -2⁶³.
    
    See Also:
    
    Constant Field Values
- Constructor Detail
  - LongUtil
```
public LongUtil()
```
- Method Detail
  - decode
```
public static long decode(java.lang.String string)
                   throws InvalidFormatException
```
    Parses the specified string and returns a long if the string can be decoded into a long value. The string may be an optional minus sign "-" followed by a hexadecimal ("0x..." or "#..."), octal ("0..."), or decimal ("...") representation of a long.
    
    Parameters:
    
    string - a string representation of a long value
    
    Returns:
    
    a long for the value represented by string
    
    Throws:
    
    InvalidFormatException - if string can not be parsed as a long value
  - parseLong
```
public static long parseLong(java.lang.String string)
                      throws InvalidFormatException
```
    Parses the specified string as a signed decimal long value. The ASCII character - ('-') is recognized as the minus sign.
    
    Parameters:
    
    string - the string representation of a long value.
    
    Returns:
    
    the primitive long value represented by string.
    
    Throws:
    
    InvalidFormatException - if string is null, has a length of zero or can not be parsed as a long value.
  - parseLong
```
public static long parseLong(java.lang.String string,
                             int radix)
                      throws InvalidFormatException
```
    Parses the specified string as a signed long value using the specified radix. The ASCII character - ('-') is recognized as the minus sign.
    
    Parameters:
    
    string - the string representation of a long value.
    
    radix - the radix to use when parsing.
    
    Returns:
    
    the primitive long value represented by string using radix.
    
    Throws:
    
    InvalidFormatException - if string is null or has a length of zero, radix < Character.MIN_RADIX, radix > Character.MAX_RADIX, or if string can not be parsed as a long value.
  - toBinaryString
```
public static java.lang.String toBinaryString(long l)
```
    Converts the specified long value into its binary string representation. The returned string is a concatenation of '0' and '1' characters.
    
    Parameters:
    
    l - the long value to convert.
    
    Returns:
    
    the binary string representation of l.
  - toHexString
```
public static java.lang.String toHexString(long l)
```
    Converts the specified long value into its hexadecimal string representation. The returned string is a concatenation of characters from '0' to '9' and 'a' to 'f'.
    
    Parameters:
    
    l - the long value to convert.
    
    Returns:
    
    the hexadecimal string representation of l.
  - toString
```
public static java.lang.String toString(long l)
```
    Converts the specified long value into its decimal string representation. The returned string is a concatenation of a minus sign if the number is negative and characters from '0' to '9'.
    
    Parameters:
    
    l - the long to convert.
    
    Returns:
    
    the decimal string representation of l.
  - highestOneBit
```
public static long highestOneBit(long lng)
```
    Determines the highest (leftmost) bit of the specified long value that is 1 and returns the bit mask value for that bit. This is also referred to as the Most Significant 1 Bit. Returns zero if the specified long is zero.
    
    Parameters:
    
    lng - the long to examine.
    
    Returns:
    
    the bit mask indicating the highest 1 bit in lng.
    
    Since:
    
    1.5
  - lowestOneBit
```
public static long lowestOneBit(long lng)
```
    Determines the lowest (rightmost) bit of the specified long value that is 1 and returns the bit mask value for that bit. This is also referred to as the Least Significant 1 Bit. Returns zero if the specified long is zero.
    
    Parameters:
    
    lng - the long to examine.
    
    Returns:
    
    the bit mask indicating the lowest 1 bit in lng.
    
    Since:
    
    1.5
  - numberOfLeadingZeros
```
public static int numberOfLeadingZeros(long lng)
```
    Determines the number of leading zeros in the specified long value prior to the highest one bit.
    
    Parameters:
    
    lng - the long to examine.
    
    Returns:
    
    the number of leading zeros in lng.
    
    Since:
    
    1.5
  - numberOfTrailingZeros
```
public static int numberOfTrailingZeros(long lng)
```
    Determines the number of trailing zeros in the specified long value after the lowest one bit.
    
    Parameters:
    
    lng - the long to examine.
    
    Returns:
    
    the number of trailing zeros in lng.
    
    Since:
    
    1.5
  - bitCount
```
public static int bitCount(long lng)
```
    Counts the number of 1 bits in the specified long value; this is also referred to as population count.
    
    Parameters:
    
    lng - the long to examine.
    
    Returns:
    
    the number of 1 bits in lng.
    
    Since:
    
    1.5
  - rotateLeft
```
public static long rotateLeft(long lng,
                              int distance)
```
    Rotates the bits of the specified long value to the left by the specified number of bits.
    
    Parameters:
    
    lng - the long value to rotate left.
    
    distance - the number of bits to rotate.
    
    Returns:
    
    the rotated value.
    
    Since:
    
    1.5
  - rotateRight
```
public static long rotateRight(long lng,
                               int distance)
```
    Rotates the bits of the specified long value to the right by the specified number of bits.
    
    Parameters:
    
    lng - the long value to rotate right.
    
    distance - the number of bits to rotate.
    
    Returns:
    
    the rotated value.
    
    Since:
    
    1.5
  - reverseBytes
```
public static long reverseBytes(long lng)
```
    Reverses the order of the bytes of the specified long value.
    
    Parameters:
    
    lng - the long value for which to reverse the byte order.
    
    Returns:
    
    the reversed value.
    
    Since:
    
    1.5
  - reverse
```
public static long reverse(long lng)
```
    Reverses the order of the bits of the specified long value.
    
    Parameters:
    
    lng - the long value for which to reverse the bit order.
    
    Returns:
    
    the reversed value.
    
    Since:
    
    1.5

Class LongUtil

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

MAX_VALUE

MIN_VALUE

Constructor Detail

LongUtil

Method Detail

decode

parseLong

parseLong

toBinaryString

toHexString

toString

highestOneBit

lowestOneBit

numberOfLeadingZeros

numberOfTrailingZeros

bitCount

rotateLeft

rotateRight

reverseBytes

reverse