bignumber.html

JAVA CARD 开发包规格说明,版本为2.2.2

<PRE>
public void <B>subtract</B>(byte[]&nbsp;bArray,
                     short&nbsp;bOff,
                     short&nbsp;bLen,
                     byte&nbsp;arrayFormat)
              throws <A HREF="../../../java/lang/ArithmeticException.html" title="class in java.lang">ArithmeticException</A></PRE>
<DL>
<DD>Decrements the internal big number by the specified operand value
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>bArray</CODE> - input byte array<DD><CODE>bOff</CODE> - offset within input byte array containing first byte (the high order byte)<DD><CODE>bLen</CODE> - byte length of input data<DD><CODE>arrayFormat</CODE> - indicates the format of the input data. Valid codes listed
 in <code>FORMAT_*</code> constants.
 See <A HREF="../../../javacardx/framework/math/BigNumber.html#FORMAT_BCD"><CODE>FORMAT_BCD</CODE></A>.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../java/lang/ArrayIndexOutOfBoundsException.html" title="class in java.lang">ArrayIndexOutOfBoundsException</A></CODE> - if accessing the input array would cause access of data outside array bounds
 or if <code>bLen</code> is negative
<DD><CODE><A HREF="../../../java/lang/NullPointerException.html" title="class in java.lang">NullPointerException</A></CODE> - if <code>bArray</code> is <code>null</code>
<DD><CODE><A HREF="../../../java/lang/ArithmeticException.html" title="class in java.lang">ArithmeticException</A></CODE> - for the following conditions:<ul>
 <li>if the input byte array format is not conformant with the specified
 <code>arrayFormat</code> parameter
 <li>if the result of the subtraction results in a negative number.
 The internal big number is left unchanged.
 <li>if <code>bLen</code> is 0
 <li>if <code>arrayFormat</code> is not one of the FORMAT_ constants.
 </ul></DL>
</DD>
</DL>
<HR>

<A NAME="multiply(byte[], short, short, byte)"><!-- --></A><H3>
multiply</H3>
<PRE>
public void <B>multiply</B>(byte[]&nbsp;bArray,
                     short&nbsp;bOff,
                     short&nbsp;bLen,
                     byte&nbsp;arrayFormat)
              throws <A HREF="../../../java/lang/ArithmeticException.html" title="class in java.lang">ArithmeticException</A></PRE>
<DL>
<DD>Multiplies the internal big number by the specified operand value
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>bArray</CODE> - input byte array<DD><CODE>bOff</CODE> - offset within input byte array containing first byte (the high order byte)<DD><CODE>bLen</CODE> - byte length of input data<DD><CODE>arrayFormat</CODE> - indicates the format of the input data. Valid codes listed
 in <code>FORMAT_*</code> constants.
 See <A HREF="../../../javacardx/framework/math/BigNumber.html#FORMAT_BCD"><CODE>FORMAT_BCD</CODE></A>.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../java/lang/ArrayIndexOutOfBoundsException.html" title="class in java.lang">ArrayIndexOutOfBoundsException</A></CODE> - if accessing the input array would cause access of data outside array bounds
 or if <code>bLen</code> is negative
<DD><CODE><A HREF="../../../java/lang/NullPointerException.html" title="class in java.lang">NullPointerException</A></CODE> - if <code>bArray</code> is <code>null</code>
<DD><CODE><A HREF="../../../java/lang/ArithmeticException.html" title="class in java.lang">ArithmeticException</A></CODE> - for the following conditions:<ul>
 <li>if the input byte array format is not conformant with the specified
 <code>arrayFormat</code> parameter
 <li>if the result of the multiplication results in a big number which cannot be
 represented within the maximum supported bytes or is greater than the configured
 max value. The internal big number is left unchanged.
 <li>if <code>bLen</code> is 0
 <li>if <code>arrayFormat</code> is not one of the FORMAT_ constants.
 </ul></DL>
</DD>
</DL>
<HR>

<A NAME="compareTo(javacardx.framework.math.BigNumber)"><!-- --></A><H3>
compareTo</H3>
<PRE>
public byte <B>compareTo</B>(<A HREF="../../../javacardx/framework/math/BigNumber.html" title="class in javacardx.framework.math">BigNumber</A>&nbsp;operand)</PRE>
<DL>
<DD>Compares the internal big number against the specified operand
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>operand</CODE> - contains the BigNumber operand
<DT><B>Returns:</B><DD>the result of the comparison as follows:<ul>
 <li> <code>0</code> if equal</li>
 <li> <code>-1</code> if the internal big number is less than the specified operand</li>
 <li> <code>1</code> if the internal big number is greater than the specified operand</li>
 </ul>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../java/lang/NullPointerException.html" title="class in java.lang">NullPointerException</A></CODE> - if <code>operand</code> is <code>null</code></DL>
</DD>
</DL>
<HR>

<A NAME="compareTo(byte[], short, short, byte)"><!-- --></A><H3>
compareTo</H3>
<PRE>
public byte <B>compareTo</B>(byte[]&nbsp;bArray,
                      short&nbsp;bOff,
                      short&nbsp;bLen,
                      byte&nbsp;arrayFormat)</PRE>
<DL>
<DD>Compares the internal big number against the specified operand. The operand is specified
 in an input byte array.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>bArray</CODE> - input byte array<DD><CODE>bOff</CODE> - offset within input byte array containing first byte (the high order byte)<DD><CODE>bLen</CODE> - byte length of input data<DD><CODE>arrayFormat</CODE> - indicates the format of the input data. Valid codes listed
 in <code>FORMAT_*</code> constants.
 See <A HREF="../../../javacardx/framework/math/BigNumber.html#FORMAT_BCD"><CODE>FORMAT_BCD</CODE></A>.
<DT><B>Returns:</B><DD>the result of the comparison as follows:<ul>
 <li> <code>0</code> if equal</li>
 <li> <code>-1</code> if the internal big number is less than the specified operand</li>
 <li> <code>1</code> if the internal big number is greater than the specified operand</li>
 </ul>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../java/lang/ArrayIndexOutOfBoundsException.html" title="class in java.lang">ArrayIndexOutOfBoundsException</A></CODE> - if accessing the input array would cause access of data outside array bounds
 or if <code>bLen</code> is negative
<DD><CODE><A HREF="../../../java/lang/NullPointerException.html" title="class in java.lang">NullPointerException</A></CODE> - if <code>bArray</code> is <code>null</code>
<DD><CODE><A HREF="../../../java/lang/ArithmeticException.html" title="class in java.lang">ArithmeticException</A></CODE> - for the following conditions:<ul>
 <li>if the input byte array format is not conformant with the specified
 <code>arrayFormat</code> parameter
 <li>if <code>bLen</code> is 0
 <li>if <code>arrayFormat</code> is not one of the FORMAT_ constants.
 </ul></DL>
</DD>
</DL>
<HR>

<A NAME="toBytes(byte[], short, short, byte)"><!-- --></A><H3>
toBytes</H3>
<PRE>
public void <B>toBytes</B>(byte[]&nbsp;outBuf,
                    short&nbsp;bOff,
                    short&nbsp;numBytes,
                    byte&nbsp;arrayFormat)
             throws <A HREF="../../../java/lang/ArrayIndexOutOfBoundsException.html" title="class in java.lang">ArrayIndexOutOfBoundsException</A>,
                    <A HREF="../../../java/lang/NullPointerException.html" title="class in java.lang">NullPointerException</A></PRE>
<DL>
<DD>Writes the internal big number out in the desired format. Note that the
 value output into the specified byte array is right justified for the number
 of requested bytes. BCD 0 nibbles are prepended to the output BCD data written out.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>outBuf</CODE> - output byte array<DD><CODE>bOff</CODE> - offset within byte array containing first byte (the high order byte)<DD><CODE>numBytes</CODE> - number of output bytes required<DD><CODE>arrayFormat</CODE> - indicates the format of the input data. Valid codes listed
 in <code>FORMAT_*</code> constants.
 See <A HREF="../../../javacardx/framework/math/BigNumber.html#FORMAT_BCD"><CODE>FORMAT_BCD</CODE></A>.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../java/lang/ArrayIndexOutOfBoundsException.html" title="class in java.lang">ArrayIndexOutOfBoundsException</A></CODE> - if accessing the output array would cause access of data outside array bounds
 or if <code>numBytes</code> is negative
<DD><CODE><A HREF="../../../java/lang/NullPointerException.html" title="class in java.lang">NullPointerException</A></CODE> - if <code>outBuf</code> is <code>null</code>
<DD><CODE><A HREF="../../../java/lang/ArithmeticException.html" title="class in java.lang">ArithmeticException</A></CODE> - for the following conditions:<ul>
 <li>if <code>numBytes</code> is not sufficient to represent the big number in the desired format
 <li>if <code>numBytes</code> is 0
 <li>if <code>arrayFormat</code> is not one of the FORMAT_ constants.
 </ul></DL>
</DD>
</DL>
<HR>

<A NAME="getByteLength(byte)"><!-- --></A><H3>
getByteLength</H3>
<PRE>
public short <B>getByteLength</B>(byte&nbsp;arrayFormat)</PRE>
<DL>
<DD>Returns the number of bytes required to represent the big number
 using the desired format
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>arrayFormat</CODE> - indicates the format of the output data. Valid codes listed
 in <code>FORMAT_*</code> constants.
 See <A HREF="../../../javacardx/framework/math/BigNumber.html#FORMAT_BCD"><CODE>FORMAT_BCD</CODE></A>.
<DT><B>Returns:</B><DD>the byte length of big number
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../java/lang/ArithmeticException.html" title="class in java.lang">ArithmeticException</A></CODE> - if <code>arrayFormat</code> is not one of the FORMAT_ constants.</DL>
</DD>
</DL>
<HR>

<A NAME="reset()"><!-- --></A><H3>
reset</H3>
<PRE>
public void <B>reset</B>()</PRE>
<DL>
<DD>Resets the big number to 0
<P>
<DD><DL>
</DL>
</DD>
</DL>
<!-- ========= END OF CLASS DATA ========= -->
<HR>


<!-- ======= START OF BOTTOM NAVBAR ====== -->
<A NAME="navbar_bottom"><!-- --></A>
<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
  <TR ALIGN="center" VALIGN="top">
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/BigNumber.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
  </TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
<b>Java Card </b><br><font size="-1">v2.2.2</font></EM>
</TD>
</TR>

<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="../../../javacardx/framework/math/BCDUtil.html" title="class in javacardx.framework.math"><B>PREV CLASS</B></A>&nbsp;
&nbsp;<A HREF="../../../javacardx/framework/math/ParityBit.html" title="class in javacardx.framework.math"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../../index.html?javacardx/framework/math/BigNumber.html" target="_top"><B>FRAMES</B></A>  &nbsp;
&nbsp;<A HREF="BigNumber.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
&nbsp;<SCRIPT type="text/javascript">
  <!--
  if(window==top) {
    document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>');
  }
  //-->
</SCRIPT>
<NOSCRIPT>
  <A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>
</NOSCRIPT>


</FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;<A HREF="#field_summary">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL:&nbsp;<A HREF="#field_detail">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<A NAME="skip-navbar_bottom"></A>
<!-- ======== END OF BOTTOM NAVBAR ======= -->

<HR>
<i>Copyright &#169; 1993-2005 Sun Microsystems, Inc. 4150 Network Circle,<br>Santa Clara, CA, 95054, U.S.A.  All Rights Reserved.</i>
</BODY>
</HTML>