[google-collections commit] r59 - in trunk/javadoc: . com/google/common/base com/google/common/collect
codesite...@google.com
Date: Mon Aug 18 16:46:26 2008
New Revision: 59
Added:
trunk/javadoc/com/google/common/collect/Collections2.html
trunk/javadoc/com/google/common/collect/ImmutableBiMap.Builder.html
trunk/javadoc/com/google/common/collect/ImmutableBiMap.html
trunk/javadoc/com/google/common/collect/ImmutableMultimap.Builder.html
trunk/javadoc/com/google/common/collect/ImmutableMultimap.html
trunk/javadoc/com/google/common/collect/ImmutableMultiset.html
trunk/javadoc/com/google/common/collect/ImmutableSortedSet.Factory.html
trunk/javadoc/com/google/common/collect/Serialization.html
trunk/javadoc/com/google/common/collect/UnmodifiableIterator.html
Removed:
trunk/javadoc/com/google/common/collect/ImmutableBiMapBuilder.html
trunk/javadoc/com/google/common/collect/ImmutableMultimapBuilder.html
trunk/javadoc/com/google/common/collect/LinkedListMultimap.html
trunk/javadoc/com/google/common/collect/SerializableComparator.html
Modified:
trunk/javadoc/allclasses-frame.html
trunk/javadoc/allclasses-noframe.html
trunk/javadoc/com/google/common/base/FinalizablePhantomReference.html
trunk/javadoc/com/google/common/base/FinalizableSoftReference.html
trunk/javadoc/com/google/common/base/FinalizableWeakReference.html
trunk/javadoc/com/google/common/base/Function.html
trunk/javadoc/com/google/common/base/Functions.html
trunk/javadoc/com/google/common/base/Join.JoinException.html
trunk/javadoc/com/google/common/base/Join.html
trunk/javadoc/com/google/common/base/Nullable.html
trunk/javadoc/com/google/common/base/Objects.html
trunk/javadoc/com/google/common/base/Preconditions.html
trunk/javadoc/com/google/common/base/Predicate.html
trunk/javadoc/com/google/common/base/Predicates.html
trunk/javadoc/com/google/common/base/ReferenceType.html
trunk/javadoc/com/google/common/base/Supplier.html
trunk/javadoc/com/google/common/base/Suppliers.CyclicDependencyException.html
trunk/javadoc/com/google/common/base/Suppliers.html
trunk/javadoc/com/google/common/base/package-frame.html
trunk/javadoc/com/google/common/base/package-summary.html
trunk/javadoc/com/google/common/base/package-tree.html
trunk/javadoc/com/google/common/collect/AbstractIterable.html
trunk/javadoc/com/google/common/collect/AbstractIterator.html
trunk/javadoc/com/google/common/collect/AbstractMapEntry.html
trunk/javadoc/com/google/common/collect/AbstractMultiset.html
trunk/javadoc/com/google/common/collect/AbstractMultisetEntry.html
trunk/javadoc/com/google/common/collect/AbstractRemovableIterator.html
trunk/javadoc/com/google/common/collect/ArrayListMultimap.html
trunk/javadoc/com/google/common/collect/BiMap.html
trunk/javadoc/com/google/common/collect/ClassToInstanceMap.html
trunk/javadoc/com/google/common/collect/Comparators.html
trunk/javadoc/com/google/common/collect/ConcurrentMultiset.html
trunk/javadoc/com/google/common/collect/Constraint.html
trunk/javadoc/com/google/common/collect/Constraints.html
trunk/javadoc/com/google/common/collect/EnumBiMap.html
trunk/javadoc/com/google/common/collect/EnumHashBiMap.html
trunk/javadoc/com/google/common/collect/EnumMultiset.html
trunk/javadoc/com/google/common/collect/ForwardingCollection.html
trunk/javadoc/com/google/common/collect/ForwardingConcurrentMap.html
trunk/javadoc/com/google/common/collect/ForwardingIterator.html
trunk/javadoc/com/google/common/collect/ForwardingList.html
trunk/javadoc/com/google/common/collect/ForwardingListIterator.html
trunk/javadoc/com/google/common/collect/ForwardingMap.html
trunk/javadoc/com/google/common/collect/ForwardingMapEntry.html
trunk/javadoc/com/google/common/collect/ForwardingMultimap.html
trunk/javadoc/com/google/common/collect/ForwardingMultiset.html
trunk/javadoc/com/google/common/collect/ForwardingObject.html
trunk/javadoc/com/google/common/collect/ForwardingQueue.html
trunk/javadoc/com/google/common/collect/ForwardingSet.html
trunk/javadoc/com/google/common/collect/ForwardingSortedMap.html
trunk/javadoc/com/google/common/collect/ForwardingSortedSet.html
trunk/javadoc/com/google/common/collect/HashBiMap.html
trunk/javadoc/com/google/common/collect/HashMultimap.html
trunk/javadoc/com/google/common/collect/HashMultiset.html
trunk/javadoc/com/google/common/collect/ImmutableCollection.html
trunk/javadoc/com/google/common/collect/ImmutableList.html
trunk/javadoc/com/google/common/collect/ImmutableMap.Builder.html
trunk/javadoc/com/google/common/collect/ImmutableMap.html
trunk/javadoc/com/google/common/collect/ImmutableSet.html
trunk/javadoc/com/google/common/collect/ImmutableSortedSet.html
trunk/javadoc/com/google/common/collect/Iterables.html
trunk/javadoc/com/google/common/collect/Iterators.html
trunk/javadoc/com/google/common/collect/LinkedHashMultimap.html
trunk/javadoc/com/google/common/collect/LinkedHashMultiset.html
trunk/javadoc/com/google/common/collect/ListMultimap.html
trunk/javadoc/com/google/common/collect/Lists.html
trunk/javadoc/com/google/common/collect/MapConstraint.html
trunk/javadoc/com/google/common/collect/MapConstraints.html
trunk/javadoc/com/google/common/collect/Maps.html
trunk/javadoc/com/google/common/collect/Multimap.html
trunk/javadoc/com/google/common/collect/Multimaps.html
trunk/javadoc/com/google/common/collect/Multiset.Entry.html
trunk/javadoc/com/google/common/collect/Multiset.html
trunk/javadoc/com/google/common/collect/Multisets.html
trunk/javadoc/com/google/common/collect/ObjectArrays.html
trunk/javadoc/com/google/common/collect/Ordering.html
trunk/javadoc/com/google/common/collect/PeekingIterator.html
trunk/javadoc/com/google/common/collect/PrimitiveArrays.html
trunk/javadoc/com/google/common/collect/ReferenceMap.html
trunk/javadoc/com/google/common/collect/SetMultimap.html
trunk/javadoc/com/google/common/collect/Sets.SetView.html
trunk/javadoc/com/google/common/collect/Sets.html
trunk/javadoc/com/google/common/collect/SortedSetMultimap.html
trunk/javadoc/com/google/common/collect/TreeMultimap.html
trunk/javadoc/com/google/common/collect/TreeMultiset.html
trunk/javadoc/com/google/common/collect/package-frame.html
trunk/javadoc/com/google/common/collect/package-summary.html
trunk/javadoc/com/google/common/collect/package-tree.html
trunk/javadoc/constant-values.html
trunk/javadoc/deprecated-list.html
trunk/javadoc/help-doc.html
trunk/javadoc/index-all.html
trunk/javadoc/index.html
trunk/javadoc/overview-frame.html
trunk/javadoc/overview-summary.html
trunk/javadoc/overview-tree.html
trunk/javadoc/serialized-form.html
trunk/javadoc/stylesheet.css
Log:
Update Javadoc for 20080818 snapshot release
Modified: trunk/javadoc/allclasses-frame.html
==============================================================================
--- trunk/javadoc/allclasses-frame.html (original)
+++ trunk/javadoc/allclasses-frame.html Mon Aug 18 16:46:26 2008
@@ -2,11 +2,12 @@
<!--NewPage-->
<HTML>
<HEAD>
-<!-- Generated by javadoc (build 1.5.0_06) on Fri May 30 13:31:25 PDT 2008
-->
+<!-- Generated by javadoc (build 1.6.0_01) on Mon Aug 18 15:24:24
GMT-08:00 2008 -->
<TITLE>
-All Classes (Google Collections Library - snapshot-20080530 (ALPHA))
+All Classes (Google Collections Library - snapshot-20080818 (ALPHA))
</TITLE>
+<META NAME="date" CONTENT="2008-08-18">
<LINK REL ="stylesheet" TYPE="text/css" HREF="stylesheet.css"
TITLE="Style">
@@ -38,6 +39,8 @@
<BR>
<A HREF="com/google/common/collect/ClassToInstanceMap.html"
title="interface in com.google.common.collect"
target="classFrame"><I>ClassToInstanceMap</I></A>
<BR>
+<A HREF="com/google/common/collect/Collections2.html" title="class in
com.google.common.collect" target="classFrame">Collections2</A>
+<BR>
<A HREF="com/google/common/collect/Comparators.html" title="class in
com.google.common.collect" target="classFrame">Comparators</A>
<BR>
<A HREF="com/google/common/collect/ConcurrentMultiset.html" title="class
in com.google.common.collect" target="classFrame">ConcurrentMultiset</A>
@@ -96,7 +99,9 @@
<BR>
<A HREF="com/google/common/collect/HashMultiset.html" title="class in
com.google.common.collect" target="classFrame">HashMultiset</A>
<BR>
-<A HREF="com/google/common/collect/ImmutableBiMapBuilder.html"
title="class in com.google.common.collect"
target="classFrame">ImmutableBiMapBuilder</A>
+<A HREF="com/google/common/collect/ImmutableBiMap.html" title="class in
com.google.common.collect" target="classFrame">ImmutableBiMap</A>
+<BR>
+<A HREF="com/google/common/collect/ImmutableBiMap.Builder.html"
title="class in com.google.common.collect"
target="classFrame">ImmutableBiMap.Builder</A>
<BR>
<A HREF="com/google/common/collect/ImmutableCollection.html" title="class
in com.google.common.collect" target="classFrame">ImmutableCollection</A>
<BR>
@@ -106,12 +111,18 @@
<BR>
<A HREF="com/google/common/collect/ImmutableMap.Builder.html" title="class
in com.google.common.collect" target="classFrame">ImmutableMap.Builder</A>
<BR>
-<A HREF="com/google/common/collect/ImmutableMultimapBuilder.html"
title="class in com.google.common.collect"
target="classFrame">ImmutableMultimapBuilder</A>
+<A HREF="com/google/common/collect/ImmutableMultimap.html" title="class in
com.google.common.collect" target="classFrame">ImmutableMultimap</A>
+<BR>
+<A HREF="com/google/common/collect/ImmutableMultimap.Builder.html"
title="class in com.google.common.collect"
target="classFrame">ImmutableMultimap.Builder</A>
+<BR>
+<A HREF="com/google/common/collect/ImmutableMultiset.html" title="class in
com.google.common.collect" target="classFrame">ImmutableMultiset</A>
<BR>
<A HREF="com/google/common/collect/ImmutableSet.html" title="class in
com.google.common.collect" target="classFrame">ImmutableSet</A>
<BR>
<A HREF="com/google/common/collect/ImmutableSortedSet.html" title="class
in com.google.common.collect" target="classFrame">ImmutableSortedSet</A>
<BR>
+<A HREF="com/google/common/collect/ImmutableSortedSet.Factory.html"
title="class in com.google.common.collect"
target="classFrame">ImmutableSortedSet.Factory</A>
+<BR>
<A HREF="com/google/common/collect/Iterables.html" title="class in
com.google.common.collect" target="classFrame">Iterables</A>
<BR>
<A HREF="com/google/common/collect/Iterators.html" title="class in
com.google.common.collect" target="classFrame">Iterators</A>
@@ -124,8 +135,6 @@
<BR>
<A HREF="com/google/common/collect/LinkedHashMultiset.html" title="class
in com.google.common.collect" target="classFrame">LinkedHashMultiset</A>
<BR>
-<A HREF="com/google/common/collect/LinkedListMultimap.html" title="class
in com.google.common.collect" target="classFrame">LinkedListMultimap</A>
-<BR>
<A HREF="com/google/common/collect/ListMultimap.html" title="interface in
com.google.common.collect" target="classFrame"><I>ListMultimap</I></A>
<BR>
<A HREF="com/google/common/collect/Lists.html" title="class in
com.google.common.collect" target="classFrame">Lists</A>
@@ -168,7 +177,7 @@
<BR>
<A HREF="com/google/common/base/ReferenceType.html" title="enum in
com.google.common.base" target="classFrame">ReferenceType</A>
<BR>
-<A HREF="com/google/common/collect/SerializableComparator.html"
title="interface in com.google.common.collect"
target="classFrame"><I>SerializableComparator</I></A>
+<A HREF="com/google/common/collect/Serialization.html" title="class in
com.google.common.collect" target="classFrame">Serialization</A>
<BR>
<A HREF="com/google/common/collect/SetMultimap.html" title="interface in
com.google.common.collect" target="classFrame"><I>SetMultimap</I></A>
<BR>
@@ -187,6 +196,8 @@
<A HREF="com/google/common/collect/TreeMultimap.html" title="class in
com.google.common.collect" target="classFrame">TreeMultimap</A>
<BR>
<A HREF="com/google/common/collect/TreeMultiset.html" title="class in
com.google.common.collect" target="classFrame">TreeMultiset</A>
+<BR>
+<A HREF="com/google/common/collect/UnmodifiableIterator.html" title="class
in com.google.common.collect" target="classFrame">UnmodifiableIterator</A>
<BR>
</FONT></TD>
</TR>
Modified: trunk/javadoc/allclasses-noframe.html
==============================================================================
--- trunk/javadoc/allclasses-noframe.html (original)
+++ trunk/javadoc/allclasses-noframe.html Mon Aug 18 16:46:26 2008
@@ -2,11 +2,12 @@
<!--NewPage-->
<HTML>
<HEAD>
-<!-- Generated by javadoc (build 1.5.0_06) on Fri May 30 13:31:25 PDT 2008
-->
+<!-- Generated by javadoc (build 1.6.0_01) on Mon Aug 18 15:24:24
GMT-08:00 2008 -->
<TITLE>
-All Classes (Google Collections Library - snapshot-20080530 (ALPHA))
+All Classes (Google Collections Library - snapshot-20080818 (ALPHA))
</TITLE>
+<META NAME="date" CONTENT="2008-08-18">
<LINK REL ="stylesheet" TYPE="text/css" HREF="stylesheet.css"
TITLE="Style">
@@ -38,6 +39,8 @@
<BR>
<A HREF="com/google/common/collect/ClassToInstanceMap.html"
title="interface in com.google.common.collect"><I>ClassToInstanceMap</I></A>
<BR>
+<A HREF="com/google/common/collect/Collections2.html" title="class in
com.google.common.collect">Collections2</A>
+<BR>
<A HREF="com/google/common/collect/Comparators.html" title="class in
com.google.common.collect">Comparators</A>
<BR>
<A HREF="com/google/common/collect/ConcurrentMultiset.html" title="class
in com.google.common.collect">ConcurrentMultiset</A>
@@ -96,7 +99,9 @@
<BR>
<A HREF="com/google/common/collect/HashMultiset.html" title="class in
com.google.common.collect">HashMultiset</A>
<BR>
-<A HREF="com/google/common/collect/ImmutableBiMapBuilder.html"
title="class in com.google.common.collect">ImmutableBiMapBuilder</A>
+<A HREF="com/google/common/collect/ImmutableBiMap.html" title="class in
com.google.common.collect">ImmutableBiMap</A>
+<BR>
+<A HREF="com/google/common/collect/ImmutableBiMap.Builder.html"
title="class in com.google.common.collect">ImmutableBiMap.Builder</A>
<BR>
<A HREF="com/google/common/collect/ImmutableCollection.html" title="class
in com.google.common.collect">ImmutableCollection</A>
<BR>
@@ -106,12 +111,18 @@
<BR>
<A HREF="com/google/common/collect/ImmutableMap.Builder.html" title="class
in com.google.common.collect">ImmutableMap.Builder</A>
<BR>
-<A HREF="com/google/common/collect/ImmutableMultimapBuilder.html"
title="class in com.google.common.collect">ImmutableMultimapBuilder</A>
+<A HREF="com/google/common/collect/ImmutableMultimap.html" title="class in
com.google.common.collect">ImmutableMultimap</A>
+<BR>
+<A HREF="com/google/common/collect/ImmutableMultimap.Builder.html"
title="class in com.google.common.collect">ImmutableMultimap.Builder</A>
+<BR>
+<A HREF="com/google/common/collect/ImmutableMultiset.html" title="class in
com.google.common.collect">ImmutableMultiset</A>
<BR>
<A HREF="com/google/common/collect/ImmutableSet.html" title="class in
com.google.common.collect">ImmutableSet</A>
<BR>
<A HREF="com/google/common/collect/ImmutableSortedSet.html" title="class
in com.google.common.collect">ImmutableSortedSet</A>
<BR>
+<A HREF="com/google/common/collect/ImmutableSortedSet.Factory.html"
title="class in com.google.common.collect">ImmutableSortedSet.Factory</A>
+<BR>
<A HREF="com/google/common/collect/Iterables.html" title="class in
com.google.common.collect">Iterables</A>
<BR>
<A HREF="com/google/common/collect/Iterators.html" title="class in
com.google.common.collect">Iterators</A>
@@ -124,8 +135,6 @@
<BR>
<A HREF="com/google/common/collect/LinkedHashMultiset.html" title="class
in com.google.common.collect">LinkedHashMultiset</A>
<BR>
-<A HREF="com/google/common/collect/LinkedListMultimap.html" title="class
in com.google.common.collect">LinkedListMultimap</A>
-<BR>
<A HREF="com/google/common/collect/ListMultimap.html" title="interface in
com.google.common.collect"><I>ListMultimap</I></A>
<BR>
<A HREF="com/google/common/collect/Lists.html" title="class in
com.google.common.collect">Lists</A>
@@ -168,7 +177,7 @@
<BR>
<A HREF="com/google/common/base/ReferenceType.html" title="enum in
com.google.common.base">ReferenceType</A>
<BR>
-<A HREF="com/google/common/collect/SerializableComparator.html"
title="interface in
com.google.common.collect"><I>SerializableComparator</I></A>
+<A HREF="com/google/common/collect/Serialization.html" title="class in
com.google.common.collect">Serialization</A>
<BR>
<A HREF="com/google/common/collect/SetMultimap.html" title="interface in
com.google.common.collect"><I>SetMultimap</I></A>
<BR>
@@ -187,6 +196,8 @@
<A HREF="com/google/common/collect/TreeMultimap.html" title="class in
com.google.common.collect">TreeMultimap</A>
<BR>
<A HREF="com/google/common/collect/TreeMultiset.html" title="class in
com.google.common.collect">TreeMultiset</A>
+<BR>
+<A HREF="com/google/common/collect/UnmodifiableIterator.html" title="class
in com.google.common.collect">UnmodifiableIterator</A>
<BR>
</FONT></TD>
</TR>
Modified:
trunk/javadoc/com/google/common/base/FinalizablePhantomReference.html
==============================================================================
--- trunk/javadoc/com/google/common/base/FinalizablePhantomReference.html
(original)
+++ trunk/javadoc/com/google/common/base/FinalizablePhantomReference.html
Mon Aug 18 16:46:26 2008
@@ -2,19 +2,21 @@
<!--NewPage-->
<HTML>
<HEAD>
-<!-- Generated by javadoc (build 1.5.0_06) on Fri May 30 13:31:20 PDT 2008
-->
+<!-- Generated by javadoc (build 1.6.0_01) on Mon Aug 18 15:24:21
GMT-08:00 2008 -->
<TITLE>
-FinalizablePhantomReference (Google Collections Library -
snapshot-20080530 (ALPHA))
+FinalizablePhantomReference (Google Collections Library -
snapshot-20080818 (ALPHA))
</TITLE>
-<META NAME="keywords"
CONTENT="com.google.common.base.FinalizablePhantomReference class">
+<META NAME="date" CONTENT="2008-08-18">
<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css"
TITLE="Style">
<SCRIPT type="text/javascript">
function windowTitle()
{
- parent.document.title="FinalizablePhantomReference (Google Collections
Library - snapshot-20080530 (ALPHA))";
+ if (location.href.indexOf('is-external=true') == -1) {
+ parent.document.title="FinalizablePhantomReference (Google
Collections Library - snapshot-20080818 (ALPHA))";
+ }
}
</SCRIPT>
<NOSCRIPT>
@@ -23,6 +25,7 @@
</HEAD>
<BODY BGCOLOR="white" onload="windowTitle();">
+<HR>
<!-- ========= START OF TOP NAVBAR ======= -->
@@ -88,20 +91,20 @@
<BR>
Class FinalizablePhantomReference<T></H2>
<PRE>
-<A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">java.lang.Object</A>
- <IMG SRC="../../../../resources/inherit.gif" ALT="extended by "><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/Reference.html"
title="class or interface in
java.lang.ref">java.lang.ref.Reference</A><T>
- <IMG SRC="../../../../resources/inherit.gif" ALT="extended by "><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/PhantomReference.html"
title="class or interface in
java.lang.ref">java.lang.ref.PhantomReference</A><T>
+<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">java.lang.Object</A>
+ <IMG SRC="../../../../resources/inherit.gif" ALT="extended by "><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/Reference.html?is-external=true"
title="class or interface in
java.lang.ref">java.lang.ref.Reference</A><T>
+ <IMG SRC="../../../../resources/inherit.gif" ALT="extended by "><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/PhantomReference.html?is-external=true"
title="class or interface in
java.lang.ref">java.lang.ref.PhantomReference</A><T>
<IMG SRC="../../../../resources/inherit.gif" ALT="extended
by "><B>com.google.common.base.FinalizablePhantomReference<T></B>
</PRE>
<HR>
<DL>
-<DT><PRE>public abstract class
<B>FinalizablePhantomReference<T></B><DT>extends <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/PhantomReference.html"
title="class or interface in
java.lang.ref">PhantomReference</A><T></DL>
+<DT><PRE>public abstract class
<B>FinalizablePhantomReference<T></B><DT>extends <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/PhantomReference.html?is-external=true"
title="class or interface in
java.lang.ref">PhantomReference</A><T></DL>
</PRE>
<P>
Phantom reference with a <code>finalizeReferent()</code> method which a
background thread invokes after the garbage collector reclaims the
- referent. This is a simpler alternative to using a <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/ReferenceQueue.html"
title="class or interface in java.lang.ref"><CODE>ReferenceQueue</CODE></A>.
+ referent. This is a simpler alternative to using a <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/ReferenceQueue.html?is-external=true"
title="class or interface in java.lang.ref"><CODE>ReferenceQueue</CODE></A>.
<P>
<P>
@@ -152,28 +155,28 @@
<A
NAME="methods_inherited_from_class_java.lang.ref.PhantomReference"><!--
--></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
-<TH ALIGN="left"><B>Methods inherited from class java.lang.ref.<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/PhantomReference.html"
title="class or interface in java.lang.ref">PhantomReference</A></B></TH>
+<TH ALIGN="left"><B>Methods inherited from class java.lang.ref.<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/PhantomReference.html?is-external=true"
title="class or interface in java.lang.ref">PhantomReference</A></B></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD><CODE><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/PhantomReference.html#get()"
title="class or interface in java.lang.ref">get</A></CODE></TD>
+<TD><CODE><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/PhantomReference.html?is-external=true#get()"
title="class or interface in java.lang.ref">get</A></CODE></TD>
</TR>
</TABLE>
<A NAME="methods_inherited_from_class_java.lang.ref.Reference"><!--
--></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
-<TH ALIGN="left"><B>Methods inherited from class java.lang.ref.<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/Reference.html"
title="class or interface in java.lang.ref">Reference</A></B></TH>
+<TH ALIGN="left"><B>Methods inherited from class java.lang.ref.<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/Reference.html?is-external=true"
title="class or interface in java.lang.ref">Reference</A></B></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD><CODE><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/Reference.html#clear()"
title="class or interface in java.lang.ref">clear</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/Reference.html#enqueue()"
title="class or interface in java.lang.ref">enqueue</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/Reference.html#isEnqueued()"
title="class or interface in java.lang.ref">isEnqueued</A></CODE></TD>
+<TD><CODE><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/Reference.html?is-external=true#clear()"
title="class or interface in java.lang.ref">clear</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/Reference.html?is-external=true#enqueue()"
title="class or interface in java.lang.ref">enqueue</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/Reference.html?is-external=true#isEnqueued()"
title="class or interface in java.lang.ref">isEnqueued</A></CODE></TD>
</TR>
</TABLE>
<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
-<TH ALIGN="left"><B>Methods inherited from class java.lang.<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A></B></TH>
+<TH ALIGN="left"><B>Methods inherited from class java.lang.<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">Object</A></B></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD><CODE><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#clone()"
title="class or interface in java.lang">clone</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#equals(java.lang.Object)"
title="class or interface in java.lang">equals</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#finalize()"
title="class or interface in java.lang">finalize</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#getClass()"
title="class or interface in java.lang">getClass</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#hashCode()"
title="class or interface in java.lang">hashCode</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#notify()"
title="class or interface in java.lang">notify</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#notifyAll()"
title="class or interface in java.lang">notifyAll</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#toString()"
title="class or interface in java.lang">toString</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#wait()"
title="class or interface in java.lang">wait</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#wait(long)"
title="class or interface in java.lang">wait</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#wait(long,
int)" title="class or interface in java.lang">wait</A></CODE></TD>
+<TD><CODE><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#clone()"
title="class or interface in java.lang">clone</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#equals(java.lang.Object)"
title="class or interface in java.lang">equals</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#finalize()"
title="class or interface in java.lang">finalize</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#getClass()"
title="class or interface in java.lang">getClass</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#hashCode()"
title="class or interface in java.lang">hashCode</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#notify()"
title="class or interface in java.lang">notify</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#notifyAll()"
title="class or interface in java.lang">notifyAll</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#toString()"
title="class or interface in java.lang">toString</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait()"
title="class or interface in java.lang">wait</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait(long)"
title="class or interface in java.lang">wait</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait(long,
int)" title="class or interface in java.lang">wait</A></CODE></TD>
</TR>
</TABLE>
Modified: trunk/javadoc/com/google/common/base/FinalizableSoftReference.html
==============================================================================
--- trunk/javadoc/com/google/common/base/FinalizableSoftReference.html
(original)
+++ trunk/javadoc/com/google/common/base/FinalizableSoftReference.html Mon
Aug 18 16:46:26 2008
@@ -2,19 +2,21 @@
<!--NewPage-->
<HTML>
<HEAD>
-<!-- Generated by javadoc (build 1.5.0_06) on Fri May 30 13:31:20 PDT 2008
-->
+<!-- Generated by javadoc (build 1.6.0_01) on Mon Aug 18 15:24:21
GMT-08:00 2008 -->
<TITLE>
-FinalizableSoftReference (Google Collections Library - snapshot-20080530
(ALPHA))
+FinalizableSoftReference (Google Collections Library - snapshot-20080818
(ALPHA))
</TITLE>
-<META NAME="keywords"
CONTENT="com.google.common.base.FinalizableSoftReference class">
+<META NAME="date" CONTENT="2008-08-18">
<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css"
TITLE="Style">
<SCRIPT type="text/javascript">
function windowTitle()
{
- parent.document.title="FinalizableSoftReference (Google Collections
Library - snapshot-20080530 (ALPHA))";
+ if (location.href.indexOf('is-external=true') == -1) {
+ parent.document.title="FinalizableSoftReference (Google
Collections Library - snapshot-20080818 (ALPHA))";
+ }
}
</SCRIPT>
<NOSCRIPT>
@@ -23,6 +25,7 @@
</HEAD>
<BODY BGCOLOR="white" onload="windowTitle();">
+<HR>
<!-- ========= START OF TOP NAVBAR ======= -->
@@ -88,20 +91,20 @@
<BR>
Class FinalizableSoftReference<T></H2>
<PRE>
-<A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">java.lang.Object</A>
- <IMG SRC="../../../../resources/inherit.gif" ALT="extended by "><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/Reference.html"
title="class or interface in
java.lang.ref">java.lang.ref.Reference</A><T>
- <IMG SRC="../../../../resources/inherit.gif" ALT="extended by "><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/SoftReference.html"
title="class or interface in
java.lang.ref">java.lang.ref.SoftReference</A><T>
+<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">java.lang.Object</A>
+ <IMG SRC="../../../../resources/inherit.gif" ALT="extended by "><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/Reference.html?is-external=true"
title="class or interface in
java.lang.ref">java.lang.ref.Reference</A><T>
+ <IMG SRC="../../../../resources/inherit.gif" ALT="extended by "><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/SoftReference.html?is-external=true"
title="class or interface in
java.lang.ref">java.lang.ref.SoftReference</A><T>
<IMG SRC="../../../../resources/inherit.gif" ALT="extended
by "><B>com.google.common.base.FinalizableSoftReference<T></B>
</PRE>
<HR>
<DL>
-<DT><PRE>public abstract class
<B>FinalizableSoftReference<T></B><DT>extends <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/SoftReference.html"
title="class or interface in java.lang.ref">SoftReference</A><T></DL>
+<DT><PRE>public abstract class
<B>FinalizableSoftReference<T></B><DT>extends <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/SoftReference.html?is-external=true"
title="class or interface in java.lang.ref">SoftReference</A><T></DL>
</PRE>
<P>
Soft reference with a <code>finalizeReferent()</code> method which a
background
thread invokes after the garbage collector reclaims the referent. This is
a
- simpler alternative to using a <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/ReferenceQueue.html"
title="class or interface in java.lang.ref"><CODE>ReferenceQueue</CODE></A>.
+ simpler alternative to using a <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/ReferenceQueue.html?is-external=true"
title="class or interface in java.lang.ref"><CODE>ReferenceQueue</CODE></A>.
<P>
<P>
@@ -152,28 +155,28 @@
<A
NAME="methods_inherited_from_class_java.lang.ref.SoftReference"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
-<TH ALIGN="left"><B>Methods inherited from class java.lang.ref.<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/SoftReference.html"
title="class or interface in java.lang.ref">SoftReference</A></B></TH>
+<TH ALIGN="left"><B>Methods inherited from class java.lang.ref.<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/SoftReference.html?is-external=true"
title="class or interface in java.lang.ref">SoftReference</A></B></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD><CODE><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/SoftReference.html#get()"
title="class or interface in java.lang.ref">get</A></CODE></TD>
+<TD><CODE><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/SoftReference.html?is-external=true#get()"
title="class or interface in java.lang.ref">get</A></CODE></TD>
</TR>
</TABLE>
<A NAME="methods_inherited_from_class_java.lang.ref.Reference"><!--
--></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
-<TH ALIGN="left"><B>Methods inherited from class java.lang.ref.<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/Reference.html"
title="class or interface in java.lang.ref">Reference</A></B></TH>
+<TH ALIGN="left"><B>Methods inherited from class java.lang.ref.<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/Reference.html?is-external=true"
title="class or interface in java.lang.ref">Reference</A></B></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD><CODE><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/Reference.html#clear()"
title="class or interface in java.lang.ref">clear</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/Reference.html#enqueue()"
title="class or interface in java.lang.ref">enqueue</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/Reference.html#isEnqueued()"
title="class or interface in java.lang.ref">isEnqueued</A></CODE></TD>
+<TD><CODE><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/Reference.html?is-external=true#clear()"
title="class or interface in java.lang.ref">clear</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/Reference.html?is-external=true#enqueue()"
title="class or interface in java.lang.ref">enqueue</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/Reference.html?is-external=true#isEnqueued()"
title="class or interface in java.lang.ref">isEnqueued</A></CODE></TD>
</TR>
</TABLE>
<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
-<TH ALIGN="left"><B>Methods inherited from class java.lang.<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A></B></TH>
+<TH ALIGN="left"><B>Methods inherited from class java.lang.<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">Object</A></B></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD><CODE><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#clone()"
title="class or interface in java.lang">clone</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#equals(java.lang.Object)"
title="class or interface in java.lang">equals</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#finalize()"
title="class or interface in java.lang">finalize</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#getClass()"
title="class or interface in java.lang">getClass</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#hashCode()"
title="class or interface in java.lang">hashCode</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#notify()"
title="class or interface in java.lang">notify</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#notifyAll()"
title="class or interface in java.lang">notifyAll</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#toString()"
title="class or interface in java.lang">toString</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#wait()"
title="class or interface in java.lang">wait</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#wait(long)"
title="class or interface in java.lang">wait</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#wait(long,
int)" title="class or interface in java.lang">wait</A></CODE></TD>
+<TD><CODE><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#clone()"
title="class or interface in java.lang">clone</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#equals(java.lang.Object)"
title="class or interface in java.lang">equals</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#finalize()"
title="class or interface in java.lang">finalize</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#getClass()"
title="class or interface in java.lang">getClass</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#hashCode()"
title="class or interface in java.lang">hashCode</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#notify()"
title="class or interface in java.lang">notify</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#notifyAll()"
title="class or interface in java.lang">notifyAll</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#toString()"
title="class or interface in java.lang">toString</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait()"
title="class or interface in java.lang">wait</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait(long)"
title="class or interface in java.lang">wait</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait(long,
int)" title="class or interface in java.lang">wait</A></CODE></TD>
</TR>
</TABLE>
Modified: trunk/javadoc/com/google/common/base/FinalizableWeakReference.html
==============================================================================
--- trunk/javadoc/com/google/common/base/FinalizableWeakReference.html
(original)
+++ trunk/javadoc/com/google/common/base/FinalizableWeakReference.html Mon
Aug 18 16:46:26 2008
@@ -2,19 +2,21 @@
<!--NewPage-->
<HTML>
<HEAD>
-<!-- Generated by javadoc (build 1.5.0_06) on Fri May 30 13:31:20 PDT 2008
-->
+<!-- Generated by javadoc (build 1.6.0_01) on Mon Aug 18 15:24:21
GMT-08:00 2008 -->
<TITLE>
-FinalizableWeakReference (Google Collections Library - snapshot-20080530
(ALPHA))
+FinalizableWeakReference (Google Collections Library - snapshot-20080818
(ALPHA))
</TITLE>
-<META NAME="keywords"
CONTENT="com.google.common.base.FinalizableWeakReference class">
+<META NAME="date" CONTENT="2008-08-18">
<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css"
TITLE="Style">
<SCRIPT type="text/javascript">
function windowTitle()
{
- parent.document.title="FinalizableWeakReference (Google Collections
Library - snapshot-20080530 (ALPHA))";
+ if (location.href.indexOf('is-external=true') == -1) {
+ parent.document.title="FinalizableWeakReference (Google
Collections Library - snapshot-20080818 (ALPHA))";
+ }
}
</SCRIPT>
<NOSCRIPT>
@@ -23,6 +25,7 @@
</HEAD>
<BODY BGCOLOR="white" onload="windowTitle();">
+<HR>
<!-- ========= START OF TOP NAVBAR ======= -->
@@ -88,20 +91,20 @@
<BR>
Class FinalizableWeakReference<T></H2>
<PRE>
-<A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">java.lang.Object</A>
- <IMG SRC="../../../../resources/inherit.gif" ALT="extended by "><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/Reference.html"
title="class or interface in
java.lang.ref">java.lang.ref.Reference</A><T>
- <IMG SRC="../../../../resources/inherit.gif" ALT="extended by "><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/WeakReference.html"
title="class or interface in
java.lang.ref">java.lang.ref.WeakReference</A><T>
+<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">java.lang.Object</A>
+ <IMG SRC="../../../../resources/inherit.gif" ALT="extended by "><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/Reference.html?is-external=true"
title="class or interface in
java.lang.ref">java.lang.ref.Reference</A><T>
+ <IMG SRC="../../../../resources/inherit.gif" ALT="extended by "><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/WeakReference.html?is-external=true"
title="class or interface in
java.lang.ref">java.lang.ref.WeakReference</A><T>
<IMG SRC="../../../../resources/inherit.gif" ALT="extended
by "><B>com.google.common.base.FinalizableWeakReference<T></B>
</PRE>
<HR>
<DL>
-<DT><PRE>public abstract class
<B>FinalizableWeakReference<T></B><DT>extends <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/WeakReference.html"
title="class or interface in java.lang.ref">WeakReference</A><T></DL>
+<DT><PRE>public abstract class
<B>FinalizableWeakReference<T></B><DT>extends <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/WeakReference.html?is-external=true"
title="class or interface in java.lang.ref">WeakReference</A><T></DL>
</PRE>
<P>
Weak reference with a <code>finalizeReferent()</code> method which a
background
thread invokes after the garbage collector reclaims the referent. This is
a
- simpler alternative to using a <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/ReferenceQueue.html"
title="class or interface in java.lang.ref"><CODE>ReferenceQueue</CODE></A>.
+ simpler alternative to using a <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/ReferenceQueue.html?is-external=true"
title="class or interface in java.lang.ref"><CODE>ReferenceQueue</CODE></A>.
<P>
<P>
@@ -152,19 +155,19 @@
<A NAME="methods_inherited_from_class_java.lang.ref.Reference"><!--
--></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
-<TH ALIGN="left"><B>Methods inherited from class java.lang.ref.<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/Reference.html"
title="class or interface in java.lang.ref">Reference</A></B></TH>
+<TH ALIGN="left"><B>Methods inherited from class java.lang.ref.<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/Reference.html?is-external=true"
title="class or interface in java.lang.ref">Reference</A></B></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD><CODE><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/Reference.html#clear()"
title="class or interface in java.lang.ref">clear</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/Reference.html#enqueue()"
title="class or interface in java.lang.ref">enqueue</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/Reference.html#get()"
title="class or interface in java.lang.ref">get</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/Reference.html#isEnqueued()"
title="class or interface in java.lang.ref">isEnqueued</A></CODE></TD>
+<TD><CODE><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/Reference.html?is-external=true#clear()"
title="class or interface in java.lang.ref">clear</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/Reference.html?is-external=true#enqueue()"
title="class or interface in java.lang.ref">enqueue</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/Reference.html?is-external=true#get()"
title="class or interface in java.lang.ref">get</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/ref/Reference.html?is-external=true#isEnqueued()"
title="class or interface in java.lang.ref">isEnqueued</A></CODE></TD>
</TR>
</TABLE>
<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
-<TH ALIGN="left"><B>Methods inherited from class java.lang.<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A></B></TH>
+<TH ALIGN="left"><B>Methods inherited from class java.lang.<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">Object</A></B></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD><CODE><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#clone()"
title="class or interface in java.lang">clone</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#equals(java.lang.Object)"
title="class or interface in java.lang">equals</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#finalize()"
title="class or interface in java.lang">finalize</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#getClass()"
title="class or interface in java.lang">getClass</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#hashCode()"
title="class or interface in java.lang">hashCode</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#notify()"
title="class or interface in java.lang">notify</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#notifyAll()"
title="class or interface in java.lang">notifyAll</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#toString()"
title="class or interface in java.lang">toString</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#wait()"
title="class or interface in java.lang">wait</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#wait(long)"
title="class or interface in java.lang">wait</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#wait(long,
int)" title="class or interface in java.lang">wait</A></CODE></TD>
+<TD><CODE><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#clone()"
title="class or interface in java.lang">clone</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#equals(java.lang.Object)"
title="class or interface in java.lang">equals</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#finalize()"
title="class or interface in java.lang">finalize</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#getClass()"
title="class or interface in java.lang">getClass</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#hashCode()"
title="class or interface in java.lang">hashCode</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#notify()"
title="class or interface in java.lang">notify</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#notifyAll()"
title="class or interface in java.lang">notifyAll</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#toString()"
title="class or interface in java.lang">toString</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait()"
title="class or interface in java.lang">wait</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait(long)"
title="class or interface in java.lang">wait</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait(long,
int)" title="class or interface in java.lang">wait</A></CODE></TD>
</TR>
</TABLE>
Modified: trunk/javadoc/com/google/common/base/Function.html
==============================================================================
--- trunk/javadoc/com/google/common/base/Function.html (original)
+++ trunk/javadoc/com/google/common/base/Function.html Mon Aug 18 16:46:26
2008
@@ -2,19 +2,21 @@
<!--NewPage-->
<HTML>
<HEAD>
-<!-- Generated by javadoc (build 1.5.0_06) on Fri May 30 13:31:20 PDT 2008
-->
+<!-- Generated by javadoc (build 1.6.0_01) on Mon Aug 18 15:24:21
GMT-08:00 2008 -->
<TITLE>
-Function (Google Collections Library - snapshot-20080530 (ALPHA))
+Function (Google Collections Library - snapshot-20080818 (ALPHA))
</TITLE>
-<META NAME="keywords" CONTENT="com.google.common.base.Function interface">
+<META NAME="date" CONTENT="2008-08-18">
<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css"
TITLE="Style">
<SCRIPT type="text/javascript">
function windowTitle()
{
- parent.document.title="Function (Google Collections Library -
snapshot-20080530 (ALPHA))";
+ if (location.href.indexOf('is-external=true') == -1) {
+ parent.document.title="Function (Google Collections Library -
snapshot-20080818 (ALPHA))";
+ }
}
</SCRIPT>
<NOSCRIPT>
@@ -23,6 +25,7 @@
</HEAD>
<BODY BGCOLOR="white" onload="windowTitle();">
+<HR>
<!-- ========= START OF TOP NAVBAR ======= -->
@@ -87,14 +90,16 @@
com.google.common.base</FONT>
<BR>
Interface Function<F,T></H2>
+<DL>
+<DT><DT><B>Type Parameters:</B><DD><CODE>F</CODE> - the type of the
function input<DD><CODE>T</CODE> - the type of the function output</DL>
<HR>
<DL>
<DT><PRE>public interface <B>Function<F,T></B></DL>
</PRE>
<P>
-A Function provides a transformation on an object and returns the resulting
- object. For example, a <code>StringToIntegerFunction</code> may implement
+A transformation from one object to another. For example, a
+ <code>StringToIntegerFunction</code> may implement
<code>Function<String,Integer></code> and transform integers in
<code>String</code> format to <code>Integer</code> format.
@@ -136,7 +141,7 @@
<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="../../../../com/google/common/base/Function.html#equals(java.lang.Object)">equals</A></B>(<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A> obj)</CODE>
+<TD><CODE><B><A
HREF="../../../../com/google/common/base/Function.html#equals(java.lang.Object)">equals</A></B>(<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">Object</A> obj)</CODE>
<BR>
Indicates
whether some other object is equal to this <code>Function</code>.</TD>
@@ -175,21 +180,21 @@
<A NAME="equals(java.lang.Object)"><!-- --></A><H3>
equals</H3>
<PRE>
-boolean <B>equals</B>(<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A> obj)</PRE>
+boolean <B>equals</B>(<FONT SIZE="-1"><A
HREF="../../../../com/google/common/base/Nullable.html" title="annotation
in com.google.common.base">@Nullable</A></FONT>
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">Object</A> obj)</PRE>
<DL>
<DD>Indicates whether some other object is equal to this
<code>Function</code>.
- This method can return <code>true</code> <em>only</em> if the specified
object
- is also a <code>Function</code> and, for every input object
<code>o</code>, it
- returns exactly the same value. Thus,
<code>function1.equals(function2)</code>
- implies that either <code>function1.apply(o)</code> and
- <code>function1.apply(o)</code> are both <code>null</code>, or
- <code>function1.apply(o).equals(function2.apply(o))</code>.
+ This method can return <code>true</code> <i>only</i> if the specified
object is
+ also a <code>Function</code> and, for every input object <code>o</code>,
it returns
+ exactly the same value. Thus, <code>function1.equals(function2)</code>
implies
+ that either <code>function1.apply(o)</code> and
<code>function2.apply(o)</code> are
+ both null, or <code>function1.apply(o).equals(function2.apply(o))</code>.
- <p>Note that it is <em>always</em> safe <em>not</em> to override
- <code>Object.equals(Object)</code>.
+ <p>Note that it is always safe <em>not</em> to override
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#equals(java.lang.Object)"
title="class or interface in
java.lang"><CODE>Object.equals(java.lang.Object)</CODE></A>.
<P>
<DD><DL>
-<DT><B>Overrides:</B><DD><CODE><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#equals(java.lang.Object)"
title="class or interface in java.lang">equals</A></CODE> in class <CODE><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A></CODE></DL>
+<DT><B>Overrides:</B><DD><CODE><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#equals(java.lang.Object)"
title="class or interface in java.lang">equals</A></CODE> in class <CODE><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">Object</A></CODE></DL>
</DD>
<DD><DL>
</DL>
Modified: trunk/javadoc/com/google/common/base/Functions.html
==============================================================================
--- trunk/javadoc/com/google/common/base/Functions.html (original)
+++ trunk/javadoc/com/google/common/base/Functions.html Mon Aug 18 16:46:26
2008
@@ -2,19 +2,21 @@
<!--NewPage-->
<HTML>
<HEAD>
-<!-- Generated by javadoc (build 1.5.0_06) on Fri May 30 13:31:20 PDT 2008
-->
+<!-- Generated by javadoc (build 1.6.0_01) on Mon Aug 18 15:24:21
GMT-08:00 2008 -->
<TITLE>
-Functions (Google Collections Library - snapshot-20080530 (ALPHA))
+Functions (Google Collections Library - snapshot-20080818 (ALPHA))
</TITLE>
-<META NAME="keywords" CONTENT="com.google.common.base.Functions class">
+<META NAME="date" CONTENT="2008-08-18">
<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css"
TITLE="Style">
<SCRIPT type="text/javascript">
function windowTitle()
{
- parent.document.title="Functions (Google Collections Library -
snapshot-20080530 (ALPHA))";
+ if (location.href.indexOf('is-external=true') == -1) {
+ parent.document.title="Functions (Google Collections Library -
snapshot-20080818 (ALPHA))";
+ }
}
</SCRIPT>
<NOSCRIPT>
@@ -23,6 +25,7 @@
</HEAD>
<BODY BGCOLOR="white" onload="windowTitle();">
+<HR>
<!-- ========= START OF TOP NAVBAR ======= -->
@@ -88,12 +91,12 @@
<BR>
Class Functions</H2>
<PRE>
-<A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">java.lang.Object</A>
+<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">java.lang.Object</A>
<IMG SRC="../../../../resources/inherit.gif" ALT="extended
by "><B>com.google.common.base.Functions</B>
</PRE>
<HR>
<DL>
-<DT><PRE>public final class <B>Functions</B><DT>extends <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A></DL>
+<DT><PRE>public final class <B>Functions</B><DT>extends <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">Object</A></DL>
</PRE>
<P>
@@ -118,19 +121,11 @@
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE>static <A
HREF="../../../../com/google/common/base/Function.html" title="interface in
com.google.common.base">Function</A><<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A>,<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html"
title="class or interface in java.lang">String</A>></CODE></FONT></TD>
+<CODE>static <A
HREF="../../../../com/google/common/base/Function.html" title="interface in
com.google.common.base">Function</A><<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">Object</A>,<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in java.lang">String</A>></CODE></FONT></TD>
<TD><CODE><B><A
HREF="../../../../com/google/common/base/Functions.html#TO_STRING">TO_STRING</A></B></CODE>
<BR>
- See <A
HREF="../../../../com/google/common/base/Functions.html#toStringFunction()"><CODE>toStringFunction()</CODE></A>.</TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE>static <A
HREF="../../../../com/google/common/base/Function.html" title="interface in
com.google.common.base">Function</A><<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html"
title="class or interface in java.lang">String</A>,<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html"
title="class or interface in java.lang">String</A>></CODE></FONT></TD>
-<TD><CODE><B><A
HREF="../../../../com/google/common/base/Functions.html#TRIM_STRING">TRIM_STRING</A></B></CODE>
-
-<BR>
- See <A
HREF="../../../../com/google/common/base/Functions.html#trimString()"><CODE>trimString()</CODE></A>.</TD>
+ A function
that calls <code>toString()</code> on its argument.</TD>
</TR>
</TABLE>
@@ -164,14 +159,14 @@
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="0" SUMMARY="">
<TR ALIGN="right" VALIGN="">
<TD NOWRAP><FONT SIZE="-1">
-<CODE><E> <A HREF="../../../../com/google/common/base/Function.html"
title="interface in com.google.common.base">Function</A><<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A>,E></CODE></FONT></TD>
+<CODE><E> <A HREF="../../../../com/google/common/base/Function.html"
title="interface in com.google.common.base">Function</A><<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">Object</A>,E></CODE></FONT></TD>
</TR>
</TABLE>
</CODE></FONT></TD>
<TD><CODE><B><A
HREF="../../../../com/google/common/base/Functions.html#constant(E)">constant</A></B>(E value)</CODE>
<BR>
- Returns a <A
HREF="../../../../com/google/common/base/Function.html" title="interface in
com.google.common.base"><CODE>Function</CODE></A> that returns
<code>value</code> for any input.</TD>
+ Creates a
function that returns <code>value</code> for any input.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
@@ -183,10 +178,10 @@
</TR>
</TABLE>
</CODE></FONT></TD>
-<TD><CODE><B><A
HREF="../../../../com/google/common/base/Functions.html#forMap(java.util.Map)">forMap</A></B>(<A
HREF="http://java.sun.com/javase/6/docs/api/java/util/Map.html"
title="class or interface in java.util">Map</A><? super A,? extends
B> map)</CODE>
+<TD><CODE><B><A
HREF="../../../../com/google/common/base/Functions.html#forMap(java.util.Map)">forMap</A></B>(<A
HREF="http://java.sun.com/javase/6/docs/api/java/util/Map.html?is-external=true"
title="class or interface in java.util">Map</A><? super A,? extends
B> map)</CODE>
<BR>
- Returns a
function which performs key-to-value lookup on <code>map</code>.</TD>
+ Returns a
function which performs a map lookup.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
@@ -198,11 +193,11 @@
</TR>
</TABLE>
</CODE></FONT></TD>
-<TD><CODE><B><A
HREF="../../../../com/google/common/base/Functions.html#forMap(java.util.Map,
B)">forMap</A></B>(<A
HREF="http://java.sun.com/javase/6/docs/api/java/util/Map.html"
title="class or interface in java.util">Map</A><? super A,? extends
B> map,
+<TD><CODE><B><A
HREF="../../../../com/google/common/base/Functions.html#forMap(java.util.Map,
B)">forMap</A></B>(<A
HREF="http://java.sun.com/javase/6/docs/api/java/util/Map.html?is-external=true"
title="class or interface in java.util">Map</A><? super A,? extends
B> map,
B defaultValue)</CODE>
<BR>
- Returns a
function which performs key-to-value lookup on <code>map</code>.</TD>
+ Returns a
function which performs a map lookup with a default value.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
@@ -210,15 +205,15 @@
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="0" SUMMARY="">
<TR ALIGN="right" VALIGN="">
<TD NOWRAP><FONT SIZE="-1">
-<CODE><T> <A HREF="../../../../com/google/common/base/Function.html"
title="interface in com.google.common.base">Function</A><T,<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Boolean.html"
title="class or interface in java.lang">Boolean</A>></CODE></FONT></TD>
+<CODE><T> <A HREF="../../../../com/google/common/base/Function.html"
title="interface in com.google.common.base">Function</A><T,<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true"
title="class or interface in java.lang">Boolean</A>></CODE></FONT></TD>
</TR>
</TABLE>
</CODE></FONT></TD>
<TD><CODE><B><A
HREF="../../../../com/google/common/base/Functions.html#forPredicate(com.google.common.base.Predicate)">forPredicate</A></B>(<A
HREF="../../../../com/google/common/base/Predicate.html" title="interface
in com.google.common.base">Predicate</A><? super
T> predicate)</CODE>
<BR>
- Returns a
boolean-valued function that evaluates to the same result as the
- given predicate.</TD>
+ Creates a
function that returns the same boolean output as the given
+ predicate for all inputs.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
@@ -237,12 +232,11 @@
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE>static <A
HREF="../../../../com/google/common/base/Function.html" title="interface in
com.google.common.base">Function</A><<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A>,<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Integer.html"
title="class or interface in java.lang">Integer</A>></CODE></FONT></TD>
+<CODE>static <A
HREF="../../../../com/google/common/base/Function.html" title="interface in
com.google.common.base">Function</A><<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">Object</A>,<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Integer.html?is-external=true"
title="class or interface in java.lang">Integer</A>></CODE></FONT></TD>
<TD><CODE><B><A
HREF="../../../../com/google/common/base/Functions.html#toHashCode()">toHashCode</A></B>()</CODE>
<BR>
- Returns a
function that determines the <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#hashCode()"
title="class or interface in java.lang"><CODE>Object.hashCode()</CODE></A>
of its
- argument.</TD>
+ Returns a
function that determines the hash code of its argument.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
@@ -250,33 +244,23 @@
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="0" SUMMARY="">
<TR ALIGN="right" VALIGN="">
<TD NOWRAP><FONT SIZE="-1">
-<CODE><F> <A HREF="../../../../com/google/common/base/Function.html"
title="interface in com.google.common.base">Function</A><F,<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html"
title="class or interface in java.lang">String</A>></CODE></FONT></TD>
+<CODE><F> <A HREF="../../../../com/google/common/base/Function.html"
title="interface in com.google.common.base">Function</A><F,<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in java.lang">String</A>></CODE></FONT></TD>
</TR>
</TABLE>
</CODE></FONT></TD>
<TD><CODE><B><A
HREF="../../../../com/google/common/base/Functions.html#toStringFunction()">toStringFunction</A></B>()</CODE>
<BR>
- Returns a
function that returns the <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#toString()"
title="class or interface in java.lang"><CODE>Object.toString()</CODE></A>
value of its
- argument.</TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE>static <A
HREF="../../../../com/google/common/base/Function.html" title="interface in
com.google.common.base">Function</A><<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html"
title="class or interface in java.lang">String</A>,<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html"
title="class or interface in java.lang">String</A>></CODE></FONT></TD>
-<TD><CODE><B><A
HREF="../../../../com/google/common/base/Functions.html#trimString()">trimString</A></B>()</CODE>
-
-<BR>
- A function
that returns the result of calling <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html#trim()"
title="class or interface in java.lang"><CODE>String.trim()</CODE></A>
- on its argument.</TD>
+ Returns a
function that calls <code>toString()</code> on its argument.</TD>
</TR>
</TABLE>
<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
-<TH ALIGN="left"><B>Methods inherited from class java.lang.<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A></B></TH>
+<TH ALIGN="left"><B>Methods inherited from class java.lang.<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">Object</A></B></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD><CODE><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#clone()"
title="class or interface in java.lang">clone</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#equals(java.lang.Object)"
title="class or interface in java.lang">equals</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#finalize()"
title="class or interface in java.lang">finalize</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#getClass()"
title="class or interface in java.lang">getClass</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#hashCode()"
title="class or interface in java.lang">hashCode</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#notify()"
title="class or interface in java.lang">notify</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#notifyAll()"
title="class or interface in java.lang">notifyAll</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#toString()"
title="class or interface in java.lang">toString</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#wait()"
title="class or interface in java.lang">wait</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#wait(long)"
title="class or interface in java.lang">wait</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#wait(long,
int)" title="class or interface in java.lang">wait</A></CODE></TD>
+<TD><CODE><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#clone()"
title="class or interface in java.lang">clone</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#equals(java.lang.Object)"
title="class or interface in java.lang">equals</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#finalize()"
title="class or interface in java.lang">finalize</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#getClass()"
title="class or interface in java.lang">getClass</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#hashCode()"
title="class or interface in java.lang">hashCode</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#notify()"
title="class or interface in java.lang">notify</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#notifyAll()"
title="class or interface in java.lang">notifyAll</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#toString()"
title="class or interface in java.lang">toString</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait()"
title="class or interface in java.lang">wait</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait(long)"
title="class or interface in java.lang">wait</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait(long,
int)" title="class or interface in java.lang">wait</A></CODE></TD>
</TR>
</TABLE>
@@ -295,26 +279,13 @@
<A NAME="TO_STRING"><!-- --></A><H3>
TO_STRING</H3>
<PRE>
-public static final <A
HREF="../../../../com/google/common/base/Function.html" title="interface in
com.google.common.base">Function</A><<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A>,<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html"
title="class or interface in java.lang">String</A>>
<B>TO_STRING</B></PRE>
+public static final <A
HREF="../../../../com/google/common/base/Function.html" title="interface in
com.google.common.base">Function</A><<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">Object</A>,<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in java.lang">String</A>>
<B>TO_STRING</B></PRE>
<DL>
-<DD>See <A
HREF="../../../../com/google/common/base/Functions.html#toStringFunction()"><CODE>toStringFunction()</CODE></A>.
+<DD>A function that calls <code>toString()</code> on its argument. This
function
+ does not accept nulls; it will throw a <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/NullPointerException.html?is-external=true"
title="class or interface in
java.lang"><CODE>NullPointerException</CODE></A> when
+ applied to <code>null</code>.
- TODO: Consider deprecating this in favor of an accessor method like
- <A
HREF="../../../../com/google/common/base/Functions.html#toStringFunction()"><CODE>toStringFunction()</CODE></A>.
-<P>
-<DL>
-</DL>
-</DL>
-<HR>
-
-<A NAME="TRIM_STRING"><!-- --></A><H3>
-TRIM_STRING</H3>
-<PRE>
-public static final <A
HREF="../../../../com/google/common/base/Function.html" title="interface in
com.google.common.base">Function</A><<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html"
title="class or interface in java.lang">String</A>,<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html"
title="class or interface in java.lang">String</A>>
<B>TRIM_STRING</B></PRE>
-<DL>
-<DD>See <A
HREF="../../../../com/google/common/base/Functions.html#trimString()"><CODE>trimString()</CODE></A>.
-
- TODO: Deprecate this and use trimString().
+ <p>TODO: Consider deprecating this in favor of <A
HREF="../../../../com/google/common/base/Functions.html#toStringFunction()"><CODE>toStringFunction()</CODE></A>.
<P>
<DL>
</DL>
@@ -333,11 +304,11 @@
<A NAME="toStringFunction()"><!-- --></A><H3>
toStringFunction</H3>
<PRE>
-public static <F> <A
HREF="../../../../com/google/common/base/Function.html" title="interface in
com.google.common.base">Function</A><F,<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html"
title="class or interface in java.lang">String</A>>
<B>toStringFunction</B>()</PRE>
+public static <F> <A
HREF="../../../../com/google/common/base/Function.html" title="interface in
com.google.common.base">Function</A><F,<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in java.lang">String</A>>
<B>toStringFunction</B>()</PRE>
<DL>
-<DD>Returns a function that returns the <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#toString()"
title="class or interface in java.lang"><CODE>Object.toString()</CODE></A>
value of its
- argument. This function is not nullable; invoking
<code>apply(null)</code> on it
- throws a <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/NullPointerException.html"
title="class or interface in
java.lang"><CODE>NullPointerException</CODE></A>.
+<DD>Returns a function that calls <code>toString()</code> on its argument.
The
+ function does not accept nulls; it will throw a
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/NullPointerException.html?is-external=true"
title="class or interface in
java.lang"><CODE>NullPointerException</CODE></A> when applied to
<code>null</code>.
<P>
<DD><DL>
</DL>
@@ -348,26 +319,11 @@
<A NAME="toHashCode()"><!-- --></A><H3>
toHashCode</H3>
<PRE>
-public static <A HREF="../../../../com/google/common/base/Function.html"
title="interface in com.google.common.base">Function</A><<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A>,<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Integer.html"
title="class or interface in java.lang">Integer</A>>
<B>toHashCode</B>()</PRE>
-<DL>
-<DD>Returns a function that determines the <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#hashCode()"
title="class or interface in java.lang"><CODE>Object.hashCode()</CODE></A>
of its
- argument. For null arguments, this returns 0, as used in hash code
- calculations by the Java Collections classes.
-<P>
-<DD><DL>
-</DL>
-</DD>
-</DL>
-<HR>
-
-<A NAME="trimString()"><!-- --></A><H3>
-trimString</H3>
-<PRE>
-public static <A HREF="../../../../com/google/common/base/Function.html"
title="interface in com.google.common.base">Function</A><<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html"
title="class or interface in java.lang">String</A>,<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html"
title="class or interface in java.lang">String</A>>
<B>trimString</B>()</PRE>
+public static <A HREF="../../../../com/google/common/base/Function.html"
title="interface in com.google.common.base">Function</A><<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">Object</A>,<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Integer.html?is-external=true"
title="class or interface in java.lang">Integer</A>>
<B>toHashCode</B>()</PRE>
<DL>
-<DD>A function that returns the result of calling <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html#trim()"
title="class or interface in java.lang"><CODE>String.trim()</CODE></A>
- on its argument. Note that this function is not @Nullable:
- it will throw a <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/NullPointerException.html"
title="class or interface in
java.lang"><CODE>NullPointerException</CODE></A> when applied to
<code>null</code>.
+<DD>Returns a function that determines the hash code of its argument. For
null
+ arguments, the function returns 0, for consistency with the hash code
+ calculations in the Java Collections classes.
<P>
<DD><DL>
</DL>
@@ -391,18 +347,18 @@
<A NAME="forMap(java.util.Map)"><!-- --></A><H3>
forMap</H3>
<PRE>
-public static <A,B> <A
HREF="../../../../com/google/common/base/Function.html" title="interface in
com.google.common.base">Function</A><A,B> <B>forMap</B>(<A
HREF="http://java.sun.com/javase/6/docs/api/java/util/Map.html"
title="class or interface in java.util">Map</A><? super A,? extends
B> map)</PRE>
+public static <A,B> <A
HREF="../../../../com/google/common/base/Function.html" title="interface in
com.google.common.base">Function</A><A,B> <B>forMap</B>(<A
HREF="http://java.sun.com/javase/6/docs/api/java/util/Map.html?is-external=true"
title="class or interface in java.util">Map</A><? super A,? extends
B> map)</PRE>
<DL>
-<DD>Returns a function which performs key-to-value lookup on
<code>map</code>.
+<DD>Returns a function which performs a map lookup.
<p>The difference between a map and a function is that a map is defined on
- a set of keys, while a function is defined on a type.
- The function built by this method returns <code>null</code>
- for all arguments that do not belong to the map's keyset.
+ a set of keys, while a function is defined on all inputs of the correct
+ type. The function created by this method returns <code>null</code> for
all
+ inputs that do not belong to the map's key set.
<P>
<DD><DL>
-<DT><B>Parameters:</B><DD><CODE>map</CODE> - Map<A,B> source map
-<DT><B>Returns:</B><DD>Function<A,B> function that returns map.get(a)
for each A a</DL>
+<DT><B>Parameters:</B><DD><CODE>map</CODE> - source map that determines
the function behavior
+<DT><B>Returns:</B><DD>function that returns <code>map.get(a)</code> for
each <code>a</code></DL>
</DD>
</DL>
<HR>
@@ -410,18 +366,18 @@
<A NAME="forMap(java.util.Map,java.lang.Object)"><!-- --></A><A
NAME="forMap(java.util.Map, B)"><!-- --></A><H3>
forMap</H3>
<PRE>
-public static <A,B> <A
HREF="../../../../com/google/common/base/Function.html" title="interface in
com.google.common.base">Function</A><A,B> <B>forMap</B>(<A
HREF="http://java.sun.com/javase/6/docs/api/java/util/Map.html"
title="class or interface in java.util">Map</A><? super A,? extends
B> map,
+public static <A,B> <A
HREF="../../../../com/google/common/base/Function.html" title="interface in
com.google.common.base">Function</A><A,B> <B>forMap</B>(<A
HREF="http://java.sun.com/javase/6/docs/api/java/util/Map.html?is-external=true"
title="class or interface in java.util">Map</A><? super A,? extends
B> map,
<FONT SIZE="-1"><A
HREF="../../../../com/google/common/base/Nullable.html" title="annotation
in com.google.common.base">@Nullable</A></FONT>
B defaultValue)</PRE>
<DL>
-<DD>Returns a function which performs key-to-value lookup on
<code>map</code>.
- The function built by this method returns <code>defaultValue</code>
- for all its arguments that do not belong to the map's keyset.
+<DD>Returns a function which performs a map lookup with a default value.
The
+ function created by this method returns <code>defaultValue</code> for all
+ inputs that do not belong to the map's key set.
<P>
<DD><DL>
-<DT><B>Parameters:</B><DD><CODE>map</CODE> -
Map<A,B><DD><CODE>defaultValue</CODE> - B
-<DT><B>Returns:</B><DD>Function <code>f</code> such that
<code>f(a)=map.get(a)</code>
- if <code>map.containsKey(x)</code>, and <code>defaultValue</code>
otherwise.<DT><B>See Also:</B><DD><A
HREF="../../../../com/google/common/base/Functions.html#forMap(java.util.Map)"><CODE>forMap(Map)</CODE></A></DL>
+<DT><B>Parameters:</B><DD><CODE>map</CODE> - source map that determines
the function behavior<DD><CODE>defaultValue</CODE> - the value to return
for inputs that aren't map keys
+<DT><B>Returns:</B><DD>function that returns <code>map.get(a)</code> when
<code>a</code> is a key,
+ or <code>defaultValue</code> otherwise</DL>
</DD>
</DL>
<HR>
@@ -434,11 +390,11 @@
<DL>
<DD>Returns the composition of two functions. For <code>f: A->B</code>
and
<code>g: B->C</code>, composition is defined as the function h such
that
- <code>h(x) == g(f(x))</code> for each <code>x</code>.
+ <code>h(a) == g(f(a))</code> for each <code>a</code>.
<P>
<DD><DL>
-<DT><B>Parameters:</B><DD><CODE>g</CODE> -
Function<B,C><DD><CODE>f</CODE> - Function<A,B>
-<DT><B>Returns:</B><DD>Function<A,C> composition of f and g<DT><B>See
Also:</B><DD><a href="//en.wikipedia.org/wiki/Function_composition">
+<DT><B>Parameters:</B><DD><CODE>g</CODE> - the second function to
apply<DD><CODE>f</CODE> - the first function to apply
+<DT><B>Returns:</B><DD>the composition of <code>f</code> and
<code>g</code><DT><B>See Also:</B><DD><a
href="//en.wikipedia.org/wiki/Function_composition">
function composition</a></DL>
</DD>
</DL>
@@ -447,10 +403,10 @@
<A NAME="forPredicate(com.google.common.base.Predicate)"><!-- --></A><H3>
forPredicate</H3>
<PRE>
-public static <T> <A
HREF="../../../../com/google/common/base/Function.html" title="interface in
com.google.common.base">Function</A><T,<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Boolean.html"
title="class or interface in java.lang">Boolean</A>>
<B>forPredicate</B>(<A
HREF="../../../../com/google/common/base/Predicate.html" title="interface
in com.google.common.base">Predicate</A><? super
T> predicate)</PRE>
+public static <T> <A
HREF="../../../../com/google/common/base/Function.html" title="interface in
com.google.common.base">Function</A><T,<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true"
title="class or interface in java.lang">Boolean</A>>
<B>forPredicate</B>(<A
HREF="../../../../com/google/common/base/Predicate.html" title="interface
in com.google.common.base">Predicate</A><? super
T> predicate)</PRE>
<DL>
-<DD>Returns a boolean-valued function that evaluates to the same result as
the
- given predicate.
+<DD>Creates a function that returns the same boolean output as the given
+ predicate for all inputs.
<P>
<DD><DL>
</DL>
@@ -461,14 +417,14 @@
<A NAME="constant(java.lang.Object)"><!-- --></A><A
NAME="constant(E)"><!-- --></A><H3>
constant</H3>
<PRE>
-public static <E> <A
HREF="../../../../com/google/common/base/Function.html" title="interface in
com.google.common.base">Function</A><<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A>,E>
<B>constant</B>(<FONT SIZE="-1"><A
HREF="../../../../com/google/common/base/Nullable.html" title="annotation
in com.google.common.base">@Nullable</A></FONT>
+public static <E> <A
HREF="../../../../com/google/common/base/Function.html" title="interface in
com.google.common.base">Function</A><<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">Object</A>,E>
<B>constant</B>(<FONT SIZE="-1"><A
HREF="../../../../com/google/common/base/Nullable.html" title="annotation
in com.google.common.base">@Nullable</A></FONT>
E value)</PRE>
<DL>
-<DD>Returns a <A HREF="../../../../com/google/common/base/Function.html"
title="interface in com.google.common.base"><CODE>Function</CODE></A> that
returns <code>value</code> for any input.
+<DD>Creates a function that returns <code>value</code> for any input.
<P>
<DD><DL>
-<DT><B>Parameters:</B><DD><CODE>value</CODE> - the constant value for the
<code>Function</code> to return
-<DT><B>Returns:</B><DD>a <code>Function</code> that always returns
<code>value</code>.</DL>
+<DT><B>Parameters:</B><DD><CODE>value</CODE> - the constant value for the
function to return
+<DT><B>Returns:</B><DD>a function that always returns
<code>value</code></DL>
</DD>
</DL>
<!-- ========= END OF CLASS DATA ========= -->
Modified: trunk/javadoc/com/google/common/base/Join.JoinException.html
==============================================================================
--- trunk/javadoc/com/google/common/base/Join.JoinException.html (original)
+++ trunk/javadoc/com/google/common/base/Join.JoinException.html Mon Aug 18
16:46:26 2008
@@ -2,19 +2,21 @@
<!--NewPage-->
<HTML>
<HEAD>
-<!-- Generated by javadoc (build 1.5.0_06) on Fri May 30 13:31:20 PDT 2008
-->
+<!-- Generated by javadoc (build 1.6.0_01) on Mon Aug 18 15:24:21
GMT-08:00 2008 -->
<TITLE>
-Join.JoinException (Google Collections Library - snapshot-20080530 (ALPHA))
+Join.JoinException (Google Collections Library - snapshot-20080818 (ALPHA))
</TITLE>
-<META NAME="keywords" CONTENT="com.google.common.base.Join.JoinException
class">
+<META NAME="date" CONTENT="2008-08-18">
<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css"
TITLE="Style">
<SCRIPT type="text/javascript">
function windowTitle()
{
- parent.document.title="Join.JoinException (Google Collections Library
- snapshot-20080530 (ALPHA))";
+ if (location.href.indexOf('is-external=true') == -1) {
+ parent.document.title="Join.JoinException (Google Collections
Library - snapshot-20080818 (ALPHA))";
+ }
}
</SCRIPT>
<NOSCRIPT>
@@ -23,6 +25,7 @@
</HEAD>
<BODY BGCOLOR="white" onload="windowTitle();">
+<HR>
<!-- ========= START OF TOP NAVBAR ======= -->
@@ -88,26 +91,26 @@
<BR>
Class Join.JoinException</H2>
<PRE>
-<A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">java.lang.Object</A>
- <IMG SRC="../../../../resources/inherit.gif" ALT="extended by "><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Throwable.html"
title="class or interface in java.lang">java.lang.Throwable</A>
- <IMG SRC="../../../../resources/inherit.gif" ALT="extended by "><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Exception.html"
title="class or interface in java.lang">java.lang.Exception</A>
- <IMG SRC="../../../../resources/inherit.gif" ALT="extended
by "><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/RuntimeException.html"
title="class or interface in java.lang">java.lang.RuntimeException</A>
+<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">java.lang.Object</A>
+ <IMG SRC="../../../../resources/inherit.gif" ALT="extended by "><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Throwable.html?is-external=true"
title="class or interface in java.lang">java.lang.Throwable</A>
+ <IMG SRC="../../../../resources/inherit.gif" ALT="extended by "><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Exception.html?is-external=true"
title="class or interface in java.lang">java.lang.Exception</A>
+ <IMG SRC="../../../../resources/inherit.gif" ALT="extended
by "><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/RuntimeException.html?is-external=true"
title="class or interface in java.lang">java.lang.RuntimeException</A>
<IMG SRC="../../../../resources/inherit.gif" ALT="extended
by "><B>com.google.common.base.Join.JoinException</B>
</PRE>
<DL>
-<DT><B>All Implemented Interfaces:</B> <DD><A
HREF="http://java.sun.com/javase/6/docs/api/java/io/Serializable.html"
title="class or interface in java.io">Serializable</A></DD>
+<DT><B>All Implemented Interfaces:</B> <DD><A
HREF="http://java.sun.com/javase/6/docs/api/java/io/Serializable.html?is-external=true"
title="class or interface in java.io">Serializable</A></DD>
</DL>
<DL>
<DT><B>Enclosing class:</B><DD><A
HREF="../../../../com/google/common/base/Join.html" title="class in
com.google.common.base">Join</A></DD>
</DL>
<HR>
<DL>
-<DT><PRE>public static class <B>Join.JoinException</B><DT>extends <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/RuntimeException.html"
title="class or interface in java.lang">RuntimeException</A></DL>
+<DT><PRE>public static class <B>Join.JoinException</B><DT>extends <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/RuntimeException.html?is-external=true"
title="class or interface in java.lang">RuntimeException</A></DL>
</PRE>
<P>
-Thrown in response to an <A
HREF="http://java.sun.com/javase/6/docs/api/java/io/IOException.html"
title="class or interface in java.io"><CODE>IOException</CODE></A> from the
supplied
- <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Appendable.html"
title="class or interface in java.lang"><CODE>Appendable</CODE></A>. This
is used because most callers won't want to
+Exception thrown in response to an <A
HREF="http://java.sun.com/javase/6/docs/api/java/io/IOException.html?is-external=true"
title="class or interface in java.io"><CODE>IOException</CODE></A> from the
supplied
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Appendable.html?is-external=true"
title="class or interface in java.lang"><CODE>Appendable</CODE></A>. This
is used because most callers won't want to
worry about catching an IOException.
<P>
@@ -130,19 +133,19 @@
<A NAME="methods_inherited_from_class_java.lang.Throwable"><!--
--></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
-<TH ALIGN="left"><B>Methods inherited from class java.lang.<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Throwable.html"
title="class or interface in java.lang">Throwable</A></B></TH>
+<TH ALIGN="left"><B>Methods inherited from class java.lang.<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Throwable.html?is-external=true"
title="class or interface in java.lang">Throwable</A></B></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD><CODE><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Throwable.html#fillInStackTrace()"
title="class or interface in java.lang">fillInStackTrace</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Throwable.html#getCause()"
title="class or interface in java.lang">getCause</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Throwable.html#getLocalizedMessage()"
title="class or interface in java.lang">getLocalizedMessage</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Throwable.html#getMessage()"
title="class or interface in java.lang">getMessage</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Throwable.html#getStackTrace()"
title="class or interface in java.lang">getStackTrace</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Throwable.html#initCause(java.lang.Throwable)"
title="class or interface in java.lang">initCause</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Throwable.html#printStackTrace()"
title="class or interface in java.lang">printStackTrace</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Throwable.html#printStackTrace(java.io.PrintStream)"
title="class or interface in java.lang">printStackTrace</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Throwable.html#printStackTrace(java.io.PrintWriter)"
title="class or interface in java.lang">printStackTrace</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Throwable.html#setStackTrace(java.lang.StackTraceElement[])"
title="class or interface in java.lang">setStackTrace</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Throwable.html#toString()"
title="class or interface in java.lang">toString</A></CODE></TD>
+<TD><CODE><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Throwable.html?is-external=true#fillInStackTrace()"
title="class or interface in java.lang">fillInStackTrace</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Throwable.html?is-external=true#getCause()"
title="class or interface in java.lang">getCause</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Throwable.html?is-external=true#getLocalizedMessage()"
title="class or interface in java.lang">getLocalizedMessage</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Throwable.html?is-external=true#getMessage()"
title="class or interface in java.lang">getMessage</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Throwable.html?is-external=true#getStackTrace()"
title="class or interface in java.lang">getStackTrace</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Throwable.html?is-external=true#initCause(java.lang.Throwable)"
title="class or interface in java.lang">initCause</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Throwable.html?is-external=true#printStackTrace()"
title="class or interface in java.lang">printStackTrace</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Throwable.html?is-external=true#printStackTrace(java.io.PrintStream)"
title="class or interface in java.lang">printStackTrace</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Throwable.html?is-external=true#printStackTrace(java.io.PrintWriter)"
title="class or interface in java.lang">printStackTrace</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Throwable.html?is-external=true#setStackTrace(java.lang.StackTraceElement[])"
title="class or interface in java.lang">setStackTrace</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Throwable.html?is-external=true#toString()"
title="class or interface in java.lang">toString</A></CODE></TD>
</TR>
</TABLE>
<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
-<TH ALIGN="left"><B>Methods inherited from class java.lang.<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A></B></TH>
+<TH ALIGN="left"><B>Methods inherited from class java.lang.<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">Object</A></B></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD><CODE><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#clone()"
title="class or interface in java.lang">clone</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#equals(java.lang.Object)"
title="class or interface in java.lang">equals</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#finalize()"
title="class or interface in java.lang">finalize</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#getClass()"
title="class or interface in java.lang">getClass</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#hashCode()"
title="class or interface in java.lang">hashCode</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#notify()"
title="class or interface in java.lang">notify</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#notifyAll()"
title="class or interface in java.lang">notifyAll</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#wait()"
title="class or interface in java.lang">wait</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#wait(long)"
title="class or interface in java.lang">wait</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#wait(long,
int)" title="class or interface in java.lang">wait</A></CODE></TD>
+<TD><CODE><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#clone()"
title="class or interface in java.lang">clone</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#equals(java.lang.Object)"
title="class or interface in java.lang">equals</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#finalize()"
title="class or interface in java.lang">finalize</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#getClass()"
title="class or interface in java.lang">getClass</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#hashCode()"
title="class or interface in java.lang">hashCode</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#notify()"
title="class or interface in java.lang">notify</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#notifyAll()"
title="class or interface in java.lang">notifyAll</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait()"
title="class or interface in java.lang">wait</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait(long)"
title="class or interface in java.lang">wait</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait(long,
int)" title="class or interface in java.lang">wait</A></CODE></TD>
</TR>
</TABLE>
Modified: trunk/javadoc/com/google/common/base/Join.html
==============================================================================
--- trunk/javadoc/com/google/common/base/Join.html (original)
+++ trunk/javadoc/com/google/common/base/Join.html Mon Aug 18 16:46:26 2008
@@ -2,19 +2,21 @@
<!--NewPage-->
<HTML>
<HEAD>
-<!-- Generated by javadoc (build 1.5.0_06) on Fri May 30 13:31:20 PDT 2008
-->
+<!-- Generated by javadoc (build 1.6.0_01) on Mon Aug 18 15:24:21
GMT-08:00 2008 -->
<TITLE>
-Join (Google Collections Library - snapshot-20080530 (ALPHA))
+Join (Google Collections Library - snapshot-20080818 (ALPHA))
</TITLE>
-<META NAME="keywords" CONTENT="com.google.common.base.Join class">
+<META NAME="date" CONTENT="2008-08-18">
<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css"
TITLE="Style">
<SCRIPT type="text/javascript">
function windowTitle()
{
- parent.document.title="Join (Google Collections Library -
snapshot-20080530 (ALPHA))";
+ if (location.href.indexOf('is-external=true') == -1) {
+ parent.document.title="Join (Google Collections Library -
snapshot-20080818 (ALPHA))";
+ }
}
</SCRIPT>
<NOSCRIPT>
@@ -23,6 +25,7 @@
</HEAD>
<BODY BGCOLOR="white" onload="windowTitle();">
+<HR>
<!-- ========= START OF TOP NAVBAR ======= -->
@@ -88,28 +91,24 @@
<BR>
Class Join</H2>
<PRE>
-<A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">java.lang.Object</A>
+<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">java.lang.Object</A>
<IMG SRC="../../../../resources/inherit.gif" ALT="extended
by "><B>com.google.common.base.Join</B>
</PRE>
<HR>
<DL>
-<DT><PRE>public final class <B>Join</B><DT>extends <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A></DL>
+<DT><PRE>public final class <B>Join</B><DT>extends <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">Object</A></DL>
</PRE>
<P>
-Join is the only utility for joining pieces of text separated by a
- delimiter that you will ever need. It can handle Iterators, Collections,
- arrays, and varargs, and can append to any Appendable or just return a
- String.
- <p>
- A trivial example: <code>join(":", "a", "b", "c")</code>
- gives <code>"a:b:c"</code>. See JoinTest for more examples.
- <p>
- All the methods of this class throw <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/NullPointerException.html"
title="class or interface in
java.lang"><CODE>NullPointerException</CODE></A> when a
- value of <code>null</code> is supplied for any parameter. The elements
within
- the collection, iterator, array, or varargs parameter list <i>may</i> be
- null -- these will be represented in the output with the string
- <code>"null"</code>.
+Utility for joining pieces of text separated by a delimiter. It can handle
+ iterators, collections, arrays, and varargs, and can append to any
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Appendable.html?is-external=true"
title="class or interface in java.lang"><CODE>Appendable</CODE></A> or just
return a <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in java.lang"><CODE>String</CODE></A>. For
example,
+ <code>join(":", "a", "b", "c")</code> returns <code>"a:b:c"</code>.
+
+ <p>All methods of this class throw <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/NullPointerException.html?is-external=true"
title="class or interface in
java.lang"><CODE>NullPointerException</CODE></A> when a value
+ of <code>null</code> is supplied for any parameter. The elements within
the
+ collection, iterator, array, or varargs parameter list <i>may</i> be null
--
+ these will be represented in the output by the string <code>"null"</code>.
<P>
<P>
@@ -134,8 +133,8 @@
<TD><CODE><B><A
HREF="../../../../com/google/common/base/Join.JoinException.html"
title="class in com.google.common.base">Join.JoinException</A></B></CODE>
<BR>
- Thrown in
response to an <A
HREF="http://java.sun.com/javase/6/docs/api/java/io/IOException.html"
title="class or interface in java.io"><CODE>IOException</CODE></A> from the
supplied
- <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Appendable.html"
title="class or interface in java.lang"><CODE>Appendable</CODE></A>.</TD>
+ Exception
thrown in response to an <A
HREF="http://java.sun.com/javase/6/docs/api/java/io/IOException.html?is-external=true"
title="class or interface in java.io"><CODE>IOException</CODE></A> from the
supplied
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Appendable.html?is-external=true"
title="class or interface in java.lang"><CODE>Appendable</CODE></A>.</TD>
</TR>
</TABLE>
@@ -149,43 +148,56 @@
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE>static <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html"
title="class or interface in java.lang">String</A></CODE></FONT></TD>
-<TD><CODE><B><A
HREF="../../../../com/google/common/base/Join.html#join(java.lang.String,
java.lang.Iterable)">join</A></B>(<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html"
title="class or interface in java.lang">String</A> delimiter,
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Iterable.html"
title="class or interface in
java.lang">Iterable</A><?> tokens)</CODE>
+<CODE>static <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in java.lang">String</A></CODE></FONT></TD>
+<TD><CODE><B><A
HREF="../../../../com/google/common/base/Join.html#join(java.lang.String,
java.lang.Iterable)">join</A></B>(<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in java.lang">String</A> delimiter,
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true"
title="class or interface in
java.lang">Iterable</A><?> tokens)</CODE>
<BR>
- Returns a
String containing the <code>tokens</code>, converted to Strings if
+ Returns a
string containing the <code>tokens</code>, converted to strings if
necessary, separated by <code>delimiter</code>.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE>static <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html"
title="class or interface in java.lang">String</A></CODE></FONT></TD>
-<TD><CODE><B><A
HREF="../../../../com/google/common/base/Join.html#join(java.lang.String,
java.util.Iterator)">join</A></B>(<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html"
title="class or interface in java.lang">String</A> delimiter,
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/util/Iterator.html"
title="class or interface in
java.util">Iterator</A><?> tokens)</CODE>
+<CODE>static <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in java.lang">String</A></CODE></FONT></TD>
+<TD><CODE><B><A
HREF="../../../../com/google/common/base/Join.html#join(java.lang.String,
java.util.Iterator)">join</A></B>(<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in java.lang">String</A> delimiter,
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/util/Iterator.html?is-external=true"
title="class or interface in
java.util">Iterator</A><?> tokens)</CODE>
<BR>
- Variant of <A
HREF="../../../../com/google/common/base/Join.html#join(java.lang.String,
java.lang.Iterable)"><CODE>join(String,Iterable)</CODE></A> where
<code>tokens</code> is an
- <code>Iterator</code>.</TD>
+ Returns a
string containing the <code>tokens</code>, converted to strings if
+ necessary, separated by <code>delimiter</code>.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE>static <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html"
title="class or interface in java.lang">String</A></CODE></FONT></TD>
-<TD><CODE><B><A
HREF="../../../../com/google/common/base/Join.html#join(java.lang.String,
java.lang.Object[])">join</A></B>(<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html"
title="class or interface in java.lang">String</A> delimiter,
- <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A>[] tokens)</CODE>
+<CODE>static <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in java.lang">String</A></CODE></FONT></TD>
+<TD><CODE><B><A
HREF="../../../../com/google/common/base/Join.html#join(java.lang.String,
java.lang.Object[])">join</A></B>(<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in java.lang">String</A> delimiter,
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">Object</A>[] tokens)</CODE>
<BR>
- Variant of <A
HREF="../../../../com/google/common/base/Join.html#join(java.lang.String,
java.lang.Iterable)"><CODE>join(String,Iterable)</CODE></A> where
<code>tokens</code> is an
- array.</TD>
+ Returns a
string containing the <code>tokens</code>, converted to strings if
+ necessary, separated by <code>delimiter</code>.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE>static <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html"
title="class or interface in java.lang">String</A></CODE></FONT></TD>
-<TD><CODE><B><A
HREF="../../../../com/google/common/base/Join.html#join(java.lang.String,
java.lang.Object, java.lang.Object...)">join</A></B>(<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html"
title="class or interface in java.lang">String</A> delimiter,
- <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A> firstToken,
- <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in
java.lang">Object</A>... otherTokens)</CODE>
+<CODE>static <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in java.lang">String</A></CODE></FONT></TD>
+<TD><CODE><B><A
HREF="../../../../com/google/common/base/Join.html#join(java.lang.String,
java.lang.Object, java.lang.Object...)">join</A></B>(<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in java.lang">String</A> delimiter,
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">Object</A> firstToken,
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in
java.lang">Object</A>... otherTokens)</CODE>
<BR>
- Variant of <A
HREF="../../../../com/google/common/base/Join.html#join(java.lang.String,
java.lang.Iterable)"><CODE>join(String,Iterable)</CODE></A> for tokens
given using varargs.</TD>
+ Returns a
string containing the <code>tokens</code>, converted to strings if
+ necessary, separated by <code>delimiter</code>.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in java.lang">String</A></CODE></FONT></TD>
+<TD><CODE><B><A
HREF="../../../../com/google/common/base/Join.html#join(java.lang.String,
java.lang.String, java.util.Map)">join</A></B>(<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in java.lang">String</A> keyValueSeparator,
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in java.lang">String</A> entryDelimiter,
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/util/Map.html?is-external=true"
title="class or interface in java.util">Map</A><?,?> map)</CODE>
+
+<BR>
+ Returns a
string containing the contents of <code>map</code>, with entries
+ separated by <code>entryDelimiter</code>, and keys and values separated
with
+ <code>keyValueSeparator</code>.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
@@ -193,19 +205,19 @@
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="0" SUMMARY="">
<TR ALIGN="right" VALIGN="">
<TD NOWRAP><FONT SIZE="-1">
-<CODE><T extends <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Appendable.html"
title="class or interface in java.lang">Appendable</A>>
+<CODE><T extends <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Appendable.html?is-external=true"
title="class or interface in java.lang">Appendable</A>>
<BR>
T</CODE></FONT></TD>
</TR>
</TABLE>
</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../com/google/common/base/Join.html#join(T,
java.lang.String, java.lang.Iterable)">join</A></B>(T appendable,
- <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html"
title="class or interface in java.lang">String</A> delimiter,
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Iterable.html"
title="class or interface in
java.lang">Iterable</A><?> tokens)</CODE>
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in java.lang">String</A> delimiter,
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true"
title="class or interface in
java.lang">Iterable</A><?> tokens)</CODE>
<BR>
- Variant of <A
HREF="../../../../com/google/common/base/Join.html#join(T,
java.lang.String,
java.util.Iterator)"><CODE>join(Appendable,String,Iterator)</CODE></A>
where <code>tokens</code>
- is an <code>Iterable</code>.</TD>
+ Appends each
of the <code>tokens</code> to <code>appendable</code>, separated by
+ <code>delimiter</code>.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
@@ -213,15 +225,15 @@
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="0" SUMMARY="">
<TR ALIGN="right" VALIGN="">
<TD NOWRAP><FONT SIZE="-1">
-<CODE><T extends <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Appendable.html"
title="class or interface in java.lang">Appendable</A>>
+<CODE><T extends <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Appendable.html?is-external=true"
title="class or interface in java.lang">Appendable</A>>
<BR>
T</CODE></FONT></TD>
</TR>
</TABLE>
</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../com/google/common/base/Join.html#join(T,
java.lang.String, java.util.Iterator)">join</A></B>(T appendable,
- <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html"
title="class or interface in java.lang">String</A> delimiter,
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/util/Iterator.html"
title="class or interface in
java.util">Iterator</A><?> tokens)</CODE>
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in java.lang">String</A> delimiter,
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/util/Iterator.html?is-external=true"
title="class or interface in
java.util">Iterator</A><?> tokens)</CODE>
<BR>
Appends each
of the <code>tokens</code> to <code>appendable</code>, separated by
@@ -233,19 +245,19 @@
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="0" SUMMARY="">
<TR ALIGN="right" VALIGN="">
<TD NOWRAP><FONT SIZE="-1">
-<CODE><T extends <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Appendable.html"
title="class or interface in java.lang">Appendable</A>>
+<CODE><T extends <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Appendable.html?is-external=true"
title="class or interface in java.lang">Appendable</A>>
<BR>
T</CODE></FONT></TD>
</TR>
</TABLE>
</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../com/google/common/base/Join.html#join(T,
java.lang.String, java.lang.Object[])">join</A></B>(T appendable,
- <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html"
title="class or interface in java.lang">String</A> delimiter,
- <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A>[] tokens)</CODE>
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in java.lang">String</A> delimiter,
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">Object</A>[] tokens)</CODE>
<BR>
- Variant of <A
HREF="../../../../com/google/common/base/Join.html#join(T,
java.lang.String,
java.util.Iterator)"><CODE>join(Appendable,String,Iterator)</CODE></A>
where <code>tokens</code>
- is an array.</TD>
+ Appends each
of the <code>tokens</code> to <code>appendable</code>, separated by
+ <code>delimiter</code>.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
@@ -253,29 +265,51 @@
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="0" SUMMARY="">
<TR ALIGN="right" VALIGN="">
<TD NOWRAP><FONT SIZE="-1">
-<CODE><T extends <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Appendable.html"
title="class or interface in java.lang">Appendable</A>>
+<CODE><T extends <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Appendable.html?is-external=true"
title="class or interface in java.lang">Appendable</A>>
<BR>
T</CODE></FONT></TD>
</TR>
</TABLE>
</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../com/google/common/base/Join.html#join(T,
java.lang.String, java.lang.Object,
java.lang.Object...)">join</A></B>(T appendable,
- <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html"
title="class or interface in java.lang">String</A> delimiter,
- <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A> firstToken,
- <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in
java.lang">Object</A>... otherTokens)</CODE>
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in java.lang">String</A> delimiter,
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">Object</A> firstToken,
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in
java.lang">Object</A>... otherTokens)</CODE>
<BR>
- Variant of <A
HREF="../../../../com/google/common/base/Join.html#join(T,
java.lang.String,
java.util.Iterator)"><CODE>join(Appendable,String,Iterator)</CODE></A> for
tokens given using
- varargs.</TD>
+ Appends each
of the <code>tokens</code> to <code>appendable</code>, separated by
+ <code>delimiter</code>.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="0" SUMMARY="">
+<TR ALIGN="right" VALIGN="">
+<TD NOWRAP><FONT SIZE="-1">
+<CODE><T extends <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Appendable.html?is-external=true"
title="class or interface in java.lang">Appendable</A>>
+<BR>
+T</CODE></FONT></TD>
+</TR>
+</TABLE>
+</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../com/google/common/base/Join.html#join(T,
java.lang.String, java.lang.String,
java.util.Map)">join</A></B>(T appendable,
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in java.lang">String</A> keyValueSeparator,
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in java.lang">String</A> entryDelimiter,
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/util/Map.html?is-external=true"
title="class or interface in java.util">Map</A><?,?> map)</CODE>
+
+<BR>
+ Appends the
contents of <code>map</code> to <code>appendable</code>, with entries
+ separated by <code>entryDelimiter</code>, and keys and values separated
with
+ <code>keyValueSeparator</code>.</TD>
</TR>
</TABLE>
<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
-<TH ALIGN="left"><B>Methods inherited from class java.lang.<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A></B></TH>
+<TH ALIGN="left"><B>Methods inherited from class java.lang.<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">Object</A></B></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD><CODE><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#clone()"
title="class or interface in java.lang">clone</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#equals(java.lang.Object)"
title="class or interface in java.lang">equals</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#finalize()"
title="class or interface in java.lang">finalize</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#getClass()"
title="class or interface in java.lang">getClass</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#hashCode()"
title="class or interface in java.lang">hashCode</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#notify()"
title="class or interface in java.lang">notify</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#notifyAll()"
title="class or interface in java.lang">notifyAll</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#toString()"
title="class or interface in java.lang">toString</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#wait()"
title="class or interface in java.lang">wait</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#wait(long)"
title="class or interface in java.lang">wait</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#wait(long,
int)" title="class or interface in java.lang">wait</A></CODE></TD>
+<TD><CODE><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#clone()"
title="class or interface in java.lang">clone</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#equals(java.lang.Object)"
title="class or interface in java.lang">equals</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#finalize()"
title="class or interface in java.lang">finalize</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#getClass()"
title="class or interface in java.lang">getClass</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#hashCode()"
title="class or interface in java.lang">hashCode</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#notify()"
title="class or interface in java.lang">notify</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#notifyAll()"
title="class or interface in java.lang">notifyAll</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#toString()"
title="class or interface in java.lang">toString</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait()"
title="class or interface in java.lang">wait</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait(long)"
title="class or interface in java.lang">wait</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait(long,
int)" title="class or interface in java.lang">wait</A></CODE></TD>
</TR>
</TABLE>
@@ -291,139 +325,249 @@
</TR>
</TABLE>
-<A
NAME="join(java.lang.Appendable,java.lang.String,java.util.Iterator)"><!--
--></A><A NAME="join(T, java.lang.String, java.util.Iterator)"><!--
--></A><H3>
+<A NAME="join(java.lang.String, java.lang.Iterable)"><!-- --></A><H3>
join</H3>
<PRE>
-public static <T extends <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Appendable.html"
title="class or interface in java.lang">Appendable</A>> T
<B>join</B>(T appendable,
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html"
title="class or interface in java.lang">String</A> delimiter,
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/util/Iterator.html"
title="class or interface in
java.util">Iterator</A><?> tokens)</PRE>
+public static <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in java.lang">String</A> <B>join</B>(<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in java.lang">String</A> delimiter,
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true"
title="class or interface in
java.lang">Iterable</A><?> tokens)</PRE>
<DL>
-<DD>Appends each of the <code>tokens</code> to <code>appendable</code>,
separated by
- <code>delimiter</code>.
+<DD>Returns a string containing the <code>tokens</code>, converted to
strings if
+ necessary, separated by <code>delimiter</code>. If <code>tokens</code> is
empty, it
+ returns an empty string.
+
+ <p>Each token will be converted to a <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/CharSequence.html?is-external=true"
title="class or interface in java.lang"><CODE>CharSequence</CODE></A> using
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true#valueOf(java.lang.Object)"
title="class or interface in
java.lang"><CODE>String.valueOf(Object)</CODE></A>, if it isn't a <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/CharSequence.html?is-external=true"
title="class or interface in java.lang"><CODE>CharSequence</CODE></A>
already.
+ Note that this implies that null tokens will be appended as the
+ four-character string <code>"null"</code>.
<P>
<DD><DL>
-<DT><B>Parameters:</B><DD><CODE>appendable</CODE> - the non-null object to
append the results to<DD><CODE>delimiter</CODE> - a non-null String to
append between every element, but not
- at the beginning or end<DD><CODE>tokens</CODE> - Objects of any
type. For each element, if it is an instance
- of <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/CharSequence.html"
title="class or interface in java.lang"><CODE>CharSequence</CODE></A> it
will be appended as-is, otherwise it
- will be converted to a <code>CharSequence</code> using
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html#valueOf(java.lang.Object)"
title="class or interface in
java.lang"><CODE>String.valueOf(Object)</CODE></A>. Note that this implies
that null
- tokens will be appended as the four-character string
- <code>"null"</code>.
-<DT><B>Returns:</B><DD>The same appendable instance that was passed in
-<DT><B>Throws:</B>
-<DD><CODE><A
HREF="../../../../com/google/common/base/Join.JoinException.html"
title="class in com.google.common.base">Join.JoinException</A></CODE> - if
an IOException occurs</DL>
+<DT><B>Parameters:</B><DD><CODE>delimiter</CODE> - a string to append
between every element, but not at the
+ beginning or end<DD><CODE>tokens</CODE> - objects to append
+<DT><B>Returns:</B><DD>a string consisting of the joined elements</DL>
</DD>
</DL>
<HR>
-<A NAME="join(java.lang.String, java.lang.Iterable)"><!-- --></A><H3>
+<A NAME="join(java.lang.String, java.lang.Object[])"><!-- --></A><H3>
join</H3>
<PRE>
-public static <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html"
title="class or interface in java.lang">String</A> <B>join</B>(<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html"
title="class or interface in java.lang">String</A> delimiter,
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Iterable.html"
title="class or interface in
java.lang">Iterable</A><?> tokens)</PRE>
+public static <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in java.lang">String</A> <B>join</B>(<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in java.lang">String</A> delimiter,
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">Object</A>[] tokens)</PRE>
<DL>
-<DD>Returns a String containing the <code>tokens</code>, converted to
Strings if
- necessary, separated by <code>delimiter</code>. If <code>tokens</code>
is empty,
- returns the empty string.
+<DD>Returns a string containing the <code>tokens</code>, converted to
strings if
+ necessary, separated by <code>delimiter</code>. If <code>tokens</code> is
empty, it
+ returns an empty string.
+
+ <p>Each token will be converted to a <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/CharSequence.html?is-external=true"
title="class or interface in java.lang"><CODE>CharSequence</CODE></A> using
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true#valueOf(java.lang.Object)"
title="class or interface in
java.lang"><CODE>String.valueOf(Object)</CODE></A>, if it isn't a <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/CharSequence.html?is-external=true"
title="class or interface in java.lang"><CODE>CharSequence</CODE></A>
already.
+ Note that this implies that null tokens will be appended as the
+ four-character string <code>"null"</code>.
<P>
<DD><DL>
-</DL>
+<DT><B>Parameters:</B><DD><CODE>delimiter</CODE> - a string to append
between every element, but not at the
+ beginning or end<DD><CODE>tokens</CODE> - objects to append
+<DT><B>Returns:</B><DD>a string consisting of the joined elements</DL>
</DD>
</DL>
<HR>
-<A
NAME="join(java.lang.Appendable,java.lang.String,java.lang.Iterable)"><!--
--></A><A NAME="join(T, java.lang.String, java.lang.Iterable)"><!--
--></A><H3>
+<A NAME="join(java.lang.String, java.lang.Object,
java.lang.Object...)"><!-- --></A><H3>
join</H3>
<PRE>
-public static <T extends <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Appendable.html"
title="class or interface in java.lang">Appendable</A>> T
<B>join</B>(T appendable,
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html"
title="class or interface in java.lang">String</A> delimiter,
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Iterable.html"
title="class or interface in
java.lang">Iterable</A><?> tokens)</PRE>
+public static <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in java.lang">String</A> <B>join</B>(<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in java.lang">String</A> delimiter,
+ <FONT SIZE="-1"><A
HREF="../../../../com/google/common/base/Nullable.html" title="annotation
in com.google.common.base">@Nullable</A></FONT>
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">Object</A> firstToken,
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in
java.lang">Object</A>... otherTokens)</PRE>
<DL>
-<DD>Variant of <A
HREF="../../../../com/google/common/base/Join.html#join(T,
java.lang.String,
java.util.Iterator)"><CODE>join(Appendable,String,Iterator)</CODE></A>
where <code>tokens</code>
- is an <code>Iterable</code>.
+<DD>Returns a string containing the <code>tokens</code>, converted to
strings if
+ necessary, separated by <code>delimiter</code>.
+
+ <p>Each token will be converted to a <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/CharSequence.html?is-external=true"
title="class or interface in java.lang"><CODE>CharSequence</CODE></A> using
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true#valueOf(java.lang.Object)"
title="class or interface in
java.lang"><CODE>String.valueOf(Object)</CODE></A>, if it isn't a <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/CharSequence.html?is-external=true"
title="class or interface in java.lang"><CODE>CharSequence</CODE></A>
already.
+ Note that this implies that null tokens will be appended as the
+ four-character string <code>"null"</code>.
<P>
<DD><DL>
-</DL>
+<DT><B>Parameters:</B><DD><CODE>delimiter</CODE> - a string to append
between every element, but not at the
+ beginning or end<DD><CODE>firstToken</CODE> - the first object to
append<DD><CODE>otherTokens</CODE> - subsequent objects to append
+<DT><B>Returns:</B><DD>a string consisting of the joined elements</DL>
</DD>
</DL>
<HR>
-<A
NAME="join(java.lang.Appendable,java.lang.String,java.lang.Object)"><!--
--></A><A NAME="join(T, java.lang.String, java.lang.Object[])"><!--
--></A><H3>
+<A NAME="join(java.lang.String, java.util.Iterator)"><!-- --></A><H3>
join</H3>
<PRE>
-public static <T extends <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Appendable.html"
title="class or interface in java.lang">Appendable</A>> T
<B>join</B>(T appendable,
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html"
title="class or interface in java.lang">String</A> delimiter,
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A>[] tokens)</PRE>
+public static <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in java.lang">String</A> <B>join</B>(<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in java.lang">String</A> delimiter,
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/util/Iterator.html?is-external=true"
title="class or interface in
java.util">Iterator</A><?> tokens)</PRE>
<DL>
-<DD>Variant of <A
HREF="../../../../com/google/common/base/Join.html#join(T,
java.lang.String,
java.util.Iterator)"><CODE>join(Appendable,String,Iterator)</CODE></A>
where <code>tokens</code>
- is an array.
+<DD>Returns a string containing the <code>tokens</code>, converted to
strings if
+ necessary, separated by <code>delimiter</code>. If <code>tokens</code> is
empty, it
+ returns an empty string.
+
+ <p>Each token will be converted to a <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/CharSequence.html?is-external=true"
title="class or interface in java.lang"><CODE>CharSequence</CODE></A> using
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true#valueOf(java.lang.Object)"
title="class or interface in
java.lang"><CODE>String.valueOf(Object)</CODE></A>, if it isn't a <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/CharSequence.html?is-external=true"
title="class or interface in java.lang"><CODE>CharSequence</CODE></A>
already.
+ Note that this implies that null tokens will be appended as the
+ four-character string <code>"null"</code>.
<P>
<DD><DL>
-</DL>
+<DT><B>Parameters:</B><DD><CODE>delimiter</CODE> - a string to append
between every element, but not at the
+ beginning or end<DD><CODE>tokens</CODE> - objects to append
+<DT><B>Returns:</B><DD>a string consisting of the joined elements</DL>
</DD>
</DL>
<HR>
-<A
NAME="join(java.lang.Appendable,java.lang.String,java.lang.Object,java.lang.Object)"><!--
--></A><A NAME="join(T, java.lang.String, java.lang.Object,
java.lang.Object...)"><!-- --></A><H3>
+<A NAME="join(java.lang.String, java.lang.String, java.util.Map)"><!--
--></A><H3>
join</H3>
<PRE>
-public static <T extends <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Appendable.html"
title="class or interface in java.lang">Appendable</A>> T
<B>join</B>(T appendable,
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html"
title="class or interface in java.lang">String</A> delimiter,
- <FONT SIZE="-1"><A
HREF="../../../../com/google/common/base/Nullable.html" title="annotation
in com.google.common.base">@Nullable</A></FONT>
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A> firstToken,
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in
java.lang">Object</A>... otherTokens)</PRE>
+public static <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in java.lang">String</A> <B>join</B>(<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in java.lang">String</A> keyValueSeparator,
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in java.lang">String</A> entryDelimiter,
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/util/Map.html?is-external=true"
title="class or interface in java.util">Map</A><?,?> map)</PRE>
<DL>
-<DD>Variant of <A
HREF="../../../../com/google/common/base/Join.html#join(T,
java.lang.String,
java.util.Iterator)"><CODE>join(Appendable,String,Iterator)</CODE></A> for
tokens given using
- varargs.
+<DD>Returns a string containing the contents of <code>map</code>, with
entries
+ separated by <code>entryDelimiter</code>, and keys and values separated
with
+ <code>keyValueSeparator</code>.
+
+ <p>Each key and value will be converted to a <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/CharSequence.html?is-external=true"
title="class or interface in java.lang"><CODE>CharSequence</CODE></A> using
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true#valueOf(java.lang.Object)"
title="class or interface in
java.lang"><CODE>String.valueOf(Object)</CODE></A>, if it isn't a <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/CharSequence.html?is-external=true"
title="class or interface in java.lang"><CODE>CharSequence</CODE></A>
already.
+ Note that this implies that null tokens will be appended as the
+ four-character string <code>"null"</code>.
<P>
<DD><DL>
-</DL>
+<DT><B>Parameters:</B><DD><CODE>keyValueSeparator</CODE> - a string to
append between every key and its
+ associated value<DD><CODE>entryDelimiter</CODE> - a string to append
between every entry, but not at
+ the beginning or end<DD><CODE>map</CODE> - the map containing the
data to join
+<DT><B>Returns:</B><DD>a string consisting of the joined entries of the
map; empty if the
+ map is empty</DL>
</DD>
</DL>
<HR>
-<A NAME="join(java.lang.String, java.util.Iterator)"><!-- --></A><H3>
+<A
NAME="join(java.lang.Appendable,java.lang.String,java.lang.Iterable)"><!--
--></A><A NAME="join(T, java.lang.String, java.lang.Iterable)"><!--
--></A><H3>
join</H3>
<PRE>
-public static <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html"
title="class or interface in java.lang">String</A> <B>join</B>(<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html"
title="class or interface in java.lang">String</A> delimiter,
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/util/Iterator.html"
title="class or interface in
java.util">Iterator</A><?> tokens)</PRE>
+public static <T extends <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Appendable.html?is-external=true"
title="class or interface in java.lang">Appendable</A>> T
<B>join</B>(T appendable,
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in java.lang">String</A> delimiter,
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true"
title="class or interface in
java.lang">Iterable</A><?> tokens)</PRE>
<DL>
-<DD>Variant of <A
HREF="../../../../com/google/common/base/Join.html#join(java.lang.String,
java.lang.Iterable)"><CODE>join(String,Iterable)</CODE></A> where
<code>tokens</code> is an
- <code>Iterator</code>.
+<DD>Appends each of the <code>tokens</code> to <code>appendable</code>,
separated by
+ <code>delimiter</code>.
+
+ <p>Each token will be converted to a <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/CharSequence.html?is-external=true"
title="class or interface in java.lang"><CODE>CharSequence</CODE></A> using
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true#valueOf(java.lang.Object)"
title="class or interface in
java.lang"><CODE>String.valueOf(Object)</CODE></A>, if it isn't a <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/CharSequence.html?is-external=true"
title="class or interface in java.lang"><CODE>CharSequence</CODE></A>
already.
+ Note that this implies that null tokens will be appended as the
+ four-character string <code>"null"</code>.
<P>
<DD><DL>
-</DL>
+<DT><B>Parameters:</B><DD><CODE>appendable</CODE> - the object to append
the results to<DD><CODE>delimiter</CODE> - a string to append between every
element, but not at the
+ beginning or end<DD><CODE>tokens</CODE> - objects to append
+<DT><B>Returns:</B><DD>the same <code>Appendable</code> instance that was
passed in
+<DT><B>Throws:</B>
+<DD><CODE><A
HREF="../../../../com/google/common/base/Join.JoinException.html"
title="class in com.google.common.base">Join.JoinException</A></CODE> - if
an <A
HREF="http://java.sun.com/javase/6/docs/api/java/io/IOException.html?is-external=true"
title="class or interface in java.io"><CODE>IOException</CODE></A>
occurs</DL>
</DD>
</DL>
<HR>
-<A NAME="join(java.lang.String, java.lang.Object[])"><!-- --></A><H3>
+<A
NAME="join(java.lang.Appendable,java.lang.String,java.lang.Object[])"><!--
--></A><A NAME="join(T, java.lang.String, java.lang.Object[])"><!--
--></A><H3>
join</H3>
<PRE>
-public static <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html"
title="class or interface in java.lang">String</A> <B>join</B>(<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html"
title="class or interface in java.lang">String</A> delimiter,
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A>[] tokens)</PRE>
+public static <T extends <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Appendable.html?is-external=true"
title="class or interface in java.lang">Appendable</A>> T
<B>join</B>(T appendable,
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in java.lang">String</A> delimiter,
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">Object</A>[] tokens)</PRE>
<DL>
-<DD>Variant of <A
HREF="../../../../com/google/common/base/Join.html#join(java.lang.String,
java.lang.Iterable)"><CODE>join(String,Iterable)</CODE></A> where
<code>tokens</code> is an
- array.
+<DD>Appends each of the <code>tokens</code> to <code>appendable</code>,
separated by
+ <code>delimiter</code>.
+
+ <p>Each token will be converted to a <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/CharSequence.html?is-external=true"
title="class or interface in java.lang"><CODE>CharSequence</CODE></A> using
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true#valueOf(java.lang.Object)"
title="class or interface in
java.lang"><CODE>String.valueOf(Object)</CODE></A>, if it isn't a <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/CharSequence.html?is-external=true"
title="class or interface in java.lang"><CODE>CharSequence</CODE></A>
already.
+ Note that this implies that null tokens will be appended as the
+ four-character string <code>"null"</code>.
<P>
<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>appendable</CODE> - the object to append
the results to<DD><CODE>delimiter</CODE> - a string to append between every
element, but not at the
+ beginning or end<DD><CODE>tokens</CODE> - objects to append
+<DT><B>Returns:</B><DD>the same <code>Appendable</code> instance that was
passed in
+<DT><B>Throws:</B>
+<DD><CODE><A
HREF="../../../../com/google/common/base/Join.JoinException.html"
title="class in com.google.common.base">Join.JoinException</A></CODE> - if
an <A
HREF="http://java.sun.com/javase/6/docs/api/java/io/IOException.html?is-external=true"
title="class or interface in java.io"><CODE>IOException</CODE></A>
occurs</DL>
+</DD>
</DL>
+<HR>
+
+<A
NAME="join(java.lang.Appendable,java.lang.String,java.lang.Object,java.lang.Object[])"><!--
--></A><A NAME="join(T, java.lang.String, java.lang.Object,
java.lang.Object...)"><!-- --></A><H3>
+join</H3>
+<PRE>
+public static <T extends <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Appendable.html?is-external=true"
title="class or interface in java.lang">Appendable</A>> T
<B>join</B>(T appendable,
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in java.lang">String</A> delimiter,
+ <FONT SIZE="-1"><A
HREF="../../../../com/google/common/base/Nullable.html" title="annotation
in com.google.common.base">@Nullable</A></FONT>
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">Object</A> firstToken,
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in
java.lang">Object</A>... otherTokens)</PRE>
+<DL>
+<DD>Appends each of the <code>tokens</code> to <code>appendable</code>,
separated by
+ <code>delimiter</code>.
+
+ <p>Each token will be converted to a <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/CharSequence.html?is-external=true"
title="class or interface in java.lang"><CODE>CharSequence</CODE></A> using
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true#valueOf(java.lang.Object)"
title="class or interface in
java.lang"><CODE>String.valueOf(Object)</CODE></A>, if it isn't a <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/CharSequence.html?is-external=true"
title="class or interface in java.lang"><CODE>CharSequence</CODE></A>
already.
+ Note that this implies that null tokens will be appended as the
+ four-character string <code>"null"</code>.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>appendable</CODE> - the object to append
the results to<DD><CODE>delimiter</CODE> - a string to append between every
element, but not at the
+ beginning or end<DD><CODE>firstToken</CODE> - the first object to
append<DD><CODE>otherTokens</CODE> - subsequent objects to append
+<DT><B>Returns:</B><DD>the same <code>Appendable</code> instance that was
passed in
+<DT><B>Throws:</B>
+<DD><CODE><A
HREF="../../../../com/google/common/base/Join.JoinException.html"
title="class in com.google.common.base">Join.JoinException</A></CODE> - if
an <A
HREF="http://java.sun.com/javase/6/docs/api/java/io/IOException.html?is-external=true"
title="class or interface in java.io"><CODE>IOException</CODE></A>
occurs</DL>
</DD>
</DL>
<HR>
-<A NAME="join(java.lang.String, java.lang.Object,
java.lang.Object...)"><!-- --></A><H3>
+<A
NAME="join(java.lang.Appendable,java.lang.String,java.util.Iterator)"><!--
--></A><A NAME="join(T, java.lang.String, java.util.Iterator)"><!--
--></A><H3>
join</H3>
<PRE>
-public static <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html"
title="class or interface in java.lang">String</A> <B>join</B>(<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html"
title="class or interface in java.lang">String</A> delimiter,
- <FONT SIZE="-1"><A
HREF="../../../../com/google/common/base/Nullable.html" title="annotation
in com.google.common.base">@Nullable</A></FONT>
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A> firstToken,
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in
java.lang">Object</A>... otherTokens)</PRE>
+public static <T extends <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Appendable.html?is-external=true"
title="class or interface in java.lang">Appendable</A>> T
<B>join</B>(T appendable,
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in java.lang">String</A> delimiter,
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/util/Iterator.html?is-external=true"
title="class or interface in
java.util">Iterator</A><?> tokens)</PRE>
<DL>
-<DD>Variant of <A
HREF="../../../../com/google/common/base/Join.html#join(java.lang.String,
java.lang.Iterable)"><CODE>join(String,Iterable)</CODE></A> for tokens
given using varargs.
+<DD>Appends each of the <code>tokens</code> to <code>appendable</code>,
separated by
+ <code>delimiter</code>.
+
+ <p>Each token will be converted to a <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/CharSequence.html?is-external=true"
title="class or interface in java.lang"><CODE>CharSequence</CODE></A> using
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true#valueOf(java.lang.Object)"
title="class or interface in
java.lang"><CODE>String.valueOf(Object)</CODE></A>, if it isn't a <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/CharSequence.html?is-external=true"
title="class or interface in java.lang"><CODE>CharSequence</CODE></A>
already.
+ Note that this implies that null tokens will be appended as the
+ four-character string <code>"null"</code>.
<P>
<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>appendable</CODE> - the object to append
the results to<DD><CODE>delimiter</CODE> - a string to append between every
element, but not at the
+ beginning or end<DD><CODE>tokens</CODE> - objects to append
+<DT><B>Returns:</B><DD>the same <code>Appendable</code> instance that was
passed in
+<DT><B>Throws:</B>
+<DD><CODE><A
HREF="../../../../com/google/common/base/Join.JoinException.html"
title="class in com.google.common.base">Join.JoinException</A></CODE> - if
an <A
HREF="http://java.sun.com/javase/6/docs/api/java/io/IOException.html?is-external=true"
title="class or interface in java.io"><CODE>IOException</CODE></A>
occurs</DL>
+</DD>
</DL>
+<HR>
+
+<A
NAME="join(java.lang.Appendable,java.lang.String,java.lang.String,java.util.Map)"><!--
--></A><A NAME="join(T, java.lang.String, java.lang.String,
java.util.Map)"><!-- --></A><H3>
+join</H3>
+<PRE>
+public static <T extends <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Appendable.html?is-external=true"
title="class or interface in java.lang">Appendable</A>> T
<B>join</B>(T appendable,
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in java.lang">String</A> keyValueSeparator,
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in java.lang">String</A> entryDelimiter,
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/util/Map.html?is-external=true"
title="class or interface in java.util">Map</A><?,?> map)</PRE>
+<DL>
+<DD>Appends the contents of <code>map</code> to <code>appendable</code>,
with entries
+ separated by <code>entryDelimiter</code>, and keys and values separated
with
+ <code>keyValueSeparator</code>.
+
+ <p>Each key and value will be converted to a <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/CharSequence.html?is-external=true"
title="class or interface in java.lang"><CODE>CharSequence</CODE></A> using
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true#valueOf(java.lang.Object)"
title="class or interface in
java.lang"><CODE>String.valueOf(Object)</CODE></A>, if it isn't a <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/CharSequence.html?is-external=true"
title="class or interface in java.lang"><CODE>CharSequence</CODE></A>
already.
+ Note that this implies that null tokens will be appended as the
+ four-character string <code>"null"</code>.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>appendable</CODE> - the object to append
the results to<DD><CODE>keyValueSeparator</CODE> - a string to append
between every key and its
+ associated value<DD><CODE>entryDelimiter</CODE> - a string to append
between every entry, but not at
+ the beginning or end<DD><CODE>map</CODE> - the map containing the
data to join
+<DT><B>Returns:</B><DD>the same <code>Appendable</code> instance that was
passed in</DL>
</DD>
</DL>
<!-- ========= END OF CLASS DATA ========= -->
Modified: trunk/javadoc/com/google/common/base/Nullable.html
==============================================================================
--- trunk/javadoc/com/google/common/base/Nullable.html (original)
+++ trunk/javadoc/com/google/common/base/Nullable.html Mon Aug 18 16:46:26
2008
@@ -2,19 +2,21 @@
<!--NewPage-->
<HTML>
<HEAD>
-<!-- Generated by javadoc (build 1.5.0_06) on Fri May 30 13:31:20 PDT 2008
-->
+<!-- Generated by javadoc (build 1.6.0_01) on Mon Aug 18 15:24:21
GMT-08:00 2008 -->
<TITLE>
-Nullable (Google Collections Library - snapshot-20080530 (ALPHA))
+Nullable (Google Collections Library - snapshot-20080818 (ALPHA))
</TITLE>
-<META NAME="keywords" CONTENT="com.google.common.base.Nullable class">
+<META NAME="date" CONTENT="2008-08-18">
<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css"
TITLE="Style">
<SCRIPT type="text/javascript">
function windowTitle()
{
- parent.document.title="Nullable (Google Collections Library -
snapshot-20080530 (ALPHA))";
+ if (location.href.indexOf('is-external=true') == -1) {
+ parent.document.title="Nullable (Google Collections Library -
snapshot-20080818 (ALPHA))";
+ }
}
</SCRIPT>
<NOSCRIPT>
@@ -23,6 +25,7 @@
</HEAD>
<BODY BGCOLOR="white" onload="windowTitle();">
+<HR>
<!-- ========= START OF TOP NAVBAR ======= -->
@@ -89,9 +92,9 @@
Annotation Type Nullable</H2>
<HR>
<DL>
-<DT><PRE><FONT SIZE="-1"><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/annotation/Documented.html"
title="class or interface in java.lang.annotation">@Documented</A>
-<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/annotation/Retention.html"
title="class or interface in java.lang.annotation">@Retention</A>(<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/annotation/Retention.html#value()"
title="class or interface in java.lang.annotation">value</A>=<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/annotation/RetentionPolicy.html#RUNTIME"
title="class or interface in java.lang.annotation">RUNTIME</A>)
-<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/annotation/Target.html"
title="class or interface in java.lang.annotation">@Target</A>(<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/annotation/Target.html#value()"
title="class or interface in java.lang.annotation">value</A>=<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/annotation/ElementType.html#PARAMETER"
title="class or interface in java.lang.annotation">PARAMETER</A>)
+<DT><PRE><FONT SIZE="-1"><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/annotation/Documented.html?is-external=true"
title="class or interface in java.lang.annotation">@Documented</A>
+<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/annotation/Retention.html?is-external=true"
title="class or interface in java.lang.annotation">@Retention</A>(<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/annotation/Retention.html?is-external=true#value()"
title="class or interface in java.lang.annotation">value</A>=<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/annotation/RetentionPolicy.html?is-external=true#RUNTIME"
title="class or interface in java.lang.annotation">RUNTIME</A>)
+<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/annotation/Target.html?is-external=true"
title="class or interface in java.lang.annotation">@Target</A>(<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/annotation/Target.html?is-external=true#value()"
title="class or interface in java.lang.annotation">value</A>=<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/annotation/ElementType.html?is-external=true#PARAMETER"
title="class or interface in java.lang.annotation">PARAMETER</A>)
</FONT>public @interface <B>Nullable</B></DL>
</PRE>
Modified: trunk/javadoc/com/google/common/base/Objects.html
==============================================================================
--- trunk/javadoc/com/google/common/base/Objects.html (original)
+++ trunk/javadoc/com/google/common/base/Objects.html Mon Aug 18 16:46:26
2008
@@ -2,19 +2,21 @@
<!--NewPage-->
<HTML>
<HEAD>
-<!-- Generated by javadoc (build 1.5.0_06) on Fri May 30 13:31:20 PDT 2008
-->
+<!-- Generated by javadoc (build 1.6.0_01) on Mon Aug 18 15:24:21
GMT-08:00 2008 -->
<TITLE>
-Objects (Google Collections Library - snapshot-20080530 (ALPHA))
+Objects (Google Collections Library - snapshot-20080818 (ALPHA))
</TITLE>
-<META NAME="keywords" CONTENT="com.google.common.base.Objects class">
+<META NAME="date" CONTENT="2008-08-18">
<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css"
TITLE="Style">
<SCRIPT type="text/javascript">
function windowTitle()
{
- parent.document.title="Objects (Google Collections Library -
snapshot-20080530 (ALPHA))";
+ if (location.href.indexOf('is-external=true') == -1) {
+ parent.document.title="Objects (Google Collections Library -
snapshot-20080818 (ALPHA))";
+ }
}
</SCRIPT>
<NOSCRIPT>
@@ -23,6 +25,7 @@
</HEAD>
<BODY BGCOLOR="white" onload="windowTitle();">
+<HR>
<!-- ========= START OF TOP NAVBAR ======= -->
@@ -88,16 +91,16 @@
<BR>
Class Objects</H2>
<PRE>
-<A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">java.lang.Object</A>
+<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">java.lang.Object</A>
<IMG SRC="../../../../resources/inherit.gif" ALT="extended
by "><B>com.google.common.base.Objects</B>
</PRE>
<HR>
<DL>
-<DT><PRE>public final class <B>Objects</B><DT>extends <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A></DL>
+<DT><PRE>public final class <B>Objects</B><DT>extends <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">Object</A></DL>
</PRE>
<P>
-Helper functions for operating on <code>Object</code>s.
+Helper functions that can operate on any <code>Object</code>.
<P>
<P>
@@ -120,36 +123,8 @@
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static boolean</CODE></FONT></TD>
-<TD><CODE><B><A
HREF="../../../../com/google/common/base/Objects.html#deepEquals(java.lang.Object,
java.lang.Object)">deepEquals</A></B>(<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A> o1,
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A> o2)</CODE>
-
-<BR>
- Determines if
two objects are equal as determined by
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#equals(java.lang.Object)"
title="class or interface in
java.lang"><CODE>Object.equals(Object)</CODE></A>, or "deeply equal" if
both are arrays.</TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE>static int</CODE></FONT></TD>
-<TD><CODE><B><A
HREF="../../../../com/google/common/base/Objects.html#deepHashCode(java.lang.Object)">deepHashCode</A></B>(<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A> o)</CODE>
-
-<BR>
- Gets hash code
of an object, optionally returns hash code based on the
- "deep contents" of array if the object is an array.</TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE>static <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html"
title="class or interface in java.lang">String</A></CODE></FONT></TD>
-<TD><CODE><B><A
HREF="../../../../com/google/common/base/Objects.html#deepToString(java.lang.Object)">deepToString</A></B>(<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A> o)</CODE>
-
-<BR>
- Gets string
representation of an object, or the "deep content" of the array
- if the <code>o</code> is an array.</TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE>static boolean</CODE></FONT></TD>
-<TD><CODE><B><A
HREF="../../../../com/google/common/base/Objects.html#equal(java.lang.Object,
java.lang.Object)">equal</A></B>(<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A> a,
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A> b)</CODE>
+<TD><CODE><B><A
HREF="../../../../com/google/common/base/Objects.html#equal(java.lang.Object,
java.lang.Object)">equal</A></B>(<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">Object</A> a,
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">Object</A> b)</CODE>
<BR>
Determines
whether two possibly-null objects are equal.</TD>
@@ -168,56 +143,25 @@
T second)</CODE>
<BR>
- Returns the
first of the given parameters that is not <code>null</code> if any,
- or otherwise throws <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/NullPointerException.html"
title="class or interface in
java.lang"><CODE>NullPointerException</CODE></A>.</TD>
+ Returns the
first of two given parameters that is not <code>null</code>, if
+ either is, or otherwise throws a <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/NullPointerException.html?is-external=true"
title="class or interface in
java.lang"><CODE>NullPointerException</CODE></A>.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static int</CODE></FONT></TD>
-<TD><CODE><B><A
HREF="../../../../com/google/common/base/Objects.html#hashCode(java.lang.Object...)">hashCode</A></B>(<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A>... objects)</CODE>
+<TD><CODE><B><A
HREF="../../../../com/google/common/base/Objects.html#hashCode(java.lang.Object...)">hashCode</A></B>(<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">Object</A>... objects)</CODE>
<BR>
- Generates a
hashcode for multiple values.</TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE>static
-<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="0" SUMMARY="">
-<TR ALIGN="right" VALIGN="">
-<TD NOWRAP><FONT SIZE="-1">
-<CODE><T> T</CODE></FONT></TD>
-</TR>
-</TABLE>
-</CODE></FONT></TD>
-<TD><CODE><B><A
HREF="../../../../com/google/common/base/Objects.html#nonNull(T)">nonNull</A></B>(T o)</CODE>
-
-<BR>
- Checks that
the specified object is not <code>null</code>.</TD>
-</TR>
-<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE>static
-<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="0" SUMMARY="">
-<TR ALIGN="right" VALIGN="">
-<TD NOWRAP><FONT SIZE="-1">
-<CODE><T> T</CODE></FONT></TD>
-</TR>
-</TABLE>
-</CODE></FONT></TD>
-<TD><CODE><B><A
HREF="../../../../com/google/common/base/Objects.html#nonNull(T,
java.lang.String)">nonNull</A></B>(T o,
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html"
title="class or interface in java.lang">String</A> message)</CODE>
-
-<BR>
- Checks that
the specified object is not <code>null</code>.</TD>
+ Generates a
hash code for multiple values.</TD>
</TR>
</TABLE>
<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
-<TH ALIGN="left"><B>Methods inherited from class java.lang.<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A></B></TH>
+<TH ALIGN="left"><B>Methods inherited from class java.lang.<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">Object</A></B></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD><CODE><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#clone()"
title="class or interface in java.lang">clone</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#equals(java.lang.Object)"
title="class or interface in java.lang">equals</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#finalize()"
title="class or interface in java.lang">finalize</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#getClass()"
title="class or interface in java.lang">getClass</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#hashCode()"
title="class or interface in java.lang">hashCode</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#notify()"
title="class or interface in java.lang">notify</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#notifyAll()"
title="class or interface in java.lang">notifyAll</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#toString()"
title="class or interface in java.lang">toString</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#wait()"
title="class or interface in java.lang">wait</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#wait(long)"
title="class or interface in java.lang">wait</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#wait(long,
int)" title="class or interface in java.lang">wait</A></CODE></TD>
+<TD><CODE><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#clone()"
title="class or interface in java.lang">clone</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#equals(java.lang.Object)"
title="class or interface in java.lang">equals</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#finalize()"
title="class or interface in java.lang">finalize</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#getClass()"
title="class or interface in java.lang">getClass</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#hashCode()"
title="class or interface in java.lang">hashCode</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#notify()"
title="class or interface in java.lang">notify</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#notifyAll()"
title="class or interface in java.lang">notifyAll</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#toString()"
title="class or interface in java.lang">toString</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait()"
title="class or interface in java.lang">wait</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait(long)"
title="class or interface in java.lang">wait</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait(long,
int)" title="class or interface in java.lang">wait</A></CODE></TD>
</TR>
</TABLE>
@@ -233,84 +177,20 @@
</TR>
</TABLE>
-<A NAME="deepHashCode(java.lang.Object)"><!-- --></A><H3>
-deepHashCode</H3>
-<PRE>
-public static int <B>deepHashCode</B>(<FONT SIZE="-1"><A
HREF="../../../../com/google/common/base/Nullable.html" title="annotation
in com.google.common.base">@Nullable</A></FONT>
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A> o)</PRE>
-<DL>
-<DD>Gets hash code of an object, optionally returns hash code based on the
- "deep contents" of array if the object is an array.
- <p>
- If <code>o</code> is null, 0 is returned; if <code>o</code> is an array,
the
- corresponding <A
HREF="http://java.sun.com/javase/6/docs/api/java/util/Arrays.html#deepHashCode(java.lang.Object[])"
title="class or interface in
java.util"><CODE>Arrays.deepHashCode(Object[])</CODE></A>, or
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/util/Arrays.html#hashCode(int[])"
title="class or interface in
java.util"><CODE>Arrays.hashCode(int[])</CODE></A> or the like is used to
calculate the hash
- code.
-<P>
-<DD><DL>
-</DL>
-</DD>
-</DL>
-<HR>
-
-<A NAME="deepToString(java.lang.Object)"><!-- --></A><H3>
-deepToString</H3>
-<PRE>
-public static <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html"
title="class or interface in java.lang">String</A>
<B>deepToString</B>(<FONT SIZE="-1"><A
HREF="../../../../com/google/common/base/Nullable.html" title="annotation
in com.google.common.base">@Nullable</A></FONT>
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A> o)</PRE>
-<DL>
-<DD>Gets string representation of an object, or the "deep content" of the
array
- if the <code>o</code> is an array.
- <p>
- If <code>o</code> is null, <code>"null"</code> is returned; if
<code>o</code> is an
- array, the corresponding <A
HREF="http://java.sun.com/javase/6/docs/api/java/util/Arrays.html#deepToString(java.lang.Object[])"
title="class or interface in
java.util"><CODE>Arrays.deepToString(Object[])</CODE></A>,
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/util/Arrays.html#toString(int[])"
title="class or interface in
java.util"><CODE>Arrays.toString(int[])</CODE></A> or the like is used to
get the string.
-<P>
-<DD><DL>
-</DL>
-</DD>
-</DL>
-<HR>
-
-<A NAME="deepEquals(java.lang.Object, java.lang.Object)"><!-- --></A><H3>
-deepEquals</H3>
-<PRE>
-public static boolean <B>deepEquals</B>(<FONT SIZE="-1"><A
HREF="../../../../com/google/common/base/Nullable.html" title="annotation
in com.google.common.base">@Nullable</A></FONT>
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A> o1,
- <FONT SIZE="-1"><A
HREF="../../../../com/google/common/base/Nullable.html" title="annotation
in com.google.common.base">@Nullable</A></FONT>
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A> o2)</PRE>
-<DL>
-<DD>Determines if two objects are equal as determined by
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#equals(java.lang.Object)"
title="class or interface in
java.lang"><CODE>Object.equals(Object)</CODE></A>, or "deeply equal" if
both are arrays.
- <p>
- If both objects are null, true is returned; if both objects are array, the
- corresponding <A
HREF="http://java.sun.com/javase/6/docs/api/java/util/Arrays.html#deepEquals(java.lang.Object[],
java.lang.Object[])" title="class or interface in
java.util"><CODE>Arrays.deepEquals(Object[], Object[])</CODE></A>, or
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/util/Arrays.html#equals(int[],
int[])" title="class or interface in java.util"><CODE>Arrays.equals(int[],
int[])</CODE></A> or the like are called to determine
- equality.
- <p>
- Note that this method does not "deeply" compare the fields of the
- objects.
-<P>
-<DD><DL>
-</DL>
-</DD>
-</DL>
-<HR>
-
<A NAME="equal(java.lang.Object, java.lang.Object)"><!-- --></A><H3>
equal</H3>
<PRE>
public static boolean <B>equal</B>(<FONT SIZE="-1"><A
HREF="../../../../com/google/common/base/Nullable.html" title="annotation
in com.google.common.base">@Nullable</A></FONT>
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A> a,
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">Object</A> a,
<FONT SIZE="-1"><A
HREF="../../../../com/google/common/base/Nullable.html" title="annotation
in com.google.common.base">@Nullable</A></FONT>
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A> b)</PRE>
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">Object</A> b)</PRE>
<DL>
<DD>Determines whether two possibly-null objects are equal. Returns:
<ul>
<li><code>true</code> if <code>a</code> and <code>b</code> are both null.
<li><code>true</code> if <code>a</code> and <code>b</code> are both
non-null and they are
- equal according to <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#equals(java.lang.Object)"
title="class or interface in
java.lang"><CODE>Object.equals(Object)</CODE></A>.
+ equal according to <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#equals(java.lang.Object)"
title="class or interface in
java.lang"><CODE>Object.equals(Object)</CODE></A>.
<li><code>false</code> in all other situations.
</ul>
@@ -326,12 +206,12 @@
<A NAME="hashCode(java.lang.Object...)"><!-- --></A><H3>
hashCode</H3>
<PRE>
-public static int <B>hashCode</B>(<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A>... objects)</PRE>
+public static int <B>hashCode</B>(<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">Object</A>... objects)</PRE>
<DL>
-<DD>Generates a hashcode for multiple values. The hash code is generated by
- calling <A
HREF="http://java.sun.com/javase/6/docs/api/java/util/Arrays.html#hashCode(java.lang.Object[])"
title="class or interface in
java.util"><CODE>Arrays.hashCode(Object[])</CODE></A>.
+<DD>Generates a hash code for multiple values. The hash code is generated
by
+ calling <A
HREF="http://java.sun.com/javase/6/docs/api/java/util/Arrays.html?is-external=true#hashCode(java.lang.Object[])"
title="class or interface in
java.util"><CODE>Arrays.hashCode(Object[])</CODE></A>.
- <p>This is useful for implementing <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#hashCode()"
title="class or interface in java.lang"><CODE>Object.hashCode()</CODE></A>.
For example,
+ <p>This is useful for implementing <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#hashCode()"
title="class or interface in java.lang"><CODE>Object.hashCode()</CODE></A>.
For example,
in an object that has three properties, <code>x</code>, <code>y</code>,
and
<code>z</code>, one could write:
<pre>
@@ -348,39 +228,6 @@
</DL>
<HR>
-<A NAME="nonNull(java.lang.Object)"><!-- --></A><A NAME="nonNull(T)"><!--
--></A><H3>
-nonNull</H3>
-<PRE>
-public static <T> T <B>nonNull</B>(T o)</PRE>
-<DL>
-<DD>Checks that the specified object is not <code>null</code>.
-<P>
-<DD><DL>
-<DT><B>Parameters:</B><DD><CODE>o</CODE> - the object to check for
nullness.
-<DT><B>Returns:</B><DD><code>o</code> if not null.
-<DT><B>Throws:</B>
-<DD><CODE><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/NullPointerException.html"
title="class or interface in java.lang">NullPointerException</A></CODE> -
if <code>o</code> is null.</DL>
-</DD>
-</DL>
-<HR>
-
-<A NAME="nonNull(java.lang.Object,java.lang.String)"><!-- --></A><A
NAME="nonNull(T, java.lang.String)"><!-- --></A><H3>
-nonNull</H3>
-<PRE>
-public static <T> T <B>nonNull</B>(T o,
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html"
title="class or interface in java.lang">String</A> message)</PRE>
-<DL>
-<DD>Checks that the specified object is not <code>null</code>.
-<P>
-<DD><DL>
-<DT><B>Parameters:</B><DD><CODE>o</CODE> - the object to check for
nullness.<DD><CODE>message</CODE> - exception message used in the event
that a <code>NullPointerException</code> is thrown.
-<DT><B>Returns:</B><DD><code>o</code> if not null.
-<DT><B>Throws:</B>
-<DD><CODE><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/NullPointerException.html"
title="class or interface in java.lang">NullPointerException</A></CODE> -
if <code>o</code> is null.</DL>
-</DD>
-</DL>
-<HR>
-
<A NAME="firstNonNull(java.lang.Object,java.lang.Object)"><!-- --></A><A
NAME="firstNonNull(T, T)"><!-- --></A><H3>
firstNonNull</H3>
<PRE>
@@ -389,17 +236,17 @@
<FONT SIZE="-1"><A
HREF="../../../../com/google/common/base/Nullable.html" title="annotation
in com.google.common.base">@Nullable</A></FONT>
T second)</PRE>
<DL>
-<DD>Returns the first of the given parameters that is not
<code>null</code> if any,
- or otherwise throws <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/NullPointerException.html"
title="class or interface in
java.lang"><CODE>NullPointerException</CODE></A>.
+<DD>Returns the first of two given parameters that is not
<code>null</code>, if
+ either is, or otherwise throws a <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/NullPointerException.html?is-external=true"
title="class or interface in
java.lang"><CODE>NullPointerException</CODE></A>.
<P>
<DD><DL>
<DT><B>Returns:</B><DD><code>first</code> if <code>first</code> is not
<code>null</code>, or
<code>second</code> if <code>first</code> is <code>null</code> and
<code>second</code> is
- not <code>null</code>.
+ not <code>null</code>
<DT><B>Throws:</B>
-<DD><CODE><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/NullPointerException.html"
title="class or interface in java.lang">NullPointerException</A></CODE> -
if both <code>first</code> and <code>second</code> were
- <code>null</code>.</DL>
+<DD><CODE><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/NullPointerException.html?is-external=true"
title="class or interface in java.lang">NullPointerException</A></CODE> -
if both <code>first</code> and <code>second</code> were
+ <code>null</code></DL>
</DD>
</DL>
<!-- ========= END OF CLASS DATA ========= -->
Modified: trunk/javadoc/com/google/common/base/Preconditions.html
==============================================================================
--- trunk/javadoc/com/google/common/base/Preconditions.html (original)
+++ trunk/javadoc/com/google/common/base/Preconditions.html Mon Aug 18
16:46:26 2008
@@ -2,19 +2,21 @@
<!--NewPage-->
<HTML>
<HEAD>
-<!-- Generated by javadoc (build 1.5.0_06) on Fri May 30 13:31:20 PDT 2008
-->
+<!-- Generated by javadoc (build 1.6.0_01) on Mon Aug 18 15:24:21
GMT-08:00 2008 -->
<TITLE>
-Preconditions (Google Collections Library - snapshot-20080530 (ALPHA))
+Preconditions (Google Collections Library - snapshot-20080818 (ALPHA))
</TITLE>
-<META NAME="keywords" CONTENT="com.google.common.base.Preconditions class">
+<META NAME="date" CONTENT="2008-08-18">
<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css"
TITLE="Style">
<SCRIPT type="text/javascript">
function windowTitle()
{
- parent.document.title="Preconditions (Google Collections Library -
snapshot-20080530 (ALPHA))";
+ if (location.href.indexOf('is-external=true') == -1) {
+ parent.document.title="Preconditions (Google Collections Library -
snapshot-20080818 (ALPHA))";
+ }
}
</SCRIPT>
<NOSCRIPT>
@@ -23,6 +25,7 @@
</HEAD>
<BODY BGCOLOR="white" onload="windowTitle();">
+<HR>
<!-- ========= START OF TOP NAVBAR ======= -->
@@ -88,17 +91,17 @@
<BR>
Class Preconditions</H2>
<PRE>
-<A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">java.lang.Object</A>
+<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">java.lang.Object</A>
<IMG SRC="../../../../resources/inherit.gif" ALT="extended
by "><B>com.google.common.base.Preconditions</B>
</PRE>
<HR>
<DL>
-<DT><PRE>public final class <B>Preconditions</B><DT>extends <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A></DL>
+<DT><PRE>public final class <B>Preconditions</B><DT>extends <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">Object</A></DL>
</PRE>
<P>
-Contains simple static methods to be called at the start of your own
methods
- to verify correct arguments and state. This allows constructs such as
+Simple static methods to be called at the start of your own methods to
verify
+ correct arguments and state. This allows constructs such as
<pre>
if (count <= 0) {
throw new IllegalArgumentException("must be positive: " + count);
@@ -110,23 +113,22 @@
Note that the sense of the expression is inverted; with
<code>Preconditions</code>
you declare what you expect to be <i>true</i>, just as you do with an
- <a href="http://java.sun.com/j2se/1.4.2/docs/guide/lang/assert.html">
+ <a href="http://java.sun.com/j2se/1.5.0/docs/guide/language/assert.html">
<code>assert</code></a> or a JUnit <code>assertTrue()</code> call.
<p>Take care not to confuse precondition checking with other similar types
of checks! Precondition exceptions -- including those provided here, but
also
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/IndexOutOfBoundsException.html"
title="class or interface in
java.lang"><CODE>IndexOutOfBoundsException</CODE></A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/util/NoSuchElementException.html"
title="class or interface in
java.util"><CODE>NoSuchElementException</CODE></A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/UnsupportedOperationException.html"
title="class or interface in
java.lang"><CODE>UnsupportedOperationException</CODE></A> and others -- are
used to signal that the
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/IndexOutOfBoundsException.html?is-external=true"
title="class or interface in
java.lang"><CODE>IndexOutOfBoundsException</CODE></A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/util/NoSuchElementException.html?is-external=true"
title="class or interface in
java.util"><CODE>NoSuchElementException</CODE></A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/UnsupportedOperationException.html?is-external=true"
title="class or interface in
java.lang"><CODE>UnsupportedOperationException</CODE></A> and others -- are
used to signal that the
<i>calling method</i> has made an error. This tells the caller that it
should
not have invoked the method when it did, with the arguments it did, or
perhaps <i>ever</i>. Postcondition or other invariant failures should not
- throw these types of exceptions, perhaps using <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/AssertionError.html"
title="class or interface in java.lang"><CODE>AssertionError</CODE></A>
- instead.
+ throw these types of exceptions.
<p><b>Note:</b> The methods of the <code>Preconditions</code> class are
highly
unusual in one way: they are <i>supposed to</i> throw exceptions, and
promise
in their specifications to do so even when given perfectly valid input.
That
is, <code>null</code> is a valid parameter to the method <A
HREF="../../../../com/google/common/base/Preconditions.html#checkNotNull(T)"><CODE>checkNotNull(Object)</CODE></A>
-- and technically this parameter could be even marked
- as <A HREF="../../../../com/google/common/base/Nullable.html"
title="annotation in com.google.common.base"><CODE>Nullable</CODE></A>! --
yet the method will still throw an exception anyway,
+ as <A HREF="../../../../com/google/common/base/Nullable.html"
title="annotation in com.google.common.base"><CODE>Nullable</CODE></A> --
yet the method will still throw an exception anyway,
because that's what its contract says to do.
<P>
@@ -160,7 +162,7 @@
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static void</CODE></FONT></TD>
<TD><CODE><B><A
HREF="../../../../com/google/common/base/Preconditions.html#checkArgument(boolean,
java.lang.Object)">checkArgument</A></B>(boolean expression,
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A> errorMessage)</CODE>
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">Object</A> errorMessage)</CODE>
<BR>
Ensures the
truth of an expression involving one or more parameters to the
@@ -170,8 +172,8 @@
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static void</CODE></FONT></TD>
<TD><CODE><B><A
HREF="../../../../com/google/common/base/Preconditions.html#checkArgument(boolean,
java.lang.String,
java.lang.Object...)">checkArgument</A></B>(boolean expression,
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html"
title="class or interface in java.lang">String</A> errorMessageFormat,
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in
java.lang">Object</A>... errorMessageArgs)</CODE>
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in
java.lang">String</A> errorMessageTemplate,
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in
java.lang">Object</A>... errorMessageArgs)</CODE>
<BR>
Ensures the
truth of an expression involving one or more parameters to the
@@ -183,7 +185,7 @@
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="0" SUMMARY="">
<TR ALIGN="right" VALIGN="">
<TD NOWRAP><FONT SIZE="-1">
-<CODE><T extends <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Iterable.html"
title="class or interface in java.lang">Iterable</A><?>>
+<CODE><T extends <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true"
title="class or interface in java.lang">Iterable</A><?>>
<BR>
T</CODE></FONT></TD>
</TR>
@@ -201,14 +203,14 @@
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="0" SUMMARY="">
<TR ALIGN="right" VALIGN="">
<TD NOWRAP><FONT SIZE="-1">
-<CODE><T extends <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Iterable.html"
title="class or interface in java.lang">Iterable</A><?>>
+<CODE><T extends <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true"
title="class or interface in java.lang">Iterable</A><?>>
<BR>
T</CODE></FONT></TD>
</TR>
</TABLE>
</CODE></FONT></TD>
<TD><CODE><B><A
HREF="../../../../com/google/common/base/Preconditions.html#checkContentsNotNull(T,
java.lang.Object)">checkContentsNotNull</A></B>(T iterable,
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A> errorMessage)</CODE>
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">Object</A> errorMessage)</CODE>
<BR>
Ensures that
an <code>Iterable</code> object passed as a parameter to the
@@ -220,15 +222,15 @@
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="0" SUMMARY="">
<TR ALIGN="right" VALIGN="">
<TD NOWRAP><FONT SIZE="-1">
-<CODE><T extends <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Iterable.html"
title="class or interface in java.lang">Iterable</A><?>>
+<CODE><T extends <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true"
title="class or interface in java.lang">Iterable</A><?>>
<BR>
T</CODE></FONT></TD>
</TR>
</TABLE>
</CODE></FONT></TD>
<TD><CODE><B><A
HREF="../../../../com/google/common/base/Preconditions.html#checkContentsNotNull(T,
java.lang.String,
java.lang.Object...)">checkContentsNotNull</A></B>(T iterable,
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html"
title="class or interface in java.lang">String</A> errorMessageFormat,
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in
java.lang">Object</A>... errorMessageArgs)</CODE>
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in
java.lang">String</A> errorMessageTemplate,
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in
java.lang">Object</A>... errorMessageArgs)</CODE>
<BR>
Ensures that
an <code>Iterable</code> object passed as a parameter to the
@@ -248,7 +250,7 @@
<BR>
Ensures that
an object reference passed as a parameter to the calling
- method is not null, throwing a <code>NullPointerException</code> if it
is.</TD>
+ method is not null.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
@@ -261,11 +263,11 @@
</TABLE>
</CODE></FONT></TD>
<TD><CODE><B><A
HREF="../../../../com/google/common/base/Preconditions.html#checkNotNull(T,
java.lang.Object)">checkNotNull</A></B>(T reference,
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A> errorMessage)</CODE>
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">Object</A> errorMessage)</CODE>
<BR>
Ensures that
an object reference passed as a parameter to the calling
- method is not null, throwing a <code>NullPointerException</code> if it
is.</TD>
+ method is not null.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
@@ -278,12 +280,12 @@
</TABLE>
</CODE></FONT></TD>
<TD><CODE><B><A
HREF="../../../../com/google/common/base/Preconditions.html#checkNotNull(T,
java.lang.String,
java.lang.Object...)">checkNotNull</A></B>(T reference,
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html"
title="class or interface in java.lang">String</A> errorMessageFormat,
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in
java.lang">Object</A>... errorMessageArgs)</CODE>
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in
java.lang">String</A> errorMessageTemplate,
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in
java.lang">Object</A>... errorMessageArgs)</CODE>
<BR>
Ensures that
an object reference passed as a parameter to the calling
- method is not null, throwing a <code>NullPointerException</code> if it
is.</TD>
+ method is not null.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
@@ -298,7 +300,7 @@
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static void</CODE></FONT></TD>
<TD><CODE><B><A
HREF="../../../../com/google/common/base/Preconditions.html#checkState(boolean,
java.lang.Object)">checkState</A></B>(boolean expression,
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A> errorMessage)</CODE>
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">Object</A> errorMessage)</CODE>
<BR>
Ensures the
truth of an expression involving the state of the calling
@@ -308,8 +310,8 @@
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static void</CODE></FONT></TD>
<TD><CODE><B><A
HREF="../../../../com/google/common/base/Preconditions.html#checkState(boolean,
java.lang.String,
java.lang.Object...)">checkState</A></B>(boolean expression,
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html"
title="class or interface in java.lang">String</A> errorMessageFormat,
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in
java.lang">Object</A>... errorMessageArgs)</CODE>
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in
java.lang">String</A> errorMessageTemplate,
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in
java.lang">Object</A>... errorMessageArgs)</CODE>
<BR>
Ensures the
truth of an expression involving the state of the calling
@@ -319,10 +321,10 @@
<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
-<TH ALIGN="left"><B>Methods inherited from class java.lang.<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A></B></TH>
+<TH ALIGN="left"><B>Methods inherited from class java.lang.<A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">Object</A></B></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD><CODE><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#clone()"
title="class or interface in java.lang">clone</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#equals(java.lang.Object)"
title="class or interface in java.lang">equals</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#finalize()"
title="class or interface in java.lang">finalize</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#getClass()"
title="class or interface in java.lang">getClass</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#hashCode()"
title="class or interface in java.lang">hashCode</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#notify()"
title="class or interface in java.lang">notify</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#notifyAll()"
title="class or interface in java.lang">notifyAll</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#toString()"
title="class or interface in java.lang">toString</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#wait()"
title="class or interface in java.lang">wait</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#wait(long)"
title="class or interface in java.lang">wait</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#wait(long,
int)" title="class or interface in java.lang">wait</A></CODE></TD>
+<TD><CODE><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#clone()"
title="class or interface in java.lang">clone</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#equals(java.lang.Object)"
title="class or interface in java.lang">equals</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#finalize()"
title="class or interface in java.lang">finalize</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#getClass()"
title="class or interface in java.lang">getClass</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#hashCode()"
title="class or interface in java.lang">hashCode</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#notify()"
title="class or interface in java.lang">notify</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#notifyAll()"
title="class or interface in java.lang">notifyAll</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#toString()"
title="class or interface in java.lang">toString</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait()"
title="class or interface in java.lang">wait</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait(long)"
title="class or interface in java.lang">wait</A>, <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait(long,
int)" title="class or interface in java.lang">wait</A></CODE></TD>
</TR>
</TABLE>
@@ -349,7 +351,7 @@
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>expression</CODE> - a boolean expression
<DT><B>Throws:</B>
-<DD><CODE><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/IllegalArgumentException.html"
title="class or interface in java.lang">IllegalArgumentException</A></CODE>
- if <code>expression</code> is false</DL>
+<DD><CODE><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/IllegalArgumentException.html?is-external=true"
title="class or interface in java.lang">IllegalArgumentException</A></CODE>
- if <code>expression</code> is false</DL>
</DD>
</DL>
<HR>
@@ -358,17 +360,16 @@
checkArgument</H3>
<PRE>
public static void <B>checkArgument</B>(boolean expression,
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="class or interface in java.lang">Object</A> errorMessage)</PRE>
+ <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">Object</A> errorMessage)</PRE>
<DL>
<DD>Ensures the truth of an expression involving one or more parameters to
the
calling method.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>expression</CODE> - a boolean
expression<DD><CODE>errorMessage</CODE> - the exception message to use if
the check fails; will
- be converted to a string using <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html#valueOf(java.lang.Object)"
title="class or interface in
java.lang"><CODE>String.valueOf(Object)</CODE></A> only if
- needed
+ be converted to a string using <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html?is-external=true#valueOf(java.lang.Object)"
title="class or interface in
java.lang"><CODE>String.valueOf(Object)</CODE></A>
<DT><B>Throws:</B>
-<DD><CODE><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/IllegalArgumentException.html"
title="class or interface in java.lang">IllegalArgumentException</A></CODE>
- if <code>expression</code> is false</DL>
+<DD><CODE><A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/IllegalArgumentException.html?is-external=true"
title="class or interface in java.lang">IllegalArgumentException</A></CODE>
- if <code>expression</code> is false</DL>
</DD>
</DL>
<HR>
@@ -377,20 +378,25 @@
checkArgument</H3>
<PRE>
public static void <B>checkArgument</B>(boolean expression,
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html"
title="class or interface in java.lang">String</A> errorMessageFormat,
- <A
HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html"
title="cla
==============================================================================
Diff truncated at 200k characters