You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@commons.apache.org by ol...@apache.org on 2012/12/16 00:43:19 UTC
svn commit: r1422422 [4/33] - in
/commons/cms-site/trunk/collections/api-2.1.1: ./ org/ org/apache/
org/apache/commons/ org/apache/commons/collections/
org/apache/commons/collections/class-use/
org/apache/commons/collections/comparators/ org/apache/com...
Added: commons/cms-site/trunk/collections/api-2.1.1/org/apache/commons/collections/BagUtils.html
URL: http://svn.apache.org/viewvc/commons/cms-site/trunk/collections/api-2.1.1/org/apache/commons/collections/BagUtils.html?rev=1422422&view=auto
==============================================================================
--- commons/cms-site/trunk/collections/api-2.1.1/org/apache/commons/collections/BagUtils.html (added)
+++ commons/cms-site/trunk/collections/api-2.1.1/org/apache/commons/collections/BagUtils.html Sat Dec 15 23:43:02 2012
@@ -0,0 +1,408 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN""http://www.w3.org/TR/REC-html40/loose.dtd">
+<!--NewPage-->
+<HTML>
+<HEAD>
+<!-- Generated by javadoc on Sat May 29 13:55:30 BST 2004 -->
+<TITLE>
+BagUtils (Collections 2.1.1 release API)
+</TITLE>
+<META NAME="keywords" CONTENT="org.apache.commons.collections.BagUtils,BagUtils class">
+<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css" TITLE="Style">
+</HEAD>
+<SCRIPT>
+function asd()
+{
+parent.document.title="BagUtils (Collections 2.1.1 release API)";
+}
+</SCRIPT>
+<BODY BGCOLOR="white" onload="asd();">
+
+<!-- ========== START OF NAVBAR ========== -->
+<A NAME="navbar_top"><!-- --></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
+<TR>
+<TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_top_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/BagUtils.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../org/apache/commons/collections/ArrayStack.html"><B>PREV CLASS</B></A>
+ <A HREF="../../../../org/apache/commons/collections/BeanMap.html"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../index.html" TARGET="_top"><B>FRAMES</B></A>
+ <A HREF="BagUtils.html" TARGET="_top"><B>NO FRAMES</B></A>
+
+<SCRIPT>
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+<A HREF="../../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>
+</NOSCRIPT>
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: NESTED | FIELD | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: FIELD | CONSTR | <A HREF="#method_detail">METHOD</A></FONT></TD>
+</TR>
+</TABLE>
+<!-- =========== END OF NAVBAR =========== -->
+
+<HR>
+<!-- ======== START OF CLASS DATA ======== -->
+<H2>
+<FONT SIZE="-1">
+org.apache.commons.collections</FONT>
+<BR>
+Class BagUtils</H2>
+<PRE>
+java.lang.Object
+ |
+ +--<B>org.apache.commons.collections.BagUtils</B>
+</PRE>
+<HR>
+<DL>
+<DT>public class <B>BagUtils</B><DT>extends java.lang.Object</DL>
+
+<P>
+Provides utility methods and decorators for <A HREF="../../../../org/apache/commons/collections/Bag.html"><CODE>Bag</CODE></A>
+ and <A HREF="../../../../org/apache/commons/collections/SortedBag.html"><CODE>SortedBag</CODE></A> instances.<P>
+<P>
+
+<P>
+<DL>
+<DT><B>Since:</B></DT>
+ <DD>2.1</DD>
+<DT><B>Version:</B></DT>
+ <DD>$Id: BagUtils.java,v 1.7.2.1 2004/05/22 12:14:01 scolebourne Exp $</DD>
+<DT><B>Author:</B></DT>
+ <DD>Paul Jack, Stephen Colebourne</DD>
+</DL>
+<HR>
+
+<P>
+<!-- ======== NESTED CLASS SUMMARY ======== -->
+
+
+<!-- =========== FIELD SUMMARY =========== -->
+
+
+<!-- ======== CONSTRUCTOR SUMMARY ======== -->
+
+
+<!-- ========== METHOD SUMMARY =========== -->
+
+<A NAME="method_summary"><!-- --></A>
+<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TD COLSPAN=2><FONT SIZE="+2">
+<B>Method Summary</B></FONT></TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static <A HREF="../../../../org/apache/commons/collections/Bag.html">Bag</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/BagUtils.html#predicatedBag(org.apache.commons.collections.Bag, org.apache.commons.collections.Predicate)">predicatedBag</A></B>(<A HREF="../../../../org/apache/commons/collections/Bag.html">Bag</A> bag,
+ <A HREF="../../../../org/apache/commons/collections/Predicate.html">Predicate</A> predicate)</CODE>
+
+<BR>
+ Returns a predicated bag backed by the given bag.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static <A HREF="../../../../org/apache/commons/collections/SortedBag.html">SortedBag</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/BagUtils.html#predicatedSortedBag(org.apache.commons.collections.SortedBag, org.apache.commons.collections.Predicate)">predicatedSortedBag</A></B>(<A HREF="../../../../org/apache/commons/collections/SortedBag.html">SortedBag</A> bag,
+ <A HREF="../../../../org/apache/commons/collections/Predicate.html">Predicate</A> predicate)</CODE>
+
+<BR>
+ Returns a predicated sorted bag backed by the given sorted bag.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static <A HREF="../../../../org/apache/commons/collections/Bag.html">Bag</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/BagUtils.html#synchronizedBag(org.apache.commons.collections.Bag)">synchronizedBag</A></B>(<A HREF="../../../../org/apache/commons/collections/Bag.html">Bag</A> bag)</CODE>
+
+<BR>
+ Returns a synchronized (thread-safe) bag backed by the given bag.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static <A HREF="../../../../org/apache/commons/collections/SortedBag.html">SortedBag</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/BagUtils.html#synchronizedSortedBag(org.apache.commons.collections.SortedBag)">synchronizedSortedBag</A></B>(<A HREF="../../../../org/apache/commons/collections/SortedBag.html">SortedBag</A> bag)</CODE>
+
+<BR>
+ Returns a synchronized (thread-safe) sorted bag backed by the given
+ sorted bag.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static <A HREF="../../../../org/apache/commons/collections/Bag.html">Bag</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/BagUtils.html#unmodifiableBag(org.apache.commons.collections.Bag)">unmodifiableBag</A></B>(<A HREF="../../../../org/apache/commons/collections/Bag.html">Bag</A> bag)</CODE>
+
+<BR>
+ Returns an unmodifiable view of the given bag.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static <A HREF="../../../../org/apache/commons/collections/SortedBag.html">SortedBag</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/BagUtils.html#unmodifiableSortedBag(org.apache.commons.collections.SortedBag)">unmodifiableSortedBag</A></B>(<A HREF="../../../../org/apache/commons/collections/SortedBag.html">SortedBag</A> bag)</CODE>
+
+<BR>
+ Returns an unmodifiable view of the given sorted bag.</TD>
+</TR>
+</TABLE>
+ <A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
+<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
+<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
+<TD><B>Methods inherited from class java.lang.Object</B></TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE>equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait</CODE></TD>
+</TR>
+</TABLE>
+
+<P>
+
+<!-- ============ FIELD DETAIL =========== -->
+
+
+<!-- ========= CONSTRUCTOR DETAIL ======== -->
+
+
+<!-- ============ METHOD DETAIL ========== -->
+
+<A NAME="method_detail"><!-- --></A>
+<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TD COLSPAN=1><FONT SIZE="+2">
+<B>Method Detail</B></FONT></TD>
+</TR>
+</TABLE>
+
+<A NAME="predicatedBag(org.apache.commons.collections.Bag, org.apache.commons.collections.Predicate)"><!-- --></A><H3>
+predicatedBag</H3>
+<PRE>
+public static <A HREF="../../../../org/apache/commons/collections/Bag.html">Bag</A> <B>predicatedBag</B>(<A HREF="../../../../org/apache/commons/collections/Bag.html">Bag</A> bag,
+ <A HREF="../../../../org/apache/commons/collections/Predicate.html">Predicate</A> predicate)</PRE>
+<DL>
+<DD>Returns a predicated bag backed by the given bag. Only objects
+ that pass the test in the given predicate can be added to the bag.
+ It is important not to use the original bag after invoking this
+ method, as it is a backdoor for adding unvalidated objects.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>bag</CODE> - the bag to predicate, must not be null<DD><CODE>predicate</CODE> - the predicate for the bag, must not be null
+<DT><B>Returns:</B><DD>a predicated bag backed by the given bag
+<DT><B>Throws:</B>
+<DD><CODE>java.lang.IllegalArgumentException</CODE> - if the Bag or Predicate is null</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="unmodifiableBag(org.apache.commons.collections.Bag)"><!-- --></A><H3>
+unmodifiableBag</H3>
+<PRE>
+public static <A HREF="../../../../org/apache/commons/collections/Bag.html">Bag</A> <B>unmodifiableBag</B>(<A HREF="../../../../org/apache/commons/collections/Bag.html">Bag</A> bag)</PRE>
+<DL>
+<DD>Returns an unmodifiable view of the given bag. Any modification
+ attempts to the returned bag will raise an
+ <CODE>UnsupportedOperationException</CODE>.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>bag</CODE> - the bag whose unmodifiable view is to be returned, must not be null
+<DT><B>Returns:</B><DD>an unmodifiable view of that bag
+<DT><B>Throws:</B>
+<DD><CODE>java.lang.IllegalArgumentException</CODE> - if the Bag is null</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="synchronizedBag(org.apache.commons.collections.Bag)"><!-- --></A><H3>
+synchronizedBag</H3>
+<PRE>
+public static <A HREF="../../../../org/apache/commons/collections/Bag.html">Bag</A> <B>synchronizedBag</B>(<A HREF="../../../../org/apache/commons/collections/Bag.html">Bag</A> bag)</PRE>
+<DL>
+<DD>Returns a synchronized (thread-safe) bag backed by the given bag.
+ In order to guarantee serial access, it is critical that all
+ access to the backing bag is accomplished through the returned bag.
+ <p>
+ It is imperative that the user manually synchronize on the returned
+ bag when iterating over it:
+
+ <pre>
+ Bag bag = BagUtils.synchronizedBag(new HashBag());
+ ...
+ synchronized(bag) {
+ Iterator i = bag.iterator(); // Must be in synchronized block
+ while (i.hasNext())
+ foo(i.next());
+ }
+ }
+ </pre>
+
+ Failure to follow this advice may result in non-deterministic
+ behavior.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>bag</CODE> - the bag to synchronize, must not be null
+<DT><B>Returns:</B><DD>a synchronized bag backed by that bag
+<DT><B>Throws:</B>
+<DD><CODE>java.lang.IllegalArgumentException</CODE> - if the Bag is null</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="predicatedSortedBag(org.apache.commons.collections.SortedBag, org.apache.commons.collections.Predicate)"><!-- --></A><H3>
+predicatedSortedBag</H3>
+<PRE>
+public static <A HREF="../../../../org/apache/commons/collections/SortedBag.html">SortedBag</A> <B>predicatedSortedBag</B>(<A HREF="../../../../org/apache/commons/collections/SortedBag.html">SortedBag</A> bag,
+ <A HREF="../../../../org/apache/commons/collections/Predicate.html">Predicate</A> predicate)</PRE>
+<DL>
+<DD>Returns a predicated sorted bag backed by the given sorted bag.
+ Only objects that pass the test in the given predicate can be
+ added to the bag.
+ It is important not to use the original bag after invoking this
+ method, as it is a backdoor for adding unvalidated objects.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>bag</CODE> - the sorted bag to predicate, must not be null<DD><CODE>predicate</CODE> - the predicate for the bag, must not be null
+<DT><B>Returns:</B><DD>a predicated bag backed by the given bag
+<DT><B>Throws:</B>
+<DD><CODE>java.lang.IllegalArgumentException</CODE> - if the SortedBag or Predicate is null</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="unmodifiableSortedBag(org.apache.commons.collections.SortedBag)"><!-- --></A><H3>
+unmodifiableSortedBag</H3>
+<PRE>
+public static <A HREF="../../../../org/apache/commons/collections/SortedBag.html">SortedBag</A> <B>unmodifiableSortedBag</B>(<A HREF="../../../../org/apache/commons/collections/SortedBag.html">SortedBag</A> bag)</PRE>
+<DL>
+<DD>Returns an unmodifiable view of the given sorted bag. Any modification
+ attempts to the returned bag will raise an
+ <CODE>UnsupportedOperationException</CODE>.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>bag</CODE> - the bag whose unmodifiable view is to be returned, must not be null
+<DT><B>Returns:</B><DD>an unmodifiable view of that bag
+<DT><B>Throws:</B>
+<DD><CODE>java.lang.IllegalArgumentException</CODE> - if the SortedBag is null</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="synchronizedSortedBag(org.apache.commons.collections.SortedBag)"><!-- --></A><H3>
+synchronizedSortedBag</H3>
+<PRE>
+public static <A HREF="../../../../org/apache/commons/collections/SortedBag.html">SortedBag</A> <B>synchronizedSortedBag</B>(<A HREF="../../../../org/apache/commons/collections/SortedBag.html">SortedBag</A> bag)</PRE>
+<DL>
+<DD>Returns a synchronized (thread-safe) sorted bag backed by the given
+ sorted bag.
+ In order to guarantee serial access, it is critical that all
+ access to the backing bag is accomplished through the returned bag.
+ <p>
+ It is imperative that the user manually synchronize on the returned
+ bag when iterating over it:
+
+ <pre>
+ SortedBag bag = BagUtils.synchronizedSortedBag(new TreeBag());
+ ...
+ synchronized(bag) {
+ Iterator i = bag.iterator(); // Must be in synchronized block
+ while (i.hasNext())
+ foo(i.next());
+ }
+ }
+ </pre>
+
+ Failure to follow this advice may result in non-deterministic
+ behavior.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>bag</CODE> - the bag to synchronize, must not be null
+<DT><B>Returns:</B><DD>a synchronized bag backed by that bag
+<DT><B>Throws:</B>
+<DD><CODE>java.lang.IllegalArgumentException</CODE> - if the SortedBag is null</DL>
+</DD>
+</DL>
+<!-- ========= END OF CLASS DATA ========= -->
+<HR>
+
+<!-- ========== START OF NAVBAR ========== -->
+<A NAME="navbar_bottom"><!-- --></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
+<TR>
+<TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_bottom_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/BagUtils.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../org/apache/commons/collections/ArrayStack.html"><B>PREV CLASS</B></A>
+ <A HREF="../../../../org/apache/commons/collections/BeanMap.html"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../index.html" TARGET="_top"><B>FRAMES</B></A>
+ <A HREF="BagUtils.html" TARGET="_top"><B>NO FRAMES</B></A>
+
+<SCRIPT>
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+<A HREF="../../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>
+</NOSCRIPT>
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: NESTED | FIELD | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: FIELD | CONSTR | <A HREF="#method_detail">METHOD</A></FONT></TD>
+</TR>
+</TABLE>
+<!-- =========== END OF NAVBAR =========== -->
+
+<HR>
+Copyright © 2001-2004 The Apache Software Foundation. All Rights Reserved.
+</BODY>
+</HTML>
Added: commons/cms-site/trunk/collections/api-2.1.1/org/apache/commons/collections/BeanMap.html
URL: http://svn.apache.org/viewvc/commons/cms-site/trunk/collections/api-2.1.1/org/apache/commons/collections/BeanMap.html?rev=1422422&view=auto
==============================================================================
--- commons/cms-site/trunk/collections/api-2.1.1/org/apache/commons/collections/BeanMap.html (added)
+++ commons/cms-site/trunk/collections/api-2.1.1/org/apache/commons/collections/BeanMap.html Sat Dec 15 23:43:02 2012
@@ -0,0 +1,812 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN""http://www.w3.org/TR/REC-html40/loose.dtd">
+<!--NewPage-->
+<HTML>
+<HEAD>
+<!-- Generated by javadoc on Sat May 29 13:55:30 BST 2004 -->
+<TITLE>
+BeanMap (Collections 2.1.1 release API)
+</TITLE>
+<META NAME="keywords" CONTENT="org.apache.commons.collections.BeanMap,BeanMap class">
+<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css" TITLE="Style">
+</HEAD>
+<SCRIPT>
+function asd()
+{
+parent.document.title="BeanMap (Collections 2.1.1 release API)";
+}
+</SCRIPT>
+<BODY BGCOLOR="white" onload="asd();">
+
+<!-- ========== START OF NAVBAR ========== -->
+<A NAME="navbar_top"><!-- --></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
+<TR>
+<TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_top_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/BeanMap.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../org/apache/commons/collections/BagUtils.html"><B>PREV CLASS</B></A>
+ <A HREF="../../../../org/apache/commons/collections/BinaryHeap.html"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../index.html" TARGET="_top"><B>FRAMES</B></A>
+ <A HREF="BeanMap.html" TARGET="_top"><B>NO FRAMES</B></A>
+
+<SCRIPT>
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+<A HREF="../../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>
+</NOSCRIPT>
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: NESTED | <A HREF="#field_summary">FIELD</A> | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: <A HREF="#field_detail">FIELD</A> | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD>
+</TR>
+</TABLE>
+<!-- =========== END OF NAVBAR =========== -->
+
+<HR>
+<!-- ======== START OF CLASS DATA ======== -->
+<H2>
+<FONT SIZE="-1">
+org.apache.commons.collections</FONT>
+<BR>
+Class BeanMap</H2>
+<PRE>
+java.lang.Object
+ |
+ +--java.util.AbstractMap
+ |
+ +--<B>org.apache.commons.collections.BeanMap</B>
+</PRE>
+<DL>
+<DT><B>All Implemented Interfaces:</B> <DD>java.lang.Cloneable, java.util.Map</DD>
+</DL>
+<HR>
+<DL>
+<DT>public class <B>BeanMap</B><DT>extends java.util.AbstractMap<DT>implements java.lang.Cloneable</DL>
+
+<P>
+An implementation of Map for JavaBeans which uses introspection to
+ get and put properties in the bean.
+
+ If an exception occurs during attempts to get or set a property then the
+ property is considered non existent in the Map
+<P>
+
+<P>
+<DL>
+<DT><B>Since:</B></DT>
+ <DD>1.0</DD>
+<DT><B>Author:</B></DT>
+ <DD><a href="mailto:jstrachan@apache.org">James Strachan</a></DD>
+</DL>
+<HR>
+
+<P>
+<!-- ======== NESTED CLASS SUMMARY ======== -->
+
+
+<!-- =========== FIELD SUMMARY =========== -->
+
+<A NAME="field_summary"><!-- --></A>
+<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TD COLSPAN=2><FONT SIZE="+2">
+<B>Field Summary</B></FONT></TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static java.util.HashMap</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/BeanMap.html#defaultTransformers">defaultTransformers</A></B></CODE>
+
+<BR>
+ Maps primitive Class types to transformers.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static java.lang.Object[]</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/BeanMap.html#NULL_ARGUMENTS">NULL_ARGUMENTS</A></B></CODE>
+
+<BR>
+ An empty array.</TD>
+</TR>
+</TABLE>
+
+<!-- ======== CONSTRUCTOR SUMMARY ======== -->
+
+<A NAME="constructor_summary"><!-- --></A>
+<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TD COLSPAN=2><FONT SIZE="+2">
+<B>Constructor Summary</B></FONT></TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/BeanMap.html#BeanMap()">BeanMap</A></B>()</CODE>
+
+<BR>
+ Constructs a new empty <Code>BeanMap</Code>.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/BeanMap.html#BeanMap(java.lang.Object)">BeanMap</A></B>(java.lang.Object bean)</CODE>
+
+<BR>
+ Constructs a new <Code>BeanMap</Code> that operates on the
+ specified bean.</TD>
+</TR>
+</TABLE>
+
+<!-- ========== METHOD SUMMARY =========== -->
+
+<A NAME="method_summary"><!-- --></A>
+<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TD COLSPAN=2><FONT SIZE="+2">
+<B>Method Summary</B></FONT></TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> void</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/BeanMap.html#clear()">clear</A></B>()</CODE>
+
+<BR>
+ This method reinitializes the bean map to have default values for the
+ bean's properties.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> java.lang.Object</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/BeanMap.html#clone()">clone</A></B>()</CODE>
+
+<BR>
+ Clone this bean map using the following process:
+
+
+
+ If there is no underlying bean, return a cloned BeanMap without a
+ bean.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> boolean</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/BeanMap.html#containsKey(java.lang.Object)">containsKey</A></B>(java.lang.Object name)</CODE>
+
+<BR>
+ Returns true if the bean defines a property with the given name.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> boolean</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/BeanMap.html#containsValue(java.lang.Object)">containsValue</A></B>(java.lang.Object value)</CODE>
+
+<BR>
+ Returns true if the bean defines a property whose current value is
+ the given object.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> java.util.Iterator</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/BeanMap.html#entryIterator()">entryIterator</A></B>()</CODE>
+
+<BR>
+ Convenience method for getting an iterator over the entries.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> java.util.Set</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/BeanMap.html#entrySet()">entrySet</A></B>()</CODE>
+
+<BR>
+ Get the mappings for this BeanMap</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> java.lang.Object</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/BeanMap.html#get(java.lang.Object)">get</A></B>(java.lang.Object name)</CODE>
+
+<BR>
+ Returns the value of the bean's property with the given name.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> java.lang.Object</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/BeanMap.html#getBean()">getBean</A></B>()</CODE>
+
+<BR>
+ Returns the bean currently being operated on.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> java.lang.Class</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/BeanMap.html#getType(java.lang.String)">getType</A></B>(java.lang.String name)</CODE>
+
+<BR>
+ Returns the type of the property with the given name.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> java.util.Iterator</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/BeanMap.html#keyIterator()">keyIterator</A></B>()</CODE>
+
+<BR>
+ Convenience method for getting an iterator over the keys.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> java.util.Set</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/BeanMap.html#keySet()">keySet</A></B>()</CODE>
+
+<BR>
+ Get the keys for this BeanMap.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> java.lang.Object</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/BeanMap.html#put(java.lang.Object, java.lang.Object)">put</A></B>(java.lang.Object name,
+ java.lang.Object value)</CODE>
+
+<BR>
+ Sets the bean property with the given name to the given value.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> void</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/BeanMap.html#putAllWriteable(org.apache.commons.collections.BeanMap)">putAllWriteable</A></B>(<A HREF="../../../../org/apache/commons/collections/BeanMap.html">BeanMap</A> map)</CODE>
+
+<BR>
+ Puts all of the writeable properties from the given BeanMap into this
+ BeanMap.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> void</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/BeanMap.html#setBean(java.lang.Object)">setBean</A></B>(java.lang.Object newBean)</CODE>
+
+<BR>
+ Sets the bean to be operated on by this map.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> int</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/BeanMap.html#size()">size</A></B>()</CODE>
+
+<BR>
+ Returns the number of properties defined by the bean.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> java.util.Iterator</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/BeanMap.html#valueIterator()">valueIterator</A></B>()</CODE>
+
+<BR>
+ Convenience method for getting an iterator over the values.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> java.util.Collection</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/BeanMap.html#values()">values</A></B>()</CODE>
+
+<BR>
+ Returns the values for the BeanMap.</TD>
+</TR>
+</TABLE>
+ <A NAME="methods_inherited_from_class_java.util.AbstractMap"><!-- --></A>
+<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
+<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
+<TD><B>Methods inherited from class java.util.AbstractMap</B></TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE>equals, hashCode, isEmpty, putAll, remove, toString</CODE></TD>
+</TR>
+</TABLE>
+ <A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
+<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
+<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
+<TD><B>Methods inherited from class java.lang.Object</B></TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE>getClass, notify, notifyAll, wait, wait, wait</CODE></TD>
+</TR>
+</TABLE>
+
+<P>
+
+<!-- ============ FIELD DETAIL =========== -->
+
+<A NAME="field_detail"><!-- --></A>
+<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TD COLSPAN=1><FONT SIZE="+2">
+<B>Field Detail</B></FONT></TD>
+</TR>
+</TABLE>
+
+<A NAME="NULL_ARGUMENTS"><!-- --></A><H3>
+NULL_ARGUMENTS</H3>
+<PRE>
+public static final java.lang.Object[] <B>NULL_ARGUMENTS</B></PRE>
+<DL>
+<DD>An empty array. Used to invoke accessors via reflection.
+<P>
+<DL>
+</DL>
+</DL>
+<HR>
+
+<A NAME="defaultTransformers"><!-- --></A><H3>
+defaultTransformers</H3>
+<PRE>
+public static java.util.HashMap <B>defaultTransformers</B></PRE>
+<DL>
+<DD>Maps primitive Class types to transformers. The transformer
+ transform strings into the appropriate primitive wrapper.
+<P>
+<DL>
+</DL>
+</DL>
+
+<!-- ========= CONSTRUCTOR DETAIL ======== -->
+
+<A NAME="constructor_detail"><!-- --></A>
+<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TD COLSPAN=1><FONT SIZE="+2">
+<B>Constructor Detail</B></FONT></TD>
+</TR>
+</TABLE>
+
+<A NAME="BeanMap()"><!-- --></A><H3>
+BeanMap</H3>
+<PRE>
+public <B>BeanMap</B>()</PRE>
+<DL>
+<DD>Constructs a new empty <Code>BeanMap</Code>.
+<P>
+</DL>
+<HR>
+
+<A NAME="BeanMap(java.lang.Object)"><!-- --></A><H3>
+BeanMap</H3>
+<PRE>
+public <B>BeanMap</B>(java.lang.Object bean)</PRE>
+<DL>
+<DD>Constructs a new <Code>BeanMap</Code> that operates on the
+ specified bean. If the given bean is <Code>null</COde>, then
+ this map will be empty.
+<P>
+<DT><B>Parameters:</B><DD><CODE>bean</CODE> - the bean for this map to operate on</DL>
+
+<!-- ============ METHOD DETAIL ========== -->
+
+<A NAME="method_detail"><!-- --></A>
+<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TD COLSPAN=1><FONT SIZE="+2">
+<B>Method Detail</B></FONT></TD>
+</TR>
+</TABLE>
+
+<A NAME="clone()"><!-- --></A><H3>
+clone</H3>
+<PRE>
+public java.lang.Object <B>clone</B>()
+ throws java.lang.CloneNotSupportedException</PRE>
+<DL>
+<DD>Clone this bean map using the following process:
+
+ <ul>
+
+ <li>If there is no underlying bean, return a cloned BeanMap without a
+ bean.
+
+ <li>Since there is an underlying bean, try to instantiate a new bean of
+ the same type using Class.newInstance().
+
+ <li>If the instantiation fails, throw a CloneNotSupportedException
+
+ <li>Clone the bean map and set the newly instantiated bean as the
+ underyling bean for the bean map.
+
+ <li>Copy each property that is both readable and writable from the
+ existing object to a cloned bean map.
+
+ <li>If anything fails along the way, throw a
+ CloneNotSupportedException.
+
+ <ul>
+<P>
+<DD><DL>
+<DT><B>Overrides:</B><DD><CODE>clone</CODE> in class <CODE>java.util.AbstractMap</CODE></DL>
+</DD>
+<DD><DL>
+
+<DD><CODE>java.lang.CloneNotSupportedException</CODE></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="putAllWriteable(org.apache.commons.collections.BeanMap)"><!-- --></A><H3>
+putAllWriteable</H3>
+<PRE>
+public void <B>putAllWriteable</B>(<A HREF="../../../../org/apache/commons/collections/BeanMap.html">BeanMap</A> map)</PRE>
+<DL>
+<DD>Puts all of the writeable properties from the given BeanMap into this
+ BeanMap. Read-only properties will be ignored.
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>map</CODE> - the BeanMap whose properties to put</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="clear()"><!-- --></A><H3>
+clear</H3>
+<PRE>
+public void <B>clear</B>()</PRE>
+<DL>
+<DD>This method reinitializes the bean map to have default values for the
+ bean's properties. This is accomplished by constructing a new instance
+ of the bean which the map uses as its underlying data source. This
+ behavior for <code>clear()</code> differs from the Map contract in that
+ the mappings are not actually removed from the map (the mappings for a
+ BeanMap are fixed).
+<P>
+<DD><DL>
+<DT><B>Specified by:</B><DD><CODE>clear</CODE> in interface <CODE>java.util.Map</CODE><DT><B>Overrides:</B><DD><CODE>clear</CODE> in class <CODE>java.util.AbstractMap</CODE></DL>
+</DD>
+<DD><DL>
+</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="containsKey(java.lang.Object)"><!-- --></A><H3>
+containsKey</H3>
+<PRE>
+public boolean <B>containsKey</B>(java.lang.Object name)</PRE>
+<DL>
+<DD>Returns true if the bean defines a property with the given name.
+ The given name must be a <Code>String</Code>; if not, this method
+ returns false. This method will also return false if the bean
+ does not define a property with that name.
+<P>
+<DD><DL>
+<DT><B>Specified by:</B><DD><CODE>containsKey</CODE> in interface <CODE>java.util.Map</CODE><DT><B>Overrides:</B><DD><CODE>containsKey</CODE> in class <CODE>java.util.AbstractMap</CODE></DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>name</CODE> - the name of the property to check
+<DT><B>Returns:</B><DD>false if the given name is null or is not a <Code>String</Code>;
+ false if the bean does not define a property with that name; or
+ true if the bean does define a property with that name</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="containsValue(java.lang.Object)"><!-- --></A><H3>
+containsValue</H3>
+<PRE>
+public boolean <B>containsValue</B>(java.lang.Object value)</PRE>
+<DL>
+<DD>Returns true if the bean defines a property whose current value is
+ the given object.
+<P>
+<DD><DL>
+<DT><B>Specified by:</B><DD><CODE>containsValue</CODE> in interface <CODE>java.util.Map</CODE><DT><B>Overrides:</B><DD><CODE>containsValue</CODE> in class <CODE>java.util.AbstractMap</CODE></DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>value</CODE> - the value to check
+<DT><B>Returns:</B><DD>false true if the bean has at least one property whose
+ current value is that object, false otherwise</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="get(java.lang.Object)"><!-- --></A><H3>
+get</H3>
+<PRE>
+public java.lang.Object <B>get</B>(java.lang.Object name)</PRE>
+<DL>
+<DD>Returns the value of the bean's property with the given name.
+ The given name must be a <CODE>String</CODE> and must not be
+ null; otherwise, this method returns <Code>null</Code>.
+ If the bean defines a property with the given name, the value of
+ that property is returned. Otherwise, <Code>null</Code> is
+ returned.
+<P>
+<DD><DL>
+<DT><B>Specified by:</B><DD><CODE>get</CODE> in interface <CODE>java.util.Map</CODE><DT><B>Overrides:</B><DD><CODE>get</CODE> in class <CODE>java.util.AbstractMap</CODE></DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>name</CODE> - the name of the property whose value to return
+<DT><B>Returns:</B><DD>the value of the property with that name</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="put(java.lang.Object, java.lang.Object)"><!-- --></A><H3>
+put</H3>
+<PRE>
+public java.lang.Object <B>put</B>(java.lang.Object name,
+ java.lang.Object value)
+ throws java.lang.IllegalArgumentException,
+ java.lang.ClassCastException</PRE>
+<DL>
+<DD>Sets the bean property with the given name to the given value.
+<P>
+<DD><DL>
+<DT><B>Specified by:</B><DD><CODE>put</CODE> in interface <CODE>java.util.Map</CODE><DT><B>Overrides:</B><DD><CODE>put</CODE> in class <CODE>java.util.AbstractMap</CODE></DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>name</CODE> - the name of the property to set<DD><CODE>value</CODE> - the value to set that property to
+<DT><B>Returns:</B><DD>the previous value of that property
+<DT><B>Throws:</B>
+<DD><CODE>java.lang.IllegalArgumentException</CODE> - if the given name is null;
+ if the given name is not a <CODE>String</CODE>; if the bean doesn't
+ define a property with that name; or if the bean property with
+ that name is read-only
+<DD><CODE>java.lang.ClassCastException</CODE></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="size()"><!-- --></A><H3>
+size</H3>
+<PRE>
+public int <B>size</B>()</PRE>
+<DL>
+<DD>Returns the number of properties defined by the bean.
+<P>
+<DD><DL>
+<DT><B>Specified by:</B><DD><CODE>size</CODE> in interface <CODE>java.util.Map</CODE><DT><B>Overrides:</B><DD><CODE>size</CODE> in class <CODE>java.util.AbstractMap</CODE></DL>
+</DD>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>the number of properties defined by the bean</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="keySet()"><!-- --></A><H3>
+keySet</H3>
+<PRE>
+public java.util.Set <B>keySet</B>()</PRE>
+<DL>
+<DD>Get the keys for this BeanMap.
+<P>
+<DD><DL>
+<DT><B>Specified by:</B><DD><CODE>keySet</CODE> in interface <CODE>java.util.Map</CODE><DT><B>Overrides:</B><DD><CODE>keySet</CODE> in class <CODE>java.util.AbstractMap</CODE></DL>
+</DD>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>BeanMap keys. The Set returned by this method is not
+ modifiable.</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="entrySet()"><!-- --></A><H3>
+entrySet</H3>
+<PRE>
+public java.util.Set <B>entrySet</B>()</PRE>
+<DL>
+<DD>Get the mappings for this BeanMap
+<P>
+<DD><DL>
+<DT><B>Specified by:</B><DD><CODE>entrySet</CODE> in interface <CODE>java.util.Map</CODE><DT><B>Specified by:</B><DD><CODE>entrySet</CODE> in class <CODE>java.util.AbstractMap</CODE></DL>
+</DD>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>BeanMap mappings. The Set returned by this method
+ is not modifiable.</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="values()"><!-- --></A><H3>
+values</H3>
+<PRE>
+public java.util.Collection <B>values</B>()</PRE>
+<DL>
+<DD>Returns the values for the BeanMap.
+<P>
+<DD><DL>
+<DT><B>Specified by:</B><DD><CODE>values</CODE> in interface <CODE>java.util.Map</CODE><DT><B>Overrides:</B><DD><CODE>values</CODE> in class <CODE>java.util.AbstractMap</CODE></DL>
+</DD>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>values for the BeanMap. The returned collection is not
+ modifiable.</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getType(java.lang.String)"><!-- --></A><H3>
+getType</H3>
+<PRE>
+public java.lang.Class <B>getType</B>(java.lang.String name)</PRE>
+<DL>
+<DD>Returns the type of the property with the given name.
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>name</CODE> - the name of the property
+<DT><B>Returns:</B><DD>the type of the property, or <Code>null</Code> if no such
+ property exists</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="keyIterator()"><!-- --></A><H3>
+keyIterator</H3>
+<PRE>
+public java.util.Iterator <B>keyIterator</B>()</PRE>
+<DL>
+<DD>Convenience method for getting an iterator over the keys.
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>an iterator over the keys</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="valueIterator()"><!-- --></A><H3>
+valueIterator</H3>
+<PRE>
+public java.util.Iterator <B>valueIterator</B>()</PRE>
+<DL>
+<DD>Convenience method for getting an iterator over the values.
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>an iterator over the values</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="entryIterator()"><!-- --></A><H3>
+entryIterator</H3>
+<PRE>
+public java.util.Iterator <B>entryIterator</B>()</PRE>
+<DL>
+<DD>Convenience method for getting an iterator over the entries.
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>an iterator over the entries</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getBean()"><!-- --></A><H3>
+getBean</H3>
+<PRE>
+public java.lang.Object <B>getBean</B>()</PRE>
+<DL>
+<DD>Returns the bean currently being operated on. The return value may
+ be null if this map is empty.
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>the bean being operated on by this map</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="setBean(java.lang.Object)"><!-- --></A><H3>
+setBean</H3>
+<PRE>
+public void <B>setBean</B>(java.lang.Object newBean)</PRE>
+<DL>
+<DD>Sets the bean to be operated on by this map. The given value may
+ be null, in which case this map will be empty.
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>newBean</CODE> - the new bean to operate on</DL>
+</DD>
+</DL>
+<!-- ========= END OF CLASS DATA ========= -->
+<HR>
+
+<!-- ========== START OF NAVBAR ========== -->
+<A NAME="navbar_bottom"><!-- --></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
+<TR>
+<TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_bottom_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/BeanMap.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../org/apache/commons/collections/BagUtils.html"><B>PREV CLASS</B></A>
+ <A HREF="../../../../org/apache/commons/collections/BinaryHeap.html"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../index.html" TARGET="_top"><B>FRAMES</B></A>
+ <A HREF="BeanMap.html" TARGET="_top"><B>NO FRAMES</B></A>
+
+<SCRIPT>
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+<A HREF="../../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>
+</NOSCRIPT>
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: NESTED | <A HREF="#field_summary">FIELD</A> | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: <A HREF="#field_detail">FIELD</A> | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD>
+</TR>
+</TABLE>
+<!-- =========== END OF NAVBAR =========== -->
+
+<HR>
+Copyright © 2001-2004 The Apache Software Foundation. All Rights Reserved.
+</BODY>
+</HTML>
Added: commons/cms-site/trunk/collections/api-2.1.1/org/apache/commons/collections/BinaryHeap.html
URL: http://svn.apache.org/viewvc/commons/cms-site/trunk/collections/api-2.1.1/org/apache/commons/collections/BinaryHeap.html?rev=1422422&view=auto
==============================================================================
--- commons/cms-site/trunk/collections/api-2.1.1/org/apache/commons/collections/BinaryHeap.html (added)
+++ commons/cms-site/trunk/collections/api-2.1.1/org/apache/commons/collections/BinaryHeap.html Sat Dec 15 23:43:02 2012
@@ -0,0 +1,736 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN""http://www.w3.org/TR/REC-html40/loose.dtd">
+<!--NewPage-->
+<HTML>
+<HEAD>
+<!-- Generated by javadoc on Sat May 29 13:55:30 BST 2004 -->
+<TITLE>
+BinaryHeap (Collections 2.1.1 release API)
+</TITLE>
+<META NAME="keywords" CONTENT="org.apache.commons.collections.BinaryHeap,BinaryHeap class">
+<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css" TITLE="Style">
+</HEAD>
+<SCRIPT>
+function asd()
+{
+parent.document.title="BinaryHeap (Collections 2.1.1 release API)";
+}
+</SCRIPT>
+<BODY BGCOLOR="white" onload="asd();">
+
+<!-- ========== START OF NAVBAR ========== -->
+<A NAME="navbar_top"><!-- --></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
+<TR>
+<TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_top_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/BinaryHeap.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../org/apache/commons/collections/BeanMap.html"><B>PREV CLASS</B></A>
+ <A HREF="../../../../org/apache/commons/collections/BoundedFifoBuffer.html"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../index.html" TARGET="_top"><B>FRAMES</B></A>
+ <A HREF="BinaryHeap.html" TARGET="_top"><B>NO FRAMES</B></A>
+
+<SCRIPT>
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+<A HREF="../../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>
+</NOSCRIPT>
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: NESTED | FIELD | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: FIELD | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD>
+</TR>
+</TABLE>
+<!-- =========== END OF NAVBAR =========== -->
+
+<HR>
+<!-- ======== START OF CLASS DATA ======== -->
+<H2>
+<FONT SIZE="-1">
+org.apache.commons.collections</FONT>
+<BR>
+Class BinaryHeap</H2>
+<PRE>
+java.lang.Object
+ |
+ +--java.util.AbstractCollection
+ |
+ +--<B>org.apache.commons.collections.BinaryHeap</B>
+</PRE>
+<DL>
+<DT><B>All Implemented Interfaces:</B> <DD><A HREF="../../../../org/apache/commons/collections/Buffer.html">Buffer</A>, java.util.Collection, <A HREF="../../../../org/apache/commons/collections/PriorityQueue.html">PriorityQueue</A></DD>
+</DL>
+<HR>
+<DL>
+<DT>public final class <B>BinaryHeap</B><DT>extends java.util.AbstractCollection<DT>implements <A HREF="../../../../org/apache/commons/collections/PriorityQueue.html">PriorityQueue</A>, <A HREF="../../../../org/apache/commons/collections/Buffer.html">Buffer</A></DL>
+
+<P>
+Binary heap implementation of <A HREF="../../../../org/apache/commons/collections/PriorityQueue.html"><CODE>PriorityQueue</CODE></A> and <A HREF="../../../../org/apache/commons/collections/Buffer.html"><CODE>Buffer</CODE></A>.
+ <p>
+ The removal order of a binary heap is based on either the natural sort
+ order of its elements or a specified <CODE>Comparator</CODE>. The
+ <A HREF="../../../../org/apache/commons/collections/BinaryHeap.html#remove()"><CODE>remove()</CODE></A> method always returns the first element as determined
+ by the sort order. (The <code>isMinHeap</code> flag in the constructors
+ can be used to reverse the sort order, in which case <A HREF="../../../../org/apache/commons/collections/BinaryHeap.html#remove()"><CODE>remove()</CODE></A>
+ will always remove the last element.) The removal order is
+ <i>not</i> the same as the order of iteration; elements are
+ returned by the iterator in no particular order.
+ <p>
+ The <A HREF="../../../../org/apache/commons/collections/BinaryHeap.html#add(java.lang.Object)"><CODE>add(Object)</CODE></A> and <A HREF="../../../../org/apache/commons/collections/BinaryHeap.html#remove()"><CODE>remove()</CODE></A> operations perform
+ in logarithmic time. The <A HREF="../../../../org/apache/commons/collections/BinaryHeap.html#get()"><CODE>get()</CODE></A> operation performs in constant
+ time. All other operations perform in linear time or worse.
+ <p>
+ Note that this implementation is not synchronized. Use
+ <A HREF="../../../../org/apache/commons/collections/BufferUtils.html#synchronizedBuffer(org.apache.commons.collections.Buffer)"><CODE>BufferUtils.synchronizedBuffer(Buffer)</CODE></A> to provide
+ synchronized access to a <code>BinaryHeap</code>:
+
+ <pre>
+ Buffer heap = BufferUtils.synchronizedBuffer(new BinaryHeap());
+ </pre>
+<P>
+
+<P>
+<DL>
+<DT><B>Since:</B></DT>
+ <DD>1.0</DD>
+<DT><B>Version:</B></DT>
+ <DD>$Id: BinaryHeap.java,v 1.11.2.1 2004/05/22 12:14:02 scolebourne Exp $</DD>
+<DT><B>Author:</B></DT>
+ <DD><a href="mailto:donaldp@apache.org">Peter Donald</a>, <a href="mailto:ram.chidambaram@telus.com">Ram Chidambaram</a>, <a href="mailto:mas@apache.org">Michael A. Smith</a>, Paul Jack, Stephen Colebourne</DD>
+</DL>
+<HR>
+
+<P>
+<!-- ======== NESTED CLASS SUMMARY ======== -->
+
+
+<!-- =========== FIELD SUMMARY =========== -->
+
+
+<!-- ======== CONSTRUCTOR SUMMARY ======== -->
+
+<A NAME="constructor_summary"><!-- --></A>
+<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TD COLSPAN=2><FONT SIZE="+2">
+<B>Constructor Summary</B></FONT></TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/BinaryHeap.html#BinaryHeap()">BinaryHeap</A></B>()</CODE>
+
+<BR>
+ Constructs a new minimum binary heap.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/BinaryHeap.html#BinaryHeap(boolean)">BinaryHeap</A></B>(boolean isMinHeap)</CODE>
+
+<BR>
+ Constructs a new minimum or maximum binary heap</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/BinaryHeap.html#BinaryHeap(boolean, java.util.Comparator)">BinaryHeap</A></B>(boolean isMinHeap,
+ java.util.Comparator comparator)</CODE>
+
+<BR>
+ Constructs a new <code>BinaryHeap</code>.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/BinaryHeap.html#BinaryHeap(java.util.Comparator)">BinaryHeap</A></B>(java.util.Comparator comparator)</CODE>
+
+<BR>
+ Constructs a new <code>BinaryHeap</code> that will use the given
+ comparator to order its elements.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/BinaryHeap.html#BinaryHeap(int)">BinaryHeap</A></B>(int capacity)</CODE>
+
+<BR>
+ Constructs a new minimum binary heap with the specified initial capacity.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/BinaryHeap.html#BinaryHeap(int, boolean)">BinaryHeap</A></B>(int capacity,
+ boolean isMinHeap)</CODE>
+
+<BR>
+ Constructs a new minimum or maximum binary heap with the specified
+ initial capacity.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/BinaryHeap.html#BinaryHeap(int, boolean, java.util.Comparator)">BinaryHeap</A></B>(int capacity,
+ boolean isMinHeap,
+ java.util.Comparator comparator)</CODE>
+
+<BR>
+ Constructs a new <code>BinaryHeap</code>.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/BinaryHeap.html#BinaryHeap(int, java.util.Comparator)">BinaryHeap</A></B>(int capacity,
+ java.util.Comparator comparator)</CODE>
+
+<BR>
+ Constructs a new <code>BinaryHeap</code>.</TD>
+</TR>
+</TABLE>
+
+<!-- ========== METHOD SUMMARY =========== -->
+
+<A NAME="method_summary"><!-- --></A>
+<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TD COLSPAN=2><FONT SIZE="+2">
+<B>Method Summary</B></FONT></TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> boolean</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/BinaryHeap.html#add(java.lang.Object)">add</A></B>(java.lang.Object object)</CODE>
+
+<BR>
+ Adds an object to this heap.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> void</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/BinaryHeap.html#clear()">clear</A></B>()</CODE>
+
+<BR>
+ Clears all elements from queue.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> java.lang.Object</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/BinaryHeap.html#get()">get</A></B>()</CODE>
+
+<BR>
+ Returns the priority element.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> void</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/BinaryHeap.html#insert(java.lang.Object)">insert</A></B>(java.lang.Object element)</CODE>
+
+<BR>
+ Inserts an element into queue.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> boolean</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/BinaryHeap.html#isEmpty()">isEmpty</A></B>()</CODE>
+
+<BR>
+ Tests if queue is empty.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> boolean</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/BinaryHeap.html#isFull()">isFull</A></B>()</CODE>
+
+<BR>
+ Tests if queue is full.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> java.util.Iterator</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/BinaryHeap.html#iterator()">iterator</A></B>()</CODE>
+
+<BR>
+ Returns an iterator over this heap's elements.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> java.lang.Object</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/BinaryHeap.html#peek()">peek</A></B>()</CODE>
+
+<BR>
+ Returns the element on top of heap but don't remove it.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> java.lang.Object</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/BinaryHeap.html#pop()">pop</A></B>()</CODE>
+
+<BR>
+ Returns the element on top of heap and remove it.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> java.lang.Object</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/BinaryHeap.html#remove()">remove</A></B>()</CODE>
+
+<BR>
+ Removes the priority element.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> int</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/BinaryHeap.html#size()">size</A></B>()</CODE>
+
+<BR>
+ Returns the number of elements in this heap.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> java.lang.String</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/BinaryHeap.html#toString()">toString</A></B>()</CODE>
+
+<BR>
+ Returns a string representation of this heap.</TD>
+</TR>
+</TABLE>
+ <A NAME="methods_inherited_from_class_java.util.AbstractCollection"><!-- --></A>
+<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
+<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
+<TD><B>Methods inherited from class java.util.AbstractCollection</B></TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE>addAll, contains, containsAll, remove, removeAll, retainAll, toArray, toArray</CODE></TD>
+</TR>
+</TABLE>
+ <A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
+<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
+<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
+<TD><B>Methods inherited from class java.lang.Object</B></TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE>equals, getClass, hashCode, notify, notifyAll, wait, wait, wait</CODE></TD>
+</TR>
+</TABLE>
+ <A NAME="methods_inherited_from_class_java.util.Collection"><!-- --></A>
+<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
+<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
+<TD><B>Methods inherited from interface java.util.Collection</B></TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE>addAll, contains, containsAll, equals, hashCode, remove, removeAll, retainAll, toArray, toArray</CODE></TD>
+</TR>
+</TABLE>
+
+<P>
+
+<!-- ============ FIELD DETAIL =========== -->
+
+
+<!-- ========= CONSTRUCTOR DETAIL ======== -->
+
+<A NAME="constructor_detail"><!-- --></A>
+<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TD COLSPAN=1><FONT SIZE="+2">
+<B>Constructor Detail</B></FONT></TD>
+</TR>
+</TABLE>
+
+<A NAME="BinaryHeap()"><!-- --></A><H3>
+BinaryHeap</H3>
+<PRE>
+public <B>BinaryHeap</B>()</PRE>
+<DL>
+<DD>Constructs a new minimum binary heap.
+<P>
+</DL>
+<HR>
+
+<A NAME="BinaryHeap(java.util.Comparator)"><!-- --></A><H3>
+BinaryHeap</H3>
+<PRE>
+public <B>BinaryHeap</B>(java.util.Comparator comparator)</PRE>
+<DL>
+<DD>Constructs a new <code>BinaryHeap</code> that will use the given
+ comparator to order its elements.
+<P>
+<DT><B>Parameters:</B><DD><CODE>comparator</CODE> - the comparator used to order the elements, null
+ means use natural order</DL>
+<HR>
+
+<A NAME="BinaryHeap(int)"><!-- --></A><H3>
+BinaryHeap</H3>
+<PRE>
+public <B>BinaryHeap</B>(int capacity)</PRE>
+<DL>
+<DD>Constructs a new minimum binary heap with the specified initial capacity.
+<P>
+<DT><B>Parameters:</B><DD><CODE>capacity</CODE> - The initial capacity for the heap. This value must
+ be greater than zero.
+<DT><B>Throws:</B>
+<DD><CODE>java.lang.IllegalArgumentException</CODE> - if <code>capacity</code> is <= <code>0</code></DL>
+<HR>
+
+<A NAME="BinaryHeap(int, java.util.Comparator)"><!-- --></A><H3>
+BinaryHeap</H3>
+<PRE>
+public <B>BinaryHeap</B>(int capacity,
+ java.util.Comparator comparator)</PRE>
+<DL>
+<DD>Constructs a new <code>BinaryHeap</code>.
+<P>
+<DT><B>Parameters:</B><DD><CODE>capacity</CODE> - the initial capacity for the heap<DD><CODE>comparator</CODE> - the comparator used to order the elements, null
+ means use natural order
+<DT><B>Throws:</B>
+<DD><CODE>java.lang.IllegalArgumentException</CODE> - if <code>capacity</code> is <= <code>0</code></DL>
+<HR>
+
+<A NAME="BinaryHeap(boolean)"><!-- --></A><H3>
+BinaryHeap</H3>
+<PRE>
+public <B>BinaryHeap</B>(boolean isMinHeap)</PRE>
+<DL>
+<DD>Constructs a new minimum or maximum binary heap
+<P>
+<DT><B>Parameters:</B><DD><CODE>isMinHeap</CODE> - if <code>true</code> the heap is created as a
+ minimum heap; otherwise, the heap is created as a maximum heap</DL>
+<HR>
+
+<A NAME="BinaryHeap(boolean, java.util.Comparator)"><!-- --></A><H3>
+BinaryHeap</H3>
+<PRE>
+public <B>BinaryHeap</B>(boolean isMinHeap,
+ java.util.Comparator comparator)</PRE>
+<DL>
+<DD>Constructs a new <code>BinaryHeap</code>.
+<P>
+<DT><B>Parameters:</B><DD><CODE>isMinHeap</CODE> - true to use the order imposed by the given
+ comparator; false to reverse that order<DD><CODE>comparator</CODE> - the comparator used to order the elements, null
+ means use natural order</DL>
+<HR>
+
+<A NAME="BinaryHeap(int, boolean)"><!-- --></A><H3>
+BinaryHeap</H3>
+<PRE>
+public <B>BinaryHeap</B>(int capacity,
+ boolean isMinHeap)</PRE>
+<DL>
+<DD>Constructs a new minimum or maximum binary heap with the specified
+ initial capacity.
+<P>
+<DT><B>Parameters:</B><DD><CODE>capacity</CODE> - the initial capacity for the heap. This value must
+ be greater than zero.<DD><CODE>isMinHeap</CODE> - if <code>true</code> the heap is created as a
+ minimum heap; otherwise, the heap is created as a maximum heap.
+<DT><B>Throws:</B>
+<DD><CODE>java.lang.IllegalArgumentException</CODE> - if <code>capacity</code> is <code><= 0</code></DL>
+<HR>
+
+<A NAME="BinaryHeap(int, boolean, java.util.Comparator)"><!-- --></A><H3>
+BinaryHeap</H3>
+<PRE>
+public <B>BinaryHeap</B>(int capacity,
+ boolean isMinHeap,
+ java.util.Comparator comparator)</PRE>
+<DL>
+<DD>Constructs a new <code>BinaryHeap</code>.
+<P>
+<DT><B>Parameters:</B><DD><CODE>capacity</CODE> - the initial capacity for the heap<DD><CODE>isMinHeap</CODE> - true to use the order imposed by the given
+ comparator; false to reverse that order<DD><CODE>comparator</CODE> - the comparator used to order the elements, null
+ means use natural order
+<DT><B>Throws:</B>
+<DD><CODE>java.lang.IllegalArgumentException</CODE> - if <code>capacity</code> is <code><= 0</code></DL>
+
+<!-- ============ METHOD DETAIL ========== -->
+
+<A NAME="method_detail"><!-- --></A>
+<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TD COLSPAN=1><FONT SIZE="+2">
+<B>Method Detail</B></FONT></TD>
+</TR>
+</TABLE>
+
+<A NAME="clear()"><!-- --></A><H3>
+clear</H3>
+<PRE>
+public void <B>clear</B>()</PRE>
+<DL>
+<DD>Clears all elements from queue.
+<P>
+<DD><DL>
+<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../org/apache/commons/collections/PriorityQueue.html#clear()">clear</A></CODE> in interface <CODE><A HREF="../../../../org/apache/commons/collections/PriorityQueue.html">PriorityQueue</A></CODE><DT><B>Overrides:</B><DD><CODE>clear</CODE> in class <CODE>java.util.AbstractCollection</CODE></DL>
+</DD>
+<DD><DL>
+</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="isEmpty()"><!-- --></A><H3>
+isEmpty</H3>
+<PRE>
+public boolean <B>isEmpty</B>()</PRE>
+<DL>
+<DD>Tests if queue is empty.
+<P>
+<DD><DL>
+<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../org/apache/commons/collections/PriorityQueue.html#isEmpty()">isEmpty</A></CODE> in interface <CODE><A HREF="../../../../org/apache/commons/collections/PriorityQueue.html">PriorityQueue</A></CODE><DT><B>Overrides:</B><DD><CODE>isEmpty</CODE> in class <CODE>java.util.AbstractCollection</CODE></DL>
+</DD>
+<DD><DL>
+
+<DT><B>Returns:</B><DD><code>true</code> if queue is empty; <code>false</code>
+ otherwise.</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="isFull()"><!-- --></A><H3>
+isFull</H3>
+<PRE>
+public boolean <B>isFull</B>()</PRE>
+<DL>
+<DD>Tests if queue is full.
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+
+<DT><B>Returns:</B><DD><code>true</code> if queue is full; <code>false</code>
+ otherwise.</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="insert(java.lang.Object)"><!-- --></A><H3>
+insert</H3>
+<PRE>
+public void <B>insert</B>(java.lang.Object element)</PRE>
+<DL>
+<DD>Inserts an element into queue.
+<P>
+<DD><DL>
+<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../org/apache/commons/collections/PriorityQueue.html#insert(java.lang.Object)">insert</A></CODE> in interface <CODE><A HREF="../../../../org/apache/commons/collections/PriorityQueue.html">PriorityQueue</A></CODE></DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>element</CODE> - the element to be inserted</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="peek()"><!-- --></A><H3>
+peek</H3>
+<PRE>
+public java.lang.Object <B>peek</B>()
+ throws java.util.NoSuchElementException</PRE>
+<DL>
+<DD>Returns the element on top of heap but don't remove it.
+<P>
+<DD><DL>
+<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../org/apache/commons/collections/PriorityQueue.html#peek()">peek</A></CODE> in interface <CODE><A HREF="../../../../org/apache/commons/collections/PriorityQueue.html">PriorityQueue</A></CODE></DL>
+</DD>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>the element at top of heap
+<DT><B>Throws:</B>
+<DD><CODE>java.util.NoSuchElementException</CODE> - if <code>isEmpty() == true</code></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="pop()"><!-- --></A><H3>
+pop</H3>
+<PRE>
+public java.lang.Object <B>pop</B>()
+ throws java.util.NoSuchElementException</PRE>
+<DL>
+<DD>Returns the element on top of heap and remove it.
+<P>
+<DD><DL>
+<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../org/apache/commons/collections/PriorityQueue.html#pop()">pop</A></CODE> in interface <CODE><A HREF="../../../../org/apache/commons/collections/PriorityQueue.html">PriorityQueue</A></CODE></DL>
+</DD>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>the element at top of heap
+<DT><B>Throws:</B>
+<DD><CODE>java.util.NoSuchElementException</CODE> - if <code>isEmpty() == true</code></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="toString()"><!-- --></A><H3>
+toString</H3>
+<PRE>
+public java.lang.String <B>toString</B>()</PRE>
+<DL>
+<DD>Returns a string representation of this heap. The returned string
+ is similar to those produced by standard JDK collections.
+<P>
+<DD><DL>
+<DT><B>Overrides:</B><DD><CODE>toString</CODE> in class <CODE>java.util.AbstractCollection</CODE></DL>
+</DD>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>a string representation of this heap</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="iterator()"><!-- --></A><H3>
+iterator</H3>
+<PRE>
+public java.util.Iterator <B>iterator</B>()</PRE>
+<DL>
+<DD>Returns an iterator over this heap's elements.
+<P>
+<DD><DL>
+<DT><B>Specified by:</B><DD><CODE>iterator</CODE> in interface <CODE>java.util.Collection</CODE><DT><B>Specified by:</B><DD><CODE>iterator</CODE> in class <CODE>java.util.AbstractCollection</CODE></DL>
+</DD>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>an iterator over this heap's elements</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="add(java.lang.Object)"><!-- --></A><H3>
+add</H3>
+<PRE>
+public boolean <B>add</B>(java.lang.Object object)</PRE>
+<DL>
+<DD>Adds an object to this heap. Same as <A HREF="../../../../org/apache/commons/collections/BinaryHeap.html#insert(java.lang.Object)"><CODE>insert(Object)</CODE></A>.
+<P>
+<DD><DL>
+<DT><B>Specified by:</B><DD><CODE>add</CODE> in interface <CODE>java.util.Collection</CODE><DT><B>Overrides:</B><DD><CODE>add</CODE> in class <CODE>java.util.AbstractCollection</CODE></DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>object</CODE> - the object to add
+<DT><B>Returns:</B><DD>true, always</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="get()"><!-- --></A><H3>
+get</H3>
+<PRE>
+public java.lang.Object <B>get</B>()</PRE>
+<DL>
+<DD>Returns the priority element. Same as <A HREF="../../../../org/apache/commons/collections/BinaryHeap.html#peek()"><CODE>peek()</CODE></A>.
+<P>
+<DD><DL>
+<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../org/apache/commons/collections/Buffer.html#get()">get</A></CODE> in interface <CODE><A HREF="../../../../org/apache/commons/collections/Buffer.html">Buffer</A></CODE></DL>
+</DD>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>the priority element
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="../../../../org/apache/commons/collections/BufferUnderflowException.html">BufferUnderflowException</A></CODE> - if this heap is empty</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="remove()"><!-- --></A><H3>
+remove</H3>
+<PRE>
+public java.lang.Object <B>remove</B>()</PRE>
+<DL>
+<DD>Removes the priority element. Same as <A HREF="../../../../org/apache/commons/collections/BinaryHeap.html#pop()"><CODE>pop()</CODE></A>.
+<P>
+<DD><DL>
+<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../org/apache/commons/collections/Buffer.html#remove()">remove</A></CODE> in interface <CODE><A HREF="../../../../org/apache/commons/collections/Buffer.html">Buffer</A></CODE></DL>
+</DD>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>the removed priority element
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="../../../../org/apache/commons/collections/BufferUnderflowException.html">BufferUnderflowException</A></CODE> - if this heap is empty</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="size()"><!-- --></A><H3>
+size</H3>
+<PRE>
+public int <B>size</B>()</PRE>
+<DL>
+<DD>Returns the number of elements in this heap.
+<P>
+<DD><DL>
+<DT><B>Specified by:</B><DD><CODE>size</CODE> in interface <CODE>java.util.Collection</CODE><DT><B>Specified by:</B><DD><CODE>size</CODE> in class <CODE>java.util.AbstractCollection</CODE></DL>
+</DD>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>the number of elements in this heap</DL>
+</DD>
+</DL>
+<!-- ========= END OF CLASS DATA ========= -->
+<HR>
+
+<!-- ========== START OF NAVBAR ========== -->
+<A NAME="navbar_bottom"><!-- --></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
+<TR>
+<TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_bottom_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/BinaryHeap.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../org/apache/commons/collections/BeanMap.html"><B>PREV CLASS</B></A>
+ <A HREF="../../../../org/apache/commons/collections/BoundedFifoBuffer.html"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../index.html" TARGET="_top"><B>FRAMES</B></A>
+ <A HREF="BinaryHeap.html" TARGET="_top"><B>NO FRAMES</B></A>
+
+<SCRIPT>
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+<A HREF="../../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>
+</NOSCRIPT>
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: NESTED | FIELD | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: FIELD | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD>
+</TR>
+</TABLE>
+<!-- =========== END OF NAVBAR =========== -->
+
+<HR>
+Copyright © 2001-2004 The Apache Software Foundation. All Rights Reserved.
+</BODY>
+</HTML>