BigInteger Constructors

Definition

Namespace:

Java.Math

Assembly:

Mono.Android.dll

Overloads

BigInteger(Byte[])	Translates a byte array containing the two's-complement binary representation of a BigInteger into a BigInteger.
BigInteger(String)	Translates the decimal String representation of a BigInteger into a BigInteger.
BigInteger(Int32, Random)	Constructs a randomly generated BigInteger, uniformly distributed over the range 0 to (2<sup>numBits</sup> - 1), inclusive.
BigInteger(Int32, Byte[])	Translates the sign-magnitude representation of a BigInteger into a BigInteger.
BigInteger(IntPtr, JniHandleOwnership)	A constructor used when creating managed representations of JNI objects; called by the runtime.
BigInteger(String, Int32)	Translates the String representation of a BigInteger in the specified radix into a BigInteger.
BigInteger(Byte[], Int32, Int32)	Translates a byte sub-array containing the two's-complement binary representation of a BigInteger into a BigInteger.
BigInteger(Int32, Int32, Random)	Constructs a randomly generated positive BigInteger that is probably prime, with the specified bitLength.
BigInteger(Int32, Byte[], Int32, Int32)	Translates the sign-magnitude representation of a BigInteger into a BigInteger.

BigInteger(Byte[])

Translates a byte array containing the two's-complement binary representation of a BigInteger into a BigInteger.

[Android.Runtime.Register(".ctor", "([B)V", "")]
public BigInteger (byte[]? val);

[<Android.Runtime.Register(".ctor", "([B)V", "")>]
new Java.Math.BigInteger : byte[] -> Java.Math.BigInteger

Parameters

val

Byte[]

big-endian two's-complement binary representation of a BigInteger.

Attributes

RegisterAttribute

Exceptions

NullPointerException

if value == null.

NumberFormatException

if the length of value is zero.

Remarks

Translates a byte array containing the two's-complement binary representation of a BigInteger into a BigInteger. The input array is assumed to be in big-endian byte-order: the most significant byte is in the zeroth element. The val array is assumed to be unchanged for the duration of the constructor call.

Java documentation for java.math.BigInteger.BigInteger(.*byte[]).

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

BigInteger(String)

Translates the decimal String representation of a BigInteger into a BigInteger.

[Android.Runtime.Register(".ctor", "(Ljava/lang/String;)V", "")]
public BigInteger (string val);

[<Android.Runtime.Register(".ctor", "(Ljava/lang/String;)V", "")>]
new Java.Math.BigInteger : string -> Java.Math.BigInteger

Parameters

val

String

decimal String representation of BigInteger.

Attributes

RegisterAttribute

Exceptions

NullPointerException

if value == null.

NumberFormatException

if value is not a valid representation of a BigInteger.

Remarks

Java documentation for java.math.BigInteger.BigInteger(java.lang.String).

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

BigInteger(Int32, Random)

Constructs a randomly generated BigInteger, uniformly distributed over the range 0 to (2^numBits - 1), inclusive.

[Android.Runtime.Register(".ctor", "(ILjava/util/Random;)V", "")]
public BigInteger (int numBits, Java.Util.Random rnd);

[<Android.Runtime.Register(".ctor", "(ILjava/util/Random;)V", "")>]
new Java.Math.BigInteger : int * Java.Util.Random -> Java.Math.BigInteger

Parameters

numBits

Int32

maximum bitLength of the new BigInteger.

rnd

Random

source of randomness to be used in computing the new BigInteger.

Attributes

RegisterAttribute

Exceptions

IllegalArgumentException

if numBits

Remarks

Java documentation for java.math.BigInteger.BigInteger(int, java.util.Random).

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

BigInteger(Int32, Byte[])

Translates the sign-magnitude representation of a BigInteger into a BigInteger.

[Android.Runtime.Register(".ctor", "(I[B)V", "")]
public BigInteger (int signum, byte[]? magnitude);

[<Android.Runtime.Register(".ctor", "(I[B)V", "")>]
new Java.Math.BigInteger : int * byte[] -> Java.Math.BigInteger

Parameters

signum

Int32

signum of the number (-1 for negative, 0 for zero, 1 for positive).

magnitude

Byte[]

big-endian binary representation of the magnitude of the number.

Attributes

RegisterAttribute

Exceptions

NullPointerException

if magnitude == null.

NumberFormatException

if the sign is not one of -1, 0, 1 or if the sign is zero and the magnitude contains non-zero entries.

Remarks

Translates the sign-magnitude representation of a BigInteger into a BigInteger. The sign is represented as an integer signum value: -1 for negative, 0 for zero, or 1 for positive. The magnitude is a byte array in big-endian byte-order: the most significant byte is the zeroth element. A zero-length magnitude array is permissible, and will result in a BigInteger value of 0, whether signum is -1, 0 or 1. The magnitude array is assumed to be unchanged for the duration of the constructor call.

Java documentation for java.math.BigInteger.BigInteger(.*int, .*byte[]).

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

BigInteger(IntPtr, JniHandleOwnership)

A constructor used when creating managed representations of JNI objects; called by the runtime.

protected BigInteger (IntPtr javaReference, Android.Runtime.JniHandleOwnership transfer);

new Java.Math.BigInteger : nativeint * Android.Runtime.JniHandleOwnership -> Java.Math.BigInteger

Parameters

javaReference

IntPtr

nativeint

A IntPtrcontaining a Java Native Interface (JNI) object reference.

transfer

JniHandleOwnership

A JniHandleOwnershipindicating how to handle javaReference

Remarks

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

BigInteger(String, Int32)

Translates the String representation of a BigInteger in the specified radix into a BigInteger.

[Android.Runtime.Register(".ctor", "(Ljava/lang/String;I)V", "")]
public BigInteger (string val, int radix);

[<Android.Runtime.Register(".ctor", "(Ljava/lang/String;I)V", "")>]
new Java.Math.BigInteger : string * int -> Java.Math.BigInteger

Parameters

val

String

String representation of BigInteger.

radix

Int32

radix to be used in interpreting val.

Attributes

RegisterAttribute

Exceptions

NullPointerException

if value == null.

NumberFormatException

if value is not a valid representation of a BigInteger or if radix or radix > Character.MAX_RADIX.

Remarks

Java documentation for java.math.BigInteger.BigInteger(java.lang.String, int).

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

BigInteger(Byte[], Int32, Int32)

Translates a byte sub-array containing the two's-complement binary representation of a BigInteger into a BigInteger.

[Android.Runtime.Register(".ctor", "([BII)V", "", ApiSince=33)]
public BigInteger (byte[]? val, int off, int len);

[<Android.Runtime.Register(".ctor", "([BII)V", "", ApiSince=33)>]
new Java.Math.BigInteger : byte[] * int * int -> Java.Math.BigInteger

Parameters

val

Byte[]

byte array containing a sub-array which is the big-endian two's-complement binary representation of a BigInteger.

off

Int32

the start offset of the binary representation.

len

Int32

the number of bytes to use.

Attributes

RegisterAttribute

Remarks

Translates a byte sub-array containing the two's-complement binary representation of a BigInteger into a BigInteger. The sub-array is specified via an offset into the array and a length. The sub-array is assumed to be in big-endian byte-order: the most significant byte is the element at index off. The val array is assumed to be unchanged for the duration of the constructor call.

An IndexOutOfBoundsException is thrown if the length of the array val is non-zero and either off is negative, len is negative, or off+len is greater than the length of val.

Added in 9.

Java documentation for java.math.BigInteger.BigInteger(.*byte[], .*int, .*int).

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

BigInteger(Int32, Int32, Random)

Constructs a randomly generated positive BigInteger that is probably prime, with the specified bitLength.

[Android.Runtime.Register(".ctor", "(IILjava/util/Random;)V", "")]
public BigInteger (int bitLength, int certainty, Java.Util.Random rnd);

[<Android.Runtime.Register(".ctor", "(IILjava/util/Random;)V", "")>]
new Java.Math.BigInteger : int * int * Java.Util.Random -> Java.Math.BigInteger

Parameters

bitLength

Int32

bitLength of the returned BigInteger.

certainty

Int32

a measure of the uncertainty that the caller is willing to tolerate. The probability that the new BigInteger represents a prime number will exceed (1 - 1/2^certainty). The execution time of this constructor is proportional to the value of this parameter.

rnd

Random

source of random bits used to select candidates to be tested for primality.

Attributes

RegisterAttribute

Exceptions

ArithmeticException

if bitLength .

Remarks

Java documentation for java.math.BigInteger.BigInteger(int, int, java.util.Random).

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

BigInteger(Int32, Byte[], Int32, Int32)

Translates the sign-magnitude representation of a BigInteger into a BigInteger.

[Android.Runtime.Register(".ctor", "(I[BII)V", "", ApiSince=33)]
public BigInteger (int signum, byte[]? magnitude, int off, int len);

[<Android.Runtime.Register(".ctor", "(I[BII)V", "", ApiSince=33)>]
new Java.Math.BigInteger : int * byte[] * int * int -> Java.Math.BigInteger

Parameters

signum

Int32

signum of the number (-1 for negative, 0 for zero, 1 for positive).

magnitude

Byte[]

big-endian binary representation of the magnitude of the number.

off

Int32

the start offset of the binary representation.

len

Int32

the number of bytes to use.

Attributes

RegisterAttribute

Remarks

Translates the sign-magnitude representation of a BigInteger into a BigInteger. The sign is represented as an integer signum value: -1 for negative, 0 for zero, or 1 for positive. The magnitude is a sub-array of a byte array in big-endian byte-order: the most significant byte is the element at index off. A zero value of the length len is permissible, and will result in a BigInteger value of 0, whether signum is -1, 0 or 1. The magnitude array is assumed to be unchanged for the duration of the constructor call.

An IndexOutOfBoundsException is thrown if the length of the array magnitude is non-zero and either off is negative, len is negative, or off+len is greater than the length of magnitude.

Added in 9.

Java documentation for java.math.BigInteger.BigInteger(.*int, .*byte[], .*int, .*int).

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.