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 [13/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/co...
Added: commons/cms-site/trunk/collections/api-2.1.1/org/apache/commons/collections/ListUtils.html
URL: http://svn.apache.org/viewvc/commons/cms-site/trunk/collections/api-2.1.1/org/apache/commons/collections/ListUtils.html?rev=1422422&view=auto
==============================================================================
--- commons/cms-site/trunk/collections/api-2.1.1/org/apache/commons/collections/ListUtils.html (added)
+++ commons/cms-site/trunk/collections/api-2.1.1/org/apache/commons/collections/ListUtils.html Sat Dec 15 23:43:02 2012
@@ -0,0 +1,456 @@
+<!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:32 BST 2004 -->
+<TITLE>
+ListUtils (Collections 2.1.1 release API)
+</TITLE>
+<META NAME="keywords" CONTENT="org.apache.commons.collections.ListUtils,ListUtils class">
+<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css" TITLE="Style">
+</HEAD>
+<SCRIPT>
+function asd()
+{
+parent.document.title="ListUtils (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/ListUtils.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/IteratorUtils.html"><B>PREV CLASS</B></A>
+ <A HREF="../../../../org/apache/commons/collections/LRUMap.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="ListUtils.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 ListUtils</H2>
+<PRE>
+java.lang.Object
+ |
+ +--<B>org.apache.commons.collections.ListUtils</B>
+</PRE>
+<HR>
+<DL>
+<DT>public class <B>ListUtils</B><DT>extends java.lang.Object</DL>
+
+<P>
+Contains static utility methods and decorators for <CODE>List</CODE>
+ instances.
+<P>
+
+<P>
+<DL>
+<DT><B>Since:</B></DT>
+ <DD>1.0</DD>
+<DT><B>Author:</B></DT>
+ <DD><a href="mailto:fede@apache.org">Federico Barbieri</a>, <a href="mailto:donaldp@apache.org">Peter Donald</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/ListUtils.html#ListUtils()">ListUtils</A></B>()</CODE>
+
+<BR>
+ Please don't ever instantiate a <Code>ListUtils</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>static java.util.List</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/ListUtils.html#fixedSizeList(java.util.List)">fixedSizeList</A></B>(java.util.List list)</CODE>
+
+<BR>
+ Returns a fixed-sized list backed by the given list.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static java.util.List</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/ListUtils.html#intersection(java.util.List, java.util.List)">intersection</A></B>(java.util.List list1,
+ java.util.List list2)</CODE>
+
+<BR>
+ Returns a new list containing all elements that are contained in
+ both given lists.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static java.util.List</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/ListUtils.html#lazyList(java.util.List, org.apache.commons.collections.Factory)">lazyList</A></B>(java.util.List list,
+ <A HREF="../../../../org/apache/commons/collections/Factory.html">Factory</A> factory)</CODE>
+
+<BR>
+ Returns a "lazy" list whose elements will be created on demand.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static java.util.List</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/ListUtils.html#predicatedList(java.util.List, org.apache.commons.collections.Predicate)">predicatedList</A></B>(java.util.List list,
+ <A HREF="../../../../org/apache/commons/collections/Predicate.html">Predicate</A> predicate)</CODE>
+
+<BR>
+ Returns a predicated list backed by the given list.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static java.util.List</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/ListUtils.html#subtract(java.util.List, java.util.List)">subtract</A></B>(java.util.List list1,
+ java.util.List list2)</CODE>
+
+<BR>
+ Subtracts all elements in the second list from the first list,
+ placing the results in a new list.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static java.util.List</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/ListUtils.html#sum(java.util.List, java.util.List)">sum</A></B>(java.util.List list1,
+ java.util.List list2)</CODE>
+
+<BR>
+ Returns the sum of the given lists.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static java.util.List</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/ListUtils.html#union(java.util.List, java.util.List)">union</A></B>(java.util.List list1,
+ java.util.List list2)</CODE>
+
+<BR>
+ Returns a new list containing the second list appended to the
+ first list.</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 ======== -->
+
+<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="ListUtils()"><!-- --></A><H3>
+ListUtils</H3>
+<PRE>
+public <B>ListUtils</B>()</PRE>
+<DL>
+<DD>Please don't ever instantiate a <Code>ListUtils</Code>.
+<P>
+</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="intersection(java.util.List, java.util.List)"><!-- --></A><H3>
+intersection</H3>
+<PRE>
+public static java.util.List <B>intersection</B>(java.util.List list1,
+ java.util.List list2)</PRE>
+<DL>
+<DD>Returns a new list containing all elements that are contained in
+ both given lists.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>list1</CODE> - the first list<DD><CODE>list2</CODE> - the second list
+<DT><B>Returns:</B><DD>the intersection of those two lists
+<DT><B>Throws:</B>
+<DD><CODE>java.lang.NullPointerException</CODE> - if either list is null</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="subtract(java.util.List, java.util.List)"><!-- --></A><H3>
+subtract</H3>
+<PRE>
+public static java.util.List <B>subtract</B>(java.util.List list1,
+ java.util.List list2)</PRE>
+<DL>
+<DD>Subtracts all elements in the second list from the first list,
+ placing the results in a new list.
+ This differs from <CODE>List.removeAll(Collection)</CODE> in that
+ cardinality is respected; if <Code>list1</Code> contains two
+ occurrences of <Code>null</Code> and <Code>list2</Code> only
+ contains one occurrence, then the returned list will still contain
+ one occurrence.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>list1</CODE> - the list to subtract from<DD><CODE>list2</CODE> - the lsit to subtract
+<DT><B>Returns:</B><DD>a new list containing the results
+<DT><B>Throws:</B>
+<DD><CODE>java.lang.NullPointerException</CODE> - if either list is null</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="sum(java.util.List, java.util.List)"><!-- --></A><H3>
+sum</H3>
+<PRE>
+public static java.util.List <B>sum</B>(java.util.List list1,
+ java.util.List list2)</PRE>
+<DL>
+<DD>Returns the sum of the given lists. This is their intersection
+ subtracted from their union.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>list1</CODE> - the first list<DD><CODE>list2</CODE> - the second list
+<DT><B>Returns:</B><DD>a new list containing the sum of those lists
+<DT><B>Throws:</B>
+<DD><CODE>java.lang.NullPointerException</CODE> - if either list is null</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="union(java.util.List, java.util.List)"><!-- --></A><H3>
+union</H3>
+<PRE>
+public static java.util.List <B>union</B>(java.util.List list1,
+ java.util.List list2)</PRE>
+<DL>
+<DD>Returns a new list containing the second list appended to the
+ first list. The <CODE>List.addAll(Collection)</CODE> operation is
+ used to append the two given lists into a new list.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>list1</CODE> - the first list<DD><CODE>list2</CODE> - the second list
+<DT><B>Returns:</B><DD>a new list containing the union of those lists
+<DT><B>Throws:</B>
+<DD><CODE>java.lang.NullPointerException</CODE> - if either list is null</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="predicatedList(java.util.List, org.apache.commons.collections.Predicate)"><!-- --></A><H3>
+predicatedList</H3>
+<PRE>
+public static java.util.List <B>predicatedList</B>(java.util.List list,
+ <A HREF="../../../../org/apache/commons/collections/Predicate.html">Predicate</A> predicate)</PRE>
+<DL>
+<DD>Returns a predicated list backed by the given list. Only objects
+ that pass the test in the given predicate can be added to the list.
+ It is important not to use the original list after invoking this
+ method, as it is a backdoor for adding unvalidated objects.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>list</CODE> - the list to predicate, must not be null<DD><CODE>predicate</CODE> - the predicate for the list, must not be null
+<DT><B>Returns:</B><DD>a predicated list backed by the given list
+<DT><B>Throws:</B>
+<DD><CODE>java.lang.IllegalArgumentException</CODE> - if the List or Predicate is null</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="lazyList(java.util.List, org.apache.commons.collections.Factory)"><!-- --></A><H3>
+lazyList</H3>
+<PRE>
+public static java.util.List <B>lazyList</B>(java.util.List list,
+ <A HREF="../../../../org/apache/commons/collections/Factory.html">Factory</A> factory)</PRE>
+<DL>
+<DD>Returns a "lazy" list whose elements will be created on demand.<P>
+ <p>
+ When the index passed to the returned list's <CODE>get</CODE>
+ method is greater than the list's size, then the factory will be used
+ to create a new object and that object will be inserted at that index.
+ <p>
+ For instance:
+
+ <pre>
+ Factory factory = new Factory() {
+ public Object create() {
+ return new Date();
+ }
+ }
+ List lazy = ListUtils.lazyList(new ArrayList(), factory);
+ Object obj = lazy.get(3);
+ </pre>
+
+ After the above code is executed, <code>obj</code> will contain
+ a new <code>Date</code> instance. Furthermore, that <code>Date</code>
+ instance is the fourth element in the list. The first, second,
+ and third element are all set to <code>null</code>.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>list</CODE> - the list to make lazy, must not be null<DD><CODE>factory</CODE> - the factory for creating new objects, must not be null
+<DT><B>Returns:</B><DD>a lazy list backed by the given list
+<DT><B>Throws:</B>
+<DD><CODE>java.lang.IllegalArgumentException</CODE> - if the List or Factory is null</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="fixedSizeList(java.util.List)"><!-- --></A><H3>
+fixedSizeList</H3>
+<PRE>
+public static java.util.List <B>fixedSizeList</B>(java.util.List list)</PRE>
+<DL>
+<DD>Returns a fixed-sized list backed by the given list.
+ Elements may not be added or removed from the returned list, but
+ existing elements can be changed (for instance, via the
+ <CODE>List.set(int,Object)</CODE> method).
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>list</CODE> - the list whose size to fix, must not be null
+<DT><B>Returns:</B><DD>a fixed-size list backed by that list
+<DT><B>Throws:</B>
+<DD><CODE>java.lang.IllegalArgumentException</CODE> - if the List 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/ListUtils.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/IteratorUtils.html"><B>PREV CLASS</B></A>
+ <A HREF="../../../../org/apache/commons/collections/LRUMap.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="ListUtils.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>
Added: commons/cms-site/trunk/collections/api-2.1.1/org/apache/commons/collections/MapUtils.html
URL: http://svn.apache.org/viewvc/commons/cms-site/trunk/collections/api-2.1.1/org/apache/commons/collections/MapUtils.html?rev=1422422&view=auto
==============================================================================
--- commons/cms-site/trunk/collections/api-2.1.1/org/apache/commons/collections/MapUtils.html (added)
+++ commons/cms-site/trunk/collections/api-2.1.1/org/apache/commons/collections/MapUtils.html Sat Dec 15 23:43:02 2012
@@ -0,0 +1,1224 @@
+<!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:32 BST 2004 -->
+<TITLE>
+MapUtils (Collections 2.1.1 release API)
+</TITLE>
+<META NAME="keywords" CONTENT="org.apache.commons.collections.MapUtils,MapUtils class">
+<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css" TITLE="Style">
+</HEAD>
+<SCRIPT>
+function asd()
+{
+parent.document.title="MapUtils (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/MapUtils.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/LRUMap.html"><B>PREV CLASS</B></A>
+ <A HREF="../../../../org/apache/commons/collections/MultiHashMap.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="MapUtils.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 MapUtils</H2>
+<PRE>
+java.lang.Object
+ |
+ +--<B>org.apache.commons.collections.MapUtils</B>
+</PRE>
+<HR>
+<DL>
+<DT>public class <B>MapUtils</B><DT>extends java.lang.Object</DL>
+
+<P>
+A helper class for using <CODE>Map</CODE> instances.<P>
+
+ It contains various typesafe methods
+ as well as other useful features like deep copying.<P>
+
+ It also provides the following decorators:
+
+ <UL>
+ <LI><A HREF="../../../../org/apache/commons/collections/MapUtils.html#fixedSizeMap(java.util.Map)"><CODE>fixedSizeMap(Map)</CODE></A>
+ <LI><A HREF="../../../../org/apache/commons/collections/MapUtils.html#fixedSizeSortedMap(java.util.SortedMap)"><CODE>fixedSizeSortedMap(SortedMap)</CODE></A>
+ <LI><A HREF="../../../../org/apache/commons/collections/MapUtils.html#lazyMap(java.util.Map, org.apache.commons.collections.Factory)"><CODE>lazyMap(Map,Factory)</CODE></A>
+ <LI><A HREF="../../../../org/apache/commons/collections/MapUtils.html#lazySortedMap(java.util.SortedMap, org.apache.commons.collections.Factory)"><CODE>lazySortedMap(SortedMap,Factory)</CODE></A>
+ <LI><A HREF="../../../../org/apache/commons/collections/MapUtils.html#predicatedMap(java.util.Map, org.apache.commons.collections.Predicate, org.apache.commons.collections.Predicate)"><CODE>predicatedMap(Map,Predicate,Predicate)</CODE></A>
+ <LI><A HREF="../../../../org/apache/commons/collections/MapUtils.html#predicatedSortedMap(java.util.SortedMap, org.apache.commons.collections.Predicate, org.apache.commons.collections.Predicate)"><CODE>predicatedSortedMap(SortedMap,Predicate,Predicate)</CODE></A>
+ </UL>
+<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>, <a href="mailto:nissim@nksystems.com">Nissim Karpenstein</a>, <a href="mailto:knielsen@apache.org">Kasper Nielsen</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/MapUtils.html#MapUtils()">MapUtils</A></B>()</CODE>
+
+<BR>
+ Please don't instantiate a <Code>MapUtils</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>static void</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/MapUtils.html#debugPrint(java.io.PrintStream, java.lang.Object, java.util.Map)">debugPrint</A></B>(java.io.PrintStream out,
+ java.lang.Object key,
+ java.util.Map map)</CODE>
+
+<BR>
+ Prints the given map with nice line breaks.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static java.util.Map</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/MapUtils.html#fixedSizeMap(java.util.Map)">fixedSizeMap</A></B>(java.util.Map map)</CODE>
+
+<BR>
+ Returns a fixed-sized map backed by the given map.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static java.util.SortedMap</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/MapUtils.html#fixedSizeSortedMap(java.util.SortedMap)">fixedSizeSortedMap</A></B>(java.util.SortedMap map)</CODE>
+
+<BR>
+ Returns a fixed-sized sorted map backed by the given sorted map.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static java.lang.Boolean</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/MapUtils.html#getBoolean(java.util.Map, java.lang.Object)">getBoolean</A></B>(java.util.Map map,
+ java.lang.Object key)</CODE>
+
+<BR>
+ Looks up the given key in the given map, converting the result into
+ a <CODE>Boolean</CODE>.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static java.lang.Boolean</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/MapUtils.html#getBoolean(java.util.Map, java.lang.Object, java.lang.Boolean)">getBoolean</A></B>(java.util.Map map,
+ java.lang.Object key,
+ java.lang.Boolean defaultValue)</CODE>
+
+<BR>
+ Looks up the given key in the given map, converting the result into
+ a boolean, using the default value if the the conversion fails.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static java.lang.Byte</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/MapUtils.html#getByte(java.util.Map, java.lang.Object)">getByte</A></B>(java.util.Map map,
+ java.lang.Object key)</CODE>
+
+<BR>
+ Looks up the given key in the given map, converting the result into
+ a <CODE>Byte</CODE>.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static java.lang.Byte</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/MapUtils.html#getByte(java.util.Map, java.lang.Object, java.lang.Byte)">getByte</A></B>(java.util.Map map,
+ java.lang.Object key,
+ java.lang.Byte defaultValue)</CODE>
+
+<BR>
+ Looks up the given key in the given map, converting the result into
+ a byte, using the default value if the the conversion fails.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static java.lang.Double</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/MapUtils.html#getDouble(java.util.Map, java.lang.Object)">getDouble</A></B>(java.util.Map map,
+ java.lang.Object key)</CODE>
+
+<BR>
+ Looks up the given key in the given map, converting the result into
+ a <CODE>Double</CODE>.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static java.lang.Double</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/MapUtils.html#getDouble(java.util.Map, java.lang.Object, java.lang.Double)">getDouble</A></B>(java.util.Map map,
+ java.lang.Object key,
+ java.lang.Double defaultValue)</CODE>
+
+<BR>
+ Looks up the given key in the given map, converting the result into
+ a double, using the default value if the the conversion fails.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static java.lang.Float</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/MapUtils.html#getFloat(java.util.Map, java.lang.Object)">getFloat</A></B>(java.util.Map map,
+ java.lang.Object key)</CODE>
+
+<BR>
+ Looks up the given key in the given map, converting the result into
+ a <CODE>Float</CODE>.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static java.lang.Float</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/MapUtils.html#getFloat(java.util.Map, java.lang.Object, java.lang.Float)">getFloat</A></B>(java.util.Map map,
+ java.lang.Object key,
+ java.lang.Float defaultValue)</CODE>
+
+<BR>
+ Looks up the given key in the given map, converting the result into
+ a float, using the default value if the the conversion fails.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static java.lang.Integer</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/MapUtils.html#getInteger(java.util.Map, java.lang.Object)">getInteger</A></B>(java.util.Map map,
+ java.lang.Object key)</CODE>
+
+<BR>
+ Looks up the given key in the given map, converting the result into
+ an <CODE>Integer</CODE>.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static java.lang.Integer</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/MapUtils.html#getInteger(java.util.Map, java.lang.Object, java.lang.Integer)">getInteger</A></B>(java.util.Map map,
+ java.lang.Object key,
+ java.lang.Integer defaultValue)</CODE>
+
+<BR>
+ Looks up the given key in the given map, converting the result into
+ an integer, using the default value if the the conversion fails.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static java.lang.Long</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/MapUtils.html#getLong(java.util.Map, java.lang.Object)">getLong</A></B>(java.util.Map map,
+ java.lang.Object key)</CODE>
+
+<BR>
+ Looks up the given key in the given map, converting the result into
+ a <CODE>Long</CODE>.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static java.lang.Long</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/MapUtils.html#getLong(java.util.Map, java.lang.Object, java.lang.Long)">getLong</A></B>(java.util.Map map,
+ java.lang.Object key,
+ java.lang.Long defaultValue)</CODE>
+
+<BR>
+ Looks up the given key in the given map, converting the result into
+ a long, using the default value if the the conversion fails.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static java.util.Map</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/MapUtils.html#getMap(java.util.Map, java.lang.Object)">getMap</A></B>(java.util.Map map,
+ java.lang.Object key)</CODE>
+
+<BR>
+ Looks up the given key in the given map, returning another map.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static java.util.Map</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/MapUtils.html#getMap(java.util.Map, java.lang.Object, java.util.Map)">getMap</A></B>(java.util.Map map,
+ java.lang.Object key,
+ java.util.Map defaultValue)</CODE>
+
+<BR>
+ Looks up the given key in the given map, converting the result into
+ a map, using the default value if the the conversion fails.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static java.lang.Number</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/MapUtils.html#getNumber(java.util.Map, java.lang.Object)">getNumber</A></B>(java.util.Map map,
+ java.lang.Object key)</CODE>
+
+<BR>
+ Looks up the given key in the given map, converting the result into
+ a <CODE>Number</CODE>.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static java.lang.Number</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/MapUtils.html#getNumber(java.util.Map, java.lang.Object, java.lang.Number)">getNumber</A></B>(java.util.Map map,
+ java.lang.Object key,
+ java.lang.Number defaultValue)</CODE>
+
+<BR>
+ Looks up the given key in the given map, converting the result into
+ a number, using the default value if the the conversion fails.</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/MapUtils.html#getObject(java.util.Map, java.lang.Object)">getObject</A></B>(java.util.Map map,
+ java.lang.Object key)</CODE>
+
+<BR>
+ Synonym for <CODE>Map.get(Object)</CODE>.</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/MapUtils.html#getObject(java.util.Map, java.lang.Object, java.lang.Object)">getObject</A></B>(java.util.Map map,
+ java.lang.Object key,
+ java.lang.Object defaultValue)</CODE>
+
+<BR>
+ Looks up the given key in the given map, converting null into the
+ given default value.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static java.lang.Short</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/MapUtils.html#getShort(java.util.Map, java.lang.Object)">getShort</A></B>(java.util.Map map,
+ java.lang.Object key)</CODE>
+
+<BR>
+ Looks up the given key in the given map, converting the result into
+ a <CODE>Short</CODE>.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static java.lang.Short</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/MapUtils.html#getShort(java.util.Map, java.lang.Object, java.lang.Short)">getShort</A></B>(java.util.Map map,
+ java.lang.Object key,
+ java.lang.Short defaultValue)</CODE>
+
+<BR>
+ Looks up the given key in the given map, converting the result into
+ a short, using the default value if the the conversion fails.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static java.lang.String</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/MapUtils.html#getString(java.util.Map, java.lang.Object)">getString</A></B>(java.util.Map map,
+ java.lang.Object key)</CODE>
+
+<BR>
+ Looks up the given key in the given map, converting the result into
+ a string.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static java.lang.String</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/MapUtils.html#getString(java.util.Map, java.lang.Object, java.lang.String)">getString</A></B>(java.util.Map map,
+ java.lang.Object key,
+ java.lang.String defaultValue)</CODE>
+
+<BR>
+ Looks up the given key in the given map, converting the result into
+ a string, using the default value if the the conversion fails.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static java.util.Map</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/MapUtils.html#lazyMap(java.util.Map, org.apache.commons.collections.Factory)">lazyMap</A></B>(java.util.Map map,
+ <A HREF="../../../../org/apache/commons/collections/Factory.html">Factory</A> factory)</CODE>
+
+<BR>
+ Returns a "lazy" map whose values will be created on demand.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static java.util.SortedMap</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/MapUtils.html#lazySortedMap(java.util.SortedMap, org.apache.commons.collections.Factory)">lazySortedMap</A></B>(java.util.SortedMap map,
+ <A HREF="../../../../org/apache/commons/collections/Factory.html">Factory</A> factory)</CODE>
+
+<BR>
+ Returns a "lazy" sorted map whose values will be created on demand.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static java.util.Map</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/MapUtils.html#predicatedMap(java.util.Map, org.apache.commons.collections.Predicate, org.apache.commons.collections.Predicate)">predicatedMap</A></B>(java.util.Map map,
+ <A HREF="../../../../org/apache/commons/collections/Predicate.html">Predicate</A> keyPred,
+ <A HREF="../../../../org/apache/commons/collections/Predicate.html">Predicate</A> valuePred)</CODE>
+
+<BR>
+ Returns a predicated map backed by the given map.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static java.util.SortedMap</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/MapUtils.html#predicatedSortedMap(java.util.SortedMap, org.apache.commons.collections.Predicate, org.apache.commons.collections.Predicate)">predicatedSortedMap</A></B>(java.util.SortedMap map,
+ <A HREF="../../../../org/apache/commons/collections/Predicate.html">Predicate</A> keyPred,
+ <A HREF="../../../../org/apache/commons/collections/Predicate.html">Predicate</A> valuePred)</CODE>
+
+<BR>
+ Returns a predicated sorted map backed by the given map.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static void</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/MapUtils.html#safeAddToMap(java.util.Map, java.lang.Object, java.lang.Object)">safeAddToMap</A></B>(java.util.Map map,
+ java.lang.Object key,
+ java.lang.Object value)</CODE>
+
+<BR>
+ Nice method for adding data to a map in such a way
+ as to not get NPE's.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static java.util.Properties</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/MapUtils.html#toProperties(java.util.Map)">toProperties</A></B>(java.util.Map map)</CODE>
+
+<BR>
+ Gets a new Properties object initialised with the values from a Map.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static void</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/collections/MapUtils.html#verbosePrint(java.io.PrintStream, java.lang.Object, java.util.Map)">verbosePrint</A></B>(java.io.PrintStream out,
+ java.lang.Object key,
+ java.util.Map map)</CODE>
+
+<BR>
+ Prints the given map with nice line breaks.</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 ======== -->
+
+<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="MapUtils()"><!-- --></A><H3>
+MapUtils</H3>
+<PRE>
+public <B>MapUtils</B>()</PRE>
+<DL>
+<DD>Please don't instantiate a <Code>MapUtils</Code>.
+<P>
+</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="getObject(java.util.Map, java.lang.Object)"><!-- --></A><H3>
+getObject</H3>
+<PRE>
+public static java.lang.Object <B>getObject</B>(java.util.Map map,
+ java.lang.Object key)</PRE>
+<DL>
+<DD>Synonym for <CODE>Map.get(Object)</CODE>.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>map</CODE> - the map whose value to look up<DD><CODE>key</CODE> - the key whose value to look up in that map
+<DT><B>Returns:</B><DD>null if the map is null; or the result of
+ <Code>map.get(key)</Code></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getString(java.util.Map, java.lang.Object)"><!-- --></A><H3>
+getString</H3>
+<PRE>
+public static java.lang.String <B>getString</B>(java.util.Map map,
+ java.lang.Object key)</PRE>
+<DL>
+<DD>Looks up the given key in the given map, converting the result into
+ a string.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>map</CODE> - the map whose value to look up<DD><CODE>key</CODE> - the key whose value to look up in that map
+<DT><B>Returns:</B><DD>null if the map is null; null if the value mapped by that
+ key is null; or the <Code>toString()</Code>
+ result of the value for that key</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getBoolean(java.util.Map, java.lang.Object)"><!-- --></A><H3>
+getBoolean</H3>
+<PRE>
+public static java.lang.Boolean <B>getBoolean</B>(java.util.Map map,
+ java.lang.Object key)</PRE>
+<DL>
+<DD>Looks up the given key in the given map, converting the result into
+ a <CODE>Boolean</CODE>. If the map is null, this method returns null.
+ If the value mapped by the given key is a
+ <CODE>Boolean</CODE>, then it is returned as-is. Otherwise, if the value
+ is a string, then if that string ignoring case equals "true", then
+ a true <CODE>Boolean</CODE> is returned. Any other string value will
+ result in a false <CODE>Boolean</CODE> being returned. OR, if the value
+ is a <CODE>Number</CODE>, and that <CODE>Number</CODE> is 0, then a false
+ <CODE>Boolean</CODE> is returned. Any other <CODE>Number</CODE> value results
+ in a true <CODE>Boolean</CODE> being returned.<P>
+
+ Any value that is not a <CODE>Boolean</CODE>, <CODE>String</CODE> or
+ <CODE>Number</CODE> results in null being returned.<P>
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>map</CODE> - the map whose value to look up<DD><CODE>key</CODE> - the key whose value to look up in that map
+<DT><B>Returns:</B><DD>a <CODE>Boolean</CODE> or null</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getNumber(java.util.Map, java.lang.Object)"><!-- --></A><H3>
+getNumber</H3>
+<PRE>
+public static java.lang.Number <B>getNumber</B>(java.util.Map map,
+ java.lang.Object key)</PRE>
+<DL>
+<DD>Looks up the given key in the given map, converting the result into
+ a <CODE>Number</CODE>. If the map is null, this method returns null.
+ Otherwise, if the key maps to a <CODE>Number</CODE>, then that number
+ is returned as-is. Otherwise, if the key maps to a <CODE>String</CODE>,
+ that string is parsed into a number using the system default
+ <CODE>NumberFormat</CODE>.<P>
+
+ If the value is not a <CODE>Number</CODE> or a <CODE>String</CODE>, or if
+ the value is a <CODE>String</CODE> that cannot be parsed into a
+ <CODE>Number</CODE>, then null is returned.<P>
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>map</CODE> - the map whose value to look up<DD><CODE>key</CODE> - the key whose value to look up in that map
+<DT><B>Returns:</B><DD>a <CODE>Number</CODE> or null</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getByte(java.util.Map, java.lang.Object)"><!-- --></A><H3>
+getByte</H3>
+<PRE>
+public static java.lang.Byte <B>getByte</B>(java.util.Map map,
+ java.lang.Object key)</PRE>
+<DL>
+<DD>Looks up the given key in the given map, converting the result into
+ a <CODE>Byte</CODE>. First, <A HREF="../../../../org/apache/commons/collections/MapUtils.html#getNumber(java.util.Map, java.lang.Object)"><CODE>getNumber(Map,Object)</CODE></A> is invoked.
+ If the result is null, then null is returned. Otherwise, the
+ byte value of the resulting <CODE>Number</CODE> is returned.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>map</CODE> - the map whose value to look up<DD><CODE>key</CODE> - the key whose value to look up in that map
+<DT><B>Returns:</B><DD>a <CODE>Byte</CODE> or null</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getShort(java.util.Map, java.lang.Object)"><!-- --></A><H3>
+getShort</H3>
+<PRE>
+public static java.lang.Short <B>getShort</B>(java.util.Map map,
+ java.lang.Object key)</PRE>
+<DL>
+<DD>Looks up the given key in the given map, converting the result into
+ a <CODE>Short</CODE>. First, <A HREF="../../../../org/apache/commons/collections/MapUtils.html#getNumber(java.util.Map, java.lang.Object)"><CODE>getNumber(Map,Object)</CODE></A> is invoked.
+ If the result is null, then null is returned. Otherwise, the
+ short value of the resulting <CODE>Number</CODE> is returned.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>map</CODE> - the map whose value to look up<DD><CODE>key</CODE> - the key whose value to look up in that map
+<DT><B>Returns:</B><DD>a <CODE>Short</CODE> or null</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getInteger(java.util.Map, java.lang.Object)"><!-- --></A><H3>
+getInteger</H3>
+<PRE>
+public static java.lang.Integer <B>getInteger</B>(java.util.Map map,
+ java.lang.Object key)</PRE>
+<DL>
+<DD>Looks up the given key in the given map, converting the result into
+ an <CODE>Integer</CODE>. First, <A HREF="../../../../org/apache/commons/collections/MapUtils.html#getNumber(java.util.Map, java.lang.Object)"><CODE>getNumber(Map,Object)</CODE></A> is invoked.
+ If the result is null, then null is returned. Otherwise, the
+ integer value of the resulting <CODE>Number</CODE> is returned.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>map</CODE> - the map whose value to look up<DD><CODE>key</CODE> - the key whose value to look up in that map
+<DT><B>Returns:</B><DD>an <CODE>Integer</CODE> or null</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getLong(java.util.Map, java.lang.Object)"><!-- --></A><H3>
+getLong</H3>
+<PRE>
+public static java.lang.Long <B>getLong</B>(java.util.Map map,
+ java.lang.Object key)</PRE>
+<DL>
+<DD>Looks up the given key in the given map, converting the result into
+ a <CODE>Long</CODE>. First, <A HREF="../../../../org/apache/commons/collections/MapUtils.html#getNumber(java.util.Map, java.lang.Object)"><CODE>getNumber(Map,Object)</CODE></A> is invoked.
+ If the result is null, then null is returned. Otherwise, the
+ long value of the resulting <CODE>Number</CODE> is returned.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>map</CODE> - the map whose value to look up<DD><CODE>key</CODE> - the key whose value to look up in that map
+<DT><B>Returns:</B><DD>a <CODE>Long</CODE> or null</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getFloat(java.util.Map, java.lang.Object)"><!-- --></A><H3>
+getFloat</H3>
+<PRE>
+public static java.lang.Float <B>getFloat</B>(java.util.Map map,
+ java.lang.Object key)</PRE>
+<DL>
+<DD>Looks up the given key in the given map, converting the result into
+ a <CODE>Float</CODE>. First, <A HREF="../../../../org/apache/commons/collections/MapUtils.html#getNumber(java.util.Map, java.lang.Object)"><CODE>getNumber(Map,Object)</CODE></A> is invoked.
+ If the result is null, then null is returned. Otherwise, the
+ float value of the resulting <CODE>Number</CODE> is returned.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>map</CODE> - the map whose value to look up<DD><CODE>key</CODE> - the key whose value to look up in that map
+<DT><B>Returns:</B><DD>a <CODE>Float</CODE> or null</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getDouble(java.util.Map, java.lang.Object)"><!-- --></A><H3>
+getDouble</H3>
+<PRE>
+public static java.lang.Double <B>getDouble</B>(java.util.Map map,
+ java.lang.Object key)</PRE>
+<DL>
+<DD>Looks up the given key in the given map, converting the result into
+ a <CODE>Double</CODE>. First, <A HREF="../../../../org/apache/commons/collections/MapUtils.html#getNumber(java.util.Map, java.lang.Object)"><CODE>getNumber(Map,Object)</CODE></A> is invoked.
+ If the result is null, then null is returned. Otherwise, the
+ double value of the resulting <CODE>Number</CODE> is returned.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>map</CODE> - the map whose value to look up<DD><CODE>key</CODE> - the key whose value to look up in that map
+<DT><B>Returns:</B><DD>a <CODE>Double</CODE> or null</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getMap(java.util.Map, java.lang.Object)"><!-- --></A><H3>
+getMap</H3>
+<PRE>
+public static java.util.Map <B>getMap</B>(java.util.Map map,
+ java.lang.Object key)</PRE>
+<DL>
+<DD>Looks up the given key in the given map, returning another map.
+ If the given map is null or if the given key doesn't map to another
+ map, then this method returns null. Otherwise the mapped map is
+ returned.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>map</CODE> - the map whose value to look up<DD><CODE>key</CODE> - the key whose value to look up in that map
+<DT><B>Returns:</B><DD>a <CODE>Map</CODE> or null</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getObject(java.util.Map, java.lang.Object, java.lang.Object)"><!-- --></A><H3>
+getObject</H3>
+<PRE>
+public static java.lang.Object <B>getObject</B>(java.util.Map map,
+ java.lang.Object key,
+ java.lang.Object defaultValue)</PRE>
+<DL>
+<DD>Looks up the given key in the given map, converting null into the
+ given default value.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>map</CODE> - the map whose value to look up<DD><CODE>key</CODE> - the key of the value to look up in that map<DD><CODE>defaultValue</CODE> - what to return if the value is null
+<DT><B>Returns:</B><DD>the value in the map, or defaultValue if the original value
+ is null or the map is null</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getString(java.util.Map, java.lang.Object, java.lang.String)"><!-- --></A><H3>
+getString</H3>
+<PRE>
+public static java.lang.String <B>getString</B>(java.util.Map map,
+ java.lang.Object key,
+ java.lang.String defaultValue)</PRE>
+<DL>
+<DD>Looks up the given key in the given map, converting the result into
+ a string, using the default value if the the conversion fails.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>map</CODE> - the map whose value to look up<DD><CODE>key</CODE> - the key of the value to look up in that map<DD><CODE>defaultValue</CODE> - what to return if the value is null or if the
+ conversion fails
+<DT><B>Returns:</B><DD>the value in the map as a string, or defaultValue if the
+ original value is null, the map is null or the string conversion
+ fails</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getBoolean(java.util.Map, java.lang.Object, java.lang.Boolean)"><!-- --></A><H3>
+getBoolean</H3>
+<PRE>
+public static java.lang.Boolean <B>getBoolean</B>(java.util.Map map,
+ java.lang.Object key,
+ java.lang.Boolean defaultValue)</PRE>
+<DL>
+<DD>Looks up the given key in the given map, converting the result into
+ a boolean, using the default value if the the conversion fails.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>map</CODE> - the map whose value to look up<DD><CODE>key</CODE> - the key of the value to look up in that map<DD><CODE>defaultValue</CODE> - what to return if the value is null or if the
+ conversion fails
+<DT><B>Returns:</B><DD>the value in the map as a boolean, or defaultValue if the
+ original value is null, the map is null or the boolean conversion
+ fails</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getNumber(java.util.Map, java.lang.Object, java.lang.Number)"><!-- --></A><H3>
+getNumber</H3>
+<PRE>
+public static java.lang.Number <B>getNumber</B>(java.util.Map map,
+ java.lang.Object key,
+ java.lang.Number defaultValue)</PRE>
+<DL>
+<DD>Looks up the given key in the given map, converting the result into
+ a number, using the default value if the the conversion fails.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>map</CODE> - the map whose value to look up<DD><CODE>key</CODE> - the key of the value to look up in that map<DD><CODE>defaultValue</CODE> - what to return if the value is null or if the
+ conversion fails
+<DT><B>Returns:</B><DD>the value in the map as a number, or defaultValue if the
+ original value is null, the map is null or the number conversion
+ fails</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getByte(java.util.Map, java.lang.Object, java.lang.Byte)"><!-- --></A><H3>
+getByte</H3>
+<PRE>
+public static java.lang.Byte <B>getByte</B>(java.util.Map map,
+ java.lang.Object key,
+ java.lang.Byte defaultValue)</PRE>
+<DL>
+<DD>Looks up the given key in the given map, converting the result into
+ a byte, using the default value if the the conversion fails.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>map</CODE> - the map whose value to look up<DD><CODE>key</CODE> - the key of the value to look up in that map<DD><CODE>defaultValue</CODE> - what to return if the value is null or if the
+ conversion fails
+<DT><B>Returns:</B><DD>the value in the map as a number, or defaultValue if the
+ original value is null, the map is null or the number conversion
+ fails</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getShort(java.util.Map, java.lang.Object, java.lang.Short)"><!-- --></A><H3>
+getShort</H3>
+<PRE>
+public static java.lang.Short <B>getShort</B>(java.util.Map map,
+ java.lang.Object key,
+ java.lang.Short defaultValue)</PRE>
+<DL>
+<DD>Looks up the given key in the given map, converting the result into
+ a short, using the default value if the the conversion fails.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>map</CODE> - the map whose value to look up<DD><CODE>key</CODE> - the key of the value to look up in that map<DD><CODE>defaultValue</CODE> - what to return if the value is null or if the
+ conversion fails
+<DT><B>Returns:</B><DD>the value in the map as a number, or defaultValue if the
+ original value is null, the map is null or the number conversion
+ fails</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getInteger(java.util.Map, java.lang.Object, java.lang.Integer)"><!-- --></A><H3>
+getInteger</H3>
+<PRE>
+public static java.lang.Integer <B>getInteger</B>(java.util.Map map,
+ java.lang.Object key,
+ java.lang.Integer defaultValue)</PRE>
+<DL>
+<DD>Looks up the given key in the given map, converting the result into
+ an integer, using the default value if the the conversion fails.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>map</CODE> - the map whose value to look up<DD><CODE>key</CODE> - the key of the value to look up in that map<DD><CODE>defaultValue</CODE> - what to return if the value is null or if the
+ conversion fails
+<DT><B>Returns:</B><DD>the value in the map as a number, or defaultValue if the
+ original value is null, the map is null or the number conversion
+ fails</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getLong(java.util.Map, java.lang.Object, java.lang.Long)"><!-- --></A><H3>
+getLong</H3>
+<PRE>
+public static java.lang.Long <B>getLong</B>(java.util.Map map,
+ java.lang.Object key,
+ java.lang.Long defaultValue)</PRE>
+<DL>
+<DD>Looks up the given key in the given map, converting the result into
+ a long, using the default value if the the conversion fails.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>map</CODE> - the map whose value to look up<DD><CODE>key</CODE> - the key of the value to look up in that map<DD><CODE>defaultValue</CODE> - what to return if the value is null or if the
+ conversion fails
+<DT><B>Returns:</B><DD>the value in the map as a number, or defaultValue if the
+ original value is null, the map is null or the number conversion
+ fails</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getFloat(java.util.Map, java.lang.Object, java.lang.Float)"><!-- --></A><H3>
+getFloat</H3>
+<PRE>
+public static java.lang.Float <B>getFloat</B>(java.util.Map map,
+ java.lang.Object key,
+ java.lang.Float defaultValue)</PRE>
+<DL>
+<DD>Looks up the given key in the given map, converting the result into
+ a float, using the default value if the the conversion fails.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>map</CODE> - the map whose value to look up<DD><CODE>key</CODE> - the key of the value to look up in that map<DD><CODE>defaultValue</CODE> - what to return if the value is null or if the
+ conversion fails
+<DT><B>Returns:</B><DD>the value in the map as a number, or defaultValue if the
+ original value is null, the map is null or the number conversion
+ fails</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getDouble(java.util.Map, java.lang.Object, java.lang.Double)"><!-- --></A><H3>
+getDouble</H3>
+<PRE>
+public static java.lang.Double <B>getDouble</B>(java.util.Map map,
+ java.lang.Object key,
+ java.lang.Double defaultValue)</PRE>
+<DL>
+<DD>Looks up the given key in the given map, converting the result into
+ a double, using the default value if the the conversion fails.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>map</CODE> - the map whose value to look up<DD><CODE>key</CODE> - the key of the value to look up in that map<DD><CODE>defaultValue</CODE> - what to return if the value is null or if the
+ conversion fails
+<DT><B>Returns:</B><DD>the value in the map as a number, or defaultValue if the
+ original value is null, the map is null or the number conversion
+ fails</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getMap(java.util.Map, java.lang.Object, java.util.Map)"><!-- --></A><H3>
+getMap</H3>
+<PRE>
+public static java.util.Map <B>getMap</B>(java.util.Map map,
+ java.lang.Object key,
+ java.util.Map defaultValue)</PRE>
+<DL>
+<DD>Looks up the given key in the given map, converting the result into
+ a map, using the default value if the the conversion fails.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>map</CODE> - the map whose value to look up<DD><CODE>key</CODE> - the key of the value to look up in that map<DD><CODE>defaultValue</CODE> - what to return if the value is null or if the
+ conversion fails
+<DT><B>Returns:</B><DD>the value in the map as a number, or defaultValue if the
+ original value is null, the map is null or the map conversion
+ fails</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="toProperties(java.util.Map)"><!-- --></A><H3>
+toProperties</H3>
+<PRE>
+public static java.util.Properties <B>toProperties</B>(java.util.Map map)</PRE>
+<DL>
+<DD>Gets a new Properties object initialised with the values from a Map.
+ A null input will return an empty properties object.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>map</CODE> - the map to convert to a Properties object
+<DT><B>Returns:</B><DD>the properties object</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="verbosePrint(java.io.PrintStream, java.lang.Object, java.util.Map)"><!-- --></A><H3>
+verbosePrint</H3>
+<PRE>
+public static void <B>verbosePrint</B>(java.io.PrintStream out,
+ java.lang.Object key,
+ java.util.Map map)</PRE>
+<DL>
+<DD>Prints the given map with nice line breaks.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>out</CODE> - the stream to print to<DD><CODE>key</CODE> - the key that maps to the map in some other map<DD><CODE>map</CODE> - the map to print</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="debugPrint(java.io.PrintStream, java.lang.Object, java.util.Map)"><!-- --></A><H3>
+debugPrint</H3>
+<PRE>
+public static void <B>debugPrint</B>(java.io.PrintStream out,
+ java.lang.Object key,
+ java.util.Map map)</PRE>
+<DL>
+<DD>Prints the given map with nice line breaks.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>out</CODE> - the stream to print to<DD><CODE>key</CODE> - the key that maps to the map in some other map<DD><CODE>map</CODE> - the map to print</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="safeAddToMap(java.util.Map, java.lang.Object, java.lang.Object)"><!-- --></A><H3>
+safeAddToMap</H3>
+<PRE>
+public static final void <B>safeAddToMap</B>(java.util.Map map,
+ java.lang.Object key,
+ java.lang.Object value)
+ throws java.lang.NullPointerException</PRE>
+<DL>
+<DD>Nice method for adding data to a map in such a way
+ as to not get NPE's. The point being that if the
+ value is null, map.put() will throw an exception.
+ That blows in the case of this class cause you may want to
+ essentially treat put("Not Null", null ) == put("Not Null", "")
+ We will still throw a NPE if the key is null cause that should
+ never happen.
+<P>
+<DD><DL>
+
+<DD><CODE>java.lang.NullPointerException</CODE></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="predicatedMap(java.util.Map, org.apache.commons.collections.Predicate, org.apache.commons.collections.Predicate)"><!-- --></A><H3>
+predicatedMap</H3>
+<PRE>
+public static java.util.Map <B>predicatedMap</B>(java.util.Map map,
+ <A HREF="../../../../org/apache/commons/collections/Predicate.html">Predicate</A> keyPred,
+ <A HREF="../../../../org/apache/commons/collections/Predicate.html">Predicate</A> valuePred)</PRE>
+<DL>
+<DD>Returns a predicated map backed by the given map. Only keys and
+ values that pass the given predicates can be added to the map.
+ It is important not to use the original map after invoking this
+ method, as it is a backdoor for adding unvalidated objects.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>map</CODE> - the map to predicate, must not be null<DD><CODE>keyPred</CODE> - the predicate for keys, must not be null<DD><CODE>valuePred</CODE> - the predicate for values, must not be null
+<DT><B>Returns:</B><DD>a predicated map backed by the given map
+<DT><B>Throws:</B>
+<DD><CODE>java.lang.IllegalArgumentException</CODE> - if the Map or Predicates are null</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="fixedSizeMap(java.util.Map)"><!-- --></A><H3>
+fixedSizeMap</H3>
+<PRE>
+public static java.util.Map <B>fixedSizeMap</B>(java.util.Map map)</PRE>
+<DL>
+<DD>Returns a fixed-sized map backed by the given map.
+ Elements may not be added or removed from the returned map, but
+ existing elements can be changed (for instance, via the
+ <CODE>Map.put(Object,Object)</CODE> method).
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>map</CODE> - the map whose size to fix, must not be null
+<DT><B>Returns:</B><DD>a fixed-size map backed by that map
+<DT><B>Throws:</B>
+<DD><CODE>java.lang.IllegalArgumentException</CODE> - if the Map is null</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="lazyMap(java.util.Map, org.apache.commons.collections.Factory)"><!-- --></A><H3>
+lazyMap</H3>
+<PRE>
+public static java.util.Map <B>lazyMap</B>(java.util.Map map,
+ <A HREF="../../../../org/apache/commons/collections/Factory.html">Factory</A> factory)</PRE>
+<DL>
+<DD>Returns a "lazy" map whose values will be created on demand.<P>
+ <p>
+ When the key passed to the returned map's <CODE>Map.get(Object)</CODE>
+ method is not present in the map, then the factory will be used
+ to create a new object and that object will become the value
+ associated with that key.
+ <p>
+ For instance:
+
+ <pre>
+ Factory factory = new Factory() {
+ public Object create() {
+ return new Date();
+ }
+ }
+ Map lazy = MapUtils.lazyMap(new HashMap(), factory);
+ Object obj = lazy.get("test");
+ </pre>
+
+ After the above code is executed, <code>obj</code> will contain
+ a new <code>Date</code> instance. Furthermore, that <code>Date</code>
+ instance is the value for the <code>test</code> key.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>map</CODE> - the map to make lazy, must not be null<DD><CODE>factory</CODE> - the factory for creating new objects, must not be null
+<DT><B>Returns:</B><DD>a lazy map backed by the given map
+<DT><B>Throws:</B>
+<DD><CODE>java.lang.IllegalArgumentException</CODE> - if the Map or Factory is null</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="predicatedSortedMap(java.util.SortedMap, org.apache.commons.collections.Predicate, org.apache.commons.collections.Predicate)"><!-- --></A><H3>
+predicatedSortedMap</H3>
+<PRE>
+public static java.util.SortedMap <B>predicatedSortedMap</B>(java.util.SortedMap map,
+ <A HREF="../../../../org/apache/commons/collections/Predicate.html">Predicate</A> keyPred,
+ <A HREF="../../../../org/apache/commons/collections/Predicate.html">Predicate</A> valuePred)</PRE>
+<DL>
+<DD>Returns a predicated sorted map backed by the given map. Only keys and
+ values that pass the given predicates can be added to the map.
+ It is important not to use the original map after invoking this
+ method, as it is a backdoor for adding unvalidated objects.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>map</CODE> - the map to predicate, must not be null<DD><CODE>keyPred</CODE> - the predicate for keys, must not be null<DD><CODE>valuePred</CODE> - the predicate for values, must not be null
+<DT><B>Returns:</B><DD>a predicated map backed by the given map
+<DT><B>Throws:</B>
+<DD><CODE>java.lang.IllegalArgumentException</CODE> - if the SortedMap or Predicates are null</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="fixedSizeSortedMap(java.util.SortedMap)"><!-- --></A><H3>
+fixedSizeSortedMap</H3>
+<PRE>
+public static java.util.SortedMap <B>fixedSizeSortedMap</B>(java.util.SortedMap map)</PRE>
+<DL>
+<DD>Returns a fixed-sized sorted map backed by the given sorted map.
+ Elements may not be added or removed from the returned map, but
+ existing elements can be changed (for instance, via the
+ <CODE>Map.put(Object,Object)</CODE> method).
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>map</CODE> - the map whose size to fix, must not be null
+<DT><B>Returns:</B><DD>a fixed-size map backed by that map
+<DT><B>Throws:</B>
+<DD><CODE>java.lang.IllegalArgumentException</CODE> - if the SortedMap is null</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="lazySortedMap(java.util.SortedMap, org.apache.commons.collections.Factory)"><!-- --></A><H3>
+lazySortedMap</H3>
+<PRE>
+public static java.util.SortedMap <B>lazySortedMap</B>(java.util.SortedMap map,
+ <A HREF="../../../../org/apache/commons/collections/Factory.html">Factory</A> factory)</PRE>
+<DL>
+<DD>Returns a "lazy" sorted map whose values will be created on demand.
+ <p>
+ When the key passed to the returned map's <CODE>Map.get(Object)</CODE>
+ method is not present in the map, then the factory will be used
+ to create a new object and that object will become the value
+ associated with that key.
+ <p>
+ For instance:
+
+ <pre>
+ Factory factory = new Factory() {
+ public Object create() {
+ return new Date();
+ }
+ }
+ SortedMap lazy = MapUtils.lazySortedMap(new TreeMap(), factory);
+ Object obj = lazy.get("test");
+ </pre>
+
+ After the above code is executed, <code>obj</code> will contain
+ a new <code>Date</code> instance. Furthermore, that <code>Date</code>
+ instance is the value for the <code>test</code> key.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>map</CODE> - the map to make lazy, must not be null<DD><CODE>factory</CODE> - the factory for creating new objects, must not be null
+<DT><B>Returns:</B><DD>a lazy map backed by the given map
+<DT><B>Throws:</B>
+<DD><CODE>java.lang.IllegalArgumentException</CODE> - if the SortedMap or Factory 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/MapUtils.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/LRUMap.html"><B>PREV CLASS</B></A>
+ <A HREF="../../../../org/apache/commons/collections/MultiHashMap.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="MapUtils.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>