2427 lines
137 KiB
HTML
2427 lines
137 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
|
<!-- NewPage -->
|
|
<html lang="en">
|
|
<head>
|
|
<!-- Generated by javadoc (version 1.7.0_51) on Wed Apr 06 13:11:04 EDT 2016 -->
|
|
<title>BigInteger (Parallel Java 2 Library Documentation)</title>
|
|
<meta name="date" content="2016-04-06">
|
|
<link rel="stylesheet" type="text/css" href="../../../stylesheet.css" title="Style">
|
|
</head>
|
|
<body>
|
|
<script type="text/javascript"><!--
|
|
if (location.href.indexOf('is-external=true') == -1) {
|
|
parent.document.title="BigInteger (Parallel Java 2 Library Documentation)";
|
|
}
|
|
//-->
|
|
</script>
|
|
<noscript>
|
|
<div>JavaScript is disabled on your browser.</div>
|
|
</noscript>
|
|
<!-- ========= START OF TOP NAVBAR ======= -->
|
|
<div class="topNav"><a name="navbar_top">
|
|
<!-- -->
|
|
</a><a href="#skip-navbar_top" title="Skip navigation links"></a><a name="navbar_top_firstrow">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="navList" title="Navigation">
|
|
<li><a href="../../../overview-summary.html">Overview</a></li>
|
|
<li><a href="package-summary.html">Package</a></li>
|
|
<li class="navBarCell1Rev">Class</li>
|
|
<li><a href="class-use/BigInteger.html">Use</a></li>
|
|
<li><a href="package-tree.html">Tree</a></li>
|
|
<li><a href="../../../deprecated-list.html">Deprecated</a></li>
|
|
<li><a href="../../../index-files/index-1.html">Index</a></li>
|
|
<li><a href="../../../help-doc.html">Help</a></li>
|
|
</ul>
|
|
</div>
|
|
<div class="subNav">
|
|
<ul class="navList">
|
|
<li><a href="../../../edu/rit/numeric/BernoulliPrng.html" title="class in edu.rit.numeric"><span class="strong">Prev Class</span></a></li>
|
|
<li><a href="../../../edu/rit/numeric/BigInteger.Bits.html" title="interface in edu.rit.numeric"><span class="strong">Next Class</span></a></li>
|
|
</ul>
|
|
<ul class="navList">
|
|
<li><a href="../../../index.html?edu/rit/numeric/BigInteger.html" target="_top">Frames</a></li>
|
|
<li><a href="BigInteger.html" target="_top">No Frames</a></li>
|
|
</ul>
|
|
<ul class="navList" id="allclasses_navbar_top">
|
|
<li><a href="../../../allclasses-noframe.html">All Classes</a></li>
|
|
</ul>
|
|
<div>
|
|
<script type="text/javascript"><!--
|
|
allClassesLink = document.getElementById("allclasses_navbar_top");
|
|
if(window==top) {
|
|
allClassesLink.style.display = "block";
|
|
}
|
|
else {
|
|
allClassesLink.style.display = "none";
|
|
}
|
|
//-->
|
|
</script>
|
|
</div>
|
|
<div>
|
|
<ul class="subNavList">
|
|
<li>Summary: </li>
|
|
<li><a href="#nested_class_summary">Nested</a> | </li>
|
|
<li>Field | </li>
|
|
<li><a href="#constructor_summary">Constr</a> | </li>
|
|
<li><a href="#method_summary">Method</a></li>
|
|
</ul>
|
|
<ul class="subNavList">
|
|
<li>Detail: </li>
|
|
<li>Field | </li>
|
|
<li><a href="#constructor_detail">Constr</a> | </li>
|
|
<li><a href="#method_detail">Method</a></li>
|
|
</ul>
|
|
</div>
|
|
<a name="skip-navbar_top">
|
|
<!-- -->
|
|
</a></div>
|
|
<!-- ========= END OF TOP NAVBAR ========= -->
|
|
<!-- ======== START OF CLASS DATA ======== -->
|
|
<div class="header">
|
|
<div class="subTitle">edu.rit.numeric</div>
|
|
<h2 title="Class BigInteger" class="title">Class BigInteger</h2>
|
|
</div>
|
|
<div class="contentContainer">
|
|
<ul class="inheritance">
|
|
<li><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">java.lang.Object</a></li>
|
|
<li>
|
|
<ul class="inheritance">
|
|
<li>edu.rit.numeric.BigInteger</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
<div class="description">
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<dl>
|
|
<dt>All Implemented Interfaces:</dt>
|
|
<dd><a href="../../../edu/rit/io/Streamable.html" title="interface in edu.rit.io">Streamable</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Cloneable.html?is-external=true" title="class or interface in java.lang">Cloneable</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Comparable.html?is-external=true" title="class or interface in java.lang">Comparable</a><<a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a>></dd>
|
|
</dl>
|
|
<hr>
|
|
<br>
|
|
<pre>public class <span class="strong">BigInteger</span>
|
|
extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>
|
|
implements <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Comparable.html?is-external=true" title="class or interface in java.lang">Comparable</a><<a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a>>, <a href="../../../edu/rit/io/Streamable.html" title="interface in edu.rit.io">Streamable</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Cloneable.html?is-external=true" title="class or interface in java.lang">Cloneable</a></pre>
|
|
<div class="block">Class BigInteger encapsulates an unsigned fixed-precision integer. A big
|
|
integer's bit size is specified when it is constructed. The big integer's bit
|
|
size remains the same for all subsequent operations. Bit positions in the big
|
|
integer are numbered from 0 (least significant bit) to <I>n</I>−1 (most
|
|
significant bit), where <I>n</I> is the bit size.
|
|
<P>
|
|
<B>Bit truncation and extension.</B>
|
|
When a value of fewer than <I>n</I> bits is stored in a big integer of
|
|
<I>n</I> bits, the extra most significant bits of the big integer are set to
|
|
zero. When a value of more than <I>n</I> bits is stored in a big integer of
|
|
<I>n</I> bits, the extra most significant bits of the value are omitted.
|
|
<P>
|
|
<B>Comparison with java.math.BigInteger.</B>
|
|
Class edu.rit.numeric.BigInteger differs from the Java Platform class
|
|
<a href="http://docs.oracle.com/javase/7/docs/api/java/math/BigInteger.html?is-external=true" title="class or interface in java.math">java.math.BigInteger</a> in these ways:
|
|
<UL>
|
|
<P><LI>
|
|
Instances of class java.math.BigInteger are immutable; every method
|
|
constructs a new instance to hold the result. Instances of class
|
|
edu.rit.numeric.BigInteger are mutable; every operation stores the result in
|
|
the instance on which the method was called. (This helps avoid the
|
|
performance reduction from incessant constructor execution and garbage
|
|
collection when a program does numerous computations on instances of class
|
|
java.math.BigInteger.)
|
|
<P><LI>
|
|
An instance of class java.math.BigInteger can have any number of bits,
|
|
depending on the value. An instance of class edu.rit.numeric.BigInteger
|
|
always has a fixed number of bits. Consequently, an arithmetic operation will
|
|
overflow if the answer is too large to fit in the bit size of the big integer
|
|
that will hold the result.
|
|
<P><LI>
|
|
Instances of class java.math.BigInteger are signed. Instances of class
|
|
edu.rit.numeric.BigInteger are unsigned.
|
|
</UL>
|
|
<P>
|
|
<B>Hashed data structure keys.</B>
|
|
Class BigInteger provides the <a href="../../../edu/rit/numeric/BigInteger.html#equals(java.lang.Object)"><code>equals()</code></a> and <a href="../../../edu/rit/numeric/BigInteger.html#hashCode()"><code>hashCode()</code></a> methods, so a big integer can be used as a key in a
|
|
hashed data structure. However, big integers are mutable. If a big integer is
|
|
used as a key, make sure not to alter the big integer's value.
|
|
<P>
|
|
<B>Multiple threads.</B>
|
|
<I>Note:</I> Class BigInteger is not multiple thread safe.</div>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<div class="summary">
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<!-- ======== NESTED CLASS SUMMARY ======== -->
|
|
<ul class="blockList">
|
|
<li class="blockList"><a name="nested_class_summary">
|
|
<!-- -->
|
|
</a>
|
|
<h3>Nested Class Summary</h3>
|
|
<table class="overviewSummary" border="0" cellpadding="3" cellspacing="0" summary="Nested Class Summary table, listing nested classes, and an explanation">
|
|
<caption><span>Nested Classes</span><span class="tabEnd"> </span></caption>
|
|
<tr>
|
|
<th class="colFirst" scope="col">Modifier and Type</th>
|
|
<th class="colLast" scope="col">Class and Description</th>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code>static interface </code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.Bits.html" title="interface in edu.rit.numeric">BigInteger.Bits</a></strong></code>
|
|
<div class="block">Interface BigInteger.Bits specifies the interface for a group of bit
|
|
positions to be extracted from a big integer.</div>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
</li>
|
|
</ul>
|
|
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
|
|
<ul class="blockList">
|
|
<li class="blockList"><a name="constructor_summary">
|
|
<!-- -->
|
|
</a>
|
|
<h3>Constructor Summary</h3>
|
|
<table class="overviewSummary" border="0" cellpadding="3" cellspacing="0" summary="Constructor Summary table, listing constructors, and an explanation">
|
|
<caption><span>Constructors</span><span class="tabEnd"> </span></caption>
|
|
<tr>
|
|
<th class="colOne" scope="col">Constructor and Description</th>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colOne"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#BigInteger(edu.rit.numeric.BigInteger)">BigInteger</a></strong>(<a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> bigint)</code>
|
|
<div class="block">Construct a new big integer that is a copy of the given big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colOne"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#BigInteger(int)">BigInteger</a></strong>(int bitSize)</code>
|
|
<div class="block">Construct a new big integer with the given bit size and a value of 0.</div>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
</li>
|
|
</ul>
|
|
<!-- ========== METHOD SUMMARY =========== -->
|
|
<ul class="blockList">
|
|
<li class="blockList"><a name="method_summary">
|
|
<!-- -->
|
|
</a>
|
|
<h3>Method Summary</h3>
|
|
<table class="overviewSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation">
|
|
<caption><span>Methods</span><span class="tabEnd"> </span></caption>
|
|
<tr>
|
|
<th class="colFirst" scope="col">Modifier and Type</th>
|
|
<th class="colLast" scope="col">Method and Description</th>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#add(edu.rit.numeric.BigInteger)">add</a></strong>(<a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> bigint)</code>
|
|
<div class="block">Add the given big integer to this big integer and assign the result to
|
|
this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#add(int)">add</a></strong>(int n)</code>
|
|
<div class="block">Add the given unsigned integer to this big integer and assign the result
|
|
to this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#add(long)">add</a></strong>(long n)</code>
|
|
<div class="block">Add the given unsigned long integer to this big integer and assign the
|
|
result to this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#and(edu.rit.numeric.BigInteger)">and</a></strong>(<a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> bigint)</code>
|
|
<div class="block">Bitwise-and this big integer with the given big integer and assign the
|
|
result to this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#and(int)">and</a></strong>(int n)</code>
|
|
<div class="block">Bitwise-and this big integer with the given unsigned integer and assign
|
|
the result to this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#and(long)">and</a></strong>(long n)</code>
|
|
<div class="block">Bitwise-and this big integer with the given unsigned long integer and
|
|
assign the result to this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#andNot(edu.rit.numeric.BigInteger)">andNot</a></strong>(<a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> bigint)</code>
|
|
<div class="block">Bitwise-and this big integer with the complement of the given big integer
|
|
and assign the result to this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#andNot(int)">andNot</a></strong>(int n)</code>
|
|
<div class="block">Bitwise-and this big integer with the complement of the given unsigned
|
|
integer and assign the result to this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#andNot(long)">andNot</a></strong>(long n)</code>
|
|
<div class="block">Bitwise-and this big integer with the complement of the given unsigned
|
|
long integer and assign the result to this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#assign(edu.rit.numeric.BigInteger)">assign</a></strong>(<a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> bigint)</code>
|
|
<div class="block">Assign the given big integer to this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#assign(int)">assign</a></strong>(int v)</code>
|
|
<div class="block">Assign the given unsigned <TT>int</TT> value to this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#assign(long)">assign</a></strong>(long v)</code>
|
|
<div class="block">Assign the given unsigned <TT>long</TT> value to this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#assign(edu.rit.util.Random)">assign</a></strong>(<a href="../../../edu/rit/util/Random.html" title="class in edu.rit.util">Random</a> prng)</code>
|
|
<div class="block">Assign to this big integer a random value obtained from the given PRNG.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#assign(java.lang.String)">assign</a></strong>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> s)</code>
|
|
<div class="block">Assign to this big integer the value parsed from the given decimal
|
|
string.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#assignHex(java.lang.String)">assignHex</a></strong>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> s)</code>
|
|
<div class="block">Assign to this big integer the value parsed from the given hexadecimal
|
|
string.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#assignMersenne(int)">assignMersenne</a></strong>(int n)</code>
|
|
<div class="block">Assign the Mersenne number 2<SUP><I>n</I></SUP>−1 to this big
|
|
integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#assignPowerOfTwo(int)">assignPowerOfTwo</a></strong>(int n)</code>
|
|
<div class="block">Assign the value 2<SUP><I>n</I></SUP> to this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#assignZero()">assignZero</a></strong>()</code>
|
|
<div class="block">Assign the value 0 to this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code>int</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#bitSize()">bitSize</a></strong>()</code>
|
|
<div class="block">Returns the size of this big integer in bits.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#clearBit(int)">clearBit</a></strong>(int pos)</code>
|
|
<div class="block">Clear the given bit in this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#clone()">clone</a></strong>()</code>
|
|
<div class="block">Returns a clone of this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code>int</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#compareTo(edu.rit.numeric.BigInteger)">compareTo</a></strong>(<a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> bigint)</code>
|
|
<div class="block">Compare this big integer to the given big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code>int</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#compareTo(int)">compareTo</a></strong>(int n)</code>
|
|
<div class="block">Compare this big integer to the given unsigned integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code>int</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#compareTo(long)">compareTo</a></strong>(long n)</code>
|
|
<div class="block">Compare this big integer to the given unsigned long integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#decrement()">decrement</a></strong>()</code>
|
|
<div class="block">Decrement this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#div(edu.rit.numeric.BigInteger)">div</a></strong>(<a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> divisor)</code>
|
|
<div class="block">Divide this big integer by the given big integer and assign the quotient
|
|
to this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#div(int)">div</a></strong>(int divisor)</code>
|
|
<div class="block">Divide this big integer by the given unsigned integer and assign the
|
|
quotient to this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#div(long)">div</a></strong>(long divisor)</code>
|
|
<div class="block">Divide this big integer by the given unsigned long integer and assign the
|
|
quotient to this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#divRem(edu.rit.numeric.BigInteger, edu.rit.numeric.BigInteger)">divRem</a></strong>(<a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> divisor,
|
|
<a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> remainder)</code>
|
|
<div class="block">Divide this big integer by the given big integer and assign the quotient
|
|
to this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code>int</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#divRem(int)">divRem</a></strong>(int divisor)</code>
|
|
<div class="block">Divide this big integer by the given unsigned integer and assign the
|
|
quotient to this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code>long</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#divRem(long)">divRem</a></strong>(long divisor)</code>
|
|
<div class="block">Divide this big integer by the given unsigned long integer and assign the
|
|
quotient to this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code>double</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#doubleValue()">doubleValue</a></strong>()</code>
|
|
<div class="block">Convert this big integer to a <TT>double</TT>.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code>boolean</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#equals(java.lang.Object)">equals</a></strong>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> obj)</code>
|
|
<div class="block">Determine if this big integer is equal to the given object.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code>boolean</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#eqZero()">eqZero</a></strong>()</code>
|
|
<div class="block">Determine if this big integer's value is equal to 0.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#extractBits(edu.rit.numeric.BigInteger, edu.rit.numeric.BigInteger.Bits)">extractBits</a></strong>(<a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> bigint,
|
|
<a href="../../../edu/rit/numeric/BigInteger.Bits.html" title="interface in edu.rit.numeric">BigInteger.Bits</a> bits)</code>
|
|
<div class="block">Extract the given bits from the given big integer and assign them to this
|
|
big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#extractBits(edu.rit.numeric.BigInteger, int[])">extractBits</a></strong>(<a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> bigint,
|
|
int[] pos)</code>
|
|
<div class="block">Extract the given bits from the given big integer and assign them to this
|
|
big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#flipBit(int)">flipBit</a></strong>(int pos)</code>
|
|
<div class="block">Flip the given bit in this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code>float</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#floatValue()">floatValue</a></strong>()</code>
|
|
<div class="block">Convert this big integer to a <TT>float</TT>.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#gcd(edu.rit.numeric.BigInteger)">gcd</a></strong>(<a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> bigint)</code>
|
|
<div class="block">Assign to this big integer the greatest common denominator (GCD) of this
|
|
big integer and the given big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code>int</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#getBit(int)">getBit</a></strong>(int pos)</code>
|
|
<div class="block">Get the given bit in this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code>int</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#hashCode()">hashCode</a></strong>()</code>
|
|
<div class="block">Returns a hash code for this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#increment()">increment</a></strong>()</code>
|
|
<div class="block">Increment this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code>int</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#intValue()">intValue</a></strong>()</code>
|
|
<div class="block">Convert this big integer to an unsigned <TT>int</TT>.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code>int</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#leftmostOne()">leftmostOne</a></strong>()</code>
|
|
<div class="block">Returns the position of the leftmost 1 bit in this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#leftRotate(int)">leftRotate</a></strong>(int shift)</code>
|
|
<div class="block">Left-rotate this big integer by the given amount.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#leftShift(int)">leftShift</a></strong>(int shift)</code>
|
|
<div class="block">Left-shift this big integer by the given amount.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code>long</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#longValue()">longValue</a></strong>()</code>
|
|
<div class="block">Convert this big integer to an unsigned <TT>long</TT>.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#max(edu.rit.numeric.BigInteger)">max</a></strong>(<a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> bigint)</code>
|
|
<div class="block">Assign to this big integer the larger of this big integer and the given
|
|
big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#min(edu.rit.numeric.BigInteger)">min</a></strong>(<a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> bigint)</code>
|
|
<div class="block">Assign to this big integer the smaller of this big integer and the given
|
|
big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#mul(edu.rit.numeric.BigInteger)">mul</a></strong>(<a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> bigint)</code>
|
|
<div class="block">Multiply the given big integer by this big integer and assign the result
|
|
to this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#mul(int)">mul</a></strong>(int n)</code>
|
|
<div class="block">Multiply the given unsigned integer by this big integer and assign the
|
|
result to this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#mul(long)">mul</a></strong>(long n)</code>
|
|
<div class="block">Multiply the given unsigned long integer by this big integer and assign
|
|
the result to this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#neg()">neg</a></strong>()</code>
|
|
<div class="block">Negate this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#not()">not</a></strong>()</code>
|
|
<div class="block">Set this big integer to its complement.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#or(edu.rit.numeric.BigInteger)">or</a></strong>(<a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> bigint)</code>
|
|
<div class="block">Bitwise-or this big integer with the given big integer and assign the
|
|
result to this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#or(int)">or</a></strong>(int n)</code>
|
|
<div class="block">Bitwise-or this big integer with the given unsigned integer and assign
|
|
the result to this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#or(long)">or</a></strong>(long n)</code>
|
|
<div class="block">Bitwise-or this big integer with the given unsigned long integer and
|
|
assign the result to this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#pack(byte[])">pack</a></strong>(byte[] v)</code>
|
|
<div class="block">Pack the value obtained from the given byte array into this big integer
|
|
in little-endian order.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#pack(int[])">pack</a></strong>(int[] v)</code>
|
|
<div class="block">Pack the value obtained from the given integer array into this big
|
|
integer in little-endian order.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#pack(long[])">pack</a></strong>(long[] v)</code>
|
|
<div class="block">Pack the value obtained from the given long array into this big integer
|
|
in little-endian order.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#pack(short[])">pack</a></strong>(short[] v)</code>
|
|
<div class="block">Pack the value obtained from the given short array into this big integer
|
|
in little-endian order.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#packBigEndian(byte[])">packBigEndian</a></strong>(byte[] v)</code>
|
|
<div class="block">Pack the value obtained from the given byte array into this big integer
|
|
in big-endian order.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#packBigEndian(int[])">packBigEndian</a></strong>(int[] v)</code>
|
|
<div class="block">Pack the value obtained from the given integer array into this big
|
|
integer in big-endian order.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#packBigEndian(long[])">packBigEndian</a></strong>(long[] v)</code>
|
|
<div class="block">Pack the value obtained from the given long array into this big integer
|
|
in big-endian order.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#packBigEndian(short[])">packBigEndian</a></strong>(short[] v)</code>
|
|
<div class="block">Pack the value obtained from the given short array into this big integer
|
|
in big-endian order.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code>int</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#popCount()">popCount</a></strong>()</code>
|
|
<div class="block">Returns this big integer's population count.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#putBit(int, int)">putBit</a></strong>(int pos,
|
|
int bit)</code>
|
|
<div class="block">Put the given bit into this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#readIn(edu.rit.io.InStream)">readIn</a></strong>(<a href="../../../edu/rit/io/InStream.html" title="class in edu.rit.io">InStream</a> in)</code>
|
|
<div class="block">Read this big integer from the given in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#rem(edu.rit.numeric.BigInteger)">rem</a></strong>(<a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> divisor)</code>
|
|
<div class="block">Divide this big integer by the given big integer and assign the remainder
|
|
to this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#rem(int)">rem</a></strong>(int divisor)</code>
|
|
<div class="block">Divide this big integer by the given unsigned integer and assign the
|
|
remainder to this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#rem(long)">rem</a></strong>(long divisor)</code>
|
|
<div class="block">Divide this big integer by the given unsigned long integer and assign the
|
|
remainder to this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code>int</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#rightmostOne()">rightmostOne</a></strong>()</code>
|
|
<div class="block">Returns the position of the rightmost 1 bit in this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#rightRotate(int)">rightRotate</a></strong>(int shift)</code>
|
|
<div class="block">Right-rotate this big integer by the given amount.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#rightShift(int)">rightShift</a></strong>(int shift)</code>
|
|
<div class="block">Right-shift this big integer by the given amount.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#setBit(int)">setBit</a></strong>(int pos)</code>
|
|
<div class="block">Set the given bit in this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#sub(edu.rit.numeric.BigInteger)">sub</a></strong>(<a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> bigint)</code>
|
|
<div class="block">Subtract the given big integer from this big integer and assign the
|
|
result to this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#sub(int)">sub</a></strong>(int n)</code>
|
|
<div class="block">Subtract the given unsigned integer from this big integer and assign the
|
|
result to this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#sub(long)">sub</a></strong>(long n)</code>
|
|
<div class="block">Subtract the given unsigned long integer from this big integer and assign
|
|
the result to this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code>boolean</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#testBit(int)">testBit</a></strong>(int pos)</code>
|
|
<div class="block">Test the given bit in this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#toString()">toString</a></strong>()</code>
|
|
<div class="block">Returns a string version of this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#toStringHex()">toStringHex</a></strong>()</code>
|
|
<div class="block">Returns a string version of this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#unpack(byte[])">unpack</a></strong>(byte[] v)</code>
|
|
<div class="block">Unpack this big integer's value into the given byte array in
|
|
little-endian order.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#unpack(int[])">unpack</a></strong>(int[] v)</code>
|
|
<div class="block">Unpack this big integer's value into the given integer array in
|
|
little-endian order.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#unpack(long[])">unpack</a></strong>(long[] v)</code>
|
|
<div class="block">Unpack this big integer's value into the given long array in
|
|
little-endian order.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#unpack(short[])">unpack</a></strong>(short[] v)</code>
|
|
<div class="block">Unpack this big integer's value into the given short array in
|
|
little-endian order.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#unpackBigEndian(byte[])">unpackBigEndian</a></strong>(byte[] v)</code>
|
|
<div class="block">Unpack this big integer's value into the given byte array in big-endian
|
|
order.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#unpackBigEndian(int[])">unpackBigEndian</a></strong>(int[] v)</code>
|
|
<div class="block">Unpack this big integer's value into the given integer array in
|
|
big-endian order.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#unpackBigEndian(long[])">unpackBigEndian</a></strong>(long[] v)</code>
|
|
<div class="block">Unpack this big integer's value into the given long array in big-endian
|
|
order.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#unpackBigEndian(short[])">unpackBigEndian</a></strong>(short[] v)</code>
|
|
<div class="block">Unpack this big integer's value into the given short array in big-endian
|
|
order.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code>int</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#wordSize()">wordSize</a></strong>()</code>
|
|
<div class="block">Returns the size of this big integer in 32-bit words.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code>static int</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#wordSize(int)">wordSize</a></strong>(int bitSize)</code>
|
|
<div class="block">Returns the word size of a big integer with the given bit size.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#writeOut(edu.rit.io.OutStream)">writeOut</a></strong>(<a href="../../../edu/rit/io/OutStream.html" title="class in edu.rit.io">OutStream</a> out)</code>
|
|
<div class="block">Write this big integer to the given out stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#xor(edu.rit.numeric.BigInteger)">xor</a></strong>(<a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> bigint)</code>
|
|
<div class="block">Bitwise-exclusive-or this big integer with the given big integer and
|
|
assign the result to this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#xor(int)">xor</a></strong>(int n)</code>
|
|
<div class="block">Bitwise-exclusive-or this big integer with the given unsigned integer and
|
|
assign the result to this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code><a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/numeric/BigInteger.html#xor(long)">xor</a></strong>(long n)</code>
|
|
<div class="block">Bitwise-exclusive-or this big integer with the given unsigned long
|
|
integer and assign the result to this big integer.</div>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
<ul class="blockList">
|
|
<li class="blockList"><a name="methods_inherited_from_class_java.lang.Object">
|
|
<!-- -->
|
|
</a>
|
|
<h3>Methods inherited from class java.lang.<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></h3>
|
|
<code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#finalize()" title="class or interface in java.lang">finalize</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#getClass()" title="class or interface in java.lang">getClass</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#notify()" title="class or interface in java.lang">notify</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#notifyAll()" title="class or interface in java.lang">notifyAll</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#wait()" title="class or interface in java.lang">wait</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#wait(long)" title="class or interface in java.lang">wait</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#wait(long, int)" title="class or interface in java.lang">wait</a></code></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<div class="details">
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<!-- ========= CONSTRUCTOR DETAIL ======== -->
|
|
<ul class="blockList">
|
|
<li class="blockList"><a name="constructor_detail">
|
|
<!-- -->
|
|
</a>
|
|
<h3>Constructor Detail</h3>
|
|
<a name="BigInteger(int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>BigInteger</h4>
|
|
<pre>public BigInteger(int bitSize)</pre>
|
|
<div class="block">Construct a new big integer with the given bit size and a value of 0.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>bitSize</code> - Bit size.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</a></code> - (unchecked exception) Thrown if <TT>bitSize</TT> < 1.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="BigInteger(edu.rit.numeric.BigInteger)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockListLast">
|
|
<li class="blockList">
|
|
<h4>BigInteger</h4>
|
|
<pre>public BigInteger(<a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> bigint)</pre>
|
|
<div class="block">Construct a new big integer that is a copy of the given big integer.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>bigint</code> - Big integer to copy.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>bigint</TT> is null.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
<!-- ============ METHOD DETAIL ========== -->
|
|
<ul class="blockList">
|
|
<li class="blockList"><a name="method_detail">
|
|
<!-- -->
|
|
</a>
|
|
<h3>Method Detail</h3>
|
|
<a name="clone()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>clone</h4>
|
|
<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> clone()</pre>
|
|
<div class="block">Returns a clone of this big integer.</div>
|
|
<dl>
|
|
<dt><strong>Overrides:</strong></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#clone()" title="class or interface in java.lang">clone</a></code> in class <code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></code></dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>Clone.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="bitSize()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>bitSize</h4>
|
|
<pre>public int bitSize()</pre>
|
|
<div class="block">Returns the size of this big integer in bits.</div>
|
|
<dl><dt><span class="strong">Returns:</span></dt><dd>Bit size.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="wordSize()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>wordSize</h4>
|
|
<pre>public int wordSize()</pre>
|
|
<div class="block">Returns the size of this big integer in 32-bit words.</div>
|
|
<dl><dt><span class="strong">Returns:</span></dt><dd>Word size.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="wordSize(int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>wordSize</h4>
|
|
<pre>public static int wordSize(int bitSize)</pre>
|
|
<div class="block">Returns the word size of a big integer with the given bit size. The word
|
|
size is <TT>bitSize</TT>/32 rounded up to the nearest integer, except the
|
|
minimum word size is 2.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>bitSize</code> - Bit size.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>Word size.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="intValue()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>intValue</h4>
|
|
<pre>public int intValue()</pre>
|
|
<div class="block">Convert this big integer to an unsigned <TT>int</TT>.</div>
|
|
<dl><dt><span class="strong">Returns:</span></dt><dd>Unsigned integer value.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="longValue()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>longValue</h4>
|
|
<pre>public long longValue()</pre>
|
|
<div class="block">Convert this big integer to an unsigned <TT>long</TT>.</div>
|
|
<dl><dt><span class="strong">Returns:</span></dt><dd>Unsigned long integer value.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="floatValue()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>floatValue</h4>
|
|
<pre>public float floatValue()</pre>
|
|
<div class="block">Convert this big integer to a <TT>float</TT>.</div>
|
|
<dl><dt><span class="strong">Returns:</span></dt><dd>Float value.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="doubleValue()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>doubleValue</h4>
|
|
<pre>public double doubleValue()</pre>
|
|
<div class="block">Convert this big integer to a <TT>double</TT>.</div>
|
|
<dl><dt><span class="strong">Returns:</span></dt><dd>Double value.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="assignZero()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>assignZero</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> assignZero()</pre>
|
|
<div class="block">Assign the value 0 to this big integer.</div>
|
|
<dl><dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="assign(int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>assign</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> assign(int v)</pre>
|
|
<div class="block">Assign the given unsigned <TT>int</TT> value to this big integer.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - <TT>int</TT> value.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="assign(long)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>assign</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> assign(long v)</pre>
|
|
<div class="block">Assign the given unsigned <TT>long</TT> value to this big integer.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - <TT>long</TT> value.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="assign(edu.rit.numeric.BigInteger)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>assign</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> assign(<a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> bigint)</pre>
|
|
<div class="block">Assign the given big integer to this big integer.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>bigint</code> - Big integer to assign.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>bigint</TT> is null.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="assign(java.lang.String)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>assign</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> assign(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> s)</pre>
|
|
<div class="block">Assign to this big integer the value parsed from the given decimal
|
|
string.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>s</code> - String.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>s</TT> is null.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NumberFormatException.html?is-external=true" title="class or interface in java.lang">NumberFormatException</a></code> - (unchecked exception) Thrown if <TT>s</TT> is zero-length. Thrown if
|
|
<TT>s</TT> contains characters other than decimal digits.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="assignHex(java.lang.String)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>assignHex</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> assignHex(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> s)</pre>
|
|
<div class="block">Assign to this big integer the value parsed from the given hexadecimal
|
|
string.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>s</code> - String.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>s</TT> is null.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NumberFormatException.html?is-external=true" title="class or interface in java.lang">NumberFormatException</a></code> - (unchecked exception) Thrown if <TT>s</TT> is zero-length. Thrown if
|
|
<TT>s</TT> contains characters other than hexadecimal digits.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="assign(edu.rit.util.Random)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>assign</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> assign(<a href="../../../edu/rit/util/Random.html" title="class in edu.rit.util">Random</a> prng)</pre>
|
|
<div class="block">Assign to this big integer a random value obtained from the given PRNG.
|
|
The value is chosen uniformly at random in the range 0 through
|
|
2<SUP><I>n</I></SUP>−1, where <I>n</I> is this big integer's bit
|
|
size.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>prng</code> - Pseudorandom number generator.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>prng</TT> is null.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="assignPowerOfTwo(int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>assignPowerOfTwo</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> assignPowerOfTwo(int n)</pre>
|
|
<div class="block">Assign the value 2<SUP><I>n</I></SUP> to this big integer.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>n</code> - Power of 2 in the range 0 ..
|
|
<a href="../../../edu/rit/numeric/BigInteger.html#bitSize()"><code>bitSize()</code></a>−1.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</a></code> - (unchecked exception) Thrown if <TT>n</TT> is out of range.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="assignMersenne(int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>assignMersenne</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> assignMersenne(int n)</pre>
|
|
<div class="block">Assign the Mersenne number 2<SUP><I>n</I></SUP>−1 to this big
|
|
integer.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>n</code> - Power of 2 in the range 0 ..
|
|
<a href="../../../edu/rit/numeric/BigInteger.html#bitSize()"><code>bitSize()</code></a>.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</a></code> - (unchecked exception) Thrown if <TT>n</TT> is out of range.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="rightShift(int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>rightShift</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> rightShift(int shift)</pre>
|
|
<div class="block">Right-shift this big integer by the given amount. The most significant
|
|
bits are filled in with 0s.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>shift</code> - Number of bit positions to right-shift.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</a></code> - (unchecked exception) Thrown if <TT>shift</TT> < 0.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="leftShift(int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>leftShift</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> leftShift(int shift)</pre>
|
|
<div class="block">Left-shift this big integer by the given amount. The least significant
|
|
bits are filled in with 0s.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>shift</code> - Number of bit positions to left-shift.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</a></code> - (unchecked exception) Thrown if <TT>shift</TT> < 0.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="rightRotate(int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>rightRotate</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> rightRotate(int shift)</pre>
|
|
<div class="block">Right-rotate this big integer by the given amount.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>shift</code> - Number of bit positions to right-rotate.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</a></code> - (unchecked exception) Thrown if <TT>shift</TT> < 0.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="leftRotate(int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>leftRotate</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> leftRotate(int shift)</pre>
|
|
<div class="block">Left-rotate this big integer by the given amount.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>shift</code> - Number of bit positions to left-rotate.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</a></code> - (unchecked exception) Thrown if <TT>shift</TT> < 0.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="getBit(int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>getBit</h4>
|
|
<pre>public int getBit(int pos)</pre>
|
|
<div class="block">Get the given bit in this big integer.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>pos</code> - Bit position to get, in the range 0 ..
|
|
<a href="../../../edu/rit/numeric/BigInteger.html#bitSize()"><code>bitSize()</code></a>−1.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>Bit value, either 0 or 1.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/IndexOutOfBoundsException.html?is-external=true" title="class or interface in java.lang">IndexOutOfBoundsException</a></code> - (unchecked exception) Thrown if <TT>pos</TT> is out of bounds.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="testBit(int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>testBit</h4>
|
|
<pre>public boolean testBit(int pos)</pre>
|
|
<div class="block">Test the given bit in this big integer.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>pos</code> - Bit position to test, in the range 0 ..
|
|
<a href="../../../edu/rit/numeric/BigInteger.html#bitSize()"><code>bitSize()</code></a>−1.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>True if the bit value is 1, false if the bit value is 0.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/IndexOutOfBoundsException.html?is-external=true" title="class or interface in java.lang">IndexOutOfBoundsException</a></code> - (unchecked exception) Thrown if <TT>pos</TT> is out of bounds.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="putBit(int, int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>putBit</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> putBit(int pos,
|
|
int bit)</pre>
|
|
<div class="block">Put the given bit into this big integer.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>pos</code> - Bit position to put, in the range 0 ..
|
|
<a href="../../../edu/rit/numeric/BigInteger.html#bitSize()"><code>bitSize()</code></a>−1.</dd><dd><code>bit</code> - Bit value, either 0 or 1.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/IndexOutOfBoundsException.html?is-external=true" title="class or interface in java.lang">IndexOutOfBoundsException</a></code> - (unchecked exception) Thrown if <TT>pos</TT> is out of bounds.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</a></code> - (unchecked exception) Thrown if <TT>bit</TT> is not 0 or 1.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="clearBit(int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>clearBit</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> clearBit(int pos)</pre>
|
|
<div class="block">Clear the given bit in this big integer. The bit's value becomes 0.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>pos</code> - Bit position to clear, in the range 0 ..
|
|
<a href="../../../edu/rit/numeric/BigInteger.html#bitSize()"><code>bitSize()</code></a>−1.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/IndexOutOfBoundsException.html?is-external=true" title="class or interface in java.lang">IndexOutOfBoundsException</a></code> - (unchecked exception) Thrown if <TT>pos</TT> is out of bounds.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="setBit(int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>setBit</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> setBit(int pos)</pre>
|
|
<div class="block">Set the given bit in this big integer. The bit's value becomes 1.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>pos</code> - Bit position to set, in the range 0 ..
|
|
<a href="../../../edu/rit/numeric/BigInteger.html#bitSize()"><code>bitSize()</code></a>−1.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/IndexOutOfBoundsException.html?is-external=true" title="class or interface in java.lang">IndexOutOfBoundsException</a></code> - (unchecked exception) Thrown if <TT>pos</TT> is out of bounds.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="flipBit(int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>flipBit</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> flipBit(int pos)</pre>
|
|
<div class="block">Flip the given bit in this big integer. The bit's value becomes its
|
|
opposite.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>pos</code> - Bit position to flip, in the range 0 ..
|
|
<a href="../../../edu/rit/numeric/BigInteger.html#bitSize()"><code>bitSize()</code></a>−1.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/IndexOutOfBoundsException.html?is-external=true" title="class or interface in java.lang">IndexOutOfBoundsException</a></code> - (unchecked exception) Thrown if <TT>pos</TT> is out of bounds.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="neg()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>neg</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> neg()</pre>
|
|
<div class="block">Negate this big integer.</div>
|
|
<dl><dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="increment()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>increment</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> increment()</pre>
|
|
<div class="block">Increment this big integer.</div>
|
|
<dl><dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="decrement()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>decrement</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> decrement()</pre>
|
|
<div class="block">Decrement this big integer.</div>
|
|
<dl><dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="add(int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>add</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> add(int n)</pre>
|
|
<div class="block">Add the given unsigned integer to this big integer and assign the result
|
|
to this big integer.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>n</code> - Integer to add.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="add(long)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>add</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> add(long n)</pre>
|
|
<div class="block">Add the given unsigned long integer to this big integer and assign the
|
|
result to this big integer.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>n</code> - Long integer to add.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="add(edu.rit.numeric.BigInteger)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>add</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> add(<a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> bigint)</pre>
|
|
<div class="block">Add the given big integer to this big integer and assign the result to
|
|
this big integer.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>bigint</code> - Big integer to add.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>bigint</TT> is null.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="sub(int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>sub</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> sub(int n)</pre>
|
|
<div class="block">Subtract the given unsigned integer from this big integer and assign the
|
|
result to this big integer.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>n</code> - Integer to subtract.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="sub(long)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>sub</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> sub(long n)</pre>
|
|
<div class="block">Subtract the given unsigned long integer from this big integer and assign
|
|
the result to this big integer.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>n</code> - Long integer to subtract.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="sub(edu.rit.numeric.BigInteger)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>sub</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> sub(<a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> bigint)</pre>
|
|
<div class="block">Subtract the given big integer from this big integer and assign the
|
|
result to this big integer.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>bigint</code> - Big integer to subtract.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>bigint</TT> is null.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="mul(int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>mul</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> mul(int n)</pre>
|
|
<div class="block">Multiply the given unsigned integer by this big integer and assign the
|
|
result to this big integer.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>n</code> - Integer to multiply.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="mul(long)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>mul</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> mul(long n)</pre>
|
|
<div class="block">Multiply the given unsigned long integer by this big integer and assign
|
|
the result to this big integer.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>n</code> - Long integer to multiply.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="mul(edu.rit.numeric.BigInteger)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>mul</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> mul(<a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> bigint)</pre>
|
|
<div class="block">Multiply the given big integer by this big integer and assign the result
|
|
to this big integer.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>bigint</code> - Big integer to multiply.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>bigint</TT> is null.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="div(int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>div</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> div(int divisor)</pre>
|
|
<div class="block">Divide this big integer by the given unsigned integer and assign the
|
|
quotient to this big integer. The remainder is discarded.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>divisor</code> - Unsigned integer divisor.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/ArithmeticException.html?is-external=true" title="class or interface in java.lang">ArithmeticException</a></code> - (unchecked exception) Thrown if <TT>divisor</TT> is zero.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="div(long)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>div</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> div(long divisor)</pre>
|
|
<div class="block">Divide this big integer by the given unsigned long integer and assign the
|
|
quotient to this big integer. The remainder is discarded.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>divisor</code> - Unsigned long integer divisor.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/ArithmeticException.html?is-external=true" title="class or interface in java.lang">ArithmeticException</a></code> - (unchecked exception) Thrown if <TT>divisor</TT> is zero.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="div(edu.rit.numeric.BigInteger)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>div</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> div(<a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> divisor)</pre>
|
|
<div class="block">Divide this big integer by the given big integer and assign the quotient
|
|
to this big integer. The remainder is discarded.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>divisor</code> - Big integer divisor.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>divisor</TT> is null.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/ArithmeticException.html?is-external=true" title="class or interface in java.lang">ArithmeticException</a></code> - (unchecked exception) Thrown if <TT>divisor</TT> is zero.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="divRem(int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>divRem</h4>
|
|
<pre>public int divRem(int divisor)</pre>
|
|
<div class="block">Divide this big integer by the given unsigned integer and assign the
|
|
quotient to this big integer. The remainder is returned.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>divisor</code> - Unsigned integer divisor.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>Unsigned integer remainder.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/ArithmeticException.html?is-external=true" title="class or interface in java.lang">ArithmeticException</a></code> - (unchecked exception) Thrown if <TT>divisor</TT> is zero.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="divRem(long)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>divRem</h4>
|
|
<pre>public long divRem(long divisor)</pre>
|
|
<div class="block">Divide this big integer by the given unsigned long integer and assign the
|
|
quotient to this big integer. The remainder is returned.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>divisor</code> - Unsigned long integer divisor.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>Unsigned long integer remainder.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/ArithmeticException.html?is-external=true" title="class or interface in java.lang">ArithmeticException</a></code> - (unchecked exception) Thrown if <TT>divisor</TT> is zero.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="divRem(edu.rit.numeric.BigInteger, edu.rit.numeric.BigInteger)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>divRem</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> divRem(<a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> divisor,
|
|
<a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> remainder)</pre>
|
|
<div class="block">Divide this big integer by the given big integer and assign the quotient
|
|
to this big integer. The remainder is assigned to <TT>remainder</TT>.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>divisor</code> - Big integer divisor.</dd><dd><code>remainder</code> - Big integer remainder.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>divisor</TT> is null. Thrown if
|
|
<TT>remainder</TT> is null.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/ArithmeticException.html?is-external=true" title="class or interface in java.lang">ArithmeticException</a></code> - (unchecked exception) Thrown if <TT>divisor</TT> is zero.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="rem(int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>rem</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> rem(int divisor)</pre>
|
|
<div class="block">Divide this big integer by the given unsigned integer and assign the
|
|
remainder to this big integer. The quotient is discarded.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>divisor</code> - Integer divisor.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/ArithmeticException.html?is-external=true" title="class or interface in java.lang">ArithmeticException</a></code> - (unchecked exception) Thrown if <TT>divisor</TT> is zero.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="rem(long)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>rem</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> rem(long divisor)</pre>
|
|
<div class="block">Divide this big integer by the given unsigned long integer and assign the
|
|
remainder to this big integer. The quotient is discarded.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>divisor</code> - Long integer divisor.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/ArithmeticException.html?is-external=true" title="class or interface in java.lang">ArithmeticException</a></code> - (unchecked exception) Thrown if <TT>divisor</TT> is zero.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="rem(edu.rit.numeric.BigInteger)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>rem</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> rem(<a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> divisor)</pre>
|
|
<div class="block">Divide this big integer by the given big integer and assign the remainder
|
|
to this big integer. The quotient is discarded.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>divisor</code> - Big integer divisor.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>divisor</TT> is null.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/ArithmeticException.html?is-external=true" title="class or interface in java.lang">ArithmeticException</a></code> - (unchecked exception) Thrown if <TT>divisor</TT> is zero.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="gcd(edu.rit.numeric.BigInteger)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>gcd</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> gcd(<a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> bigint)</pre>
|
|
<div class="block">Assign to this big integer the greatest common denominator (GCD) of this
|
|
big integer and the given big integer. If this big integer is zero or
|
|
<TT>bigint</TT> is zero, this big integer is set to zero.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>bigint</code> - Big integer.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>bigint</TT> is null.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="min(edu.rit.numeric.BigInteger)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>min</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> min(<a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> bigint)</pre>
|
|
<div class="block">Assign to this big integer the smaller of this big integer and the given
|
|
big integer.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>bigint</code> - Big integer to compare.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>bigint</TT> is null.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="max(edu.rit.numeric.BigInteger)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>max</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> max(<a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> bigint)</pre>
|
|
<div class="block">Assign to this big integer the larger of this big integer and the given
|
|
big integer.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>bigint</code> - Big integer to compare.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>bigint</TT> is null.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="not()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>not</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> not()</pre>
|
|
<div class="block">Set this big integer to its complement.</div>
|
|
<dl><dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="xor(int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>xor</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> xor(int n)</pre>
|
|
<div class="block">Bitwise-exclusive-or this big integer with the given unsigned integer and
|
|
assign the result to this big integer.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>n</code> - Integer to bitwise-exclusive-or.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="xor(long)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>xor</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> xor(long n)</pre>
|
|
<div class="block">Bitwise-exclusive-or this big integer with the given unsigned long
|
|
integer and assign the result to this big integer.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>n</code> - Long integer to bitwise-exclusive-or.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="xor(edu.rit.numeric.BigInteger)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>xor</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> xor(<a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> bigint)</pre>
|
|
<div class="block">Bitwise-exclusive-or this big integer with the given big integer and
|
|
assign the result to this big integer.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>bigint</code> - Big integer to bitwise-exclusive-or.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>bigint</TT> is null.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="or(int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>or</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> or(int n)</pre>
|
|
<div class="block">Bitwise-or this big integer with the given unsigned integer and assign
|
|
the result to this big integer.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>n</code> - Integer to bitwise-or.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="or(long)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>or</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> or(long n)</pre>
|
|
<div class="block">Bitwise-or this big integer with the given unsigned long integer and
|
|
assign the result to this big integer.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>n</code> - Long integer to bitwise-or.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="or(edu.rit.numeric.BigInteger)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>or</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> or(<a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> bigint)</pre>
|
|
<div class="block">Bitwise-or this big integer with the given big integer and assign the
|
|
result to this big integer.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>bigint</code> - Big integer to bitwise-or.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>bigint</TT> is null.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="and(int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>and</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> and(int n)</pre>
|
|
<div class="block">Bitwise-and this big integer with the given unsigned integer and assign
|
|
the result to this big integer.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>n</code> - Integer to bitwise-and.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="and(long)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>and</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> and(long n)</pre>
|
|
<div class="block">Bitwise-and this big integer with the given unsigned long integer and
|
|
assign the result to this big integer.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>n</code> - Long integer to bitwise-and.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="and(edu.rit.numeric.BigInteger)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>and</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> and(<a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> bigint)</pre>
|
|
<div class="block">Bitwise-and this big integer with the given big integer and assign the
|
|
result to this big integer.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>bigint</code> - Big integer to bitwise-and.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>bigint</TT> is null.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="andNot(int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>andNot</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> andNot(int n)</pre>
|
|
<div class="block">Bitwise-and this big integer with the complement of the given unsigned
|
|
integer and assign the result to this big integer.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>n</code> - Integer to bitwise-and.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="andNot(long)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>andNot</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> andNot(long n)</pre>
|
|
<div class="block">Bitwise-and this big integer with the complement of the given unsigned
|
|
long integer and assign the result to this big integer.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>n</code> - Long integer to bitwise-and.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="andNot(edu.rit.numeric.BigInteger)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>andNot</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> andNot(<a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> bigint)</pre>
|
|
<div class="block">Bitwise-and this big integer with the complement of the given big integer
|
|
and assign the result to this big integer.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>bigint</code> - Big integer to bitwise-and.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>bigint</TT> is null.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="extractBits(edu.rit.numeric.BigInteger, int[])">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>extractBits</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> extractBits(<a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> bigint,
|
|
int[] pos)</pre>
|
|
<div class="block">Extract the given bits from the given big integer and assign them to this
|
|
big integer. The bit at position <TT>pos[0]</TT> of <TT>bigint</TT> is
|
|
assigned to bit 0 of this big integer, the bit at position
|
|
<TT>pos[1]</TT> of <TT>bigint</TT> is assigned to bit 1 of this big
|
|
integer, and so on. Any remaining unassigned bits of this big integer are
|
|
set to 0. The bit size of this big integer must be greater than or equal
|
|
to the length of the <TT>pos</TT> array. Each bit position in the
|
|
<TT>pos</TT> array must be in the range 0 .. <a href="../../../edu/rit/numeric/BigInteger.html#bitSize()"><code>bitSize()</code></a>−1.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>bigint</code> - Big integer from which to extract bits.</dd><dd><code>pos</code> - Array of bit positions to extract.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>bigint</TT> is null. Thrown if
|
|
<TT>pos</TT> is null.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/IndexOutOfBoundsException.html?is-external=true" title="class or interface in java.lang">IndexOutOfBoundsException</a></code> - (unchecked exception) Thrown if <a href="../../../edu/rit/numeric/BigInteger.html#bitSize()"><code>bitSize()</code></a> <
|
|
<TT>pos.length</TT>. Thrown if any bit position in <TT>pos</TT> is
|
|
out of bounds.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="extractBits(edu.rit.numeric.BigInteger, edu.rit.numeric.BigInteger.Bits)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>extractBits</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> extractBits(<a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> bigint,
|
|
<a href="../../../edu/rit/numeric/BigInteger.Bits.html" title="interface in edu.rit.numeric">BigInteger.Bits</a> bits)</pre>
|
|
<div class="block">Extract the given bits from the given big integer and assign them to this
|
|
big integer. The bit at position <TT>bits.bit(0)</TT> of <TT>bigint</TT>
|
|
is assigned to bit 0 of this big integer, the bit at position
|
|
<TT>bits.bit(1)</TT> of <TT>bigint</TT> is assigned to bit 1 of this big
|
|
integer, and so on. Any remaining unassigned bits of this big integer are
|
|
set to 0. The bit size of this big integer must be greater than or equal
|
|
to <TT>bits.size()</TT>. Each bit position in <TT>bits</TT> must be in
|
|
the range 0 .. <a href="../../../edu/rit/numeric/BigInteger.html#bitSize()"><code>bitSize()</code></a>−1.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>bigint</code> - Big integer from which to extract bits.</dd><dd><code>bits</code> - Object specifying bit positions to extract.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>bigint</TT> is null. Thrown if
|
|
<TT>bits</TT> is null.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/IndexOutOfBoundsException.html?is-external=true" title="class or interface in java.lang">IndexOutOfBoundsException</a></code> - (unchecked exception) Thrown if <a href="../../../edu/rit/numeric/BigInteger.html#bitSize()"><code>bitSize()</code></a> <
|
|
<TT>bits.size()</TT>. Thrown if any bit position in <TT>bits</TT> is
|
|
out of bounds.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="popCount()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>popCount</h4>
|
|
<pre>public int popCount()</pre>
|
|
<div class="block">Returns this big integer's population count. The population count is the
|
|
number of 1 bits in this big integer.</div>
|
|
<dl><dt><span class="strong">Returns:</span></dt><dd>Population count.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="leftmostOne()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>leftmostOne</h4>
|
|
<pre>public int leftmostOne()</pre>
|
|
<div class="block">Returns the position of the leftmost 1 bit in this big integer.</div>
|
|
<dl><dt><span class="strong">Returns:</span></dt><dd>Position of the leftmost 1 bit in the range 0 ..
|
|
<a href="../../../edu/rit/numeric/BigInteger.html#bitSize()"><code>bitSize()</code></a>−1, or −1 if this big
|
|
integer is zero.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="rightmostOne()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>rightmostOne</h4>
|
|
<pre>public int rightmostOne()</pre>
|
|
<div class="block">Returns the position of the rightmost 1 bit in this big integer.</div>
|
|
<dl><dt><span class="strong">Returns:</span></dt><dd>Position of the rightmost 1 bit in the range 0 ..
|
|
<a href="../../../edu/rit/numeric/BigInteger.html#bitSize()"><code>bitSize()</code></a>−1, or −1 if this big
|
|
integer is zero.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="eqZero()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>eqZero</h4>
|
|
<pre>public boolean eqZero()</pre>
|
|
<div class="block">Determine if this big integer's value is equal to 0.</div>
|
|
<dl><dt><span class="strong">Returns:</span></dt><dd>True if value = 0, false if value ≠ 0.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="compareTo(int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>compareTo</h4>
|
|
<pre>public int compareTo(int n)</pre>
|
|
<div class="block">Compare this big integer to the given unsigned integer.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>n</code> - Unsigned integer to compare.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>A value less than, equal to, or greater than 0 if this big
|
|
integer is less than, equal to, or greater than <TT>n</TT>,
|
|
respectively.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="compareTo(long)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>compareTo</h4>
|
|
<pre>public int compareTo(long n)</pre>
|
|
<div class="block">Compare this big integer to the given unsigned long integer.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>n</code> - Unsigned long integer to compare.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>A value less than, equal to, or greater than 0 if this big
|
|
integer is less than, equal to, or greater than <TT>n</TT>,
|
|
respectively.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="compareTo(edu.rit.numeric.BigInteger)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>compareTo</h4>
|
|
<pre>public int compareTo(<a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> bigint)</pre>
|
|
<div class="block">Compare this big integer to the given big integer.</div>
|
|
<dl>
|
|
<dt><strong>Specified by:</strong></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Comparable.html?is-external=true#compareTo(T)" title="class or interface in java.lang">compareTo</a></code> in interface <code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Comparable.html?is-external=true" title="class or interface in java.lang">Comparable</a><<a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a>></code></dd>
|
|
<dt><span class="strong">Parameters:</span></dt><dd><code>bigint</code> - Big integer to compare.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>A value less than, equal to, or greater than 0 if this big
|
|
integer is less than, equal to, or greater than <TT>bigint</TT>,
|
|
respectively.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>bigint</TT> is null.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="pack(byte[])">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>pack</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> pack(byte[] v)</pre>
|
|
<div class="block">Pack the value obtained from the given byte array into this big integer
|
|
in little-endian order. Bits 0 through 7 of this big integer are set to
|
|
<TT>v[0]</TT>, bits 8 through 15 of this big integer are set to
|
|
<TT>v[1]</TT>, and so on. If there are not enough bytes in <TT>v</TT> to
|
|
fill this big integer, the unfilled most significant bits of this big
|
|
integer are set to 0. If there are more bytes in <TT>v</TT> than needed
|
|
to fill this big integer, the extra bytes in <TT>v</TT> are ignored.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - Value array.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>v</TT> is null.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="pack(short[])">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>pack</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> pack(short[] v)</pre>
|
|
<div class="block">Pack the value obtained from the given short array into this big integer
|
|
in little-endian order. Bits 0 through 15 of this big integer are set to
|
|
<TT>v[0]</TT>, bits 15 through 31 of this big integer are set to
|
|
<TT>v[1]</TT>, and so on. If there are not enough shorts in <TT>v</TT> to
|
|
fill this big integer, the unfilled most significant bits of this big
|
|
integer are set to 0. If there are more shorts in <TT>v</TT> than needed
|
|
to fill this big integer, the extra shorts in <TT>v</TT> are ignored.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - Value array.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>v</TT> is null.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="pack(int[])">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>pack</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> pack(int[] v)</pre>
|
|
<div class="block">Pack the value obtained from the given integer array into this big
|
|
integer in little-endian order. Bits 0 through 31 of this big integer are
|
|
set to <TT>v[0]</TT>, bits 32 through 63 of this big integer are set to
|
|
<TT>v[1]</TT>, and so on. If there are not enough integers in <TT>v</TT>
|
|
to fill this big integer, the unfilled most significant bits of this big
|
|
integer are set to 0. If there are more integers in <TT>v</TT> than
|
|
needed to fill this big integer, the extra integers in <TT>v</TT> are
|
|
ignored.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - Value array.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>v</TT> is null.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="pack(long[])">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>pack</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> pack(long[] v)</pre>
|
|
<div class="block">Pack the value obtained from the given long array into this big integer
|
|
in little-endian order. Bits 0 through 63 of this big integer are set to
|
|
<TT>v[0]</TT>, bits 64 through 127 of this big integer are set to
|
|
<TT>v[1]</TT>, and so on. If there are not enough longs in <TT>v</TT> to
|
|
fill this big integer, the unfilled most significant bits of this big
|
|
integer are set to 0. If there are more longs in <TT>v</TT> than needed
|
|
to fill this big integer, the extra longs in <TT>v</TT> are ignored.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - Value array.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>v</TT> is null.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="packBigEndian(byte[])">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>packBigEndian</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> packBigEndian(byte[] v)</pre>
|
|
<div class="block">Pack the value obtained from the given byte array into this big integer
|
|
in big-endian order. Let <TT>L</TT> = <TT>v.length</TT>. Bits 0 through 7
|
|
of this big integer are set to <TT>v[L-1]</TT>, bits 8 through 15 of this
|
|
big integer are set to <TT>v[L-2]</TT>, and so on. If there are not
|
|
enough bytes in <TT>v</TT> to fill this big integer, the unfilled most
|
|
significant bits of this big integer are set to 0. If there are more
|
|
bytes in <TT>v</TT> than needed to fill this big integer, the extra bytes
|
|
in <TT>v</TT> are ignored.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - Value array.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>v</TT> is null.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="packBigEndian(short[])">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>packBigEndian</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> packBigEndian(short[] v)</pre>
|
|
<div class="block">Pack the value obtained from the given short array into this big integer
|
|
in big-endian order. Let <TT>L</TT> = <TT>v.length</TT>. Bits 0 through
|
|
15 of this big integer are set to <TT>v[L-1]</TT>, bits 15 through 31 of
|
|
this big integer are set to <TT>v[L-2]</TT>, and so on. If there are not
|
|
enough shorts in <TT>v</TT> to fill this big integer, the unfilled most
|
|
significant bits of this big integer are set to 0. If there are more
|
|
shorts in <TT>v</TT> than needed to fill this big integer, the extra
|
|
shorts in <TT>v</TT> are ignored.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - Value array.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>v</TT> is null.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="packBigEndian(int[])">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>packBigEndian</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> packBigEndian(int[] v)</pre>
|
|
<div class="block">Pack the value obtained from the given integer array into this big
|
|
integer in big-endian order. Let <TT>L</TT> = <TT>v.length</TT>. Bits 0
|
|
through 31 of this big integer are set to <TT>v[L-1]</TT>, bits 32
|
|
through 63 of this big integer are set to <TT>v[L-2]</TT>, and so on. If
|
|
there are not enough integers in <TT>v</TT> to fill this big integer, the
|
|
unfilled most significant bits of this big integer are set to 0. If there
|
|
are more integers in <TT>v</TT> than needed to fill this big integer, the
|
|
extra integers in <TT>v</TT> are ignored.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - Value array.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>v</TT> is null.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="packBigEndian(long[])">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>packBigEndian</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> packBigEndian(long[] v)</pre>
|
|
<div class="block">Pack the value obtained from the given long array into this big integer
|
|
in big-endian order. Let <TT>L</TT> = <TT>v.length</TT>. Bits 0 through
|
|
63 of this big integer are set to <TT>v[L-1]</TT>, bits 64 through 127 of
|
|
this big integer are set to <TT>v[L-2]</TT>, and so on. If there are not
|
|
enough longs in <TT>v</TT> to fill this big integer, the unfilled most
|
|
significant bits of this big integer are set to 0. If there are more
|
|
longs in <TT>v</TT> than needed to fill this big integer, the extra longs
|
|
in <TT>v</TT> are ignored.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - Value array.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>v</TT> is null.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="unpack(byte[])">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>unpack</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> unpack(byte[] v)</pre>
|
|
<div class="block">Unpack this big integer's value into the given byte array in
|
|
little-endian order. <TT>v[0]</TT> is set to bits 0–7 of this big
|
|
integer, <TT>v[1]</TT> is set to bits 8–15 of this big integer, and
|
|
so on. If there are not enough bytes in this big integer's value to fill
|
|
<TT>v</TT>, the unfilled portion of <TT>v</TT> is set to 0. If there are
|
|
more bytes in this big integer's value than needed to fill <TT>v</TT>,
|
|
the extra bytes in this big integer's value are ignored.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - Value array.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>v</TT> is null.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="unpack(short[])">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>unpack</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> unpack(short[] v)</pre>
|
|
<div class="block">Unpack this big integer's value into the given short array in
|
|
little-endian order. <TT>v[0]</TT> is set to bits 0–15 of this big
|
|
integer, <TT>v[1]</TT> is set to bits 16–31 of this big integer,
|
|
and so on. If there are not enough shorts in this big integer's value to
|
|
fill <TT>v</TT>, the unfilled portion of <TT>v</TT> is set to 0. If there
|
|
are more shorts in this big integer's value than needed to fill
|
|
<TT>v</TT>, the extra shorts in this big integer's value are ignored.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - Value array.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>v</TT> is null.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="unpack(int[])">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>unpack</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> unpack(int[] v)</pre>
|
|
<div class="block">Unpack this big integer's value into the given integer array in
|
|
little-endian order. <TT>v[0]</TT> is set to bits 0–31 of this big
|
|
integer, <TT>v[1]</TT> is set to bits 32–63 of this big integer,
|
|
and so on. If there are not enough integers in this big integer's value
|
|
to fill <TT>v</TT>, the unfilled portion of <TT>v</TT> is set to 0. If
|
|
there are more integers in this big integer's value than needed to fill
|
|
<TT>v</TT>, the extra integers in this big integer's value are ignored.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - Value array.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>v</TT> is null.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="unpack(long[])">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>unpack</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> unpack(long[] v)</pre>
|
|
<div class="block">Unpack this big integer's value into the given long array in
|
|
little-endian order. <TT>v[0]</TT> is set to bits 0–63 of this big
|
|
integer, <TT>v[1]</TT> is set to bits 64–127 of this big integer,
|
|
and so on. If there are not enough longs in this big integer's value to
|
|
fill <TT>v</TT>, the unfilled portion of <TT>v</TT> is set to 0. If there
|
|
are more longs in this big integer's value than needed to fill
|
|
<TT>v</TT>, the extra longs in this big integer's value are ignored.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - Value array.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>v</TT> is null.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="unpackBigEndian(byte[])">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>unpackBigEndian</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> unpackBigEndian(byte[] v)</pre>
|
|
<div class="block">Unpack this big integer's value into the given byte array in big-endian
|
|
order. Let <TT>L</TT> = <TT>v.length</TT>. <TT>v[L-1]</TT> is set to bits
|
|
0–7 of this big integer, <TT>v[L-2]</TT> is set to bits 8–15
|
|
of this big integer, and so on. If there are not enough bytes in this big
|
|
integer's value to fill <TT>v</TT>, the unfilled portion of <TT>v</TT> is
|
|
set to 0. If there are more bytes in this big integer's value than needed
|
|
to fill <TT>v</TT>, the extra bytes in this big integer's value are
|
|
ignored.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - Value array.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>v</TT> is null.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="unpackBigEndian(short[])">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>unpackBigEndian</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> unpackBigEndian(short[] v)</pre>
|
|
<div class="block">Unpack this big integer's value into the given short array in big-endian
|
|
order. Let <TT>L</TT> = <TT>v.length</TT>. <TT>v[L-1]</TT> is set to bits
|
|
0–15 of this big integer, <TT>v[L-2]</TT> is set to bits
|
|
16–31 of this big integer, and so on. If there are not enough
|
|
shorts in this big integer's value to fill <TT>v</TT>, the unfilled
|
|
portion of <TT>v</TT> is set to 0. If there are more shorts in this big
|
|
integer's value than needed to fill <TT>v</TT>, the extra shorts in this
|
|
big integer's value are ignored.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - Value array.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>v</TT> is null.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="unpackBigEndian(int[])">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>unpackBigEndian</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> unpackBigEndian(int[] v)</pre>
|
|
<div class="block">Unpack this big integer's value into the given integer array in
|
|
big-endian order. Let <TT>L</TT> = <TT>v.length</TT>. <TT>v[L-1]</TT> is
|
|
set to bits 0–31 of this big integer, <TT>v[L-2]</TT> is set to
|
|
bits 32–63 of this big integer, and so on. If there are not enough
|
|
integers in this big integer's value to fill <TT>v</TT>, the unfilled
|
|
portion of <TT>v</TT> is set to 0. If there are more integers in this big
|
|
integer's value than needed to fill <TT>v</TT>, the extra integers in
|
|
this big integer's value are ignored.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - Value array.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>v</TT> is null.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="unpackBigEndian(long[])">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>unpackBigEndian</h4>
|
|
<pre>public <a href="../../../edu/rit/numeric/BigInteger.html" title="class in edu.rit.numeric">BigInteger</a> unpackBigEndian(long[] v)</pre>
|
|
<div class="block">Unpack this big integer's value into the given long array in big-endian
|
|
order. Let <TT>L</TT> = <TT>v.length</TT>. <TT>v[L-1]</TT> is set to bits
|
|
0–63 of this big integer, <TT>v[L-2]</TT> is set to bits
|
|
64–127 of this big integer, and so on. If there are not enough
|
|
longs in this big integer's value to fill <TT>v</TT>, the unfilled
|
|
portion of <TT>v</TT> is set to 0. If there are more longs in this big
|
|
integer's value than needed to fill <TT>v</TT>, the extra longs in this
|
|
big integer's value are ignored.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - Value array.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>This big integer.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>v</TT> is null.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="equals(java.lang.Object)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>equals</h4>
|
|
<pre>public boolean equals(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> obj)</pre>
|
|
<div class="block">Determine if this big integer is equal to the given object.</div>
|
|
<dl>
|
|
<dt><strong>Overrides:</strong></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#equals(java.lang.Object)" title="class or interface in java.lang">equals</a></code> in class <code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></code></dd>
|
|
<dt><span class="strong">Parameters:</span></dt><dd><code>obj</code> - Object to test.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>True if this big integer is equal to <TT>obj</TT>, false
|
|
otherwise.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="hashCode()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>hashCode</h4>
|
|
<pre>public int hashCode()</pre>
|
|
<div class="block">Returns a hash code for this big integer.</div>
|
|
<dl>
|
|
<dt><strong>Overrides:</strong></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#hashCode()" title="class or interface in java.lang">hashCode</a></code> in class <code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></code></dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>Hash code.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="toString()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>toString</h4>
|
|
<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> toString()</pre>
|
|
<div class="block">Returns a string version of this big integer. The string is this big
|
|
integer's value in decimal.</div>
|
|
<dl>
|
|
<dt><strong>Overrides:</strong></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#toString()" title="class or interface in java.lang">toString</a></code> in class <code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></code></dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>String version.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="toStringHex()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>toStringHex</h4>
|
|
<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> toStringHex()</pre>
|
|
<div class="block">Returns a string version of this big integer. The string is this big
|
|
integer's value in hexadecimal.</div>
|
|
<dl><dt><span class="strong">Returns:</span></dt><dd>String version.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="writeOut(edu.rit.io.OutStream)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>writeOut</h4>
|
|
<pre>public void writeOut(<a href="../../../edu/rit/io/OutStream.html" title="class in edu.rit.io">OutStream</a> out)
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Write this big integer to the given out stream.</div>
|
|
<dl>
|
|
<dt><strong>Specified by:</strong></dt>
|
|
<dd><code><a href="../../../edu/rit/io/Streamable.html#writeOut(edu.rit.io.OutStream)">writeOut</a></code> in interface <code><a href="../../../edu/rit/io/Streamable.html" title="interface in edu.rit.io">Streamable</a></code></dd>
|
|
<dt><span class="strong">Parameters:</span></dt><dd><code>out</code> - Out stream.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readIn(edu.rit.io.InStream)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockListLast">
|
|
<li class="blockList">
|
|
<h4>readIn</h4>
|
|
<pre>public void readIn(<a href="../../../edu/rit/io/InStream.html" title="class in edu.rit.io">InStream</a> in)
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read this big integer from the given in stream.</div>
|
|
<dl>
|
|
<dt><strong>Specified by:</strong></dt>
|
|
<dd><code><a href="../../../edu/rit/io/Streamable.html#readIn(edu.rit.io.InStream)">readIn</a></code> in interface <code><a href="../../../edu/rit/io/Streamable.html" title="interface in edu.rit.io">Streamable</a></code></dd>
|
|
<dt><span class="strong">Parameters:</span></dt><dd><code>in</code> - In stream.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<!-- ========= END OF CLASS DATA ========= -->
|
|
<!-- ======= START OF BOTTOM NAVBAR ====== -->
|
|
<div class="bottomNav"><a name="navbar_bottom">
|
|
<!-- -->
|
|
</a><a href="#skip-navbar_bottom" title="Skip navigation links"></a><a name="navbar_bottom_firstrow">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="navList" title="Navigation">
|
|
<li><a href="../../../overview-summary.html">Overview</a></li>
|
|
<li><a href="package-summary.html">Package</a></li>
|
|
<li class="navBarCell1Rev">Class</li>
|
|
<li><a href="class-use/BigInteger.html">Use</a></li>
|
|
<li><a href="package-tree.html">Tree</a></li>
|
|
<li><a href="../../../deprecated-list.html">Deprecated</a></li>
|
|
<li><a href="../../../index-files/index-1.html">Index</a></li>
|
|
<li><a href="../../../help-doc.html">Help</a></li>
|
|
</ul>
|
|
</div>
|
|
<div class="subNav">
|
|
<ul class="navList">
|
|
<li><a href="../../../edu/rit/numeric/BernoulliPrng.html" title="class in edu.rit.numeric"><span class="strong">Prev Class</span></a></li>
|
|
<li><a href="../../../edu/rit/numeric/BigInteger.Bits.html" title="interface in edu.rit.numeric"><span class="strong">Next Class</span></a></li>
|
|
</ul>
|
|
<ul class="navList">
|
|
<li><a href="../../../index.html?edu/rit/numeric/BigInteger.html" target="_top">Frames</a></li>
|
|
<li><a href="BigInteger.html" target="_top">No Frames</a></li>
|
|
</ul>
|
|
<ul class="navList" id="allclasses_navbar_bottom">
|
|
<li><a href="../../../allclasses-noframe.html">All Classes</a></li>
|
|
</ul>
|
|
<div>
|
|
<script type="text/javascript"><!--
|
|
allClassesLink = document.getElementById("allclasses_navbar_bottom");
|
|
if(window==top) {
|
|
allClassesLink.style.display = "block";
|
|
}
|
|
else {
|
|
allClassesLink.style.display = "none";
|
|
}
|
|
//-->
|
|
</script>
|
|
</div>
|
|
<div>
|
|
<ul class="subNavList">
|
|
<li>Summary: </li>
|
|
<li><a href="#nested_class_summary">Nested</a> | </li>
|
|
<li>Field | </li>
|
|
<li><a href="#constructor_summary">Constr</a> | </li>
|
|
<li><a href="#method_summary">Method</a></li>
|
|
</ul>
|
|
<ul class="subNavList">
|
|
<li>Detail: </li>
|
|
<li>Field | </li>
|
|
<li><a href="#constructor_detail">Constr</a> | </li>
|
|
<li><a href="#method_detail">Method</a></li>
|
|
</ul>
|
|
</div>
|
|
<a name="skip-navbar_bottom">
|
|
<!-- -->
|
|
</a></div>
|
|
<!-- ======== END OF BOTTOM NAVBAR ======= -->
|
|
<p class="legalCopy"><small><FONT SIZE="-2">Copyright © 2013–2016 by Alan Kaminsky. All rights reserved. Send comments to ark</FONT><FONT SIZE="1" COLOR="#FFFFFF">­</FONT><FONT SIZE="-2">@</FONT><FONT SIZE="1" COLOR="#FFFFFF">­</FONT><FONT SIZE="-2">cs.rit.edu.</FONT></small></p>
|
|
</body>
|
|
</html>
|