constructedbertlv.html

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

<PRE>
public short <B>delete</B>(<A HREF="../../../javacardx/framework/tlv/BERTLV.html" title="class in javacardx.framework.tlv">BERTLV</A>&nbsp;aTLV,
                    short&nbsp;occurrenceNum)
             throws <A HREF="../../../javacardx/framework/tlv/TLVException.html" title="class in javacardx.framework.tlv">TLVException</A></PRE>
<DL>
<DD>Delete the specified occurrence of the specified BER TLV from <code>this</code> <CODE>ConstructedBERTLV</CODE>.
 The internal reference at the specified occurrence to the specified BER TLV object is removed.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>aTLV</CODE> - the BER TLV object to delete from <code>this</code><DD><CODE>occurrenceNum</CODE> - specifies which occurrence of <code>aTLV</code> within <code>this</code> BER TLV to use
<DT><B>Returns:</B><DD>the resulting size of <code>this</code> TLV if represented in bytes
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../java/lang/NullPointerException.html" title="class in java.lang">NullPointerException</A></CODE> - if <code>aTLV</code>
 is <code>null</code>
<DD><CODE><A HREF="../../../javacardx/framework/tlv/TLVException.html" title="class in javacardx.framework.tlv">TLVException</A></CODE> - with the following reason codes:<ul>
 <li><code>TLVException.INVALID_PARAM</code> if the specified BER TLV object parameter is not an
 element of <code>this</code> or occurs less than <code>occurrenceNum</code> times in <code>this</code>
 or <code>occurrenceNum</code> is 0 or negative.
 </ul></DL>
</DD>
</DL>
<HR>

<A NAME="find(javacardx.framework.tlv.BERTag)"><!-- --></A><H3>
find</H3>
<PRE>
public <A HREF="../../../javacardx/framework/tlv/BERTLV.html" title="class in javacardx.framework.tlv">BERTLV</A> <B>find</B>(<A HREF="../../../javacardx/framework/tlv/BERTag.html" title="class in javacardx.framework.tlv">BERTag</A>&nbsp;tag)</PRE>
<DL>
<DD>Find the contained <CODE>BERTLV</CODE> within <code>this</code> <CODE>ConstructedBERTLV</CODE> object that matches
 the specified BER Tag.
 If the tag parameter is <CODE>null</CODE>, the first contained BER TLV object is returned.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>tag</CODE> - the <CODE>BERTag</CODE> to be found
<DT><B>Returns:</B><DD>TLV object matching the indicated tag or null if none found.</DL>
</DD>
</DL>
<HR>

<A NAME="findNext(javacardx.framework.tlv.BERTag, javacardx.framework.tlv.BERTLV, short)"><!-- --></A><H3>
findNext</H3>
<PRE>
public <A HREF="../../../javacardx/framework/tlv/BERTLV.html" title="class in javacardx.framework.tlv">BERTLV</A> <B>findNext</B>(<A HREF="../../../javacardx/framework/tlv/BERTag.html" title="class in javacardx.framework.tlv">BERTag</A>&nbsp;tag,
                       <A HREF="../../../javacardx/framework/tlv/BERTLV.html" title="class in javacardx.framework.tlv">BERTLV</A>&nbsp;aTLV,
                       short&nbsp;occurrenceNum)</PRE>
<DL>
<DD>Find the next contained <CODE>BERTLV</CODE> within <code>this</code> <CODE>ConstructedBERTLV</CODE> object that matches
 the specified BER Tag. The search must be started from the TLV position
 following the specified occurrence of the specified BER TLV object parameter. If the tag parameter
 is null, the next contained BER TLV object is returned.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>tag</CODE> - the BERTag to be found<DD><CODE>aTLV</CODE> - tlv object contained within <code>this</code> BER TLV following which the search begins<DD><CODE>occurrenceNum</CODE> - specifies which occurrence of <code>aTLV</code> within <code>this</code> BER TLV to use
<DT><B>Returns:</B><DD>TLV object matching the indicated tag or null if none found.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../java/lang/NullPointerException.html" title="class in java.lang">NullPointerException</A></CODE> - if <code>aTLV</code>
 is <code>null</code>
<DD><CODE><A HREF="../../../javacardx/framework/tlv/TLVException.html" title="class in javacardx.framework.tlv">TLVException</A></CODE> - with the following reason codes:<ul>
 <li><code>TLVException.INVALID_PARAM</code> if the specified BER TLV object parameter is not an
 element of <code>this</code> or occurs less than <code>occurrenceNum</code> times in <code>this</code>
 or if <code>occurrenceNum</code> is 0 or negative.
 </ul></DL>
</DD>
</DL>
<HR>

<A NAME="append(byte[], short, byte[], short)"><!-- --></A><H3>
append</H3>
<PRE>
public static short <B>append</B>(byte[]&nbsp;berTLVInArray,
                           short&nbsp;bTLVInOff,
                           byte[]&nbsp;berTLVOutArray,
                           short&nbsp;bTLVOutOff)
                    throws <A HREF="../../../javacardx/framework/tlv/TLVException.html" title="class in javacardx.framework.tlv">TLVException</A></PRE>
<DL>
<DD>Append the TLV representation in the specified byte array to the constructed BER tlv
 representation in the specified output byte array.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>berTLVInArray</CODE> - input byte array<DD><CODE>bTLVInOff</CODE> - offset within byte array containing the tlv data<DD><CODE>berTLVOutArray</CODE> - output TLV byte array<DD><CODE>bTLVOutOff</CODE> - offset within byte array where output begins
<DT><B>Returns:</B><DD>the size of the resulting output TLV
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../java/lang/ArrayIndexOutOfBoundsException.html" title="class in java.lang">ArrayIndexOutOfBoundsException</A></CODE> - if accessing the input or output array
 would cause access of data outside array bounds, or if either array offset
 parameter is negative
<DD><CODE><A HREF="../../../java/lang/NullPointerException.html" title="class in java.lang">NullPointerException</A></CODE> - if either <code>berTLVInArray</code>
 or <code>berTLVOutArray</code> is <code>null</code>
<DD><CODE><A HREF="../../../javacardx/framework/tlv/TLVException.html" title="class in javacardx.framework.tlv">TLVException</A></CODE> - with the following reason codes:<ul>
 <li><code>TLVException.MALFORMED_TLV</code> if the TLV representation in the input byte
 array is not a well-formed constructed BER TLV.
 </ul></DL>
</DD>
</DL>
<HR>

<A NAME="find(byte[], short, byte[], short)"><!-- --></A><H3>
find</H3>
<PRE>
public static short <B>find</B>(byte[]&nbsp;berTLVArray,
                         short&nbsp;bTLVOff,
                         byte[]&nbsp;berTagArray,
                         short&nbsp;bTagOff)
                  throws <A HREF="../../../javacardx/framework/tlv/TLVException.html" title="class in javacardx.framework.tlv">TLVException</A></PRE>
<DL>
<DD>Find the offset of the contained TLV representation at the top level
 within the TLV structure representation in the specified byte array that
 matches the specified tag representation in the specified byte array
 If the tag array parameter is null, the
 offset of the first contained TLV is returned.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>berTLVArray</CODE> - input byte array<DD><CODE>bTLVOff</CODE> - offset within byte array containing the tlv data<DD><CODE>berTagArray</CODE> - byte array containing the Tag to be searched<DD><CODE>bTagOff</CODE> - offset within <CODE>berTagArray</CODE> byte array where tag data begins
<DT><B>Returns:</B><DD>offset into <CODE>berTLVArray</CODE> where the indicated tag was found
 or -1 if none found.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../java/lang/ArrayIndexOutOfBoundsException.html" title="class in java.lang">ArrayIndexOutOfBoundsException</A></CODE> - if accessing the input arrays
 would cause access of data outside array bounds, or if either array offset
 parameter is negative
<DD><CODE><A HREF="../../../java/lang/NullPointerException.html" title="class in java.lang">NullPointerException</A></CODE> - if <code>berTLVArray</code>
 is <code>null</code>
<DD><CODE><A HREF="../../../javacardx/framework/tlv/TLVException.html" title="class in javacardx.framework.tlv">TLVException</A></CODE> - with the following reason codes:<ul>
 <li><code>TLVException.MALFORMED_TLV</code> if the TLV representation in the specified byte
 array is not a well-formed constructed BER TLV structure.
 <li><code>TLVException.MALFORMED_TAG</code> if tag representation in the specified byte
 array is is not a well-formed BER Tag structure.
 </ul></DL>
</DD>
</DL>
<HR>

<A NAME="findNext(byte[], short, short, byte[], short)"><!-- --></A><H3>
findNext</H3>
<PRE>
public static short <B>findNext</B>(byte[]&nbsp;berTLVArray,
                             short&nbsp;bTLVOff,
                             short&nbsp;startOffset,
                             byte[]&nbsp;berTagArray,
                             short&nbsp;bTagOff)
                      throws <A HREF="../../../javacardx/framework/tlv/TLVException.html" title="class in javacardx.framework.tlv">TLVException</A></PRE>
<DL>
<DD>Find the offset of the next contained TLV representation at the top level
 within the TLV structure representation in the specified byte array that
 matches the specified tag representation in the specified byte array.
 The search must be started from the TLV position
 following the specified <CODE>startOffset</CODE> parameter where a contained TLV exists
 at the top level.
 If the tag array parameter - <CODE>berTagArray</CODE> - is null, the
 offset of the next contained TLV representation at the top level is returned.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>berTLVArray</CODE> - input byte array<DD><CODE>bTLVOff</CODE> - offset within byte array containing the TLV data<DD><CODE>startOffset</CODE> - offset within the input <CODE>berTLVArray</CODE> to begin the search<DD><CODE>berTagArray</CODE> - byte array containing the Tag to be searched<DD><CODE>bTagOff</CODE> - offset within <CODE>berTagArray</CODE> byte array where tag data begins
<DT><B>Returns:</B><DD>offset into <CODE>berTLVArray</CODE> where the indicated tag was found
 or -1 if none found.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../java/lang/ArrayIndexOutOfBoundsException.html" title="class in java.lang">ArrayIndexOutOfBoundsException</A></CODE> - if accessing the input arrays
 would cause access of data outside array bounds, or if any of the array offset
 parameters is negative
<DD><CODE><A HREF="../../../java/lang/NullPointerException.html" title="class in java.lang">NullPointerException</A></CODE> - if <code>berTLVArray</code>
 is <code>null</code>
<DD><CODE><A HREF="../../../javacardx/framework/tlv/TLVException.html" title="class in javacardx.framework.tlv">TLVException</A></CODE> - with the following reason codes:<ul>
 <li><code>TLVException.MALFORMED_TLV</code> if the TLV representation in the specified byte
 array is not a well-formed constructed BER TLV structure.
 <li><code>TLVException.MALFORMED_TAG</code> if the tag representation in the specified byte
 array is not a well-formed BER Tag structure.
 <li><code>TLVException.INVALID_PARAM</code> if the <code>berTLVArray</code> array does not
 contain a top level contained TLV element at the specified <code>startOffset</code> offset.
 </ul></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/ConstructedBERTLV.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/tlv/ConstructedBERTag.html" title="class in javacardx.framework.tlv"><B>PREV CLASS</B></A>&nbsp;
&nbsp;<A HREF="../../../javacardx/framework/tlv/PrimitiveBERTag.html" title="class in javacardx.framework.tlv"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../../index.html?javacardx/framework/tlv/ConstructedBERTLV.html" target="_top"><B>FRAMES</B></A>  &nbsp;
&nbsp;<A HREF="ConstructedBERTLV.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;FIELD&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;FIELD&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>