scala.math

# BigInt

#### final class BigInt extends ScalaNumber with ScalaNumericConversions with Serializable

Version

  1.0, 15/07/2003

Linear Supertypes
Serializable, ScalaNumericConversions, ScalaNumericAnyConversions, ScalaNumber, Number, java.io.Serializable, AnyRef, Any
Type Hierarchy Learn more about scaladoc diagrams
Ordering

1. Alphabetic
2. By inheritance

Inherited

1. BigInt
2. Serializable
3. ScalaNumericConversions
4. ScalaNumericAnyConversions
5. ScalaNumber
6. Number
7. Serializable
8. AnyRef
9. Any

Implicitly

1. by any2stringadd
2. by StringFormat
3. by Ensuring
4. by ArrowAssoc

1. Hide All
2. Show all

Learn more about member selection
Visibility

1. Public
2. All

### Instance Constructors

1. #### new BigInt(bigInteger: BigInteger)

### Value Members

1. #### final def !=(arg0: Any): Boolean

   Definition Classes
     AnyRef → Any

2. #### final def ##(): Int

   Definition Classes
     AnyRef → Any

3. #### def %(that: BigInt): BigInt

   Remainder of BigInts

4. #### def &(that: BigInt): BigInt

   Bitwise and of BigInts

5. #### def &~(that: BigInt): BigInt

   Bitwise and-not of BigInts.

   Bitwise and-not of BigInts. Returns a BigInt whose value is (this & ~that).

6. #### def *(that: BigInt): BigInt

   Multiplication of BigInts

7. #### def +(that: BigInt): BigInt

   Addition of BigInts

8. #### def -(that: BigInt): BigInt

   Subtraction of BigInts

9. #### def ->[B](y: B): (BigInt, B)

   Implicit information
     This member is added by an implicit conversion from BigInt to ArrowAssoc[BigInt] performed by method ArrowAssoc in scala.Predef.
   Definition Classes
     ArrowAssoc
   Annotations
     @inline()

10. #### def /(that: BigInt): BigInt

    Division of BigInts

11. #### def /%(that: BigInt): (BigInt, BigInt)

    Returns a pair of two BigInts containing (this / that) and (this % that).

12. #### def <(that: BigInt): Boolean

    Less-than of BigInts

13. #### def <<(n: Int): BigInt

    Leftshift of BigInt

14. #### def <=(that: BigInt): Boolean

    Less-than-or-equals comparison of BigInts

15. #### final def ==(arg0: Any): Boolean

    Definition Classes
      AnyRef → Any

16. #### def >(that: BigInt): Boolean

    Greater-than comparison of BigInts

17. #### def >=(that: BigInt): Boolean

    Greater-than-or-equals comparison of BigInts

18. #### def >>(n: Int): BigInt

    (Signed) rightshift of BigInt

19. #### def ^(that: BigInt): BigInt

    Bitwise exclusive-or of BigInts

20. #### def abs: BigInt

    Returns the absolute value of this BigInt

21. #### final def asInstanceOf[T0]: T0

    Definition Classes
      Any

22. #### val bigInteger: BigInteger

23. #### def bitCount: Int

    Returns the number of bits in the two's complement representation of this BigInt that differ from its sign bit.

24. #### def bitLength: Int

    Returns the number of bits in the minimal two's-complement representation of this BigInt, excluding a sign bit.

25. #### def byteValue(): Byte

    Converts this BigInt to a `byte`.

    Converts this BigInt to a `byte`. If the BigInt is too big to fit in a byte, only the low-order 8 bits are returned. Note that this conversion can lose information about the overall magnitude of the BigInt value as well as return a result with the opposite sign.

    Definition Classes
      BigInt → ScalaNumericAnyConversions → Number

26. #### def charValue: Char

    Converts this BigInt to a `char`.

    Converts this BigInt to a `char`. If the BigInt is too big to fit in a char, only the low-order 16 bits are returned. Note that this conversion can lose information about the overall magnitude of the BigInt value and that it always returns a positive result.

27. #### def clearBit(n: Int): BigInt

    Returns a BigInt whose value is equivalent to this BigInt with the designated bit cleared.

28. #### def clone(): AnyRef

    Attributes
      protected[java.lang]
    Definition Classes
      AnyRef
    Annotations
      @throws( ... )

29. #### def compare(that: BigInt): Int

    Compares this BigInt with the specified BigInt

30. #### def doubleValue(): Double

    Converts this `BigInt` to a `double`.

    Converts this `BigInt` to a `double`. if this `BigInt` has too great a magnitude to represent as a double, it will be converted to `Double.NEGATIVE_INFINITY` or `Double.POSITIVE_INFINITY` as appropriate.

    Definition Classes
      BigInt → ScalaNumericAnyConversions → Number

31. #### def ensuring(cond: (BigInt) ⇒ Boolean, msg: ⇒ Any): BigInt

    Implicit information
      This member is added by an implicit conversion from BigInt to Ensuring[BigInt] performed by method Ensuring in scala.Predef.
    Definition Classes
      Ensuring

32. #### def ensuring(cond: (BigInt) ⇒ Boolean): BigInt

    Implicit information
      This member is added by an implicit conversion from BigInt to Ensuring[BigInt] performed by method Ensuring in scala.Predef.
    Definition Classes
      Ensuring

33. #### def ensuring(cond: Boolean, msg: ⇒ Any): BigInt

    Implicit information
      This member is added by an implicit conversion from BigInt to Ensuring[BigInt] performed by method Ensuring in scala.Predef.
    Definition Classes
      Ensuring

34. #### def ensuring(cond: Boolean): BigInt

    Implicit information
      This member is added by an implicit conversion from BigInt to Ensuring[BigInt] performed by method Ensuring in scala.Predef.
    Definition Classes
      Ensuring

35. #### final def eq(arg0: AnyRef): Boolean

    Definition Classes
      AnyRef

36. #### def equals(that: BigInt): Boolean

    Compares this BigInt with the specified BigInt for equality.

37. #### def equals(that: Any): Boolean

    Compares this BigInt with the specified value for equality.

    Compares this BigInt with the specified value for equality.

    Definition Classes
      BigInt → AnyRef → Any

38. #### def finalize(): Unit

    Attributes
      protected[java.lang]
    Definition Classes
      AnyRef
    Annotations
      @throws( classOf[java.lang.Throwable] )

39. #### def flipBit(n: Int): BigInt

    Returns a BigInt whose value is equivalent to this BigInt with the designated bit flipped.

40. #### def floatValue(): Float

    Converts this `BigInt` to a `float`.

    Converts this `BigInt` to a `float`. If this `BigInt` has too great a magnitude to represent as a float, it will be converted to `Float.NEGATIVE_INFINITY` or `Float.POSITIVE_INFINITY` as appropriate.

    Definition Classes
      BigInt → ScalaNumericAnyConversions → Number

41. #### def formatted(fmtstr: String): String

    Returns string formatted according to given `format` string.

    Returns string formatted according to given `format` string. Format strings are as for `String.format` (@see java.lang.String.format).

    Implicit information
      This member is added by an implicit conversion from BigInt to StringFormat[BigInt] performed by method StringFormat in scala.Predef.
    Definition Classes
      StringFormat
    Annotations
      @inline()

42. #### def gcd(that: BigInt): BigInt

    Returns the greatest common divisor of abs(this) and abs(that)

43. #### final def getClass(): Class[_]

    Definition Classes
      AnyRef → Any

44. #### def hashCode(): Int

    Returns the hash code for this BigInt.

    Returns the hash code for this BigInt.

    Definition Classes
      BigInt → AnyRef → Any

45. #### def intValue(): Int

    Converts this BigInt to an `int`.

    Converts this BigInt to an `int`. If the BigInt is too big to fit in an int, only the low-order 32 bits are returned. Note that this conversion can lose information about the overall magnitude of the BigInt value as well as return a result with the opposite sign.

    Definition Classes
      BigInt → ScalaNumericAnyConversions → Number

46. #### final def isInstanceOf[T0]: Boolean

    Definition Classes
      Any

47. #### def isProbablePrime(certainty: Int): Boolean

    Returns true if this BigInt is probably prime, false if it's definitely composite.

    Returns true if this BigInt is probably prime, false if it's definitely composite.

    certainty

      a measure of the uncertainty that the caller is willing to tolerate: if the call returns true the probability that this BigInt is prime exceeds (1 - 1/2 ^ certainty). The execution time of this method is proportional to the value of this parameter.

48. #### def isValidByte: Boolean

    Returns `true` iff this has a zero fractional part, and is within the range of scala.Byte MinValue and MaxValue; otherwise returns `false`.

    Returns `true` iff this has a zero fractional part, and is within the range of scala.Byte MinValue and MaxValue; otherwise returns `false`.

    Definition Classes
      BigInt → ScalaNumericAnyConversions

49. #### def isValidChar: Boolean

    Returns `true` iff this has a zero fractional part, and is within the range of scala.Char MinValue and MaxValue; otherwise returns `false`.

    Returns `true` iff this has a zero fractional part, and is within the range of scala.Char MinValue and MaxValue; otherwise returns `false`.

    Definition Classes
      BigInt → ScalaNumericAnyConversions

50. #### def isValidDouble: Boolean

    Returns `true` iff this can be represented exactly by scala.Double; otherwise returns `false`.

51. #### def isValidFloat: Boolean

    Returns `true` iff this can be represented exactly by scala.Float; otherwise returns `false`.

52. #### def isValidInt: Boolean

    Returns `true` iff this has a zero fractional part, and is within the range of scala.Int MinValue and MaxValue; otherwise returns `false`.

    Returns `true` iff this has a zero fractional part, and is within the range of scala.Int MinValue and MaxValue; otherwise returns `false`.

    Definition Classes
      BigInt → ScalaNumericAnyConversions

53. #### def isValidLong: Boolean

54. #### def isValidShort: Boolean

    Returns `true` iff this has a zero fractional part, and is within the range of scala.Short MinValue and MaxValue; otherwise returns `false`.

    Returns `true` iff this has a zero fractional part, and is within the range of scala.Short MinValue and MaxValue; otherwise returns `false`.

    Definition Classes
      BigInt → ScalaNumericAnyConversions

55. #### def isWhole(): Boolean

    returns

      `true` if this number has no decimal component, `false` otherwise.

    Definition Classes
      BigInt → ScalaNumericAnyConversions → ScalaNumber

56. #### def longValue(): Long

    Converts this BigInt to a `long`.

    Converts this BigInt to a `long`. If the BigInt is too big to fit in a long, only the low-order 64 bits are returned. Note that this conversion can lose information about the overall magnitude of the BigInt value as well as return a result with the opposite sign.

    Definition Classes
      BigInt → ScalaNumericAnyConversions → Number

57. #### def lowestSetBit: Int

    Returns the index of the rightmost (lowest-order) one bit in this BigInt (the number of zero bits to the right of the rightmost one bit).

58. #### def max(that: BigInt): BigInt

    Returns the maximum of this and that

59. #### def min(that: BigInt): BigInt

    Returns the minimum of this and that

60. #### def mod(that: BigInt): BigInt

    Returns a BigInt whose value is (this mod that).

    Returns a BigInt whose value is (this mod that). This method differs from `%` in that it always returns a non-negative BigInt.

61. #### def modInverse(m: BigInt): BigInt

    Returns a BigInt whose value is (the inverse of `this` modulo `m`).

    Returns a BigInt whose value is (the inverse of `this` modulo `m`).

62. #### def modPow(exp: BigInt, m: BigInt): BigInt

    Returns a BigInt whose value is (`this` raised to the power of `exp` modulo `m`).

    Returns a BigInt whose value is (`this` raised to the power of `exp` modulo `m`).

63. #### final def ne(arg0: AnyRef): Boolean

    Definition Classes
      AnyRef

64. #### final def notify(): Unit

    Definition Classes
      AnyRef

65. #### final def notifyAll(): Unit

    Definition Classes
      AnyRef

66. #### def pow(exp: Int): BigInt

    Returns a BigInt whose value is (`this` raised to the power of `exp`).

    Returns a BigInt whose value is (`this` raised to the power of `exp`).

67. #### def setBit(n: Int): BigInt

    Returns a BigInt whose value is equivalent to this BigInt with the designated bit set.

68. #### def shortValue(): Short

    Converts this BigInt to a `short`.

    Converts this BigInt to a `short`. If the BigInt is too big to fit in a short, only the low-order 16 bits are returned. Note that this conversion can lose information about the overall magnitude of the BigInt value as well as return a result with the opposite sign.

    Definition Classes
      BigInt → ScalaNumericAnyConversions → Number

69. #### def signum: Int

    Returns the sign of this BigInt, i.

    Returns the sign of this BigInt, i.e. -1 if it is less than 0, +1 if it is greater than 0 0 if it is equal to 0

70. #### final def synchronized[T0](arg0: ⇒ T0): T0

    Definition Classes
      AnyRef

71. #### def testBit(n: Int): Boolean

    Returns true if and only if the designated bit is set.

72. #### def to(end: BigInt, step: BigInt = BigInt(1)): Inclusive[scala.BigInt]

    Like until, but inclusive of the end value.

73. #### def toByte: Byte

    Returns the value of this as a scala.Byte.

    Returns the value of this as a scala.Byte. This may involve rounding or truncation.

    Definition Classes
      ScalaNumericAnyConversions

74. #### def toByteArray: Array[Byte]

    Returns a byte array containing the two's-complement representation of this BigInt.

    Returns a byte array containing the two's-complement representation of this BigInt. The byte array will be in big-endian byte-order: the most significant byte is in the zeroth element. The array will contain the minimum number of bytes required to represent this BigInt, including at least one sign bit.

75. #### def toChar: Char

    Returns the value of this as a scala.Char.

    Returns the value of this as a scala.Char. This may involve rounding or truncation.

    Definition Classes
      ScalaNumericAnyConversions

76. #### def toDouble: Double

    Returns the value of this as a scala.Double.

    Returns the value of this as a scala.Double. This may involve rounding or truncation.

    Definition Classes
      ScalaNumericAnyConversions

77. #### def toFloat: Float

    Returns the value of this as a scala.Float.

    Returns the value of this as a scala.Float. This may involve rounding or truncation.

    Definition Classes
      ScalaNumericAnyConversions

78. #### def toInt: Int

    Returns the value of this as an scala.Int.

    Returns the value of this as an scala.Int. This may involve rounding or truncation.

    Definition Classes
      ScalaNumericAnyConversions

79. #### def toLong: Long

    Returns the value of this as a scala.Long.

    Returns the value of this as a scala.Long. This may involve rounding or truncation.

    Definition Classes
      ScalaNumericAnyConversions

80. #### def toShort: Short

    Returns the value of this as a scala.Short.

    Returns the value of this as a scala.Short. This may involve rounding or truncation.

    Definition Classes
      ScalaNumericAnyConversions

81. #### def toString(radix: Int): String

    Returns the String representation in the specified radix of this BigInt.

82. #### def toString(): String

    Returns the decimal String representation of this BigInt.

    Returns the decimal String representation of this BigInt.

    Definition Classes
      BigInt → AnyRef → Any

83. #### def unary_-: BigInt

    Returns a BigInt whose value is the negation of this BigInt

84. #### def unary_~: BigInt

    Returns the bitwise complement of this BigInt

85. #### def underlying(): BigInteger

    Definition Classes
      BigInt → ScalaNumericConversions → ScalaNumericAnyConversions → ScalaNumber

86. #### def unifiedPrimitiveEquals(x: Any): Boolean

    Should only be called after all known non-primitive types have been excluded.

    Should only be called after all known non-primitive types have been excluded. This method won't dispatch anywhere else after checking against the primitives to avoid infinite recursion between equals and this on unknown "Number" variants.

    Additionally, this should only be called if the numeric type is happy to be converted to Long, Float, and Double. If for instance a BigInt much larger than the Long range is sent here, it will claim equality with whatever Long is left in its lower 64 bits. Or a BigDecimal with more precision than Double can hold: same thing. There's no way given the interface available here to prevent this error.

    Attributes
      protected
    Definition Classes
      ScalaNumericAnyConversions

87. #### def unifiedPrimitiveHashcode(): Int

    Attributes
      protected
    Definition Classes
      ScalaNumericAnyConversions

88. #### def until(end: BigInt, step: BigInt = BigInt(1)): Exclusive[scala.BigInt]

    Create a `NumericRange[BigInt]` in range `[start;end)` with the specified step, where start is the target BigInt.

    Create a `NumericRange[BigInt]` in range `[start;end)` with the specified step, where start is the target BigInt.

    end

      the end value of the range (exclusive)

    step

      the distance between elements (defaults to 1)

    returns

      the range

89. #### final def wait(): Unit

    Definition Classes
      AnyRef
    Annotations
      @throws( ... )

90. #### final def wait(arg0: Long, arg1: Int): Unit

    Definition Classes
      AnyRef
    Annotations
      @throws( ... )

91. #### final def wait(arg0: Long): Unit

    Definition Classes
      AnyRef
    Annotations
      @throws( ... )

92. #### def |(that: BigInt): BigInt

    Bitwise or of BigInts

93. #### def →[B](y: B): (BigInt, B)

    Implicit information
      This member is added by an implicit conversion from BigInt to ArrowAssoc[BigInt] performed by method ArrowAssoc in scala.Predef.
    Definition Classes
      ArrowAssoc

### Shadowed Implicit Value Members

1. #### def +(other: String): String

   Implicit information
     This member is added by an implicit conversion from BigInt to any2stringadd[BigInt] performed by method any2stringadd in scala.Predef.
   Shadowing
     This implicitly inherited member is shadowed by one or more members in this class.
     To access this member you can use a type ascription:

         (bigInt: any2stringadd[BigInt]).+(other)

   Definition Classes
     any2stringadd

### Inherited from Serializable

### Inherited from ScalaNumericConversions

### Inherited from ScalaNumericAnyConversions

### Inherited from ScalaNumber

### Inherited from Number

### Inherited from java.io.Serializable

### Inherited from AnyRef

### Inherited from Any

### Inherited by implicit conversion any2stringadd from BigInt to any2stringadd[BigInt]

### Inherited by implicit conversion StringFormat from BigInt to StringFormat[BigInt]

### Inherited by implicit conversion Ensuring from BigInt to Ensuring[BigInt]

### Inherited by implicit conversion ArrowAssoc from BigInt to ArrowAssoc[BigInt]

### Ungrouped