From bdbcb3796172d286238d61c75480d595d971ef93 Mon Sep 17 00:00:00 2001 From: "copybara-service[bot]" Date: Wed, 16 Nov 2022 12:57:11 +0000 Subject: [PATCH] Generate Javadoc and JDiff for Guava HEAD-jre-SNAPSHOT --- .../com/google/common/base/CharMatcher.html | 2 - .../com/google/common/base/Converter.html | 8 - .../common/base/Equivalence.Wrapper.html | 15 - .../base/FinalizableReferenceQueue.html | 15 +- .../docs/com/google/common/base/Function.html | 8 - .../base/MoreObjects.ToStringHelper.html | 2 - .../docs/com/google/common/base/Optional.html | 15 - .../com/google/common/base/Predicate.html | 8 - .../common/base/StandardSystemProperty.html | 2 - .../com/google/common/base/Stopwatch.html | 2 - .../com/google/common/cache/CacheBuilder.html | 2 - .../google/common/cache/CacheBuilderSpec.html | 91 +-- .../com/google/common/cache/CacheStats.html | 113 +-- .../common/collect/AbstractIterator.html | 22 +- .../collect/AbstractSequentialIterator.html | 22 +- .../common/collect/ArrayListMultimap.html | 10 - .../com/google/common/collect/ArrayTable.html | 93 +-- .../docs/com/google/common/collect/BiMap.html | 51 +- .../common/collect/ClassToInstanceMap.html | 2 +- .../collect/ConcurrentHashMultiset.html | 336 +++------ .../google/common/collect/ContiguousSet.html | 186 +---- .../com/google/common/collect/EnumBiMap.html | 150 +--- .../google/common/collect/EnumHashBiMap.html | 150 +--- .../google/common/collect/EnumMultiset.html | 291 +++----- .../google/common/collect/EvictingQueue.html | 39 +- .../google/common/collect/FluentIterable.html | 2 - .../collect/ForwardingBlockingDeque.html | 253 +------ .../common/collect/ForwardingCollection.html | 210 +----- .../collect/ForwardingConcurrentMap.html | 95 +-- .../common/collect/ForwardingDeque.html | 213 +----- .../common/collect/ForwardingIterator.html | 35 +- .../google/common/collect/ForwardingList.html | 257 +------ .../collect/ForwardingListIterator.html | 83 +-- .../ForwardingMap.StandardEntrySet.html | 107 +-- .../collect/ForwardingMap.StandardKeySet.html | 115 +-- .../collect/ForwardingMap.StandardValues.html | 99 +-- .../google/common/collect/ForwardingMap.html | 290 +------- .../common/collect/ForwardingMapEntry.html | 121 +--- .../common/collect/ForwardingMultimap.html | 107 +-- ...ForwardingMultiset.StandardElementSet.html | 130 +--- .../common/collect/ForwardingMultiset.html | 98 +-- ...ingNavigableMap.StandardDescendingMap.html | 430 +---------- ...gNavigableMap.StandardNavigableKeySet.html | 371 +--------- .../collect/ForwardingNavigableMap.html | 279 +------- ...ingNavigableSet.StandardDescendingSet.html | 316 +------- .../collect/ForwardingNavigableSet.html | 167 +---- .../common/collect/ForwardingObject.html | 2 - .../common/collect/ForwardingQueue.html | 56 +- .../google/common/collect/ForwardingSet.html | 89 +-- .../ForwardingSortedMap.StandardKeySet.html | 204 +----- .../common/collect/ForwardingSortedMap.html | 90 +-- ...edMultiset.StandardDescendingMultiset.html | 67 +- ...dingSortedMultiset.StandardElementSet.html | 386 +--------- .../common/collect/ForwardingSortedSet.html | 89 +-- .../common/collect/ForwardingTable.html | 91 +-- .../google/common/collect/HashBasedTable.html | 93 +-- .../com/google/common/collect/HashBiMap.html | 167 +---- .../google/common/collect/HashMultimap.html | 10 - .../google/common/collect/HashMultiset.html | 291 +++----- .../google/common/collect/ImmutableBiMap.html | 199 +----- .../collect/ImmutableClassToInstanceMap.html | 21 +- .../common/collect/ImmutableCollection.html | 93 +-- .../google/common/collect/ImmutableList.html | 306 +------- .../common/collect/ImmutableListMultimap.html | 63 +- .../google/common/collect/ImmutableMap.html | 410 +---------- .../common/collect/ImmutableMultimap.html | 63 +- .../common/collect/ImmutableMultiset.html | 135 +--- .../common/collect/ImmutableRangeMap.html | 113 +-- .../common/collect/ImmutableRangeSet.html | 117 +-- .../google/common/collect/ImmutableSet.html | 165 +---- .../common/collect/ImmutableSetMultimap.html | 63 +- .../common/collect/ImmutableSortedMap.html | 661 +---------------- .../common/collect/ImmutableSortedSet.html | 355 +-------- .../google/common/collect/ImmutableTable.html | 93 +-- .../common/collect/LinkedHashMultimap.html | 10 - .../common/collect/LinkedHashMultiset.html | 291 +++----- .../common/collect/LinkedListMultimap.html | 63 +- .../google/common/collect/ListMultimap.html | 8 - .../MapDifference.ValueDifference.html | 13 - .../google/common/collect/MapDifference.html | 13 - .../com/google/common/collect/MapMaker.html | 2 - .../common/collect/MinMaxPriorityQueue.html | 95 +-- .../com/google/common/collect/Multimap.html | 13 - .../google/common/collect/Multiset.Entry.html | 89 +-- .../com/google/common/collect/Multiset.html | 80 +-- .../collect/MutableClassToInstanceMap.html | 56 +- .../com/google/common/collect/Ordering.html | 40 +- .../common/collect/PeekingIterator.html | 23 +- .../docs/com/google/common/collect/Range.html | 15 - .../com/google/common/collect/RangeMap.html | 15 - .../com/google/common/collect/RangeSet.html | 15 - .../google/common/collect/SetMultimap.html | 8 - .../google/common/collect/Sets.SetView.html | 31 - .../google/common/collect/SortedMultiset.html | 10 +- .../com/google/common/collect/Table.Cell.html | 13 - .../docs/com/google/common/collect/Table.html | 13 - .../google/common/collect/TreeBasedTable.html | 93 +-- .../google/common/collect/TreeMultimap.html | 10 - .../google/common/collect/TreeMultiset.html | 294 +++----- .../google/common/collect/TreeRangeMap.html | 113 +-- .../google/common/collect/TreeRangeSet.html | 117 +-- .../collect/UnmodifiableListIterator.html | 5 - .../collect/class-use/ImmutableSortedSet.html | 13 - .../com/google/common/eventbus/DeadEvent.html | 24 +- .../com/google/common/eventbus/EventBus.html | 24 +- .../google/common/graph/AbstractGraph.html | 107 +-- .../google/common/graph/AbstractNetwork.html | 108 +-- .../common/graph/AbstractValueGraph.html | 108 +-- .../com/google/common/graph/ElementOrder.html | 113 +-- .../com/google/common/graph/EndpointPair.html | 15 - .../docs/com/google/common/graph/Graph.html | 13 - .../docs/com/google/common/graph/Network.html | 13 - .../com/google/common/graph/ValueGraph.html | 13 - .../com/google/common/hash/BloomFilter.html | 96 +-- .../docs/com/google/common/hash/HashCode.html | 15 - .../docs/com/google/common/hash/Hasher.html | 33 - .../common/hash/HashingInputStream.html | 32 +- .../common/hash/HashingOutputStream.html | 60 +- .../google/common/io/ByteArrayDataInput.html | 435 +---------- .../google/common/io/ByteArrayDataOutput.html | 318 +-------- .../api/docs/com/google/common/io/Closer.html | 2 +- .../google/common/io/CountingInputStream.html | 112 +-- .../common/io/CountingOutputStream.html | 60 +- .../common/io/FileBackedOutputStream.html | 104 +-- .../io/LittleEndianDataInputStream.html | 283 +------- .../io/LittleEndianDataOutputStream.html | 178 +---- .../common/io/PatternFilenameFilter.html | 12 +- .../com/google/common/math/PairedStats.html | 111 +-- .../docs/com/google/common/math/Stats.html | 111 +-- .../com/google/common/net/HostAndPort.html | 91 +-- .../com/google/common/net/HostSpecifier.html | 91 +-- .../google/common/net/InternetDomainName.html | 48 +- .../docs/com/google/common/net/MediaType.html | 91 +-- .../primitives/ImmutableDoubleArray.html | 15 - .../common/primitives/ImmutableIntArray.html | 15 - .../common/primitives/ImmutableLongArray.html | 15 - .../common/primitives/UnsignedInteger.html | 108 +-- .../common/primitives/UnsignedLong.html | 143 +--- .../reflect/AbstractInvocationHandler.html | 75 +- .../common/reflect/ClassPath.ClassInfo.html | 24 +- .../reflect/ClassPath.ResourceInfo.html | 113 +-- .../reflect/ImmutableTypeToInstanceMap.html | 19 +- .../com/google/common/reflect/Invokable.html | 225 +----- .../reflect/MutableTypeToInstanceMap.html | 32 +- .../com/google/common/reflect/Parameter.html | 256 +------ .../google/common/reflect/TypeParameter.html | 113 +-- .../common/reflect/TypeToInstanceMap.html | 2 +- .../com/google/common/reflect/TypeToken.html | 70 +- .../AbstractExecutionThreadService.html | 24 +- .../util/concurrent/AbstractFuture.html | 109 +-- .../util/concurrent/AbstractIdleService.html | 24 +- .../AbstractListeningExecutorService.html | 88 +-- .../concurrent/AbstractScheduledService.html | 24 +- .../util/concurrent/AbstractService.html | 24 +- .../common/util/concurrent/AtomicDouble.html | 12 - .../common/util/concurrent/AtomicLongMap.html | 24 +- .../common/util/concurrent/ClosingFuture.html | 76 +- ...ockFactory.PotentialDeadlockException.html | 3 - .../concurrent/ForwardingBlockingDeque.html | 268 +------ .../concurrent/ForwardingBlockingQueue.html | 120 +--- .../concurrent/ForwardingExecutorService.html | 244 +------ .../util/concurrent/ForwardingFuture.html | 84 +-- .../ForwardingListeningExecutorService.html | 55 +- .../util/concurrent/ListenableFutureTask.html | 21 +- .../concurrent/ListeningExecutorService.html | 109 +-- .../ListeningScheduledExecutorService.html | 109 +-- .../common/util/concurrent/RateLimiter.html | 24 +- .../util/concurrent/ServiceManager.html | 24 +- .../util/concurrent/SettableFuture.html | 81 +-- .../snapshot-android/api/docs/index-all.html | 105 +-- .../api/docs/member-search-index.zip | Bin 47091 -> 47091 bytes .../api/docs/package-search-index.zip | Bin 322 -> 322 bytes .../api/docs/type-search-index.zip | Bin 3280 -> 3280 bytes .../com/google/common/base/CharMatcher.html | 5 - .../com/google/common/base/Converter.html | 20 - .../common/base/Equivalence.Wrapper.html | 15 - .../com/google/common/base/Equivalence.html | 8 - .../base/FinalizableReferenceQueue.html | 15 +- .../docs/com/google/common/base/Function.html | 18 +- .../base/MoreObjects.ToStringHelper.html | 2 - .../docs/com/google/common/base/Optional.html | 15 - .../com/google/common/base/Predicate.html | 19 +- .../common/base/StandardSystemProperty.html | 2 - .../com/google/common/base/Stopwatch.html | 2 - .../common/cache/AbstractLoadingCache.html | 10 +- .../com/google/common/cache/CacheBuilder.html | 2 - .../google/common/cache/CacheBuilderSpec.html | 91 +-- .../com/google/common/cache/CacheStats.html | 113 +-- .../common/cache/ForwardingLoadingCache.html | 10 +- .../com/google/common/cache/LoadingCache.html | 6 - .../common/collect/AbstractIterator.html | 22 +- .../collect/AbstractSequentialIterator.html | 22 +- .../common/collect/ArrayListMultimap.html | 10 - .../com/google/common/collect/ArrayTable.html | 93 +-- .../docs/com/google/common/collect/BiMap.html | 51 +- .../common/collect/ClassToInstanceMap.html | 2 +- .../collect/ConcurrentHashMultiset.html | 336 +++------ .../google/common/collect/ContiguousSet.html | 186 +---- .../com/google/common/collect/EnumBiMap.html | 163 +---- .../google/common/collect/EnumHashBiMap.html | 163 +---- .../google/common/collect/EnumMultiset.html | 291 +++----- .../google/common/collect/EvictingQueue.html | 39 +- .../google/common/collect/FluentIterable.html | 2 - .../collect/ForwardingBlockingDeque.html | 253 +------ .../common/collect/ForwardingCollection.html | 210 +----- .../collect/ForwardingConcurrentMap.html | 95 +-- .../common/collect/ForwardingDeque.html | 213 +----- .../common/collect/ForwardingIterator.html | 35 +- .../google/common/collect/ForwardingList.html | 257 +------ .../collect/ForwardingListIterator.html | 83 +-- .../ForwardingMap.StandardEntrySet.html | 107 +-- .../collect/ForwardingMap.StandardKeySet.html | 135 +--- .../collect/ForwardingMap.StandardValues.html | 119 +--- .../google/common/collect/ForwardingMap.html | 290 +------- .../common/collect/ForwardingMapEntry.html | 121 +--- .../common/collect/ForwardingMultimap.html | 107 +-- ...ForwardingMultiset.StandardElementSet.html | 130 +--- .../common/collect/ForwardingMultiset.html | 98 +-- ...ingNavigableMap.StandardDescendingMap.html | 445 +----------- ...gNavigableMap.StandardNavigableKeySet.html | 391 +--------- .../collect/ForwardingNavigableMap.html | 279 +------- ...ingNavigableSet.StandardDescendingSet.html | 316 +------- .../collect/ForwardingNavigableSet.html | 167 +---- .../common/collect/ForwardingObject.html | 2 - .../common/collect/ForwardingQueue.html | 56 +- .../google/common/collect/ForwardingSet.html | 89 +-- .../ForwardingSortedMap.StandardKeySet.html | 224 +----- .../common/collect/ForwardingSortedMap.html | 90 +-- ...edMultiset.StandardDescendingMultiset.html | 67 +- ...dingSortedMultiset.StandardElementSet.html | 386 +--------- .../common/collect/ForwardingSortedSet.html | 89 +-- .../common/collect/ForwardingTable.html | 91 +-- .../google/common/collect/HashBasedTable.html | 93 +-- .../com/google/common/collect/HashBiMap.html | 193 +---- .../google/common/collect/HashMultimap.html | 10 - .../google/common/collect/HashMultiset.html | 291 +++----- .../google/common/collect/ImmutableBiMap.html | 199 +----- .../collect/ImmutableClassToInstanceMap.html | 21 +- .../common/collect/ImmutableCollection.html | 130 +--- .../google/common/collect/ImmutableList.html | 362 +--------- .../common/collect/ImmutableListMultimap.html | 63 +- .../google/common/collect/ImmutableMap.html | 468 +----------- .../common/collect/ImmutableMultimap.html | 63 +- .../common/collect/ImmutableMultiset.html | 135 +--- .../common/collect/ImmutableRangeMap.html | 113 +-- .../common/collect/ImmutableRangeSet.html | 117 +-- .../google/common/collect/ImmutableSet.html | 165 +---- .../common/collect/ImmutableSetMultimap.html | 63 +- .../common/collect/ImmutableSortedMap.html | 674 +----------------- .../common/collect/ImmutableSortedSet.html | 387 +--------- .../google/common/collect/ImmutableTable.html | 93 +-- .../common/collect/LinkedHashMultimap.html | 10 - .../common/collect/LinkedHashMultiset.html | 291 +++----- .../common/collect/LinkedListMultimap.html | 63 +- .../google/common/collect/ListMultimap.html | 8 - .../MapDifference.ValueDifference.html | 13 - .../google/common/collect/MapDifference.html | 13 - .../com/google/common/collect/MapMaker.html | 2 - .../common/collect/MinMaxPriorityQueue.html | 95 +-- .../com/google/common/collect/Multimap.html | 13 - .../google/common/collect/Multiset.Entry.html | 89 +-- .../com/google/common/collect/Multiset.html | 129 +--- .../collect/MutableClassToInstanceMap.html | 56 +- .../com/google/common/collect/Ordering.html | 40 +- .../common/collect/PeekingIterator.html | 23 +- .../docs/com/google/common/collect/Range.html | 15 - .../com/google/common/collect/RangeMap.html | 15 - .../com/google/common/collect/RangeSet.html | 15 - .../google/common/collect/SetMultimap.html | 8 - .../google/common/collect/Sets.SetView.html | 36 - .../google/common/collect/SortedMultiset.html | 10 +- .../com/google/common/collect/Table.Cell.html | 13 - .../docs/com/google/common/collect/Table.html | 13 - .../google/common/collect/TreeBasedTable.html | 93 +-- .../google/common/collect/TreeMultimap.html | 10 - .../google/common/collect/TreeMultiset.html | 294 +++----- .../google/common/collect/TreeRangeMap.html | 113 +-- .../google/common/collect/TreeRangeSet.html | 117 +-- .../collect/UnmodifiableListIterator.html | 5 - .../collect/class-use/ImmutableSortedSet.html | 13 - .../com/google/common/eventbus/DeadEvent.html | 24 +- .../com/google/common/eventbus/EventBus.html | 24 +- .../google/common/graph/AbstractGraph.html | 107 +-- .../google/common/graph/AbstractNetwork.html | 108 +-- .../common/graph/AbstractValueGraph.html | 108 +-- .../com/google/common/graph/ElementOrder.html | 113 +-- .../com/google/common/graph/EndpointPair.html | 15 - .../docs/com/google/common/graph/Graph.html | 13 - .../docs/com/google/common/graph/Network.html | 13 - .../com/google/common/graph/ValueGraph.html | 13 - .../com/google/common/hash/BloomFilter.html | 96 +-- .../docs/com/google/common/hash/HashCode.html | 15 - .../docs/com/google/common/hash/Hasher.html | 33 - .../common/hash/HashingInputStream.html | 32 +- .../common/hash/HashingOutputStream.html | 60 +- .../google/common/io/ByteArrayDataInput.html | 435 +---------- .../google/common/io/ByteArrayDataOutput.html | 318 +-------- .../api/docs/com/google/common/io/Closer.html | 2 +- .../google/common/io/CountingInputStream.html | 112 +-- .../common/io/CountingOutputStream.html | 60 +- .../common/io/FileBackedOutputStream.html | 104 +-- .../io/LittleEndianDataInputStream.html | 283 +------- .../io/LittleEndianDataOutputStream.html | 178 +---- .../common/io/PatternFilenameFilter.html | 12 +- .../com/google/common/math/PairedStats.html | 111 +-- .../docs/com/google/common/math/Stats.html | 111 +-- .../com/google/common/net/HostAndPort.html | 91 +-- .../com/google/common/net/HostSpecifier.html | 91 +-- .../google/common/net/InternetDomainName.html | 48 +- .../docs/com/google/common/net/MediaType.html | 91 +-- .../primitives/ImmutableDoubleArray.html | 15 - .../common/primitives/ImmutableIntArray.html | 15 - .../common/primitives/ImmutableLongArray.html | 15 - .../common/primitives/UnsignedInteger.html | 108 +-- .../common/primitives/UnsignedLong.html | 143 +--- .../reflect/AbstractInvocationHandler.html | 75 +- .../common/reflect/ClassPath.ClassInfo.html | 24 +- .../reflect/ClassPath.ResourceInfo.html | 113 +-- .../reflect/ImmutableTypeToInstanceMap.html | 19 +- .../com/google/common/reflect/Invokable.html | 225 +----- .../reflect/MutableTypeToInstanceMap.html | 32 +- .../com/google/common/reflect/Parameter.html | 256 +------ .../google/common/reflect/TypeParameter.html | 113 +-- .../common/reflect/TypeToInstanceMap.html | 2 +- .../com/google/common/reflect/TypeToken.html | 70 +- .../AbstractExecutionThreadService.html | 24 +- .../util/concurrent/AbstractFuture.html | 109 +-- .../util/concurrent/AbstractIdleService.html | 24 +- .../AbstractListeningExecutorService.html | 88 +-- .../concurrent/AbstractScheduledService.html | 24 +- .../util/concurrent/AbstractService.html | 24 +- .../common/util/concurrent/AtomicDouble.html | 12 - .../common/util/concurrent/AtomicLongMap.html | 24 +- .../common/util/concurrent/ClosingFuture.html | 76 +- ...ockFactory.PotentialDeadlockException.html | 3 - .../concurrent/ForwardingBlockingDeque.html | 268 +------ .../concurrent/ForwardingBlockingQueue.html | 120 +--- .../concurrent/ForwardingExecutorService.html | 244 +------ .../util/concurrent/ForwardingFuture.html | 84 +-- .../ForwardingListeningExecutorService.html | 55 +- .../util/concurrent/ListenableFutureTask.html | 21 +- .../concurrent/ListeningExecutorService.html | 109 +-- .../ListeningScheduledExecutorService.html | 109 +-- .../common/util/concurrent/RateLimiter.html | 24 +- .../util/concurrent/ServiceManager.html | 24 +- .../util/concurrent/SettableFuture.html | 81 +-- releases/snapshot-jre/api/docs/index-all.html | 106 +-- .../api/docs/member-search-index.zip | Bin 50334 -> 50334 bytes .../api/docs/package-search-index.zip | Bin 322 -> 322 bytes .../api/docs/type-search-index.zip | Bin 3351 -> 3351 bytes 350 files changed, 2938 insertions(+), 31858 deletions(-) diff --git a/releases/snapshot-android/api/docs/com/google/common/base/CharMatcher.html b/releases/snapshot-android/api/docs/com/google/common/base/CharMatcher.html index a31bc9238548..04cca12c03a5 100644 --- a/releases/snapshot-android/api/docs/com/google/common/base/CharMatcher.html +++ b/releases/snapshot-android/api/docs/com/google/common/base/CharMatcher.html @@ -1378,8 +1378,6 @@

toString

Overrides:
toString in class java.lang.Object
-
Returns:
-
a string representation of the object.
diff --git a/releases/snapshot-android/api/docs/com/google/common/base/Converter.html b/releases/snapshot-android/api/docs/com/google/common/base/Converter.html index cf56a253978d..b33d117f4d5e 100644 --- a/releases/snapshot-android/api/docs/com/google/common/base/Converter.html +++ b/releases/snapshot-android/api/docs/com/google/common/base/Converter.html @@ -546,14 +546,6 @@

equals

equals in interface Function<A,​B>
Overrides:
equals in class java.lang.Object
-
Parameters:
-
object - the reference object with which to compare.
-
Returns:
-
true if this object is the same as the obj - argument; false otherwise.
-
See Also:
-
Object.hashCode(), -HashMap
diff --git a/releases/snapshot-android/api/docs/com/google/common/base/Equivalence.Wrapper.html b/releases/snapshot-android/api/docs/com/google/common/base/Equivalence.Wrapper.html index daac1e289e35..807a4bfeb937 100644 --- a/releases/snapshot-android/api/docs/com/google/common/base/Equivalence.Wrapper.html +++ b/releases/snapshot-android/api/docs/com/google/common/base/Equivalence.Wrapper.html @@ -262,14 +262,6 @@

equals

Overrides:
equals in class java.lang.Object
-
Parameters:
-
obj - the reference object with which to compare.
-
Returns:
-
true if this object is the same as the obj - argument; false otherwise.
-
See Also:
-
Object.hashCode(), -HashMap
@@ -284,11 +276,6 @@

hashCode

Overrides:
hashCode in class java.lang.Object
-
Returns:
-
a hash code value for this object.
-
See Also:
-
Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
@@ -304,8 +291,6 @@

toString

Overrides:
toString in class java.lang.Object
-
Returns:
-
a string representation of the object.
diff --git a/releases/snapshot-android/api/docs/com/google/common/base/FinalizableReferenceQueue.html b/releases/snapshot-android/api/docs/com/google/common/base/FinalizableReferenceQueue.html index 521904780df1..f14a649f11a4 100644 --- a/releases/snapshot-android/api/docs/com/google/common/base/FinalizableReferenceQueue.html +++ b/releases/snapshot-android/api/docs/com/google/common/base/FinalizableReferenceQueue.html @@ -246,10 +246,7 @@

Method Summary

void close() - -
Closes this stream and releases any system resources associated - with it.
- +  diff --git a/releases/snapshot-android/api/docs/com/google/common/base/MoreObjects.ToStringHelper.html b/releases/snapshot-android/api/docs/com/google/common/base/MoreObjects.ToStringHelper.html index c0eae575f3e6..d30d955caa8f 100644 --- a/releases/snapshot-android/api/docs/com/google/common/base/MoreObjects.ToStringHelper.html +++ b/releases/snapshot-android/api/docs/com/google/common/base/MoreObjects.ToStringHelper.html @@ -576,8 +576,6 @@

toString

Overrides:
toString in class java.lang.Object
-
Returns:
-
a string representation of the object.
diff --git a/releases/snapshot-android/api/docs/com/google/common/base/Optional.html b/releases/snapshot-android/api/docs/com/google/common/base/Optional.html index 5e3746df5598..a2ff7000e6b8 100644 --- a/releases/snapshot-android/api/docs/com/google/common/base/Optional.html +++ b/releases/snapshot-android/api/docs/com/google/common/base/Optional.html @@ -596,14 +596,6 @@

equals

Overrides:
equals in class java.lang.Object
-
Parameters:
-
object - the reference object with which to compare.
-
Returns:
-
true if this object is the same as the obj - argument; false otherwise.
-
See Also:
-
Object.hashCode(), -HashMap
@@ -621,11 +613,6 @@

hashCode

Overrides:
hashCode in class java.lang.Object
-
Returns:
-
a hash code value for this object.
-
See Also:
-
Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
@@ -643,8 +630,6 @@

toString

Overrides:
toString in class java.lang.Object
-
Returns:
-
a string representation of the object.
diff --git a/releases/snapshot-android/api/docs/com/google/common/base/Predicate.html b/releases/snapshot-android/api/docs/com/google/common/base/Predicate.html index 42b3236d3e2b..fce3fff497f4 100644 --- a/releases/snapshot-android/api/docs/com/google/common/base/Predicate.html +++ b/releases/snapshot-android/api/docs/com/google/common/base/Predicate.html @@ -251,14 +251,6 @@

equals

Overrides:
equals in class java.lang.Object
-
Parameters:
-
object - the reference object with which to compare.
-
Returns:
-
true if this object is the same as the obj - argument; false otherwise.
-
See Also:
-
Object.hashCode(), -HashMap
diff --git a/releases/snapshot-android/api/docs/com/google/common/base/StandardSystemProperty.html b/releases/snapshot-android/api/docs/com/google/common/base/StandardSystemProperty.html index 228e3b947081..3a1239aee388 100644 --- a/releases/snapshot-android/api/docs/com/google/common/base/StandardSystemProperty.html +++ b/releases/snapshot-android/api/docs/com/google/common/base/StandardSystemProperty.html @@ -815,8 +815,6 @@

toString

Overrides:
toString in class java.lang.Enum<StandardSystemProperty>
-
Returns:
-
the name of this enum constant
diff --git a/releases/snapshot-android/api/docs/com/google/common/base/Stopwatch.html b/releases/snapshot-android/api/docs/com/google/common/base/Stopwatch.html index dfa6d69211cd..c9a794fe49a3 100644 --- a/releases/snapshot-android/api/docs/com/google/common/base/Stopwatch.html +++ b/releases/snapshot-android/api/docs/com/google/common/base/Stopwatch.html @@ -459,8 +459,6 @@

toString

Overrides:
toString in class java.lang.Object
-
Returns:
-
a string representation of the object.
diff --git a/releases/snapshot-android/api/docs/com/google/common/cache/CacheBuilder.html b/releases/snapshot-android/api/docs/com/google/common/cache/CacheBuilder.html index ff77a8dcada4..2589992ffd25 100644 --- a/releases/snapshot-android/api/docs/com/google/common/cache/CacheBuilder.html +++ b/releases/snapshot-android/api/docs/com/google/common/cache/CacheBuilder.html @@ -1005,8 +1005,6 @@

toString

Overrides:
toString in class java.lang.Object
-
Returns:
-
a string representation of the object.
diff --git a/releases/snapshot-android/api/docs/com/google/common/cache/CacheBuilderSpec.html b/releases/snapshot-android/api/docs/com/google/common/cache/CacheBuilderSpec.html index 6a375b01240b..2ebeed3d6d22 100644 --- a/releases/snapshot-android/api/docs/com/google/common/cache/CacheBuilderSpec.html +++ b/releases/snapshot-android/api/docs/com/google/common/cache/CacheBuilderSpec.html @@ -212,16 +212,12 @@

Method Summary

boolean equals​(java.lang.Object obj) - -
Indicates whether some other object is "equal to" this one.
- +  int hashCode() - -
Returns a hash code value for the object.
- +  static CacheBuilderSpec @@ -316,8 +312,6 @@

toString

Overrides:
toString in class java.lang.Object
-
Returns:
-
a string representation of the object.
@@ -328,43 +322,9 @@

toString

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -376,56 +336,9 @@

    hashCode

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object obj)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    diff --git a/releases/snapshot-android/api/docs/com/google/common/cache/CacheStats.html b/releases/snapshot-android/api/docs/com/google/common/cache/CacheStats.html index 1ba6a14c3adc..931bda30d45c 100644 --- a/releases/snapshot-android/api/docs/com/google/common/cache/CacheStats.html +++ b/releases/snapshot-android/api/docs/com/google/common/cache/CacheStats.html @@ -225,9 +225,7 @@

    Method Summary

    boolean equals​(java.lang.Object object) - -
    Indicates whether some other object is "equal to" this one.
    - +  long @@ -239,9 +237,7 @@

    Method Summary

    int hashCode() - -
    Returns a hash code value for the object.
    - +  long @@ -329,9 +325,7 @@

    Method Summary

    java.lang.String toString() - -
    Returns a string representation of the object.
    - +  long @@ -597,43 +591,9 @@

    plus

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -645,56 +605,9 @@

    hashCode

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object object)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -705,29 +618,9 @@

    equals

  • toString

    public java.lang.String toString()
    -
    Description copied from class: java.lang.Object
    -
    Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

    - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

    - 
    - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/AbstractIterator.html b/releases/snapshot-android/api/docs/com/google/common/collect/AbstractIterator.html index 108854d46515..3220b7c526c7 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/AbstractIterator.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/AbstractIterator.html @@ -243,16 +243,12 @@

    Method Summary

    boolean hasNext() - -
    Returns true if the iteration has more elements.
    - +  T next() - -
    Returns the next element in the iteration.
    - +  T @@ -379,14 +375,6 @@

    endOfData

  • hasNext

    public final boolean hasNext()
    -
    Description copied from interface: java.util.Iterator
    -
    Returns true if the iteration has more elements. - (In other words, returns true if Iterator.next() would - return an element rather than throwing an exception.)
    -
    -
    Returns:
    -
    true if the iteration has more elements
    -
    • @@ -397,12 +385,6 @@

    hasNext

    next

    @CanIgnoreReturnValue
 public final T next()
    -
    Description copied from interface: java.util.Iterator
    -
    Returns the next element in the iteration.
    -
    -
    Returns:
    -
    the next element in the iteration
    -
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/AbstractSequentialIterator.html b/releases/snapshot-android/api/docs/com/google/common/collect/AbstractSequentialIterator.html index 3a2d5d1cc120..b33db3c2ebc8 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/AbstractSequentialIterator.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/AbstractSequentialIterator.html @@ -221,16 +221,12 @@

    Method Summary

    boolean     hasNext() - -
    Returns true if the iteration has more elements.
    - +  T next() - -
    Returns the next element in the iteration.
    - +  @@ -333,12 +321,6 @@

    hasNext

  • next

    public final T next()
    -
    Description copied from interface: java.util.Iterator
    -
    Returns the next element in the iteration.
    -
    -
    Returns:
    -
    the next element in the iteration
    -
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ArrayListMultimap.html b/releases/snapshot-android/api/docs/com/google/common/collect/ArrayListMultimap.html index 927c9bbf3901..1975763aaeac 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ArrayListMultimap.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ArrayListMultimap.html @@ -636,14 +636,6 @@

    equals

    equals in interface ListMultimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Specified by:
    equals in interface Multimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -922,8 +914,6 @@

    hashCode

    hashCode in interface Multimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    See Also:
    Map.hashCode()
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ArrayTable.html b/releases/snapshot-android/api/docs/com/google/common/collect/ArrayTable.html index 24651bfac31f..1ce0bed5f24e 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ArrayTable.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ArrayTable.html @@ -334,7 +334,7 @@

    Method Summary

    boolean equals​(java.lang.Object obj) -
    Indicates whether some other object is "equal to" this one.
    +
    Compares the specified object with this table for equality.
    @@ -365,7 +365,7 @@

    Method Summary

    int hashCode() -
    Returns a hash code value for the object.
    +
    Returns the hash code for this table.
    @@ -1086,58 +1086,14 @@

    values

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object obj)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    +
    Description copied from interface: Table
    +
    Compares the specified object with this table for equality. Two tables are equal when their + cell views, as returned by Table.cellSet(), are equal.
    Specified by:
    equals in interface Table<R extends @Nullable java.lang.Object,​C extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -1148,45 +1104,14 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    +
    Description copied from interface: Table
    +
    Returns the hash code for this table. The hash code of a table is defined as the hash code of + its cell view, as returned by Table.cellSet().
    Specified by:
    hashCode in interface Table<R extends @Nullable java.lang.Object,​C extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -1201,8 +1126,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/BiMap.html b/releases/snapshot-android/api/docs/com/google/common/collect/BiMap.html index 741ba7ab1a76..db52d470149e 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/BiMap.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/BiMap.html @@ -164,7 +164,7 @@

    Nested Class Summary

    Nested classes/interfaces inherited from interface java.util.Map

    -java.util.Map.Entry<K,​V> +java.util.Map.Entry<K extends java.lang.Object,​V extends java.lang.Object> @@ -204,25 +204,14 @@

    Method Summary

    V put​(K key, V value) - -
    Associates the specified value with the specified key in this map - (optional operation).
    - void putAll​(java.util.Map<? extends K,​? extends V> map) - -
    Copies all of the mappings from the specified map to this map - (optional operation).
    - java.util.Set<V> values() - -
    Returns a Collection view of the values contained in this map.
    - diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ClassToInstanceMap.html b/releases/snapshot-android/api/docs/com/google/common/collect/ClassToInstanceMap.html index 4f78741c30ea..04eacaa2b178 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ClassToInstanceMap.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ClassToInstanceMap.html @@ -186,7 +186,7 @@

    Nested Class Summary

    Nested classes/interfaces inherited from interface java.util.Map

    -java.util.Map.Entry<K,​V> +java.util.Map.Entry<K extends java.lang.Object,​V extends java.lang.Object> diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ConcurrentHashMultiset.html b/releases/snapshot-android/api/docs/com/google/common/collect/ConcurrentHashMultiset.html index aa0b6cf2ce08..756cad19e8e4 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ConcurrentHashMultiset.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ConcurrentHashMultiset.html @@ -198,8 +198,7 @@

    Method Summary

    boolean add​(E element) -
    Ensures that this collection contains the specified element (optional - operation).
    +
    Adds a single occurrence of the specified element to this multiset.
    @@ -213,23 +212,17 @@

    Method Summary

    boolean addAll​(java.util.Collection<? extends E> elementsToAdd) - -
    Adds all of the elements in the specified collection to this collection - (optional operation).
    - void clear() - -
    Removes all of the elements from this collection (optional operation).
    - +  boolean contains​(java.lang.Object element) -
    Returns true if this collection contains the specified element.
    +
    Determines whether this multiset contains the specified element.
    @@ -291,36 +284,30 @@

    Method Summary

    boolean equals​(java.lang.Object object) -
    Indicates whether some other object is "equal to" this one.
    +
    Compares the specified object with this multiset for equality.
    int hashCode() -
    Returns a hash code value for the object.
    +
    Returns the hash code for this multiset.
    boolean isEmpty() - -
    Returns true if this collection contains no elements.
    - +  java.util.Iterator<E> iterator() - -
    Returns an iterator over the elements contained in this collection.
    - boolean remove​(java.lang.Object element) -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation).
    +
    Removes a single occurrence of the specified element from this multiset, if present.
    @@ -334,10 +321,6 @@

    Method Summary

    boolean removeAll​(java.util.Collection<?> elementsToRemove) - -
    Removes all of this collection's elements that are also contained in the - specified collection (optional operation).
    - boolean @@ -351,10 +334,6 @@

    Method Summary

    boolean retainAll​(java.util.Collection<?> elementsToRetain) - -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation).
    - int @@ -379,30 +358,22 @@

    Method Summary

    int size() -
    Returns the number of elements in this collection.
    +
    Returns the total number of all occurrences of all elements in this multiset.
    java.lang.Object[] toArray() - -
    Returns an array containing all of the elements in this collection.
    - +  <T extends @Nullable java.lang.Object>
    T[]     toArray​(T[] array) - -
    Returns an array containing all of the elements in this collection; - the runtime type of the returned array is that of the specified array.
    - +  java.lang.String toString() - -
    Returns a string representation of this collection.
    - @@ -561,24 +531,11 @@

    size

  • toArray

    public java.lang.Object[] toArray()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns an array containing all of the elements in this collection. - If this collection makes any guarantees as to what order its elements - are returned by its iterator, this method must return the elements in - the same order. The returned array's runtime component type is Object. - -

    The returned array will be "safe" in that no references to it are - maintained by this collection. (In other words, this method must - allocate a new array even if this collection is backed by an array). - The caller is thus free to modify the returned array.

    Specified by:
    toArray in interface java.util.Collection<E>
    Overrides:
    toArray in class java.util.AbstractCollection<E>
    -
    Returns:
    -
    an array, whose runtime component - type is Object, containing all of the elements in this collection
    • @@ -591,36 +548,11 @@

    toArray

  • toArray

    public <T extends @Nullable java.lang.Object> T[] toArray​(T[] array)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns an array containing all of the elements in this collection; - the runtime type of the returned array is that of the specified array. - If the collection fits in the specified array, it is returned therein. - Otherwise, a new array is allocated with the runtime type of the - specified array and the size of this collection. - -

    If this collection fits in the specified array with room to spare - (i.e., the array has more elements than this collection), the element - in the array immediately following the end of the collection is set to - null. (This is useful in determining the length of this - collection only if the caller knows that this collection does - not contain any null elements.) - -

    If this collection makes any guarantees as to what order its elements - are returned by its iterator, this method must return the elements in - the same order.

    Specified by:
    toArray in interface java.util.Collection<E>
    Overrides:
    toArray in class java.util.AbstractCollection<E>
    -
    Type Parameters:
    -
    T - the component type of the array to contain the collection
    -
    Parameters:
    -
    array - the array into which the elements of this collection are to be - stored, if it is big enough; otherwise, a new array of the same - runtime type is allocated for this purpose.
    -
    Returns:
    -
    an array containing all of the elements in this collection
    • @@ -780,13 +712,9 @@

    createEntrySet

  • isEmpty

    public boolean isEmpty()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains no elements.
    Specified by:
    isEmpty in interface java.util.Collection<E>
    -
    Returns:
    -
    true if this collection contains no elements
    • @@ -797,8 +725,11 @@

    isEmpty

  • iterator

    public java.util.Iterator<E> iterator()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns an iterator over the elements contained in this collection.
    +
    Description copied from interface: Multiset
    +
    + +

    Elements that occur multiple times in the multiset will appear multiple times in this + iterator, though not necessarily sequentially.

    Specified by:
    iterator in interface java.util.Collection<E>
    @@ -808,8 +739,6 @@

    iterator

    iterator in interface Multiset<E>
    Specified by:
    iterator in class java.util.AbstractCollection<E>
    -
    Returns:
    -
    an iterator over the elements contained in this collection
    • @@ -820,9 +749,6 @@

    iterator

  • clear

    public void clear()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes all of the elements from this collection (optional operation). - The collection will be empty after this method returns.
    Specified by:
    clear in interface java.util.Collection<E>
    @@ -837,11 +763,11 @@

    clear

    contains

    public boolean contains​(@CheckForNull
                         java.lang.Object element)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains the specified element. - More formally, returns true if and only if this collection - contains at least one element e such that - Objects.equals(o, e).
    +
    Description copied from interface: Multiset
    +
    Determines whether this multiset contains the specified element. + +

    This method refines Collection.contains(java.lang.Object) to further specify that it may not + throw an exception in response to element being null or of the wrong type.

    Specified by:
    contains in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -850,10 +776,9 @@

    contains

    Overrides:
    contains in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    Parameters:
    -
    element - element whose presence in this collection is to be tested
    +
    element - the element to check for
    Returns:
    -
    true if this collection contains the specified - element
    +
    true if this multiset contains at least one occurrence of the element
    • @@ -867,24 +792,14 @@

    contains

    add

    @CanIgnoreReturnValue
 public final boolean add​(E element)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Ensures that this collection contains the specified element (optional - operation). Returns true if this collection changed as a - result of the call. (Returns false if this collection does - not permit duplicates and already contains the specified element.)

    +

    Description copied from interface: Multiset
    +
    Adds a single occurrence of the specified element to this multiset. - Collections that support this operation may place limitations on what - elements may be added to this collection. In particular, some - collections will refuse to add null elements, and others will - impose restrictions on the type of elements that may be added. - Collection classes should clearly specify in their documentation any - restrictions on what elements may be added.

    +

    This method refines Collection.add(E), which only ensures the presence of the + element, to further specify that a successful call must always increment the count of the + element, and the overall size of the collection, by one. - If a collection refuses to add a particular element for any reason - other than that it already contains the element, it must throw - an exception (rather than returning false). This preserves - the invariant that a collection always contains the specified element - after this call returns.

    +

    To both add the element and obtain the previous count of that element, use add(element, 1) instead.

    Specified by:
    add in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -893,10 +808,11 @@

    add

    Overrides:
    add in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    Parameters:
    -
    element - element whose presence in this collection is to be ensured
    +
    element - the element to add one occurrence of; may be null only if explicitly allowed by + the implementation
    Returns:
    -
    true if this collection changed as a result of the - call
    +
    true always, since this call is required to modify the multiset, unlike other + Collection types
    @@ -909,14 +825,13 @@

    remove

    @CanIgnoreReturnValue
 public final boolean remove​(@CheckForNull
                             java.lang.Object element)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation). More formally, - removes an element e such that - Objects.equals(o, e), if - this collection contains one or more such elements. Returns - true if this collection contained the specified element (or - equivalently, if this collection changed as a result of the call).
    +
    Description copied from interface: Multiset
    +
    Removes a single occurrence of the specified element from this multiset, if present. + +

    This method refines Collection.remove(java.lang.Object) to further specify that it may not + throw an exception in response to element being null or of the wrong type. + +

    To both remove the element and obtain the previous count of that element, use remove(element, 1) instead.

    Specified by:
    remove in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -925,9 +840,9 @@

    remove

    Overrides:
    remove in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    Parameters:
    -
    element - element to be removed from this collection, if present
    +
    element - the element to remove one occurrence of
    Returns:
    -
    true if an element was removed as a result of this call
    +
    true if an occurrence was found and removed
    @@ -939,12 +854,7 @@

    remove

    addAll

    @CanIgnoreReturnValue
 public final boolean addAll​(java.util.Collection<? extends E> elementsToAdd)
    -
    Adds all of the elements in the specified collection to this collection - (optional operation). The behavior of this operation is undefined if - the specified collection is modified while the operation is in progress. - (This implies that the behavior of this call is undefined if the - specified collection is this collection, and this collection is - nonempty.) +

    This implementation is highly efficient when elementsToAdd is itself a Multiset.

    @@ -952,12 +862,6 @@

    addAll

    addAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    Overrides:
    addAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    elementsToAdd - collection containing elements to be added to this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    -
    See Also:
    -
    AbstractCollection.add(Object)
    @@ -969,11 +873,16 @@

    addAll

    removeAll

    @CanIgnoreReturnValue
 public final boolean removeAll​(java.util.Collection<?> elementsToRemove)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes all of this collection's elements that are also contained in the - specified collection (optional operation). After this call returns, - this collection will contain no elements in common with the specified - collection.
    +
    Description copied from interface: Multiset
    +
    + +

    Note: This method ignores how often any element might appear in c, and only + cares whether or not an element appears at all. If you wish to remove one occurrence in this + multiset for every occurrence in c, see Multisets.removeOccurrences(Multiset, + Multiset). + +

    This method refines Collection.removeAll(java.util.Collection<?>) to further specify that it may not + throw an exception in response to any of elements being null or of the wrong type.

    Specified by:
    removeAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -981,14 +890,6 @@

    removeAll

    removeAll in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    removeAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    elementsToRemove - collection containing elements to be removed from this collection
    -
    Returns:
    -
    true if this collection changed as a result of the - call
    -
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    @@ -1000,11 +901,16 @@

    removeAll

    retainAll

    @CanIgnoreReturnValue
 public final boolean retainAll​(java.util.Collection<?> elementsToRetain)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation). In other words, removes from - this collection all of its elements that are not contained in the - specified collection.
    +
    Description copied from interface: Multiset
    +
    + +

    Note: This method ignores how often any element might appear in c, and only + cares whether or not an element appears at all. If you wish to remove one occurrence in this + multiset for every occurrence in c, see Multisets.retainOccurrences(Multiset, + Multiset). + +

    This method refines Collection.retainAll(java.util.Collection<?>) to further specify that it may not + throw an exception in response to any of elements being null or of the wrong type.

    Specified by:
    retainAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -1012,13 +918,8 @@

    retainAll

    retainAll in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    retainAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    elementsToRetain - collection containing elements to be retained in this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    +
    Multisets.retainOccurrences(Multiset, Multiset)
    @@ -1084,44 +985,9 @@

    entrySet

    equals

    public final boolean equals​(@CheckForNull
                             java.lang.Object object)
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes. +

    Compares the specified object with this multiset for equality. Returns true if the + given object is also a multiset and contains equal elements with equal counts, regardless of + order.

    This implementation returns true if object is a multiset of the same size and if, for each element, the two multisets have the same count.

    @@ -1132,14 +998,6 @@

    equals

    equals in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -1150,34 +1008,14 @@

    equals

  • hashCode

    public final int hashCode()
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.) +

    Returns the hash code for this multiset. This is defined as the sum of + + 
    
+ ((element == null) ? 0 : element.hashCode()) ^ count(element)
+
    + +

    over all distinct elements in the multiset. It follows that a multiset and its entry set + always have the same hash code.

    This implementation returns the hash code of Multiset.entrySet().

    @@ -1187,11 +1025,6 @@

    hashCode

    hashCode in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -1202,12 +1035,11 @@

    hashCode

  • toString

    public final java.lang.String toString()
    -
    Returns a string representation of this collection. The string - representation consists of a list of the collection's elements in the - order they are returned by its iterator, enclosed in square brackets - ("[]"). Adjacent elements are separated by the characters - ", " (comma and space). Elements are converted to strings as - by String.valueOf(Object). +
    + +

    It is recommended, though not mandatory, that this method return the result of invoking + Multiset.toString() on the Multiset.entrySet(), yielding a result such as [a x 3, c, d x 2, + e].

    This implementation returns the result of invoking toString on Multiset.entrySet().

    @@ -1215,8 +1047,6 @@

    toString

    toString in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    toString in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a string representation of this collection
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ContiguousSet.html b/releases/snapshot-android/api/docs/com/google/common/collect/ContiguousSet.html index a7027f2c1d7c..841ec8f21e54 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ContiguousSet.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ContiguousSet.html @@ -294,19 +294,12 @@

    Method Summary

    ContiguousSet<C> headSet​(C toElement) - -
    Returns a view of the portion of this set whose elements are - strictly less than toElement.
    - ContiguousSet<C> headSet​(C toElement, boolean inclusive) - -
    Returns a view of the portion of this set whose elements are less than - (or equal to, if inclusive is true) toElement.
    - +  abstract ContiguousSet<C> @@ -409,37 +402,22 @@

    Method Summary

    boolean fromInclusive, C toElement, boolean toInclusive) - -
    Returns a view of the portion of this set whose elements range from - fromElement to toElement.
    - +  ContiguousSet<C> subSet​(C fromElement, C toElement) - -
    Returns a view of the portion of this set whose elements range - from fromElement, inclusive, to toElement, - exclusive.
    - ContiguousSet<C> tailSet​(C fromElement) - -
    Returns a view of the portion of this set whose elements are - greater than or equal to fromElement.
    - ContiguousSet<C> tailSet​(C fromElement, boolean inclusive) - -
    Returns a view of the portion of this set whose elements are greater - than (or equal to, if inclusive is true) fromElement.
    - +  java.lang.String @@ -636,16 +614,7 @@

    closedOpen

    headSet

    public ContiguousSet<C> headSet​(C toElement)
    Description copied from class: ImmutableSortedSet
    -
    Returns a view of the portion of this set whose elements are - strictly less than toElement. The returned set is - backed by this set, so changes in the returned set are - reflected in this set, and vice-versa. The returned set - supports all optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range. - -

    Equivalent to headSet(toElement, false). +

    This method returns a serializable ImmutableSortedSet. @@ -660,11 +629,6 @@

    headSet

    headSet in interface java.util.SortedSet<C extends java.lang.Comparable>
    Overrides:
    headSet in class ImmutableSortedSet<C extends java.lang.Comparable>
    -
    Parameters:
    -
    toElement - high endpoint (exclusive) of the returned set
    -
    Returns:
    -
    a view of the portion of this set whose elements are strictly - less than toElement
    @@ -679,27 +643,11 @@

    headSet

    @GwtIncompatible
 public ContiguousSet<C> headSet​(C toElement,
                                 boolean inclusive)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns a view of the portion of this set whose elements are less than - (or equal to, if inclusive is true) toElement. The - returned set is backed by this set, so changes in the returned set are - reflected in this set, and vice-versa. The returned set supports all - optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    headSet in interface java.util.NavigableSet<C extends java.lang.Comparable>
    Overrides:
    headSet in class ImmutableSortedSet<C extends java.lang.Comparable>
    -
    Parameters:
    -
    toElement - high endpoint of the returned set
    -
    inclusive - true if the high endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this set whose elements are less than - (or equal to, if inclusive is true) toElement
    Since:
    12.0
    @@ -716,18 +664,7 @@

    subSet

    public ContiguousSet<C> subSet​(C fromElement,
                                C toElement)
    Description copied from class: ImmutableSortedSet
    -
    Returns a view of the portion of this set whose elements range - from fromElement, inclusive, to toElement, - exclusive. (If fromElement and toElement are - equal, the returned set is empty.) The returned set is backed - by this set, so changes in the returned set are reflected in - this set, and vice-versa. The returned set supports all - optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range. - -

    Equivalent to subSet(fromElement, true, toElement, false). +

    This method returns a serializable ImmutableSortedSet. @@ -743,12 +680,6 @@

    subSet

    subSet in interface java.util.SortedSet<C extends java.lang.Comparable>
    Overrides:
    subSet in class ImmutableSortedSet<C extends java.lang.Comparable>
    -
    Parameters:
    -
    fromElement - low endpoint (inclusive) of the returned set
    -
    toElement - high endpoint (exclusive) of the returned set
    -
    Returns:
    -
    a view of the portion of this set whose elements range from - fromElement, inclusive, to toElement, exclusive
    @@ -765,32 +696,11 @@

    subSet

    boolean fromInclusive, C toElement, boolean toInclusive) -
    Description copied from interface: java.util.NavigableSet
    -
    Returns a view of the portion of this set whose elements range from - fromElement to toElement. If fromElement and - toElement are equal, the returned set is empty unless - fromInclusive and toInclusive are both true. The returned set - is backed by this set, so changes in the returned set are reflected in - this set, and vice-versa. The returned set supports all optional set - operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    subSet in interface java.util.NavigableSet<C extends java.lang.Comparable>
    Overrides:
    subSet in class ImmutableSortedSet<C extends java.lang.Comparable>
    -
    Parameters:
    -
    fromElement - low endpoint of the returned set
    -
    fromInclusive - true if the low endpoint - is to be included in the returned view
    -
    toElement - high endpoint of the returned set
    -
    toInclusive - true if the high endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this set whose elements range from - fromElement, inclusive, to toElement, exclusive
    Since:
    12.0
    @@ -806,16 +716,7 @@

    subSet

    tailSet

    public ContiguousSet<C> tailSet​(C fromElement)
    Description copied from class: ImmutableSortedSet
    -
    Returns a view of the portion of this set whose elements are - greater than or equal to fromElement. The returned - set is backed by this set, so changes in the returned set are - reflected in this set, and vice-versa. The returned set - supports all optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range. - -

    Equivalent to tailSet(fromElement, true). +

    This method returns a serializable ImmutableSortedSet. @@ -830,11 +731,6 @@

    tailSet

    tailSet in interface java.util.SortedSet<C extends java.lang.Comparable>
    Overrides:
    tailSet in class ImmutableSortedSet<C extends java.lang.Comparable>
    -
    Parameters:
    -
    fromElement - low endpoint (inclusive) of the returned set
    -
    Returns:
    -
    a view of the portion of this set whose elements are greater - than or equal to fromElement
    @@ -849,27 +745,11 @@

    tailSet

    @GwtIncompatible
 public ContiguousSet<C> tailSet​(C fromElement,
                                 boolean inclusive)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns a view of the portion of this set whose elements are greater - than (or equal to, if inclusive is true) fromElement. - The returned set is backed by this set, so changes in the returned set - are reflected in this set, and vice-versa. The returned set supports - all optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    tailSet in interface java.util.NavigableSet<C extends java.lang.Comparable>
    Overrides:
    tailSet in class ImmutableSortedSet<C extends java.lang.Comparable>
    -
    Parameters:
    -
    fromElement - low endpoint of the returned set
    -
    inclusive - true if the low endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this set whose elements are greater - than or equal to fromElement
    Since:
    12.0
    @@ -934,8 +814,6 @@

    toString

    Overrides:
    toString in class java.util.AbstractCollection<C extends java.lang.Comparable>
    -
    Returns:
    -
    a string representation of this collection
    @@ -995,12 +873,6 @@

    of

    element. Proper calls will resolve to the version in ImmutableSortedSet, not this dummy version.
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    element - the single element
    -
    Returns:
    -
    a Set containing the specified element
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -1024,13 +896,6 @@

    of

    element. Proper calls will resolve to the version in ImmutableSortedSet, not this dummy version.
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    Returns:
    -
    a Set containing the specified elements
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -1055,14 +920,6 @@

    of

    element. Proper calls will resolve to the version in ImmutableSortedSet, not this dummy version.
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    Returns:
    -
    a Set containing the specified elements
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -1088,15 +945,6 @@

    of

    element. Proper calls will resolve to the version in ImmutableSortedSet, not this dummy version.
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    e4 - the fourth element
    -
    Returns:
    -
    a Set containing the specified elements
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -1123,16 +971,6 @@

    of

    element. Proper calls will resolve to the version in ImmutableSortedSet, not this dummy version.
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    e4 - the fourth element
    -
    e5 - the fifth element
    -
    Returns:
    -
    a Set containing the specified elements
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -1162,18 +1000,6 @@

    of

    element. Proper calls will resolve to the version in ImmutableSortedSet, not this dummy version.
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    e4 - the fourth element
    -
    e5 - the fifth element
    -
    e6 - the sixth element
    -
    remaining - the seventh element
    -
    Returns:
    -
    a Set containing the specified elements
    Throws:
    java.lang.UnsupportedOperationException - always
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/EnumBiMap.html b/releases/snapshot-android/api/docs/com/google/common/collect/EnumBiMap.html index e93f825505d7..020614775089 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/EnumBiMap.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/EnumBiMap.html @@ -186,7 +186,7 @@

    Nested classes/interfaces inherited from class com.google.common.collec

    Nested classes/interfaces inherited from interface java.util.Map

    -java.util.Map.Entry<K,​V> +java.util.Map.Entry<K extends java.lang.Object,​V extends java.lang.Object> @@ -208,17 +208,12 @@

    Method Summary

    void clear() - -
    Removes all of the mappings from this map (optional operation).
    - +  boolean containsValue​(java.lang.Object value) - -
    Returns true if this map maps one or more keys to the - specified value.
    - +  static <K extends java.lang.Enum<K>,​V extends java.lang.Enum<V>>
    EnumBiMap<K,​V>     @@ -245,9 +240,7 @@

    Method Summary

    java.util.Set<java.util.Map.Entry<K,​V>> entrySet() - -
    Returns a Set view of the mappings contained in this map.
    - +  V @@ -269,9 +262,7 @@

    Method Summary

    java.util.Set<K> keySet() - -
    Returns a Set view of the keys contained in this map.
    - +  java.lang.Class<K> @@ -284,33 +275,19 @@

    Method Summary

    V put​(K key, V value) - -
    Associates the specified value with the specified key in this map - (optional operation).
    - void putAll​(java.util.Map<? extends K,​? extends V> map) - -
    Copies all of the mappings from the specified map to this map - (optional operation).
    - V remove​(java.lang.Object key) - -
    Removes the mapping for a key from this map if it is present - (optional operation).
    - +  java.util.Set<V> values() - -
    Returns a Collection view of the values contained in this map.
    - java.lang.Class<V> @@ -445,23 +422,11 @@

    delegate

    containsValue

    public boolean containsValue​(@CheckForNull
                              java.lang.Object value)
    -
    Description copied from interface: java.util.Map
    -
    Returns true if this map maps one or more keys to the - specified value. More formally, returns true if and only if - this map contains at least one mapping to a value v such that - Objects.equals(value, v). This operation - will probably require time linear in the map size for most - implementations of the Map interface.
    Specified by:
    containsValue in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    containsValue in class ForwardingMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    value - value whose presence in this map is to be tested
    -
    Returns:
    -
    true if this map maps one or more keys to the - specified value
    @@ -477,13 +442,7 @@

    put

    @CheckForNull public V put​(K key, V value) -
    Description copied from interface: java.util.Map
    -
    Associates the specified value with the specified key in this map - (optional operation). If the map previously contained a mapping for - the key, the old value is replaced by the specified value. (A map - m is said to contain a mapping for a key k if and only - if m.containsKey(k) would return - true.)
    +
    Description copied from interface: BiMap
    Specified by:
    put in interface BiMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    @@ -491,15 +450,6 @@

    put

    put in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    put in class ForwardingMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - key with which the specified value is to be associated
    -
    value - value to be associated with the specified key
    -
    Returns:
    -
    the previous value associated with key, or - null if there was no mapping for key. - (A null return can also indicate that the map - previously associated null with key, - if the implementation supports null values.)
    @@ -549,33 +499,11 @@

    remove

    @CheckForNull public V remove​(@CheckForNull java.lang.Object key) -
    Description copied from interface: java.util.Map
    -
    Removes the mapping for a key from this map if it is present - (optional operation). More formally, if this map contains a mapping - from key k to value v such that - Objects.equals(key, k), that mapping - is removed. (The map can contain at most one such mapping.) - -

    Returns the value to which this map previously associated the key, - or null if the map contained no mapping for the key. - -

    If this map permits null values, then a return value of - null does not necessarily indicate that the map - contained no mapping for the key; it's also possible that the map - explicitly mapped the key to null. - -

    The map will not contain a mapping for the specified key once the - call returns.

    Specified by:
    remove in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    remove in class ForwardingMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - key whose mapping is to be removed from the map
    -
    Returns:
    -
    the previous value associated with key, or - null if there was no mapping for key.
    @@ -586,13 +514,11 @@

    remove

  • putAll

    public void putAll​(java.util.Map<? extends K,​? extends V> map)
    -
    Description copied from interface: java.util.Map
    -
    Copies all of the mappings from the specified map to this map - (optional operation). The effect of this call is equivalent to that - of calling put(k, v) on this map once - for each mapping from key k to value v in the - specified map. The behavior of this operation is undefined if the - specified map is modified while the operation is in progress.
    +
    Description copied from interface: BiMap
    +
    + +

    Warning: the results of calling this method may vary depending on the iteration order + of map.

    Specified by:
    putAll in interface BiMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    @@ -600,8 +526,6 @@

    putAll

    putAll in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    putAll in class ForwardingMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    map - mappings to be stored in this map
    • @@ -612,9 +536,6 @@

    putAll

  • clear

    public void clear()
    -
    Description copied from interface: java.util.Map
    -
    Removes all of the mappings from this map (optional operation). - The map will be empty after this call returns.
    Specified by:
    clear in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    @@ -652,25 +573,11 @@

    inverse

  • keySet

    public java.util.Set<K> keySet()
    -
    Description copied from interface: java.util.Map
    -
    Returns a Set view of the keys contained in this map. - The set is backed by the map, so changes to the map are - reflected in the set, and vice-versa. If the map is modified - while an iteration over the set is in progress (except through - the iterator's own remove operation), the results of - the iteration are undefined. The set supports element removal, - which removes the corresponding mapping from the map, via the - Iterator.remove, Set.remove, - removeAll, retainAll, and clear - operations. It does not support the add or addAll - operations.
    Specified by:
    keySet in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    keySet in class ForwardingMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a set view of the keys contained in this map
    • @@ -681,18 +588,10 @@

    keySet

  • values

    public java.util.Set<V> values()
    -
    Description copied from interface: java.util.Map
    -
    Returns a Collection view of the values contained in this map. - The collection is backed by the map, so changes to the map are - reflected in the collection, and vice-versa. If the map is - modified while an iteration over the collection is in progress - (except through the iterator's own remove operation), - the results of the iteration are undefined. The collection - supports element removal, which removes the corresponding - mapping from the map, via the Iterator.remove, - Collection.remove, removeAll, - retainAll and clear operations. It does not - support the add or addAll operations.
    +
    Description copied from interface: BiMap
    +
    + +

    Because a bimap has unique values, this method returns a Set, instead of the Collection specified in the Map interface.

    Specified by:
    values in interface BiMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    @@ -700,8 +599,6 @@

    values

    values in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    values in class ForwardingMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a collection view of the values contained in this map
    • @@ -712,26 +609,11 @@

    values

  • entrySet

    public java.util.Set<java.util.Map.Entry<K,​V>> entrySet()
    -
    Description copied from interface: java.util.Map
    -
    Returns a Set view of the mappings contained in this map. - The set is backed by the map, so changes to the map are - reflected in the set, and vice-versa. If the map is modified - while an iteration over the set is in progress (except through - the iterator's own remove operation, or through the - setValue operation on a map entry returned by the - iterator) the results of the iteration are undefined. The set - supports element removal, which removes the corresponding - mapping from the map, via the Iterator.remove, - Set.remove, removeAll, retainAll and - clear operations. It does not support the - add or addAll operations.
    Specified by:
    entrySet in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    entrySet in class ForwardingMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a set view of the mappings contained in this map
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/EnumHashBiMap.html b/releases/snapshot-android/api/docs/com/google/common/collect/EnumHashBiMap.html index 37b3a1b9b3e1..aa1fba5ba630 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/EnumHashBiMap.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/EnumHashBiMap.html @@ -187,7 +187,7 @@

    Nested classes/interfaces inherited from class com.google.common.collec

    Nested classes/interfaces inherited from interface java.util.Map

    -java.util.Map.Entry<K,​V>
    • +java.util.Map.Entry<K extends java.lang.Object,​V extends java.lang.Object> @@ -209,17 +209,12 @@

    Method Summary

    void clear() - -
    Removes all of the mappings from this map (optional operation).
    - +  boolean containsValue​(java.lang.Object value) - -
    Returns true if this map maps one or more keys to the - specified value.
    - +  static <K extends java.lang.Enum<K>,​V extends @Nullable java.lang.Object>
    EnumHashBiMap<K,​V>     @@ -245,9 +240,7 @@

    Method Summary

    java.util.Set<java.util.Map.Entry<K,​V>> entrySet() - -
    Returns a Set view of the mappings contained in this map.
    - +  V @@ -269,9 +262,7 @@

    Method Summary

    java.util.Set<K> keySet() - -
    Returns a Set view of the keys contained in this map.
    - +  java.lang.Class<K> @@ -284,33 +275,19 @@

    Method Summary

    V put​(K key, V value) - -
    Associates the specified value with the specified key in this map - (optional operation).
    - void putAll​(java.util.Map<? extends K,​? extends V> map) - -
    Copies all of the mappings from the specified map to this map - (optional operation).
    - V remove​(java.lang.Object key) - -
    Removes the mapping for a key from this map if it is present - (optional operation).
    - +  java.util.Set<V> values() - -
    Returns a Collection view of the values contained in this map.
    -
      @@ -403,27 +380,12 @@

      put

      @CheckForNull public V put​(K key, V value) -
      Description copied from interface: java.util.Map
      -
      Associates the specified value with the specified key in this map - (optional operation). If the map previously contained a mapping for - the key, the old value is replaced by the specified value. (A map - m is said to contain a mapping for a key k if and only - if m.containsKey(k) would return - true.)
      +
      Description copied from interface: BiMap
      Specified by:
      put in interface BiMap<K extends java.lang.Enum<K>,​V extends @Nullable java.lang.Object>
      Specified by:
      put in interface java.util.Map<K extends java.lang.Enum<K>,​V extends @Nullable java.lang.Object>
      -
      Parameters:
      -
      key - key with which the specified value is to be associated
      -
      value - value to be associated with the specified key
      -
      Returns:
      -
      the previous value associated with key, or - null if there was no mapping for key. - (A null return can also indicate that the map - previously associated null with key, - if the implementation supports null values.)
    @@ -499,23 +461,11 @@

    delegate

    containsValue

    public boolean containsValue​(@CheckForNull
                              java.lang.Object value)
    -
    Description copied from interface: java.util.Map
    -
    Returns true if this map maps one or more keys to the - specified value. More formally, returns true if and only if - this map contains at least one mapping to a value v such that - Objects.equals(value, v). This operation - will probably require time linear in the map size for most - implementations of the Map interface.
    Specified by:
    containsValue in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    containsValue in class ForwardingMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    value - value whose presence in this map is to be tested
    -
    Returns:
    -
    true if this map maps one or more keys to the - specified value
    @@ -529,33 +479,11 @@

    remove

    @CheckForNull public V remove​(@CheckForNull java.lang.Object key) -
    Description copied from interface: java.util.Map
    -
    Removes the mapping for a key from this map if it is present - (optional operation). More formally, if this map contains a mapping - from key k to value v such that - Objects.equals(key, k), that mapping - is removed. (The map can contain at most one such mapping.) - -

    Returns the value to which this map previously associated the key, - or null if the map contained no mapping for the key. - -

    If this map permits null values, then a return value of - null does not necessarily indicate that the map - contained no mapping for the key; it's also possible that the map - explicitly mapped the key to null. - -

    The map will not contain a mapping for the specified key once the - call returns.

    Specified by:
    remove in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    remove in class ForwardingMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - key whose mapping is to be removed from the map
    -
    Returns:
    -
    the previous value associated with key, or - null if there was no mapping for key.
    @@ -566,13 +494,11 @@

    remove

  • putAll

    public void putAll​(java.util.Map<? extends K,​? extends V> map)
    -
    Description copied from interface: java.util.Map
    -
    Copies all of the mappings from the specified map to this map - (optional operation). The effect of this call is equivalent to that - of calling put(k, v) on this map once - for each mapping from key k to value v in the - specified map. The behavior of this operation is undefined if the - specified map is modified while the operation is in progress.
    +
    Description copied from interface: BiMap
    +
    + +

    Warning: the results of calling this method may vary depending on the iteration order + of map.

    Specified by:
    putAll in interface BiMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    @@ -580,8 +506,6 @@

    putAll

    putAll in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    putAll in class ForwardingMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    map - mappings to be stored in this map
    • @@ -592,9 +516,6 @@

    putAll

  • clear

    public void clear()
    -
    Description copied from interface: java.util.Map
    -
    Removes all of the mappings from this map (optional operation). - The map will be empty after this call returns.
    Specified by:
    clear in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    @@ -632,25 +553,11 @@

    inverse

  • keySet

    public java.util.Set<K> keySet()
    -
    Description copied from interface: java.util.Map
    -
    Returns a Set view of the keys contained in this map. - The set is backed by the map, so changes to the map are - reflected in the set, and vice-versa. If the map is modified - while an iteration over the set is in progress (except through - the iterator's own remove operation), the results of - the iteration are undefined. The set supports element removal, - which removes the corresponding mapping from the map, via the - Iterator.remove, Set.remove, - removeAll, retainAll, and clear - operations. It does not support the add or addAll - operations.
    Specified by:
    keySet in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    keySet in class ForwardingMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a set view of the keys contained in this map
    • @@ -661,18 +568,10 @@

    keySet

  • values

    public java.util.Set<V> values()
    -
    Description copied from interface: java.util.Map
    -
    Returns a Collection view of the values contained in this map. - The collection is backed by the map, so changes to the map are - reflected in the collection, and vice-versa. If the map is - modified while an iteration over the collection is in progress - (except through the iterator's own remove operation), - the results of the iteration are undefined. The collection - supports element removal, which removes the corresponding - mapping from the map, via the Iterator.remove, - Collection.remove, removeAll, - retainAll and clear operations. It does not - support the add or addAll operations.
    +
    Description copied from interface: BiMap
    +
    + +

    Because a bimap has unique values, this method returns a Set, instead of the Collection specified in the Map interface.

    Specified by:
    values in interface BiMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    @@ -680,8 +579,6 @@

    values

    values in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    values in class ForwardingMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a collection view of the values contained in this map
    • @@ -692,26 +589,11 @@

    values

  • entrySet

    public java.util.Set<java.util.Map.Entry<K,​V>> entrySet()
    -
    Description copied from interface: java.util.Map
    -
    Returns a Set view of the mappings contained in this map. - The set is backed by the map, so changes to the map are - reflected in the set, and vice-versa. If the map is modified - while an iteration over the set is in progress (except through - the iterator's own remove operation, or through the - setValue operation on a map entry returned by the - iterator) the results of the iteration are undefined. The set - supports element removal, which removes the corresponding - mapping from the map, via the Iterator.remove, - Set.remove, removeAll, retainAll and - clear operations. It does not support the - add or addAll operations.
    Specified by:
    entrySet in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    entrySet in class ForwardingMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a set view of the mappings contained in this map
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/EnumMultiset.html b/releases/snapshot-android/api/docs/com/google/common/collect/EnumMultiset.html index 8b2c7524db32..708b668bfc49 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/EnumMultiset.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/EnumMultiset.html @@ -198,8 +198,7 @@

    Method Summary

    boolean add​(E element) -
    Ensures that this collection contains the specified element (optional - operation).
    +
    Adds a single occurrence of the specified element to this multiset.
    @@ -213,23 +212,17 @@

    Method Summary

    boolean addAll​(java.util.Collection<? extends E> elementsToAdd) - -
    Adds all of the elements in the specified collection to this collection - (optional operation).
    - void clear() - -
    Removes all of the elements from this collection (optional operation).
    - +  boolean contains​(java.lang.Object element) -
    Returns true if this collection contains the specified element.
    +
    Determines whether this multiset contains the specified element.
    @@ -281,36 +274,30 @@

    Method Summary

    boolean equals​(java.lang.Object object) -
    Indicates whether some other object is "equal to" this one.
    +
    Compares the specified object with this multiset for equality.
    int hashCode() -
    Returns a hash code value for the object.
    +
    Returns the hash code for this multiset.
    boolean isEmpty() - -
    Returns true if this collection contains no elements.
    - +  java.util.Iterator<E> iterator() - -
    Returns an iterator over the elements contained in this collection.
    - boolean remove​(java.lang.Object element) -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation).
    +
    Removes a single occurrence of the specified element from this multiset, if present.
    @@ -324,18 +311,10 @@

    Method Summary

    boolean removeAll​(java.util.Collection<?> elementsToRemove) - -
    Removes all of this collection's elements that are also contained in the - specified collection (optional operation).
    - boolean retainAll​(java.util.Collection<?> elementsToRetain) - -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation).
    - int @@ -359,15 +338,12 @@

    Method Summary

    int size() -
    Returns the number of elements in this collection.
    +
    Returns the total number of all occurrences of all elements in this multiset.
    java.lang.String toString() - -
    Returns a string representation of this collection.
    -
      @@ -471,10 +447,11 @@

      create

    • size

      public int size()
      -
      Description copied from interface: java.util.Collection
      -
      Returns the number of elements in this collection. If this collection - contains more than Integer.MAX_VALUE elements, returns - Integer.MAX_VALUE.
      +
      Description copied from interface: Multiset
      +
      Returns the total number of all occurrences of all elements in this multiset. + +

      Note: this method does not return the number of distinct elements in the + multiset, which is given by entrySet().size().

      Specified by:
      size in interface java.util.Collection<E extends java.lang.Enum<E>>
      @@ -482,8 +459,6 @@

      size

      size in interface Multiset<E extends java.lang.Enum<E>>
      Specified by:
      size in class java.util.AbstractCollection<E extends java.lang.Enum<E>>
      -
      Returns:
      -
      the number of elements in this collection
    @@ -604,9 +579,6 @@

    setCount

  • clear

    public void clear()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes all of the elements from this collection (optional operation). - The collection will be empty after this method returns.
    Specified by:
    clear in interface java.util.Collection<E extends java.lang.Enum<E>>
    @@ -620,8 +592,11 @@

    clear

  • iterator

    public java.util.Iterator<E> iterator()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns an iterator over the elements contained in this collection.
    +
    Description copied from interface: Multiset
    +
    + +

    Elements that occur multiple times in the multiset will appear multiple times in this + iterator, though not necessarily sequentially.

    Specified by:
    iterator in interface java.util.Collection<E extends java.lang.Enum<E>>
    @@ -631,8 +606,6 @@

    iterator

    iterator in interface Multiset<E extends java.lang.Enum<E>>
    Specified by:
    iterator in class java.util.AbstractCollection<E extends java.lang.Enum<E>>
    -
    Returns:
    -
    an iterator over the elements contained in this collection
    • @@ -643,15 +616,11 @@

    iterator

  • isEmpty

    public boolean isEmpty()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains no elements.
    Specified by:
    isEmpty in interface java.util.Collection<E extends @Nullable java.lang.Object>
    Overrides:
    isEmpty in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    true if this collection contains no elements
    • @@ -663,11 +632,11 @@

    isEmpty

    contains

    public boolean contains​(@CheckForNull
                         java.lang.Object element)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains the specified element. - More formally, returns true if and only if this collection - contains at least one element e such that - Objects.equals(o, e).
    +
    Description copied from interface: Multiset
    +
    Determines whether this multiset contains the specified element. + +

    This method refines Collection.contains(java.lang.Object) to further specify that it may not + throw an exception in response to element being null or of the wrong type.

    Specified by:
    contains in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -676,10 +645,9 @@

    contains

    Overrides:
    contains in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    Parameters:
    -
    element - element whose presence in this collection is to be tested
    +
    element - the element to check for
    Returns:
    -
    true if this collection contains the specified - element
    +
    true if this multiset contains at least one occurrence of the element
    • @@ -693,24 +661,14 @@

    contains

    add

    @CanIgnoreReturnValue
 public final boolean add​(E element)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Ensures that this collection contains the specified element (optional - operation). Returns true if this collection changed as a - result of the call. (Returns false if this collection does - not permit duplicates and already contains the specified element.)

    +

    Description copied from interface: Multiset
    +
    Adds a single occurrence of the specified element to this multiset. - Collections that support this operation may place limitations on what - elements may be added to this collection. In particular, some - collections will refuse to add null elements, and others will - impose restrictions on the type of elements that may be added. - Collection classes should clearly specify in their documentation any - restrictions on what elements may be added.

    +

    This method refines Collection.add(E), which only ensures the presence of the + element, to further specify that a successful call must always increment the count of the + element, and the overall size of the collection, by one. - If a collection refuses to add a particular element for any reason - other than that it already contains the element, it must throw - an exception (rather than returning false). This preserves - the invariant that a collection always contains the specified element - after this call returns.

    +

    To both add the element and obtain the previous count of that element, use add(element, 1) instead.

    Specified by:
    add in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -719,10 +677,11 @@

    add

    Overrides:
    add in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    Parameters:
    -
    element - element whose presence in this collection is to be ensured
    +
    element - the element to add one occurrence of; may be null only if explicitly allowed by + the implementation
    Returns:
    -
    true if this collection changed as a result of the - call
    +
    true always, since this call is required to modify the multiset, unlike other + Collection types
    • @@ -735,14 +694,13 @@

    remove

    @CanIgnoreReturnValue
 public final boolean remove​(@CheckForNull
                             java.lang.Object element)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation). More formally, - removes an element e such that - Objects.equals(o, e), if - this collection contains one or more such elements. Returns - true if this collection contained the specified element (or - equivalently, if this collection changed as a result of the call).
    +
    Description copied from interface: Multiset
    +
    Removes a single occurrence of the specified element from this multiset, if present. + +

    This method refines Collection.remove(java.lang.Object) to further specify that it may not + throw an exception in response to element being null or of the wrong type. + +

    To both remove the element and obtain the previous count of that element, use remove(element, 1) instead.

    Specified by:
    remove in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -751,9 +709,9 @@

    remove

    Overrides:
    remove in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    Parameters:
    -
    element - element to be removed from this collection, if present
    +
    element - the element to remove one occurrence of
    Returns:
    -
    true if an element was removed as a result of this call
    +
    true if an occurrence was found and removed
    @@ -794,12 +752,7 @@

    setCount

    addAll

    @CanIgnoreReturnValue
 public final boolean addAll​(java.util.Collection<? extends E> elementsToAdd)
    -
    Adds all of the elements in the specified collection to this collection - (optional operation). The behavior of this operation is undefined if - the specified collection is modified while the operation is in progress. - (This implies that the behavior of this call is undefined if the - specified collection is this collection, and this collection is - nonempty.) +

    This implementation is highly efficient when elementsToAdd is itself a Multiset.

    @@ -807,12 +760,6 @@

    addAll

    addAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    Overrides:
    addAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    elementsToAdd - collection containing elements to be added to this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    -
    See Also:
    -
    AbstractCollection.add(Object)
    @@ -824,11 +771,16 @@

    addAll

    removeAll

    @CanIgnoreReturnValue
 public final boolean removeAll​(java.util.Collection<?> elementsToRemove)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes all of this collection's elements that are also contained in the - specified collection (optional operation). After this call returns, - this collection will contain no elements in common with the specified - collection.
    +
    Description copied from interface: Multiset
    +
    + +

    Note: This method ignores how often any element might appear in c, and only + cares whether or not an element appears at all. If you wish to remove one occurrence in this + multiset for every occurrence in c, see Multisets.removeOccurrences(Multiset, + Multiset). + +

    This method refines Collection.removeAll(java.util.Collection<?>) to further specify that it may not + throw an exception in response to any of elements being null or of the wrong type.

    Specified by:
    removeAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -836,14 +788,6 @@

    removeAll

    removeAll in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    removeAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    elementsToRemove - collection containing elements to be removed from this collection
    -
    Returns:
    -
    true if this collection changed as a result of the - call
    -
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    @@ -855,11 +799,16 @@

    removeAll

    retainAll

    @CanIgnoreReturnValue
 public final boolean retainAll​(java.util.Collection<?> elementsToRetain)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation). In other words, removes from - this collection all of its elements that are not contained in the - specified collection.
    +
    Description copied from interface: Multiset
    +
    + +

    Note: This method ignores how often any element might appear in c, and only + cares whether or not an element appears at all. If you wish to remove one occurrence in this + multiset for every occurrence in c, see Multisets.retainOccurrences(Multiset, + Multiset). + +

    This method refines Collection.retainAll(java.util.Collection<?>) to further specify that it may not + throw an exception in response to any of elements being null or of the wrong type.

    Specified by:
    retainAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -867,13 +816,8 @@

    retainAll

    retainAll in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    retainAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    elementsToRetain - collection containing elements to be retained in this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    +
    Multisets.retainOccurrences(Multiset, Multiset)
    @@ -939,44 +883,9 @@

    entrySet

    equals

    public final boolean equals​(@CheckForNull
                             java.lang.Object object)
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes. +

    Compares the specified object with this multiset for equality. Returns true if the + given object is also a multiset and contains equal elements with equal counts, regardless of + order.

    This implementation returns true if object is a multiset of the same size and if, for each element, the two multisets have the same count.

    @@ -987,14 +896,6 @@

    equals

    equals in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -1005,34 +906,14 @@

    equals

  • hashCode

    public final int hashCode()
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.) +

    Returns the hash code for this multiset. This is defined as the sum of + + 
    
+ ((element == null) ? 0 : element.hashCode()) ^ count(element)
+
    + +

    over all distinct elements in the multiset. It follows that a multiset and its entry set + always have the same hash code.

    This implementation returns the hash code of Multiset.entrySet().

    @@ -1042,11 +923,6 @@

    hashCode

    hashCode in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -1057,12 +933,11 @@

    hashCode

  • toString

    public final java.lang.String toString()
    -
    Returns a string representation of this collection. The string - representation consists of a list of the collection's elements in the - order they are returned by its iterator, enclosed in square brackets - ("[]"). Adjacent elements are separated by the characters - ", " (comma and space). Elements are converted to strings as - by String.valueOf(Object). +
    + +

    It is recommended, though not mandatory, that this method return the result of invoking + Multiset.toString() on the Multiset.entrySet(), yielding a result such as [a x 3, c, d x 2, + e].

    This implementation returns the result of invoking toString on Multiset.entrySet().

    @@ -1070,8 +945,6 @@

    toString

    toString in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    toString in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a string representation of this collection
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/EvictingQueue.html b/releases/snapshot-android/api/docs/com/google/common/collect/EvictingQueue.html index cc483e26244d..18904ec3afa4 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/EvictingQueue.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/EvictingQueue.html @@ -204,10 +204,7 @@

    Method Summary

    boolean addAll​(java.util.Collection<? extends E> collection) - -
    Adds all of the elements in the specified collection to this collection - (optional operation).
    - +  static <E> EvictingQueue<E> @@ -241,9 +238,7 @@

    Method Summary

    java.lang.Object[] toArray() - -
    Returns an array containing all of the elements in this collection.
    - + 
      @@ -367,8 +362,6 @@

      offer

      offer in interface java.util.Queue<E>
      Overrides:
      offer in class ForwardingQueue<E>
      -
      Parameters:
      -
      e - the element to add
      Returns:
      true always
      @@ -393,8 +386,6 @@

      add

      add in interface java.util.Queue<E>
      Overrides:
      add in class ForwardingCollection<E>
      -
      Parameters:
      -
      e - element whose presence in this collection is to be ensured
      Returns:
      true always
      @@ -408,24 +399,11 @@

      add

      addAll

      @CanIgnoreReturnValue
 public boolean addAll​(java.util.Collection<? extends E> collection)
      -
      Description copied from interface: java.util.Collection
      -
      Adds all of the elements in the specified collection to this collection - (optional operation). The behavior of this operation is undefined if - the specified collection is modified while the operation is in progress. - (This implies that the behavior of this call is undefined if the - specified collection is this collection, and this collection is - nonempty.)
      Specified by:
      addAll in interface java.util.Collection<E>
      Overrides:
      addAll in class ForwardingCollection<E>
      -
      Parameters:
      -
      collection - collection containing elements to be added to this collection
      -
      Returns:
      -
      true if this collection changed as a result of the call
      -
      See Also:
      -
      Collection.add(Object)
    @@ -436,24 +414,11 @@

    addAll

  • toArray

    public java.lang.Object[] toArray()
    -
    Description copied from interface: java.util.Collection
    -
    Returns an array containing all of the elements in this collection. - If this collection makes any guarantees as to what order its elements - are returned by its iterator, this method must return the elements in - the same order. The returned array's runtime component type is Object. - -

    The returned array will be "safe" in that no references to it are - maintained by this collection. (In other words, this method must - allocate a new array even if this collection is backed by an array). - The caller is thus free to modify the returned array.

    Specified by:
    toArray in interface java.util.Collection<E>
    Overrides:
    toArray in class ForwardingCollection<E>
    -
    Returns:
    -
    an array, whose runtime component - type is Object, containing all of the elements in this collection
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/FluentIterable.html b/releases/snapshot-android/api/docs/com/google/common/collect/FluentIterable.html index b09a966c52df..37ac21fa26d9 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/FluentIterable.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/FluentIterable.html @@ -848,8 +848,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingBlockingDeque.html b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingBlockingDeque.html index 73ff14186314..af6061148544 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingBlockingDeque.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingBlockingDeque.html @@ -245,9 +245,7 @@

    Method Summary

    drainTo​(java.util.Collection<? super E> c)
    Deprecated.
    -
    Removes all available elements from this queue and adds them - to the given collection.
    - +  int @@ -255,9 +253,7 @@

    Method Summary

    int maxElements)
    Deprecated.
    -
    Removes at most the given number of available elements from - this queue and adds them to the given collection.
    - +  boolean @@ -266,10 +262,7 @@

    Method Summary

    java.util.concurrent.TimeUnit unit)
    Deprecated.
    -
    Inserts the specified element into the queue represented by this deque - (in other words, at the tail of this deque), waiting up to the - specified wait time if necessary for space to become available.
    - +  boolean @@ -278,10 +271,7 @@

    Method Summary

    java.util.concurrent.TimeUnit unit)
    Deprecated.
    -
    Inserts the specified element at the front of this deque, - waiting up to the specified wait time if necessary for space to - become available.
    - +  boolean @@ -290,10 +280,7 @@

    Method Summary

    java.util.concurrent.TimeUnit unit)
    Deprecated.
    -
    Inserts the specified element at the end of this deque, - waiting up to the specified wait time if necessary for space to - become available.
    - +  E @@ -301,10 +288,7 @@

    Method Summary

    java.util.concurrent.TimeUnit unit)
    Deprecated.
    -
    Retrieves and removes the head of the queue represented by this deque - (in other words, the first element of this deque), waiting up to the - specified wait time if necessary for an element to become available.
    - +  E @@ -312,10 +296,7 @@

    Method Summary

    java.util.concurrent.TimeUnit unit)
    Deprecated.
    -
    Retrieves and removes the first element of this deque, waiting - up to the specified wait time if necessary for an element to - become available.
    - +  E @@ -323,77 +304,56 @@

    Method Summary

    java.util.concurrent.TimeUnit unit)
    Deprecated.
    -
    Retrieves and removes the last element of this deque, waiting - up to the specified wait time if necessary for an element to - become available.
    - +  void put​(E e)
    Deprecated.
    -
    Inserts the specified element into the queue represented by this deque - (in other words, at the tail of this deque), waiting if necessary for - space to become available.
    - +  void putFirst​(E e)
    Deprecated.
    -
    Inserts the specified element at the front of this deque, - waiting if necessary for space to become available.
    - +  void putLast​(E e)
    Deprecated.
    -
    Inserts the specified element at the end of this deque, - waiting if necessary for space to become available.
    - +  int remainingCapacity()
    Deprecated.
    -
    Returns the number of additional elements that this queue can ideally - (in the absence of memory or resource constraints) accept without - blocking, or Integer.MAX_VALUE if there is no intrinsic - limit.
    - +  E take()
    Deprecated.
    -
    Retrieves and removes the head of the queue represented by this deque - (in other words, the first element of this deque), waiting if - necessary until an element becomes available.
    - +  E takeFirst()
    Deprecated.
    -
    Retrieves and removes the first element of this deque, waiting - if necessary until an element becomes available.
    - +  E takeLast()
    Deprecated.
    -
    Retrieves and removes the last element of this deque, waiting - if necessary until an element becomes available.
    - + 
      @@ -523,21 +483,9 @@

      delegate

      remainingCapacity

      public int remainingCapacity()
      Deprecated.
      -
      Description copied from interface: java.util.concurrent.BlockingQueue
      -
      Returns the number of additional elements that this queue can ideally - (in the absence of memory or resource constraints) accept without - blocking, or Integer.MAX_VALUE if there is no intrinsic - limit. - -

      Note that you cannot always tell if an attempt to insert - an element will succeed by inspecting remainingCapacity - because it may be the case that another thread is about to - insert or remove an element.

      Specified by:
      remainingCapacity in interface java.util.concurrent.BlockingQueue<E>
      -
      Returns:
      -
      the remaining capacity
    @@ -552,16 +500,11 @@

    putFirst

    public void putFirst​(E e)
               throws java.lang.InterruptedException
    Deprecated.
    -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Inserts the specified element at the front of this deque, - waiting if necessary for space to become available.
    Specified by:
    putFirst in interface java.util.concurrent.BlockingDeque<E>
    -
    Parameters:
    -
    e - the element to add
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -576,16 +519,11 @@

    putLast

    public void putLast​(E e)
              throws java.lang.InterruptedException
    Deprecated.
    -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Inserts the specified element at the end of this deque, - waiting if necessary for space to become available.
    Specified by:
    putLast in interface java.util.concurrent.BlockingDeque<E>
    -
    Parameters:
    -
    e - the element to add
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -602,24 +540,11 @@

    offerFirst

    java.util.concurrent.TimeUnit unit) throws java.lang.InterruptedException
    Deprecated.
    -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Inserts the specified element at the front of this deque, - waiting up to the specified wait time if necessary for space to - become available.
    Specified by:
    offerFirst in interface java.util.concurrent.BlockingDeque<E>
    -
    Parameters:
    -
    e - the element to add
    -
    timeout - how long to wait before giving up, in units of - unit
    -
    unit - a TimeUnit determining how to interpret the - timeout parameter
    -
    Returns:
    -
    true if successful, or false if - the specified waiting time elapses before space is available
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -636,24 +561,11 @@

    offerLast

    java.util.concurrent.TimeUnit unit) throws java.lang.InterruptedException
    Deprecated.
    -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Inserts the specified element at the end of this deque, - waiting up to the specified wait time if necessary for space to - become available.
    Specified by:
    offerLast in interface java.util.concurrent.BlockingDeque<E>
    -
    Parameters:
    -
    e - the element to add
    -
    timeout - how long to wait before giving up, in units of - unit
    -
    unit - a TimeUnit determining how to interpret the - timeout parameter
    -
    Returns:
    -
    true if successful, or false if - the specified waiting time elapses before space is available
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -666,16 +578,11 @@

    takeFirst

    public E takeFirst()
             throws java.lang.InterruptedException
    Deprecated.
    -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Retrieves and removes the first element of this deque, waiting - if necessary until an element becomes available.
    Specified by:
    takeFirst in interface java.util.concurrent.BlockingDeque<E>
    -
    Returns:
    -
    the head of this deque
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -688,16 +595,11 @@

    takeLast

    public E takeLast()
            throws java.lang.InterruptedException
    Deprecated.
    -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Retrieves and removes the last element of this deque, waiting - if necessary until an element becomes available.
    Specified by:
    takeLast in interface java.util.concurrent.BlockingDeque<E>
    -
    Returns:
    -
    the tail of this deque
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -712,23 +614,11 @@

    pollFirst

    java.util.concurrent.TimeUnit unit) throws java.lang.InterruptedException
    Deprecated.
    -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Retrieves and removes the first element of this deque, waiting - up to the specified wait time if necessary for an element to - become available.
    Specified by:
    pollFirst in interface java.util.concurrent.BlockingDeque<E>
    -
    Parameters:
    -
    timeout - how long to wait before giving up, in units of - unit
    -
    unit - a TimeUnit determining how to interpret the - timeout parameter
    -
    Returns:
    -
    the head of this deque, or null if the specified - waiting time elapses before an element is available
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -743,23 +633,11 @@

    pollLast

    java.util.concurrent.TimeUnit unit) throws java.lang.InterruptedException
    Deprecated.
    -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Retrieves and removes the last element of this deque, waiting - up to the specified wait time if necessary for an element to - become available.
    Specified by:
    pollLast in interface java.util.concurrent.BlockingDeque<E>
    -
    Parameters:
    -
    timeout - how long to wait before giving up, in units of - unit
    -
    unit - a TimeUnit determining how to interpret the - timeout parameter
    -
    Returns:
    -
    the tail of this deque, or null if the specified - waiting time elapses before an element is available
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -774,21 +652,13 @@

    put

    public void put​(E e)
          throws java.lang.InterruptedException
    Deprecated.
    -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Inserts the specified element into the queue represented by this deque - (in other words, at the tail of this deque), waiting if necessary for - space to become available. - -

    This method is equivalent to putLast.

    Specified by:
    put in interface java.util.concurrent.BlockingDeque<E>
    Specified by:
    put in interface java.util.concurrent.BlockingQueue<E>
    -
    Parameters:
    -
    e - the element to add
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -805,29 +675,13 @@

    offer

    java.util.concurrent.TimeUnit unit) throws java.lang.InterruptedException
    Deprecated.
    -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Inserts the specified element into the queue represented by this deque - (in other words, at the tail of this deque), waiting up to the - specified wait time if necessary for space to become available. - -

    This method is equivalent to - offerLast.

    Specified by:
    offer in interface java.util.concurrent.BlockingDeque<E>
    Specified by:
    offer in interface java.util.concurrent.BlockingQueue<E>
    -
    Parameters:
    -
    e - the element to add
    -
    timeout - how long to wait before giving up, in units of - unit
    -
    unit - a TimeUnit determining how to interpret the - timeout parameter
    -
    Returns:
    -
    true if the element was added to this deque, else - false
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -840,21 +694,13 @@

    take

    public E take()
        throws java.lang.InterruptedException
    Deprecated.
    -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Retrieves and removes the head of the queue represented by this deque - (in other words, the first element of this deque), waiting if - necessary until an element becomes available. - -

    This method is equivalent to takeFirst.

    Specified by:
    take in interface java.util.concurrent.BlockingDeque<E>
    Specified by:
    take in interface java.util.concurrent.BlockingQueue<E>
    -
    Returns:
    -
    the head of this deque
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -869,28 +715,13 @@

    poll

    java.util.concurrent.TimeUnit unit) throws java.lang.InterruptedException
    Deprecated.
    -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Retrieves and removes the head of the queue represented by this deque - (in other words, the first element of this deque), waiting up to the - specified wait time if necessary for an element to become available. - -

    This method is equivalent to - pollFirst.

    Specified by:
    poll in interface java.util.concurrent.BlockingDeque<E>
    Specified by:
    poll in interface java.util.concurrent.BlockingQueue<E>
    -
    Parameters:
    -
    timeout - how long to wait before giving up, in units of - unit
    -
    unit - a TimeUnit determining how to interpret the - timeout parameter
    -
    Returns:
    -
    the head of this deque, or null if the - specified waiting time elapses before an element is available
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -902,24 +733,9 @@

    poll

    drainTo

    public int drainTo​(java.util.Collection<? super E> c)
    Deprecated.
    -
    Description copied from interface: java.util.concurrent.BlockingQueue
    -
    Removes all available elements from this queue and adds them - to the given collection. This operation may be more - efficient than repeatedly polling this queue. A failure - encountered while attempting to add elements to - collection c may result in elements being in neither, - either or both collections when the associated exception is - thrown. Attempts to drain a queue to itself result in - IllegalArgumentException. Further, the behavior of - this operation is undefined if the specified collection is - modified while the operation is in progress.
    Specified by:
    drainTo in interface java.util.concurrent.BlockingQueue<E>
    -
    Parameters:
    -
    c - the collection to transfer elements into
    -
    Returns:
    -
    the number of elements transferred
    @@ -932,24 +748,9 @@

    drainTo

    public int drainTo​(java.util.Collection<? super E> c,
                    int maxElements)
    Deprecated.
    -
    Description copied from interface: java.util.concurrent.BlockingQueue
    -
    Removes at most the given number of available elements from - this queue and adds them to the given collection. A failure - encountered while attempting to add elements to - collection c may result in elements being in neither, - either or both collections when the associated exception is - thrown. Attempts to drain a queue to itself result in - IllegalArgumentException. Further, the behavior of - this operation is undefined if the specified collection is - modified while the operation is in progress.
    Specified by:
    drainTo in interface java.util.concurrent.BlockingQueue<E>
    -
    Parameters:
    -
    c - the collection to transfer elements into
    -
    maxElements - the maximum number of elements to transfer
    -
    Returns:
    -
    the number of elements transferred
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingCollection.html b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingCollection.html index 36c1e3329d20..d15fe2a9b630 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingCollection.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingCollection.html @@ -219,40 +219,27 @@

    Method Summary

    boolean add​(E element) - -
    Ensures that this collection contains the specified element (optional - operation).
    - +  boolean addAll​(java.util.Collection<? extends E> collection) - -
    Adds all of the elements in the specified collection to this collection - (optional operation).
    - +  void clear() - -
    Removes all of the elements from this collection (optional operation).
    - +  boolean contains​(java.lang.Object object) - -
    Returns true if this collection contains the specified element.
    - +  boolean containsAll​(java.util.Collection<?> collection) - -
    Returns true if this collection contains all of the elements - in the specified collection.
    - +  protected abstract java.util.Collection<E> @@ -264,47 +251,32 @@

    Method Summary

    boolean isEmpty() - -
    Returns true if this collection contains no elements.
    - +  java.util.Iterator<E> iterator() - -
    Returns an iterator over the elements in this collection.
    - +  boolean remove​(java.lang.Object object) - -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation).
    - +  boolean removeAll​(java.util.Collection<?> collection) - -
    Removes all of this collection's elements that are also contained in the - specified collection (optional operation).
    - +  boolean retainAll​(java.util.Collection<?> collection) - -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation).
    - +  int size() - -
    Returns the number of elements in this collection.
    - +  protected boolean @@ -390,17 +362,12 @@

    Method Summary

    @Nullable java.lang.Object[] toArray() - -
    Returns an array containing all of the elements in this collection.
    - +  <T extends @Nullable java.lang.Object>
    T[]     toArray​(T[] array) - -
    Returns an array containing all of the elements in this collection; - the runtime type of the returned array is that of the specified array.
    - + 
      @@ -492,18 +459,11 @@

      delegate

    • iterator

      public java.util.Iterator<E> iterator()
      -
      Description copied from interface: java.util.Collection
      -
      Returns an iterator over the elements in this collection. There are no - guarantees concerning the order in which the elements are returned - (unless this collection is an instance of some class that provides a - guarantee).
      Specified by:
      iterator in interface java.util.Collection<E extends @Nullable java.lang.Object>
      Specified by:
      iterator in interface java.lang.Iterable<E extends @Nullable java.lang.Object>
      -
      Returns:
      -
      an Iterator over the elements in this collection
    @@ -514,15 +474,9 @@

    iterator

  • size

    public int size()
    -
    Description copied from interface: java.util.Collection
    -
    Returns the number of elements in this collection. If this collection - contains more than Integer.MAX_VALUE elements, returns - Integer.MAX_VALUE.
    Specified by:
    size in interface java.util.Collection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the number of elements in this collection
    • @@ -534,22 +488,9 @@

    size

    removeAll

    @CanIgnoreReturnValue
 public boolean removeAll​(java.util.Collection<?> collection)
    -
    Description copied from interface: java.util.Collection
    -
    Removes all of this collection's elements that are also contained in the - specified collection (optional operation). After this call returns, - this collection will contain no elements in common with the specified - collection.
    Specified by:
    removeAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    collection - collection containing elements to be removed from this collection
    -
    Returns:
    -
    true if this collection changed as a result of the - call
    -
    See Also:
    -
    Collection.remove(Object), -Collection.contains(Object)
    @@ -560,13 +501,9 @@

    removeAll

  • isEmpty

    public boolean isEmpty()
    -
    Description copied from interface: java.util.Collection
    -
    Returns true if this collection contains no elements.
    Specified by:
    isEmpty in interface java.util.Collection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    true if this collection contains no elements
    • @@ -578,19 +515,9 @@

    isEmpty

    contains

    public boolean contains​(@CheckForNull
                         java.lang.Object object)
    -
    Description copied from interface: java.util.Collection
    -
    Returns true if this collection contains the specified element. - More formally, returns true if and only if this collection - contains at least one element e such that - Objects.equals(o, e).
    Specified by:
    contains in interface java.util.Collection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    object - element whose presence in this collection is to be tested
    -
    Returns:
    -
    true if this collection contains the specified - element
    @@ -604,32 +531,9 @@

    contains

    add

    @CanIgnoreReturnValue
 public boolean add​(E element)
    -
    Description copied from interface: java.util.Collection
    -
    Ensures that this collection contains the specified element (optional - operation). Returns true if this collection changed as a - result of the call. (Returns false if this collection does - not permit duplicates and already contains the specified element.)

    - - Collections that support this operation may place limitations on what - elements may be added to this collection. In particular, some - collections will refuse to add null elements, and others will - impose restrictions on the type of elements that may be added. - Collection classes should clearly specify in their documentation any - restrictions on what elements may be added.

    - - If a collection refuses to add a particular element for any reason - other than that it already contains the element, it must throw - an exception (rather than returning false). This preserves - the invariant that a collection always contains the specified element - after this call returns.

    Specified by:
    add in interface java.util.Collection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    element - element whose presence in this collection is to be ensured
    -
    Returns:
    -
    true if this collection changed as a result of the - call
    @@ -642,21 +546,9 @@

    remove

    @CanIgnoreReturnValue
 public boolean remove​(@CheckForNull
                       java.lang.Object object)
    -
    Description copied from interface: java.util.Collection
    -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation). More formally, - removes an element e such that - Objects.equals(o, e), if - this collection contains one or more such elements. Returns - true if this collection contained the specified element (or - equivalently, if this collection changed as a result of the call).
    Specified by:
    remove in interface java.util.Collection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    object - element to be removed from this collection, if present
    -
    Returns:
    -
    true if an element was removed as a result of this call
    @@ -667,19 +559,9 @@

    remove

  • containsAll

    public boolean containsAll​(java.util.Collection<?> collection)
    -
    Description copied from interface: java.util.Collection
    -
    Returns true if this collection contains all of the elements - in the specified collection.
    Specified by:
    containsAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    collection - collection to be checked for containment in this collection
    -
    Returns:
    -
    true if this collection contains all of the elements - in the specified collection
    -
    See Also:
    -
    Collection.contains(Object)
    • @@ -691,22 +573,9 @@

    containsAll

    addAll

    @CanIgnoreReturnValue
 public boolean addAll​(java.util.Collection<? extends E> collection)
    -
    Description copied from interface: java.util.Collection
    -
    Adds all of the elements in the specified collection to this collection - (optional operation). The behavior of this operation is undefined if - the specified collection is modified while the operation is in progress. - (This implies that the behavior of this call is undefined if the - specified collection is this collection, and this collection is - nonempty.)
    Specified by:
    addAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    collection - collection containing elements to be added to this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    -
    See Also:
    -
    Collection.add(Object)
    @@ -718,21 +587,9 @@

    addAll

    retainAll

    @CanIgnoreReturnValue
 public boolean retainAll​(java.util.Collection<?> collection)
    -
    Description copied from interface: java.util.Collection
    -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation). In other words, removes from - this collection all of its elements that are not contained in the - specified collection.
    Specified by:
    retainAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    collection - collection containing elements to be retained in this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    -
    See Also:
    -
    Collection.remove(Object), -Collection.contains(Object)
    @@ -743,9 +600,6 @@

    retainAll

  • clear

    public void clear()
    -
    Description copied from interface: java.util.Collection
    -
    Removes all of the elements from this collection (optional operation). - The collection will be empty after this method returns.
    Specified by:
    clear in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -759,22 +613,9 @@

    clear

  • toArray

    public @Nullable java.lang.Object[] toArray()
    -
    Description copied from interface: java.util.Collection
    -
    Returns an array containing all of the elements in this collection. - If this collection makes any guarantees as to what order its elements - are returned by its iterator, this method must return the elements in - the same order. The returned array's runtime component type is Object. - -

    The returned array will be "safe" in that no references to it are - maintained by this collection. (In other words, this method must - allocate a new array even if this collection is backed by an array). - The caller is thus free to modify the returned array.

    Specified by:
    toArray in interface java.util.Collection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    an array, whose runtime component - type is Object, containing all of the elements in this collection
    • @@ -788,34 +629,9 @@

    toArray

    toArray

    @CanIgnoreReturnValue
 public <T extends @Nullable java.lang.Object> T[] toArray​(T[] array)
    -
    Description copied from interface: java.util.Collection
    -
    Returns an array containing all of the elements in this collection; - the runtime type of the returned array is that of the specified array. - If the collection fits in the specified array, it is returned therein. - Otherwise, a new array is allocated with the runtime type of the - specified array and the size of this collection. - -

    If this collection fits in the specified array with room to spare - (i.e., the array has more elements than this collection), the element - in the array immediately following the end of the collection is set to - null. (This is useful in determining the length of this - collection only if the caller knows that this collection does - not contain any null elements.) - -

    If this collection makes any guarantees as to what order its elements - are returned by its iterator, this method must return the elements in - the same order.

    Specified by:
    toArray in interface java.util.Collection<E extends @Nullable java.lang.Object>
    -
    Type Parameters:
    -
    T - the component type of the array to contain the collection
    -
    Parameters:
    -
    array - the array into which the elements of this collection are to be - stored, if it is big enough; otherwise, a new array of the same - runtime type is allocated for this purpose.
    -
    Returns:
    -
    an array containing all of the elements in this collection
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingConcurrentMap.html b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingConcurrentMap.html index 1b97820396b8..9cb2f7aedc83 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingConcurrentMap.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingConcurrentMap.html @@ -189,7 +189,7 @@

    Nested classes/interfaces inherited from class com.google.common.collec

    Nested classes/interfaces inherited from interface java.util.Map

    -java.util.Map.Entry<K,​V> +java.util.Map.Entry<K extends java.lang.Object,​V extends java.lang.Object> @@ -244,35 +244,26 @@

    Method Summary

    V putIfAbsent​(K key, V value) - -
    If the specified key is not already associated - with a value, associates it with the given value.
    - +  boolean remove​(java.lang.Object key, java.lang.Object value) - -
    Removes the entry for a key only if currently mapped to a given value.
    - +  V replace​(K key, V value) - -
    Replaces the entry for a key only if currently mapped to some value.
    - +  boolean replace​(K key, V oldValue, V newValue) - -
    Replaces the entry for a key only if currently mapped to a given value.
    - + 
      @@ -376,31 +367,11 @@

      putIfAbsent

      @CheckForNull public V putIfAbsent​(K key, V value) -
      Description copied from interface: java.util.concurrent.ConcurrentMap
      -
      If the specified key is not already associated - with a value, associates it with the given value. - This is equivalent to, for this map: - 
       
- if (!map.containsKey(key))
-   return map.put(key, value);
- else
-   return map.get(key);
      - - except that the action is performed atomically.
      Specified by:
      putIfAbsent in interface java.util.concurrent.ConcurrentMap<K,​V>
      Specified by:
      putIfAbsent in interface java.util.Map<K,​V>
      -
      Parameters:
      -
      key - key with which the specified value is to be associated
      -
      value - value to be associated with the specified key
      -
      Returns:
      -
      the previous value associated with the specified key, or - null if there was no mapping for the key. - (A null return can also indicate that the map - previously associated null with the key, - if the implementation supports null values.)
    @@ -415,29 +386,11 @@

    remove

    java.lang.Object key, @CheckForNull java.lang.Object value) -
    Description copied from interface: java.util.concurrent.ConcurrentMap
    -
    Removes the entry for a key only if currently mapped to a given value. - This is equivalent to, for this map: - 
     
- if (map.containsKey(key)
-     && Objects.equals(map.get(key), value)) {
-   map.remove(key);
-   return true;
- } else {
-   return false;
- }
    - - except that the action is performed atomically.
    Specified by:
    remove in interface java.util.concurrent.ConcurrentMap<K,​V>
    Specified by:
    remove in interface java.util.Map<K,​V>
    -
    Parameters:
    -
    key - key with which the specified value is associated
    -
    value - value expected to be associated with the specified key
    -
    Returns:
    -
    true if the value was removed
    @@ -453,30 +406,11 @@

    replace

    @CheckForNull public V replace​(K key, V value) -
    Description copied from interface: java.util.concurrent.ConcurrentMap
    -
    Replaces the entry for a key only if currently mapped to some value. - This is equivalent to, for this map: - 
     
- if (map.containsKey(key))
-   return map.put(key, value);
- else
-   return null;
    - - except that the action is performed atomically.
    Specified by:
    replace in interface java.util.concurrent.ConcurrentMap<K,​V>
    Specified by:
    replace in interface java.util.Map<K,​V>
    -
    Parameters:
    -
    key - key with which the specified value is associated
    -
    value - value to be associated with the specified key
    -
    Returns:
    -
    the previous value associated with the specified key, or - null if there was no mapping for the key. - (A null return can also indicate that the map - previously associated null with the key, - if the implementation supports null values.)
    @@ -492,30 +426,11 @@

    replace

    public boolean replace​(K key, V oldValue, V newValue) -
    Description copied from interface: java.util.concurrent.ConcurrentMap
    -
    Replaces the entry for a key only if currently mapped to a given value. - This is equivalent to, for this map: - 
     
- if (map.containsKey(key)
-     && Objects.equals(map.get(key), oldValue)) {
-   map.put(key, newValue);
-   return true;
- } else {
-   return false;
- }
    - - except that the action is performed atomically.
    Specified by:
    replace in interface java.util.concurrent.ConcurrentMap<K,​V>
    Specified by:
    replace in interface java.util.Map<K,​V>
    -
    Parameters:
    -
    key - key with which the specified value is associated
    -
    oldValue - value expected to be associated with the specified key
    -
    newValue - value to be associated with the specified key
    -
    Returns:
    -
    true if the value was replaced
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingDeque.html b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingDeque.html index 5675315d0168..2889851013af 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingDeque.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingDeque.html @@ -224,22 +224,12 @@

    Method Summary

    void addFirst​(E e) - -
    Inserts the specified element at the front of this deque if it is - possible to do so immediately without violating capacity restrictions, - throwing an IllegalStateException if no space is currently - available.
    - +  void addLast​(E e) - -
    Inserts the specified element at the end of this deque if it is - possible to do so immediately without violating capacity restrictions, - throwing an IllegalStateException if no space is currently - available.
    - +  protected abstract java.util.Deque<E> @@ -251,117 +241,77 @@

    Method Summary

    java.util.Iterator<E> descendingIterator() - -
    Returns an iterator over the elements in this deque in reverse - sequential order.
    - +  E getFirst() - -
    Retrieves, but does not remove, the first element of this deque.
    - +  E getLast() - -
    Retrieves, but does not remove, the last element of this deque.
    - +  boolean offerFirst​(E e) - -
    Inserts the specified element at the front of this deque unless it would - violate capacity restrictions.
    - +  boolean offerLast​(E e) - -
    Inserts the specified element at the end of this deque unless it would - violate capacity restrictions.
    - +  E peekFirst() - -
    Retrieves, but does not remove, the first element of this deque, - or returns null if this deque is empty.
    - +  E peekLast() - -
    Retrieves, but does not remove, the last element of this deque, - or returns null if this deque is empty.
    - +  E pollFirst() - -
    Retrieves and removes the first element of this deque, - or returns null if this deque is empty.
    - +  E pollLast() - -
    Retrieves and removes the last element of this deque, - or returns null if this deque is empty.
    - +  E pop() - -
    Pops an element from the stack represented by this deque.
    - +  void push​(E e) - -
    Pushes an element onto the stack represented by this deque (in other - words, at the head of this deque) if it is possible to do so - immediately without violating capacity restrictions, throwing an - IllegalStateException if no space is currently available.
    - +  E removeFirst() - -
    Retrieves and removes the first element of this deque.
    - +  boolean removeFirstOccurrence​(java.lang.Object o) - -
    Removes the first occurrence of the specified element from this deque.
    - +  E removeLast() - -
    Retrieves and removes the last element of this deque.
    - +  boolean removeLastOccurrence​(java.lang.Object o) - -
    Removes the last occurrence of the specified element from this deque.
    - + 
      @@ -476,17 +426,9 @@

      delegate

    • addFirst

      public void addFirst​(E e)
      -
      Description copied from interface: java.util.Deque
      -
      Inserts the specified element at the front of this deque if it is - possible to do so immediately without violating capacity restrictions, - throwing an IllegalStateException if no space is currently - available. When using a capacity-restricted deque, it is generally - preferable to use method Deque.offerFirst(E).
      Specified by:
      addFirst in interface java.util.Deque<E extends @Nullable java.lang.Object>
      -
      Parameters:
      -
      e - the element to add
    @@ -499,19 +441,9 @@

    addFirst

  • addLast

    public void addLast​(E e)
    -
    Description copied from interface: java.util.Deque
    -
    Inserts the specified element at the end of this deque if it is - possible to do so immediately without violating capacity restrictions, - throwing an IllegalStateException if no space is currently - available. When using a capacity-restricted deque, it is generally - preferable to use method Deque.offerLast(E). - -

    This method is equivalent to Deque.add(E).

    Specified by:
    addLast in interface java.util.Deque<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    e - the element to add
    • @@ -522,16 +454,9 @@

    addLast

  • descendingIterator

    public java.util.Iterator<E> descendingIterator()
    -
    Description copied from interface: java.util.Deque
    -
    Returns an iterator over the elements in this deque in reverse - sequential order. The elements will be returned in order from - last (tail) to first (head).
    Specified by:
    descendingIterator in interface java.util.Deque<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    an iterator over the elements in this deque in reverse - sequence
    • @@ -542,16 +467,9 @@

    descendingIterator

  • getFirst

    public E getFirst()
    -
    Description copied from interface: java.util.Deque
    -
    Retrieves, but does not remove, the first element of this deque. - - This method differs from peekFirst only in that it - throws an exception if this deque is empty.
    Specified by:
    getFirst in interface java.util.Deque<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the head of this deque
    • @@ -562,15 +480,9 @@

    getFirst

  • getLast

    public E getLast()
    -
    Description copied from interface: java.util.Deque
    -
    Retrieves, but does not remove, the last element of this deque. - This method differs from peekLast only in that it - throws an exception if this deque is empty.
    Specified by:
    getLast in interface java.util.Deque<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the tail of this deque
    • @@ -584,19 +496,9 @@

    getLast

    offerFirst

    @CanIgnoreReturnValue
 public boolean offerFirst​(E e)
    -
    Description copied from interface: java.util.Deque
    -
    Inserts the specified element at the front of this deque unless it would - violate capacity restrictions. When using a capacity-restricted deque, - this method is generally preferable to the Deque.addFirst(E) method, - which can fail to insert an element only by throwing an exception.
    Specified by:
    offerFirst in interface java.util.Deque<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    e - the element to add
    -
    Returns:
    -
    true if the element was added to this deque, else - false
    @@ -610,19 +512,9 @@

    offerFirst

    offerLast

    @CanIgnoreReturnValue
 public boolean offerLast​(E e)
    -
    Description copied from interface: java.util.Deque
    -
    Inserts the specified element at the end of this deque unless it would - violate capacity restrictions. When using a capacity-restricted deque, - this method is generally preferable to the Deque.addLast(E) method, - which can fail to insert an element only by throwing an exception.
    Specified by:
    offerLast in interface java.util.Deque<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    e - the element to add
    -
    Returns:
    -
    true if the element was added to this deque, else - false
    @@ -634,14 +526,9 @@

    offerLast

    peekFirst

    @CheckForNull
 public E peekFirst()
    -
    Description copied from interface: java.util.Deque
    -
    Retrieves, but does not remove, the first element of this deque, - or returns null if this deque is empty.
    Specified by:
    peekFirst in interface java.util.Deque<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the head of this deque, or null if this deque is empty
    @@ -653,14 +540,9 @@

    peekFirst

    peekLast

    @CheckForNull
 public E peekLast()
    -
    Description copied from interface: java.util.Deque
    -
    Retrieves, but does not remove, the last element of this deque, - or returns null if this deque is empty.
    Specified by:
    peekLast in interface java.util.Deque<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the tail of this deque, or null if this deque is empty
    @@ -673,14 +555,9 @@

    pollFirst

    @CanIgnoreReturnValue
 @CheckForNull
 public E pollFirst()
    -
    Description copied from interface: java.util.Deque
    -
    Retrieves and removes the first element of this deque, - or returns null if this deque is empty.
    Specified by:
    pollFirst in interface java.util.Deque<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the head of this deque, or null if this deque is empty
    @@ -693,14 +570,9 @@

    pollLast

    @CanIgnoreReturnValue
 @CheckForNull
 public E pollLast()
    -
    Description copied from interface: java.util.Deque
    -
    Retrieves and removes the last element of this deque, - or returns null if this deque is empty.
    Specified by:
    pollLast in interface java.util.Deque<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the tail of this deque, or null if this deque is empty
    @@ -712,17 +584,9 @@

    pollLast

    pop

    @CanIgnoreReturnValue
 public E pop()
    -
    Description copied from interface: java.util.Deque
    -
    Pops an element from the stack represented by this deque. In other - words, removes and returns the first element of this deque. - -

    This method is equivalent to Deque.removeFirst().

    Specified by:
    pop in interface java.util.Deque<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the element at the front of this deque (which is the top - of the stack represented by this deque)
    @@ -735,18 +599,9 @@

    pop

  • push

    public void push​(E e)
    -
    Description copied from interface: java.util.Deque
    -
    Pushes an element onto the stack represented by this deque (in other - words, at the head of this deque) if it is possible to do so - immediately without violating capacity restrictions, throwing an - IllegalStateException if no space is currently available. - -

    This method is equivalent to Deque.addFirst(E).

    Specified by:
    push in interface java.util.Deque<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    e - the element to push
    • @@ -758,15 +613,9 @@

    push

    removeFirst

    @CanIgnoreReturnValue
 public E removeFirst()
    -
    Description copied from interface: java.util.Deque
    -
    Retrieves and removes the first element of this deque. This method - differs from pollFirst only in that it throws an - exception if this deque is empty.
    Specified by:
    removeFirst in interface java.util.Deque<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the head of this deque
    @@ -778,15 +627,9 @@

    removeFirst

    removeLast

    @CanIgnoreReturnValue
 public E removeLast()
    -
    Description copied from interface: java.util.Deque
    -
    Retrieves and removes the last element of this deque. This method - differs from pollLast only in that it throws an - exception if this deque is empty.
    Specified by:
    removeLast in interface java.util.Deque<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the tail of this deque
    @@ -799,20 +642,9 @@

    removeFirstOccurrence

    @CanIgnoreReturnValue
 public boolean removeFirstOccurrence​(@CheckForNull
                                      java.lang.Object o)
    -
    Description copied from interface: java.util.Deque
    -
    Removes the first occurrence of the specified element from this deque. - If the deque does not contain the element, it is unchanged. - More formally, removes the first element e such that - Objects.equals(o, e) (if such an element exists). - Returns true if this deque contained the specified element - (or equivalently, if this deque changed as a result of the call).
    Specified by:
    removeFirstOccurrence in interface java.util.Deque<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    o - element to be removed from this deque, if present
    -
    Returns:
    -
    true if an element was removed as a result of this call
    @@ -825,20 +657,9 @@

    removeLastOccurrence

    @CanIgnoreReturnValue
 public boolean removeLastOccurrence​(@CheckForNull
                                     java.lang.Object o)
    -
    Description copied from interface: java.util.Deque
    -
    Removes the last occurrence of the specified element from this deque. - If the deque does not contain the element, it is unchanged. - More formally, removes the last element e such that - Objects.equals(o, e) (if such an element exists). - Returns true if this deque contained the specified element - (or equivalently, if this deque changed as a result of the call).
    Specified by:
    removeLastOccurrence in interface java.util.Deque<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    o - element to be removed from this deque, if present
    -
    Returns:
    -
    true if an element was removed as a result of this call
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingIterator.html b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingIterator.html index 6614938714f1..484a83d5db80 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingIterator.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingIterator.html @@ -218,24 +218,17 @@

    Method Summary

    boolean hasNext() - -
    Returns true if the iteration has more elements.
    - +  T next() - -
    Returns the next element in the iteration.
    - +  void remove() - -
    Removes from the underlying collection the last element returned - by this iterator (optional operation).
    - + 
      @@ -320,15 +313,9 @@

      delegate

    • hasNext

      public boolean hasNext()
      -
      Description copied from interface: java.util.Iterator
      -
      Returns true if the iteration has more elements. - (In other words, returns true if Iterator.next() would - return an element rather than throwing an exception.)
      Specified by:
      hasNext in interface java.util.Iterator<T extends @Nullable java.lang.Object>
      -
      Returns:
      -
      true if the iteration has more elements
    @@ -340,13 +327,9 @@

    hasNext

    next

    @CanIgnoreReturnValue
 public T next()
    -
    Description copied from interface: java.util.Iterator
    -
    Returns the next element in the iteration.
    Specified by:
    next in interface java.util.Iterator<T extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the next element in the iteration
    @@ -357,18 +340,6 @@

    next

  • remove

    public void remove()
    -
    Description copied from interface: java.util.Iterator
    -
    Removes from the underlying collection the last element returned - by this iterator (optional operation). This method can be called - only once per call to Iterator.next(). -

    - The behavior of an iterator is unspecified if the underlying collection - is modified while the iteration is in progress in any way other than by - calling this method, unless an overriding class has specified a - concurrent modification policy. -

    - The behavior of an iterator is unspecified if this method is called - after a call to the forEachRemaining method.

    Specified by:
    remove in interface java.util.Iterator<T extends @Nullable java.lang.Object>
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingList.html b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingList.html index 16f9661f253e..e9d273273486 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingList.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingList.html @@ -223,19 +223,13 @@

    Method Summary

    void add​(int index, E element) - -
    Inserts the specified element at the specified position in this list - (optional operation).
    - +  boolean addAll​(int index, java.util.Collection<? extends E> elements) - -
    Inserts all of the elements in the specified collection into this - list at the specified position (optional operation).
    - +  protected abstract java.util.List<E> @@ -247,72 +241,48 @@

    Method Summary

    boolean equals​(java.lang.Object object) - -
    Indicates whether some other object is "equal to" this one.
    - +  E get​(int index) - -
    Returns the element at the specified position in this list.
    - +  int hashCode() - -
    Returns a hash code value for the object.
    - +  int indexOf​(java.lang.Object element) - -
    Returns the index of the first occurrence of the specified element - in this list, or -1 if this list does not contain the element.
    - +  int lastIndexOf​(java.lang.Object element) - -
    Returns the index of the last occurrence of the specified element - in this list, or -1 if this list does not contain the element.
    - +  java.util.ListIterator<E> listIterator() - -
    Returns a list iterator over the elements in this list (in proper - sequence).
    - +  java.util.ListIterator<E> listIterator​(int index) - -
    Returns a list iterator over the elements in this list (in proper - sequence), starting at the specified position in the list.
    - +  E remove​(int index) - -
    Removes the element at the specified position in this list (optional - operation).
    - +  E set​(int index, E element) - -
    Replaces the element at the specified position in this list with the - specified element (optional operation).
    - +  protected boolean @@ -393,10 +363,7 @@

    Method Summary

    java.util.List<E> subList​(int fromIndex, int toIndex) - -
    Returns a view of the portion of this list between the specified - fromIndex, inclusive, and toIndex, exclusive.
    - + 
      @@ -505,17 +472,9 @@

      delegate

      add

      public void add​(int index,
                 E element)
      -
      Description copied from interface: java.util.List
      -
      Inserts the specified element at the specified position in this list - (optional operation). Shifts the element currently at that position - (if any) and any subsequent elements to the right (adds one to their - indices).
      Specified by:
      add in interface java.util.List<E extends @Nullable java.lang.Object>
      -
      Parameters:
      -
      index - index at which the specified element is to be inserted
      -
      element - element to be inserted
    @@ -528,25 +487,9 @@

    addAll

    @CanIgnoreReturnValue
 public boolean addAll​(int index,
                       java.util.Collection<? extends E> elements)
    -
    Description copied from interface: java.util.List
    -
    Inserts all of the elements in the specified collection into this - list at the specified position (optional operation). Shifts the - element currently at that position (if any) and any subsequent - elements to the right (increases their indices). The new elements - will appear in this list in the order that they are returned by the - specified collection's iterator. The behavior of this operation is - undefined if the specified collection is modified while the - operation is in progress. (Note that this will occur if the specified - collection is this list, and it's nonempty.)
    Specified by:
    addAll in interface java.util.List<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    index - index at which to insert the first element from the - specified collection
    -
    elements - collection containing elements to be added to this list
    -
    Returns:
    -
    true if this list changed as a result of the call
    • @@ -557,15 +500,9 @@

    addAll

  • get

    public E get​(int index)
    -
    Description copied from interface: java.util.List
    -
    Returns the element at the specified position in this list.
    Specified by:
    get in interface java.util.List<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    index - index of the element to return
    -
    Returns:
    -
    the element at the specified position in this list
    • @@ -577,20 +514,9 @@

    get

    indexOf

    public int indexOf​(@CheckForNull
                    java.lang.Object element)
    -
    Description copied from interface: java.util.List
    -
    Returns the index of the first occurrence of the specified element - in this list, or -1 if this list does not contain the element. - More formally, returns the lowest index i such that - Objects.equals(o, get(i)), - or -1 if there is no such index.
    Specified by:
    indexOf in interface java.util.List<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    element - element to search for
    -
    Returns:
    -
    the index of the first occurrence of the specified element in - this list, or -1 if this list does not contain the element
    @@ -602,20 +528,9 @@

    indexOf

    lastIndexOf

    public int lastIndexOf​(@CheckForNull
                        java.lang.Object element)
    -
    Description copied from interface: java.util.List
    -
    Returns the index of the last occurrence of the specified element - in this list, or -1 if this list does not contain the element. - More formally, returns the highest index i such that - Objects.equals(o, get(i)), - or -1 if there is no such index.
    Specified by:
    lastIndexOf in interface java.util.List<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    element - element to search for
    -
    Returns:
    -
    the index of the last occurrence of the specified element in - this list, or -1 if this list does not contain the element
    @@ -626,15 +541,9 @@

    lastIndexOf

  • listIterator

    public java.util.ListIterator<E> listIterator()
    -
    Description copied from interface: java.util.List
    -
    Returns a list iterator over the elements in this list (in proper - sequence).
    Specified by:
    listIterator in interface java.util.List<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a list iterator over the elements in this list (in proper - sequence)
    • @@ -645,22 +554,9 @@

    listIterator

  • listIterator

    public java.util.ListIterator<E> listIterator​(int index)
    -
    Description copied from interface: java.util.List
    -
    Returns a list iterator over the elements in this list (in proper - sequence), starting at the specified position in the list. - The specified index indicates the first element that would be - returned by an initial call to next. - An initial call to previous would - return the element with the specified index minus one.
    Specified by:
    listIterator in interface java.util.List<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    index - index of the first element to be returned from the - list iterator (by a call to next)
    -
    Returns:
    -
    a list iterator over the elements in this list (in proper - sequence), starting at the specified position in the list
    • @@ -672,18 +568,9 @@

    listIterator

    remove

    @CanIgnoreReturnValue
 public E remove​(int index)
    -
    Description copied from interface: java.util.List
    -
    Removes the element at the specified position in this list (optional - operation). Shifts any subsequent elements to the left (subtracts one - from their indices). Returns the element that was removed from the - list.
    Specified by:
    remove in interface java.util.List<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    index - the index of the element to be removed
    -
    Returns:
    -
    the element previously at the specified position
    @@ -698,17 +585,9 @@

    set

    @CanIgnoreReturnValue
 public E set​(int index,
              E element)
    -
    Description copied from interface: java.util.List
    -
    Replaces the element at the specified position in this list with the - specified element (optional operation).
    Specified by:
    set in interface java.util.List<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    index - index of the element to replace
    -
    element - element to be stored at the specified position
    -
    Returns:
    -
    the element previously at the specified position
    @@ -720,40 +599,9 @@

    set

    subList

    public java.util.List<E> subList​(int fromIndex,
                                  int toIndex)
    -
    Description copied from interface: java.util.List
    -
    Returns a view of the portion of this list between the specified - fromIndex, inclusive, and toIndex, exclusive. (If - fromIndex and toIndex are equal, the returned list is - empty.) The returned list is backed by this list, so non-structural - changes in the returned list are reflected in this list, and vice-versa. - The returned list supports all of the optional list operations supported - by this list.

    - - This method eliminates the need for explicit range operations (of - the sort that commonly exist for arrays). Any operation that expects - a list can be used as a range operation by passing a subList view - instead of a whole list. For example, the following idiom - removes a range of elements from a list: - 

    
-      list.subList(from, to).clear();
-
    - Similar idioms may be constructed for indexOf and - lastIndexOf, and all of the algorithms in the - Collections class can be applied to a subList.

    - - The semantics of the list returned by this method become undefined if - the backing list (i.e., this list) is structurally modified in - any way other than via the returned list. (Structural modifications are - those that change the size of this list, or otherwise perturb it in such - a fashion that iterations in progress may yield incorrect results.)

    Specified by:
    subList in interface java.util.List<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromIndex - low endpoint (inclusive) of the subList
    -
    toIndex - high endpoint (exclusive) of the subList
    -
    Returns:
    -
    a view of the specified range within this list
    @@ -765,45 +613,6 @@

    subList

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object object)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    Specified by:
    equals in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -811,14 +620,6 @@

    equals

    equals in interface java.util.List<E extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -829,35 +630,6 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    Specified by:
    hashCode in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -865,11 +637,6 @@

    hashCode

    hashCode in interface java.util.List<E extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingListIterator.html b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingListIterator.html index b60447712f9c..7b0e228c6dcc 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingListIterator.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingListIterator.html @@ -212,9 +212,7 @@

    Method Summary

    void add​(E element) - -
    Inserts the specified element into the list (optional operation).
    - +  protected abstract java.util.ListIterator<E> @@ -226,42 +224,27 @@

    Method Summary

    boolean hasPrevious() - -
    Returns true if this list iterator has more elements when - traversing the list in the reverse direction.
    - +  int nextIndex() - -
    Returns the index of the element that would be returned by a - subsequent call to ListIterator.next().
    - +  E previous() - -
    Returns the previous element in the list and moves the cursor - position backwards.
    - +  int previousIndex() - -
    Returns the index of the element that would be returned by a - subsequent call to ListIterator.previous().
    - +  void set​(E element) - -
    Replaces the last element returned by ListIterator.next() or - ListIterator.previous() with the specified element (optional operation).
    - + 
      @@ -362,22 +345,9 @@

      delegate

    • add

      public void add​(E element)
      -
      Description copied from interface: java.util.ListIterator
      -
      Inserts the specified element into the list (optional operation). - The element is inserted immediately before the element that - would be returned by ListIterator.next(), if any, and after the element - that would be returned by ListIterator.previous(), if any. (If the - list contains no elements, the new element becomes the sole element - on the list.) The new element is inserted before the implicit - cursor: a subsequent call to next would be unaffected, and a - subsequent call to previous would return the new element. - (This call increases by one the value that would be returned by a - call to nextIndex or previousIndex.)
      Specified by:
      add in interface java.util.ListIterator<E extends @Nullable java.lang.Object>
      -
      Parameters:
      -
      element - the element to insert
    @@ -388,17 +358,9 @@

    add

  • hasPrevious

    public boolean hasPrevious()
    -
    Description copied from interface: java.util.ListIterator
    -
    Returns true if this list iterator has more elements when - traversing the list in the reverse direction. (In other words, - returns true if ListIterator.previous() would return an element - rather than throwing an exception.)
    Specified by:
    hasPrevious in interface java.util.ListIterator<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    true if the list iterator has more elements when - traversing the list in the reverse direction
    • @@ -409,17 +371,9 @@

    hasPrevious

  • nextIndex

    public int nextIndex()
    -
    Description copied from interface: java.util.ListIterator
    -
    Returns the index of the element that would be returned by a - subsequent call to ListIterator.next(). (Returns list size if the list - iterator is at the end of the list.)
    Specified by:
    nextIndex in interface java.util.ListIterator<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the index of the element that would be returned by a - subsequent call to next, or list size if the list - iterator is at the end of the list
    • @@ -431,18 +385,9 @@

    nextIndex

    previous

    @CanIgnoreReturnValue
 public E previous()
    -
    Description copied from interface: java.util.ListIterator
    -
    Returns the previous element in the list and moves the cursor - position backwards. This method may be called repeatedly to - iterate through the list backwards, or intermixed with calls to - ListIterator.next() to go back and forth. (Note that alternating calls - to next and previous will return the same - element repeatedly.)
    Specified by:
    previous in interface java.util.ListIterator<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the previous element in the list
    @@ -453,17 +398,9 @@

    previous

  • previousIndex

    public int previousIndex()
    -
    Description copied from interface: java.util.ListIterator
    -
    Returns the index of the element that would be returned by a - subsequent call to ListIterator.previous(). (Returns -1 if the list - iterator is at the beginning of the list.)
    Specified by:
    previousIndex in interface java.util.ListIterator<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the index of the element that would be returned by a - subsequent call to previous, or -1 if the list - iterator is at the beginning of the list
    • @@ -476,17 +413,9 @@

    previousIndex

  • set

    public void set​(E element)
    -
    Description copied from interface: java.util.ListIterator
    -
    Replaces the last element returned by ListIterator.next() or - ListIterator.previous() with the specified element (optional operation). - This call can be made only if neither ListIterator.remove() nor ListIterator.add(E) have been called after the last call to next or - previous.
    Specified by:
    set in interface java.util.ListIterator<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    element - the element with which to replace the last element returned by - next or previous
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingMap.StandardEntrySet.html b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingMap.StandardEntrySet.html index 74c89b8d5c31..e2b9c7544bfe 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingMap.StandardEntrySet.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingMap.StandardEntrySet.html @@ -208,54 +208,37 @@

    Method Summary

    void clear() - -
    Removes all of the elements from this collection (optional operation).
    - +  boolean contains​(java.lang.Object o) - -
    Returns true if this collection contains the specified element.
    - +  boolean isEmpty() - -
    Returns true if this collection contains no elements.
    - +  boolean remove​(java.lang.Object o) - -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation).
    - +  boolean removeAll​(java.util.Collection<?> c) - -
    Removes from this set all of its elements that are contained in the - specified collection (optional operation).
    - +  boolean retainAll​(java.util.Collection<?> c) - -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation).
    - +  int size() - -
    Returns the number of elements in this collection.
    - + 
      @@ -343,10 +326,6 @@

      Method Detail

    • size

      public int size()
      -
      Description copied from interface: java.util.Collection
      -
      Returns the number of elements in this collection. If this collection - contains more than Integer.MAX_VALUE elements, returns - Integer.MAX_VALUE.
      Specified by:
      size in interface java.util.Collection<K extends @Nullable java.lang.Object>
      @@ -354,8 +333,6 @@

      size

      size in interface java.util.Set<K extends @Nullable java.lang.Object>
      Specified by:
      size in class java.util.AbstractCollection<java.util.Map.Entry<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>>
      -
      Returns:
      -
      the number of elements in this collection
    @@ -366,9 +343,6 @@

    size

  • clear

    public void clear()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes all of the elements from this collection (optional operation). - The collection will be empty after this method returns.
    Specified by:
    clear in interface java.util.Collection<K extends @Nullable java.lang.Object>
    @@ -387,11 +361,6 @@

    clear

    contains

    public boolean contains​(@CheckForNull
                         java.lang.Object o)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains the specified element. - More formally, returns true if and only if this collection - contains at least one element e such that - Objects.equals(o, e).
    Specified by:
    contains in interface java.util.Collection<K extends @Nullable java.lang.Object>
    @@ -399,11 +368,6 @@

    contains

    contains in interface java.util.Set<K extends @Nullable java.lang.Object>
    Overrides:
    contains in class java.util.AbstractCollection<java.util.Map.Entry<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>>
    -
    Parameters:
    -
    o - element whose presence in this collection is to be tested
    -
    Returns:
    -
    true if this collection contains the specified - element
    • @@ -414,8 +378,6 @@

    contains

  • isEmpty

    public boolean isEmpty()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains no elements.
    Specified by:
    isEmpty in interface java.util.Collection<K extends @Nullable java.lang.Object>
    @@ -423,8 +385,6 @@

    isEmpty

    isEmpty in interface java.util.Set<K extends @Nullable java.lang.Object>
    Overrides:
    isEmpty in class java.util.AbstractCollection<java.util.Map.Entry<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>>
    -
    Returns:
    -
    true if this collection contains no elements
    • @@ -436,14 +396,6 @@

    isEmpty

    remove

    public boolean remove​(@CheckForNull
                       java.lang.Object o)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation). More formally, - removes an element e such that - Objects.equals(o, e), if - this collection contains one or more such elements. Returns - true if this collection contained the specified element (or - equivalently, if this collection changed as a result of the call).
    Specified by:
    remove in interface java.util.Collection<K extends @Nullable java.lang.Object>
    @@ -451,10 +403,6 @@

    remove

    remove in interface java.util.Set<K extends @Nullable java.lang.Object>
    Overrides:
    remove in class java.util.AbstractCollection<java.util.Map.Entry<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>>
    -
    Parameters:
    -
    o - element to be removed from this collection, if present
    -
    Returns:
    -
    true if an element was removed as a result of this call
    @@ -465,40 +413,11 @@

    remove

  • removeAll

    public boolean removeAll​(java.util.Collection<?> c)
    -
    Description copied from class: java.util.AbstractSet
    -
    Removes from this set all of its elements that are contained in the - specified collection (optional operation). If the specified - collection is also a set, this operation effectively modifies this - set so that its value is the asymmetric set difference of - the two sets. - -

    This implementation determines which is the smaller of this set - and the specified collection, by invoking the size - method on each. If this set has fewer elements, then the - implementation iterates over this set, checking each element - returned by the iterator in turn to see if it is contained in - the specified collection. If it is so contained, it is removed - from this set with the iterator's remove method. If - the specified collection has fewer elements, then the - implementation iterates over the specified collection, removing - from this set each element returned by the iterator, using this - set's remove method. - -

    Note that this implementation will throw an - UnsupportedOperationException if the iterator returned by the - iterator method does not implement the remove method.

    Specified by:
    removeAll in interface java.util.Collection<K extends @Nullable java.lang.Object>
    Specified by:
    removeAll in interface java.util.Set<K extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    c - collection containing elements to be removed from this set
    -
    Returns:
    -
    true if this set changed as a result of the call
    -
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    • @@ -509,23 +428,11 @@

    removeAll

  • retainAll

    public boolean retainAll​(java.util.Collection<?> c)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation). In other words, removes from - this collection all of its elements that are not contained in the - specified collection.
    Specified by:
    retainAll in interface java.util.Collection<K extends @Nullable java.lang.Object>
    Specified by:
    retainAll in interface java.util.Set<K extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    c - collection containing elements to be retained in this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    -
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingMap.StandardKeySet.html b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingMap.StandardKeySet.html index ca74bd1f789b..4244935b951c 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingMap.StandardKeySet.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingMap.StandardKeySet.html @@ -205,61 +205,42 @@

    Method Summary

    void clear() - -
    Removes all of the elements from this collection (optional operation).
    - +  boolean contains​(java.lang.Object o) - -
    Returns true if this collection contains the specified element.
    - +  boolean isEmpty() - -
    Returns true if this collection contains no elements.
    - +  java.util.Iterator<K> iterator() - -
    Returns an iterator over the elements contained in this collection.
    - +  boolean remove​(java.lang.Object o) - -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation).
    - +  boolean removeAll​(java.util.Collection<?> c) - -
    Removes from this set all of its elements that are contained in the - specified collection (optional operation).
    - +  boolean retainAll​(java.util.Collection<?> c) - -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation).
    - +  int size() - -
    Returns the number of elements in this collection.
    - + 
      @@ -347,8 +328,6 @@

      Method Detail

    • iterator

      public java.util.Iterator<K> iterator()
      -
      Description copied from class: java.util.AbstractCollection
      -
      Returns an iterator over the elements contained in this collection.
      Specified by:
      iterator in interface java.util.Collection<K extends @Nullable java.lang.Object>
      @@ -358,8 +337,6 @@

      iterator

      iterator in interface java.util.Set<K extends @Nullable java.lang.Object>
      Specified by:
      iterator in class java.util.AbstractCollection<K extends @Nullable java.lang.Object>
      -
      Returns:
      -
      an iterator over the elements contained in this collection
    @@ -370,10 +347,6 @@

    iterator

  • size

    public int size()
    -
    Description copied from interface: java.util.Collection
    -
    Returns the number of elements in this collection. If this collection - contains more than Integer.MAX_VALUE elements, returns - Integer.MAX_VALUE.
    Specified by:
    size in interface java.util.Collection<K extends @Nullable java.lang.Object>
    @@ -381,8 +354,6 @@

    size

    size in interface java.util.Set<K extends @Nullable java.lang.Object>
    Specified by:
    size in class java.util.AbstractCollection<K extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the number of elements in this collection
    • @@ -393,8 +364,6 @@

    size

  • isEmpty

    public boolean isEmpty()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains no elements.
    Specified by:
    isEmpty in interface java.util.Collection<K extends @Nullable java.lang.Object>
    @@ -402,8 +371,6 @@

    isEmpty

    isEmpty in interface java.util.Set<K extends @Nullable java.lang.Object>
    Overrides:
    isEmpty in class java.util.AbstractCollection<K extends @Nullable java.lang.Object>
    -
    Returns:
    -
    true if this collection contains no elements
    • @@ -415,11 +382,6 @@

    isEmpty

    contains

    public boolean contains​(@CheckForNull
                         java.lang.Object o)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains the specified element. - More formally, returns true if and only if this collection - contains at least one element e such that - Objects.equals(o, e).
    Specified by:
    contains in interface java.util.Collection<K extends @Nullable java.lang.Object>
    @@ -427,11 +389,6 @@

    contains

    contains in interface java.util.Set<K extends @Nullable java.lang.Object>
    Overrides:
    contains in class java.util.AbstractCollection<K extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    o - element whose presence in this collection is to be tested
    -
    Returns:
    -
    true if this collection contains the specified - element
    @@ -443,14 +400,6 @@

    contains

    remove

    public boolean remove​(@CheckForNull
                       java.lang.Object o)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation). More formally, - removes an element e such that - Objects.equals(o, e), if - this collection contains one or more such elements. Returns - true if this collection contained the specified element (or - equivalently, if this collection changed as a result of the call).
    Specified by:
    remove in interface java.util.Collection<K extends @Nullable java.lang.Object>
    @@ -458,10 +407,6 @@

    remove

    remove in interface java.util.Set<K extends @Nullable java.lang.Object>
    Overrides:
    remove in class java.util.AbstractCollection<K extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    o - element to be removed from this collection, if present
    -
    Returns:
    -
    true if an element was removed as a result of this call
    @@ -472,9 +417,6 @@

    remove

  • clear

    public void clear()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes all of the elements from this collection (optional operation). - The collection will be empty after this method returns.
    Specified by:
    clear in interface java.util.Collection<K extends @Nullable java.lang.Object>
    @@ -492,28 +434,6 @@

    clear

  • removeAll

    public boolean removeAll​(java.util.Collection<?> c)
    -
    Description copied from class: java.util.AbstractSet
    -
    Removes from this set all of its elements that are contained in the - specified collection (optional operation). If the specified - collection is also a set, this operation effectively modifies this - set so that its value is the asymmetric set difference of - the two sets. - -

    This implementation determines which is the smaller of this set - and the specified collection, by invoking the size - method on each. If this set has fewer elements, then the - implementation iterates over this set, checking each element - returned by the iterator in turn to see if it is contained in - the specified collection. If it is so contained, it is removed - from this set with the iterator's remove method. If - the specified collection has fewer elements, then the - implementation iterates over the specified collection, removing - from this set each element returned by the iterator, using this - set's remove method. - -

    Note that this implementation will throw an - UnsupportedOperationException if the iterator returned by the - iterator method does not implement the remove method.

    Specified by:
    removeAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -521,13 +441,6 @@

    removeAll

    removeAll in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    removeAll in class java.util.AbstractSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    c - collection containing elements to be removed from this set
    -
    Returns:
    -
    true if this set changed as a result of the call
    -
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    • @@ -538,11 +451,6 @@

    removeAll

  • retainAll

    public boolean retainAll​(java.util.Collection<?> c)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation). In other words, removes from - this collection all of its elements that are not contained in the - specified collection.
    Specified by:
    retainAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -550,13 +458,6 @@

    retainAll

    retainAll in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    retainAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    c - collection containing elements to be retained in this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    -
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingMap.StandardValues.html b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingMap.StandardValues.html index 659b61a4ff8a..b17758c5b9e0 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingMap.StandardValues.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingMap.StandardValues.html @@ -201,61 +201,42 @@

    Method Summary

    void clear() - -
    Removes all of the elements from this collection (optional operation).
    - +  boolean contains​(java.lang.Object o) - -
    Returns true if this collection contains the specified element.
    - +  boolean isEmpty() - -
    Returns true if this collection contains no elements.
    - +  java.util.Iterator<V> iterator() - -
    Returns an iterator over the elements contained in this collection.
    - +  boolean remove​(java.lang.Object o) - -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation).
    - +  boolean removeAll​(java.util.Collection<?> c) - -
    Removes all of this collection's elements that are also contained in the - specified collection (optional operation).
    - +  boolean retainAll​(java.util.Collection<?> c) - -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation).
    - +  int size() - -
    Returns the number of elements in this collection.
    - + 
      @@ -329,8 +310,6 @@

      Method Detail

    • iterator

      public java.util.Iterator<V> iterator()
      -
      Description copied from class: java.util.AbstractCollection
      -
      Returns an iterator over the elements contained in this collection.
      Specified by:
      iterator in interface java.util.Collection<K extends @Nullable java.lang.Object>
      @@ -338,8 +317,6 @@

      iterator

      iterator in interface java.lang.Iterable<K extends @Nullable java.lang.Object>
      Specified by:
      iterator in class java.util.AbstractCollection<V extends @Nullable java.lang.Object>
      -
      Returns:
      -
      an iterator over the elements contained in this collection
    @@ -351,23 +328,11 @@

    iterator

    remove

    public boolean remove​(@CheckForNull
                       java.lang.Object o)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation). More formally, - removes an element e such that - Objects.equals(o, e), if - this collection contains one or more such elements. Returns - true if this collection contained the specified element (or - equivalently, if this collection changed as a result of the call).
    Specified by:
    remove in interface java.util.Collection<K extends @Nullable java.lang.Object>
    Overrides:
    remove in class java.util.AbstractCollection<V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    o - element to be removed from this collection, if present
    -
    Returns:
    -
    true if an element was removed as a result of this call
    • @@ -378,24 +343,11 @@

    remove

  • removeAll

    public boolean removeAll​(java.util.Collection<?> c)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes all of this collection's elements that are also contained in the - specified collection (optional operation). After this call returns, - this collection will contain no elements in common with the specified - collection.
    Specified by:
    removeAll in interface java.util.Collection<K extends @Nullable java.lang.Object>
    Overrides:
    removeAll in class java.util.AbstractCollection<V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    c - collection containing elements to be removed from this collection
    -
    Returns:
    -
    true if this collection changed as a result of the - call
    -
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    • @@ -406,23 +358,11 @@

    removeAll

  • retainAll

    public boolean retainAll​(java.util.Collection<?> c)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation). In other words, removes from - this collection all of its elements that are not contained in the - specified collection.
    Specified by:
    retainAll in interface java.util.Collection<K extends @Nullable java.lang.Object>
    Overrides:
    retainAll in class java.util.AbstractCollection<V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    c - collection containing elements to be retained in this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    -
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    • @@ -433,17 +373,11 @@

    retainAll

  • size

    public int size()
    -
    Description copied from interface: java.util.Collection
    -
    Returns the number of elements in this collection. If this collection - contains more than Integer.MAX_VALUE elements, returns - Integer.MAX_VALUE.
    Specified by:
    size in interface java.util.Collection<K extends @Nullable java.lang.Object>
    Specified by:
    size in class java.util.AbstractCollection<V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the number of elements in this collection
    • @@ -454,15 +388,11 @@

    size

  • isEmpty

    public boolean isEmpty()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains no elements.
    Specified by:
    isEmpty in interface java.util.Collection<K extends @Nullable java.lang.Object>
    Overrides:
    isEmpty in class java.util.AbstractCollection<V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    true if this collection contains no elements
    • @@ -474,21 +404,11 @@

    isEmpty

    contains

    public boolean contains​(@CheckForNull
                         java.lang.Object o)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains the specified element. - More formally, returns true if and only if this collection - contains at least one element e such that - Objects.equals(o, e).
    Specified by:
    contains in interface java.util.Collection<K extends @Nullable java.lang.Object>
    Overrides:
    contains in class java.util.AbstractCollection<V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    o - element whose presence in this collection is to be tested
    -
    Returns:
    -
    true if this collection contains the specified - element
    @@ -499,9 +419,6 @@

    contains

  • clear

    public void clear()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes all of the elements from this collection (optional operation). - The collection will be empty after this method returns.
    Specified by:
    clear in interface java.util.Collection<K extends @Nullable java.lang.Object>
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingMap.html b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingMap.html index 455e8af36848..e6fe72224532 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingMap.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingMap.html @@ -224,7 +224,7 @@

    Nested Class Summary

    Nested classes/interfaces inherited from interface java.util.Map

    -java.util.Map.Entry<K,​V>
    • +java.util.Map.Entry<K extends java.lang.Object,​V extends java.lang.Object> @@ -271,25 +271,17 @@

    Method Summary

    void clear() - -
    Removes all of the mappings from this map (optional operation).
    - +  boolean containsKey​(java.lang.Object key) - -
    Returns true if this map contains a mapping for the specified - key.
    - +  boolean containsValue​(java.lang.Object value) - -
    Returns true if this map maps one or more keys to the - specified value.
    - +  protected abstract java.util.Map<K,​V> @@ -301,77 +293,53 @@

    Method Summary

    java.util.Set<java.util.Map.Entry<K,​V>> entrySet() - -
    Returns a Set view of the mappings contained in this map.
    - +  boolean equals​(java.lang.Object object) - -
    Indicates whether some other object is "equal to" this one.
    - +  V get​(java.lang.Object key) - -
    Returns the value to which the specified key is mapped, - or null if this map contains no mapping for the key.
    - +  int hashCode() - -
    Returns a hash code value for the object.
    - +  boolean isEmpty() - -
    Returns true if this map contains no key-value mappings.
    - +  java.util.Set<K> keySet() - -
    Returns a Set view of the keys contained in this map.
    - +  V put​(K key, V value) - -
    Associates the specified value with the specified key in this map - (optional operation).
    - +  void putAll​(java.util.Map<? extends K,​? extends V> map) - -
    Copies all of the mappings from the specified map to this map - (optional operation).
    - +  V remove​(java.lang.Object key) - -
    Removes the mapping for a key from this map if it is present - (optional operation).
    - +  int size() - -
    Returns the number of key-value mappings in this map.
    - +  protected void @@ -442,9 +410,7 @@

    Method Summary

    java.util.Collection<V> values() - -
    Returns a Collection view of the values contained in this map.
    - + 
      @@ -529,15 +495,9 @@

      delegate

    • size

      public int size()
      -
      Description copied from interface: java.util.Map
      -
      Returns the number of key-value mappings in this map. If the - map contains more than Integer.MAX_VALUE elements, returns - Integer.MAX_VALUE.
      Specified by:
      size in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
      -
      Returns:
      -
      the number of key-value mappings in this map
    @@ -548,13 +508,9 @@

    size

  • isEmpty

    public boolean isEmpty()
    -
    Description copied from interface: java.util.Map
    -
    Returns true if this map contains no key-value mappings.
    Specified by:
    isEmpty in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    true if this map contains no key-value mappings
    • @@ -568,31 +524,9 @@

    remove

    @CheckForNull public V remove​(@CheckForNull java.lang.Object key) -
    Description copied from interface: java.util.Map
    -
    Removes the mapping for a key from this map if it is present - (optional operation). More formally, if this map contains a mapping - from key k to value v such that - Objects.equals(key, k), that mapping - is removed. (The map can contain at most one such mapping.) - -

    Returns the value to which this map previously associated the key, - or null if the map contained no mapping for the key. - -

    If this map permits null values, then a return value of - null does not necessarily indicate that the map - contained no mapping for the key; it's also possible that the map - explicitly mapped the key to null. - -

    The map will not contain a mapping for the specified key once the - call returns.

    Specified by:
    remove in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - key whose mapping is to be removed from the map
    -
    Returns:
    -
    the previous value associated with key, or - null if there was no mapping for key.
    @@ -603,9 +537,6 @@

    remove

  • clear

    public void clear()
    -
    Description copied from interface: java.util.Map
    -
    Removes all of the mappings from this map (optional operation). - The map will be empty after this call returns.
    Specified by:
    clear in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    @@ -620,20 +551,9 @@

    clear

    containsKey

    public boolean containsKey​(@CheckForNull
                            java.lang.Object key)
    -
    Description copied from interface: java.util.Map
    -
    Returns true if this map contains a mapping for the specified - key. More formally, returns true if and only if - this map contains a mapping for a key k such that - Objects.equals(key, k). (There can be - at most one such mapping.)
    Specified by:
    containsKey in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - key whose presence in this map is to be tested
    -
    Returns:
    -
    true if this map contains a mapping for the specified - key
    • @@ -645,21 +565,9 @@

    containsKey

    containsValue

    public boolean containsValue​(@CheckForNull
                              java.lang.Object value)
    -
    Description copied from interface: java.util.Map
    -
    Returns true if this map maps one or more keys to the - specified value. More formally, returns true if and only if - this map contains at least one mapping to a value v such that - Objects.equals(value, v). This operation - will probably require time linear in the map size for most - implementations of the Map interface.
    Specified by:
    containsValue in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    value - value whose presence in this map is to be tested
    -
    Returns:
    -
    true if this map maps one or more keys to the - specified value
    @@ -672,28 +580,9 @@

    get

    @CheckForNull
 public V get​(@CheckForNull
              java.lang.Object key)
    -
    Description copied from interface: java.util.Map
    -
    Returns the value to which the specified key is mapped, - or null if this map contains no mapping for the key. - -

    More formally, if this map contains a mapping from a key - k to a value v such that - Objects.equals(key, k), - then this method returns v; otherwise - it returns null. (There can be at most one such mapping.) - -

    If this map permits null values, then a return value of - null does not necessarily indicate that the map - contains no mapping for the key; it's also possible that the map - explicitly maps the key to null. The containsKey operation may be used to distinguish these two cases.

    Specified by:
    get in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - the key whose associated value is to be returned
    -
    Returns:
    -
    the value to which the specified key is mapped, or - null if this map contains no mapping for the key
    @@ -709,25 +598,9 @@

    put

    @CheckForNull public V put​(K key, V value) -
    Description copied from interface: java.util.Map
    -
    Associates the specified value with the specified key in this map - (optional operation). If the map previously contained a mapping for - the key, the old value is replaced by the specified value. (A map - m is said to contain a mapping for a key k if and only - if m.containsKey(k) would return - true.)
    Specified by:
    put in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - key with which the specified value is to be associated
    -
    value - value to be associated with the specified key
    -
    Returns:
    -
    the previous value associated with key, or - null if there was no mapping for key. - (A null return can also indicate that the map - previously associated null with key, - if the implementation supports null values.)
    @@ -738,18 +611,9 @@

    put

  • putAll

    public void putAll​(java.util.Map<? extends K,​? extends V> map)
    -
    Description copied from interface: java.util.Map
    -
    Copies all of the mappings from the specified map to this map - (optional operation). The effect of this call is equivalent to that - of calling put(k, v) on this map once - for each mapping from key k to value v in the - specified map. The behavior of this operation is undefined if the - specified map is modified while the operation is in progress.
    Specified by:
    putAll in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    map - mappings to be stored in this map
    • @@ -760,23 +624,9 @@

    putAll

  • keySet

    public java.util.Set<K> keySet()
    -
    Description copied from interface: java.util.Map
    -
    Returns a Set view of the keys contained in this map. - The set is backed by the map, so changes to the map are - reflected in the set, and vice-versa. If the map is modified - while an iteration over the set is in progress (except through - the iterator's own remove operation), the results of - the iteration are undefined. The set supports element removal, - which removes the corresponding mapping from the map, via the - Iterator.remove, Set.remove, - removeAll, retainAll, and clear - operations. It does not support the add or addAll - operations.
    Specified by:
    keySet in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a set view of the keys contained in this map
    • @@ -787,23 +637,9 @@

    keySet

  • values

    public java.util.Collection<V> values()
    -
    Description copied from interface: java.util.Map
    -
    Returns a Collection view of the values contained in this map. - The collection is backed by the map, so changes to the map are - reflected in the collection, and vice-versa. If the map is - modified while an iteration over the collection is in progress - (except through the iterator's own remove operation), - the results of the iteration are undefined. The collection - supports element removal, which removes the corresponding - mapping from the map, via the Iterator.remove, - Collection.remove, removeAll, - retainAll and clear operations. It does not - support the add or addAll operations.
    Specified by:
    values in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a collection view of the values contained in this map
    • @@ -814,24 +650,9 @@

    values

  • entrySet

    public java.util.Set<java.util.Map.Entry<K,​V>> entrySet()
    -
    Description copied from interface: java.util.Map
    -
    Returns a Set view of the mappings contained in this map. - The set is backed by the map, so changes to the map are - reflected in the set, and vice-versa. If the map is modified - while an iteration over the set is in progress (except through - the iterator's own remove operation, or through the - setValue operation on a map entry returned by the - iterator) the results of the iteration are undefined. The set - supports element removal, which removes the corresponding - mapping from the map, via the Iterator.remove, - Set.remove, removeAll, retainAll and - clear operations. It does not support the - add or addAll operations.
    Specified by:
    entrySet in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a set view of the mappings contained in this map
    • @@ -843,58 +664,11 @@

    entrySet

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object object)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    Specified by:
    equals in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -905,45 +679,11 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    Specified by:
    hashCode in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingMapEntry.html b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingMapEntry.html index 13b13cd57301..a80fe0f0bdde 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingMapEntry.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingMapEntry.html @@ -222,38 +222,27 @@

    Method Summary

    boolean equals​(java.lang.Object object) - -
    Indicates whether some other object is "equal to" this one.
    - +  K getKey() - -
    Returns the key corresponding to this entry.
    - +  V getValue() - -
    Returns the value corresponding to this entry.
    - +  int hashCode() - -
    Returns a hash code value for the object.
    - +  V setValue​(V value) - -
    Replaces the value corresponding to this entry with the specified - value (optional operation).
    - +  protected boolean @@ -352,13 +341,9 @@

    delegate

  • getKey

    public K getKey()
    -
    Description copied from interface: java.util.Map.Entry
    -
    Returns the key corresponding to this entry.
    Specified by:
    getKey in interface java.util.Map.Entry<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the key corresponding to this entry
    • @@ -369,15 +354,9 @@

    getKey

  • getValue

    public V getValue()
    -
    Description copied from interface: java.util.Map.Entry
    -
    Returns the value corresponding to this entry. If the mapping - has been removed from the backing map (by the iterator's - remove operation), the results of this call are undefined.
    Specified by:
    getValue in interface java.util.Map.Entry<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the value corresponding to this entry
    • @@ -390,18 +369,9 @@

    getValue

  • setValue

    public V setValue​(V value)
    -
    Description copied from interface: java.util.Map.Entry
    -
    Replaces the value corresponding to this entry with the specified - value (optional operation). (Writes through to the map.) The - behavior of this call is undefined if the mapping has already been - removed from the map (by the iterator's remove operation).
    Specified by:
    setValue in interface java.util.Map.Entry<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    value - new value to be stored in this entry
    -
    Returns:
    -
    old value corresponding to the entry
    • @@ -413,58 +383,11 @@

    setValue

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object object)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    Specified by:
    equals in interface java.util.Map.Entry<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -475,45 +398,11 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    Specified by:
    hashCode in interface java.util.Map.Entry<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingMultimap.html b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingMultimap.html index 062b930a3def..2d46262c0911 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingMultimap.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingMultimap.html @@ -265,7 +265,7 @@

    Method Summary

    boolean equals​(java.lang.Object object) -
    Indicates whether some other object is "equal to" this one.
    +
    Compares the specified object with this multimap for equality.
    @@ -279,7 +279,7 @@

    Method Summary

    int hashCode() -
    Returns a hash code value for the object.
    +
    Returns the hash code for this multimap.
    @@ -814,58 +814,23 @@

    values

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object object)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    +
    Description copied from interface: Multimap
    +
    Compares the specified object with this multimap for equality. Two multimaps are equal when + their map views, as returned by Multimap.asMap(), are also equal. + +

    In general, two multimaps with identical key-value mappings may or may not be equal, + depending on the implementation. For example, two SetMultimap instances with the same + key-value mappings are equal, but equality of two ListMultimap instances depends on the + ordering of the values for each key. + +

    A non-empty SetMultimap cannot be equal to a non-empty ListMultimap, since + their Multimap.asMap() views contain unequal collections as values. However, any two empty + multimaps are equal, because they both have empty Multimap.asMap() views.

    Specified by:
    equals in interface Multimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -876,45 +841,21 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    +
    Description copied from interface: Multimap
    +
    Returns the hash code for this multimap. + +

    The hash code of a multimap is defined as the hash code of the map view, as returned by + Multimap.asMap(). + +

    In general, two multimaps with identical key-value mappings may or may not have the same + hash codes, depending on the implementation. For example, two SetMultimap instances + with the same key-value mappings will have the same hashCode, but the hashCode + of ListMultimap instances depends on the ordering of the values for each key.

    Specified by:
    hashCode in interface Multimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingMultiset.StandardElementSet.html b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingMultiset.StandardElementSet.html index 35d8dcd7380e..7577b52653cb 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingMultiset.StandardElementSet.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingMultiset.StandardElementSet.html @@ -207,69 +207,47 @@

    Method Summary

    void clear() - -
    Removes all of the elements from this collection (optional operation).
    - +  boolean contains​(java.lang.Object o) - -
    Returns true if this collection contains the specified element.
    - +  boolean containsAll​(java.util.Collection<?> c) - -
    Returns true if this collection contains all of the elements - in the specified collection.
    - +  boolean isEmpty() - -
    Returns true if this collection contains no elements.
    - +  java.util.Iterator<E> iterator() - -
    Returns an iterator over the elements contained in this collection.
    - +  boolean remove​(java.lang.Object o) - -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation).
    - +  boolean removeAll​(java.util.Collection<?> c) - -
    Removes from this set all of its elements that are contained in the - specified collection (optional operation).
    - +  boolean retainAll​(java.util.Collection<?> c) - -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation).
    - +  int size() - -
    Returns the number of elements in this collection.
    - + 
      @@ -357,8 +335,6 @@

      Method Detail

    • iterator

      public java.util.Iterator<E> iterator()
      -
      Description copied from class: java.util.AbstractCollection
      -
      Returns an iterator over the elements contained in this collection.
      Specified by:
      iterator in interface java.util.Collection<E extends @Nullable java.lang.Object>
      @@ -366,8 +342,6 @@

      iterator

      iterator in interface java.lang.Iterable<E extends @Nullable java.lang.Object>
      Specified by:
      iterator in interface java.util.Set<E extends @Nullable java.lang.Object>
      -
      Returns:
      -
      an iterator over the elements contained in this collection
    @@ -378,9 +352,6 @@

    iterator

  • clear

    public void clear()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes all of the elements from this collection (optional operation). - The collection will be empty after this method returns.
    Specified by:
    clear in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -399,11 +370,6 @@

    clear

    contains

    public boolean contains​(@CheckForNull
                         java.lang.Object o)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains the specified element. - More formally, returns true if and only if this collection - contains at least one element e such that - Objects.equals(o, e).
    Specified by:
    contains in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -411,11 +377,6 @@

    contains

    contains in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    contains in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    o - element whose presence in this collection is to be tested
    -
    Returns:
    -
    true if this collection contains the specified - element
    • @@ -426,9 +387,6 @@

    contains

  • containsAll

    public boolean containsAll​(java.util.Collection<?> c)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains all of the elements - in the specified collection.
    Specified by:
    containsAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -436,13 +394,6 @@

    containsAll

    containsAll in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    containsAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    c - collection to be checked for containment in this collection
    -
    Returns:
    -
    true if this collection contains all of the elements - in the specified collection
    -
    See Also:
    -
    AbstractCollection.contains(Object)
    • @@ -453,8 +404,6 @@

    containsAll

  • isEmpty

    public boolean isEmpty()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains no elements.
    Specified by:
    isEmpty in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -462,8 +411,6 @@

    isEmpty

    isEmpty in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    isEmpty in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    true if this collection contains no elements
    • @@ -475,14 +422,6 @@

    isEmpty

    remove

    public boolean remove​(@CheckForNull
                       java.lang.Object o)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation). More formally, - removes an element e such that - Objects.equals(o, e), if - this collection contains one or more such elements. Returns - true if this collection contained the specified element (or - equivalently, if this collection changed as a result of the call).
    Specified by:
    remove in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -490,10 +429,6 @@

    remove

    remove in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    remove in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    o - element to be removed from this collection, if present
    -
    Returns:
    -
    true if an element was removed as a result of this call
    @@ -504,10 +439,6 @@

    remove

  • size

    public int size()
    -
    Description copied from interface: java.util.Collection
    -
    Returns the number of elements in this collection. If this collection - contains more than Integer.MAX_VALUE elements, returns - Integer.MAX_VALUE.
    Specified by:
    size in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -515,8 +446,6 @@

    size

    size in interface java.util.Set<E extends @Nullable java.lang.Object>
    Specified by:
    size in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the number of elements in this collection
    • @@ -527,28 +456,6 @@

    size

  • removeAll

    public boolean removeAll​(java.util.Collection<?> c)
    -
    Description copied from class: java.util.AbstractSet
    -
    Removes from this set all of its elements that are contained in the - specified collection (optional operation). If the specified - collection is also a set, this operation effectively modifies this - set so that its value is the asymmetric set difference of - the two sets. - -

    This implementation determines which is the smaller of this set - and the specified collection, by invoking the size - method on each. If this set has fewer elements, then the - implementation iterates over this set, checking each element - returned by the iterator in turn to see if it is contained in - the specified collection. If it is so contained, it is removed - from this set with the iterator's remove method. If - the specified collection has fewer elements, then the - implementation iterates over the specified collection, removing - from this set each element returned by the iterator, using this - set's remove method. - -

    Note that this implementation will throw an - UnsupportedOperationException if the iterator returned by the - iterator method does not implement the remove method.

    Specified by:
    removeAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -556,13 +463,6 @@

    removeAll

    removeAll in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    removeAll in class java.util.AbstractSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    c - collection containing elements to be removed from this set
    -
    Returns:
    -
    true if this set changed as a result of the call
    -
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    • @@ -573,11 +473,6 @@

    removeAll

  • retainAll

    public boolean retainAll​(java.util.Collection<?> c)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation). In other words, removes from - this collection all of its elements that are not contained in the - specified collection.
    Specified by:
    retainAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -585,13 +480,6 @@

    retainAll

    retainAll in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    retainAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    c - collection containing elements to be retained in this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    -
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingMultiset.html b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingMultiset.html index 77d587d42602..f089be60e2b3 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingMultiset.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingMultiset.html @@ -295,14 +295,14 @@

    Method Summary

    boolean equals​(java.lang.Object object) -
    Indicates whether some other object is "equal to" this one.
    +
    Compares the specified object with this multiset for equality.
    int hashCode() -
    Returns a hash code value for the object.
    +
    Returns the hash code for this multiset.
    @@ -686,45 +686,10 @@

    entrySet

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object object)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    +
    Description copied from interface: Multiset
    +
    Compares the specified object with this multiset for equality. Returns true if the + given object is also a multiset and contains equal elements with equal counts, regardless of + order.
    Specified by:
    equals in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -732,14 +697,6 @@

    equals

    equals in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -750,35 +707,15 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    +
    Description copied from interface: Multiset
    +
    Returns the hash code for this multiset. This is defined as the sum of + + 
    
+ ((element == null) ? 0 : element.hashCode()) ^ count(element)
+
    + +

    over all distinct elements in the multiset. It follows that a multiset and its entry set + always have the same hash code.

    Specified by:
    hashCode in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -786,11 +723,6 @@

    hashCode

    hashCode in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingNavigableMap.StandardDescendingMap.html b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingNavigableMap.StandardDescendingMap.html index 5b4f9b9c45a1..e0f5875351af 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingNavigableMap.StandardDescendingMap.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingNavigableMap.StandardDescendingMap.html @@ -187,7 +187,7 @@

    Nested classes/interfaces inherited from class com.google.common.collec

    Nested classes/interfaces inherited from interface java.util.Map

    -java.util.Map.Entry<K,​V> +java.util.Map.Entry<K extends java.lang.Object,​V extends java.lang.Object> @@ -232,27 +232,17 @@

    Method Summary

    java.util.Map.Entry<K,​V> ceilingEntry​(K key) - -
    Returns a key-value mapping associated with the least key - greater than or equal to the given key, or null if - there is no such key.
    - +  K ceilingKey​(K key) - -
    Returns the least key greater than or equal to the given key, - or null if there is no such key.
    - +  java.util.Comparator<? super K> comparator() - -
    Returns the comparator used to order the keys in this map, or - null if this map uses the natural ordering of its keys.
    - +  protected java.util.Map<K,​V> @@ -264,16 +254,12 @@

    Method Summary

    java.util.NavigableSet<K> descendingKeySet() - -
    Returns a reverse order NavigableSet view of the keys contained in this map.
    - +  java.util.NavigableMap<K,​V> descendingMap() - -
    Returns a reverse order view of the mappings contained in this map.
    - +  protected java.util.Iterator<java.util.Map.Entry<K,​V>> @@ -283,137 +269,88 @@

    Method Summary

    java.util.Set<java.util.Map.Entry<K,​V>> entrySet() - -
    Returns a Set view of the mappings contained in this map.
    - +  java.util.Map.Entry<K,​V> firstEntry() - -
    Returns a key-value mapping associated with the least - key in this map, or null if the map is empty.
    - +  K firstKey() - -
    Returns the first (lowest) key currently in this map.
    - +  java.util.Map.Entry<K,​V> floorEntry​(K key) - -
    Returns a key-value mapping associated with the greatest key - less than or equal to the given key, or null if there - is no such key.
    - +  K floorKey​(K key) - -
    Returns the greatest key less than or equal to the given key, - or null if there is no such key.
    - +  java.util.SortedMap<K,​V> headMap​(K toKey) - -
    Returns a view of the portion of this map whose keys are - strictly less than toKey.
    - +  java.util.NavigableMap<K,​V> headMap​(K toKey, boolean inclusive) - -
    Returns a view of the portion of this map whose keys are less than (or - equal to, if inclusive is true) toKey.
    - +  java.util.Map.Entry<K,​V> higherEntry​(K key) - -
    Returns a key-value mapping associated with the least key - strictly greater than the given key, or null if there - is no such key.
    - +  K higherKey​(K key) - -
    Returns the least key strictly greater than the given key, or - null if there is no such key.
    - +  java.util.Set<K> keySet() - -
    Returns a Set view of the keys contained in this map.
    - +  java.util.Map.Entry<K,​V> lastEntry() - -
    Returns a key-value mapping associated with the greatest - key in this map, or null if the map is empty.
    - +  K lastKey() - -
    Returns the last (highest) key currently in this map.
    - +  java.util.Map.Entry<K,​V> lowerEntry​(K key) - -
    Returns a key-value mapping associated with the greatest key - strictly less than the given key, or null if there is - no such key.
    - +  K lowerKey​(K key) - -
    Returns the greatest key strictly less than the given key, or - null if there is no such key.
    - +  java.util.NavigableSet<K> navigableKeySet() - -
    Returns a NavigableSet view of the keys contained in this map.
    - +  java.util.Map.Entry<K,​V> pollFirstEntry() - -
    Removes and returns a key-value mapping associated with - the least key in this map, or null if the map is empty.
    - +  java.util.Map.Entry<K,​V> pollLastEntry() - -
    Removes and returns a key-value mapping associated with - the greatest key in this map, or null if the map is empty.
    - +  java.util.NavigableMap<K,​V> @@ -421,36 +358,24 @@

    Method Summary

    boolean fromInclusive, K toKey, boolean toInclusive) - -
    Returns a view of the portion of this map whose keys range from - fromKey to toKey.
    - +  java.util.SortedMap<K,​V> subMap​(K fromKey, K toKey) - -
    Returns a view of the portion of this map whose keys range from - fromKey, inclusive, to toKey, exclusive.
    - +  java.util.SortedMap<K,​V> tailMap​(K fromKey) - -
    Returns a view of the portion of this map whose keys are - greater than or equal to fromKey.
    - +  java.util.NavigableMap<K,​V> tailMap​(K fromKey, boolean inclusive) - -
    Returns a view of the portion of this map whose keys are greater than (or - equal to, if inclusive is true) fromKey.
    - +  java.lang.String @@ -462,9 +387,7 @@

    Method Summary

    java.util.Collection<V> values() - -
    Returns a Collection view of the values contained in this map.
    - + 
      @@ -558,16 +481,9 @@

      delegate

    • comparator

      public java.util.Comparator<? super K> comparator()
      -
      Description copied from interface: java.util.SortedMap
      -
      Returns the comparator used to order the keys in this map, or - null if this map uses the natural ordering of its keys.
      Specified by:
      comparator in interface java.util.SortedMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
      -
      Returns:
      -
      the comparator used to order the keys in this map, - or null if this map uses the natural ordering - of its keys
    @@ -578,13 +494,9 @@

    comparator

  • firstKey

    public K firstKey()
    -
    Description copied from interface: java.util.SortedMap
    -
    Returns the first (lowest) key currently in this map.
    Specified by:
    firstKey in interface java.util.SortedMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the first (lowest) key currently in this map
    • @@ -595,13 +507,9 @@

    firstKey

  • lastKey

    public K lastKey()
    -
    Description copied from interface: java.util.SortedMap
    -
    Returns the last (highest) key currently in this map.
    Specified by:
    lastKey in interface java.util.SortedMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the last (highest) key currently in this map
    • @@ -615,18 +523,9 @@

    lastKey

    lowerEntry

    @CheckForNull
 public java.util.Map.Entry<K,​V> lowerEntry​(K key)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a key-value mapping associated with the greatest key - strictly less than the given key, or null if there is - no such key.
    Specified by:
    lowerEntry in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - the key
    -
    Returns:
    -
    an entry with the greatest key less than key, - or null if there is no such key
    @@ -640,17 +539,9 @@

    lowerEntry

    lowerKey

    @CheckForNull
 public K lowerKey​(K key)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns the greatest key strictly less than the given key, or - null if there is no such key.
    Specified by:
    lowerKey in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - the key
    -
    Returns:
    -
    the greatest key less than key, - or null if there is no such key
    @@ -664,18 +555,9 @@

    lowerKey

    floorEntry

    @CheckForNull
 public java.util.Map.Entry<K,​V> floorEntry​(K key)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a key-value mapping associated with the greatest key - less than or equal to the given key, or null if there - is no such key.
    Specified by:
    floorEntry in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - the key
    -
    Returns:
    -
    an entry with the greatest key less than or equal to - key, or null if there is no such key
    @@ -689,17 +571,9 @@

    floorEntry

    floorKey

    @CheckForNull
 public K floorKey​(K key)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns the greatest key less than or equal to the given key, - or null if there is no such key.
    Specified by:
    floorKey in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - the key
    -
    Returns:
    -
    the greatest key less than or equal to key, - or null if there is no such key
    @@ -713,18 +587,9 @@

    floorKey

    ceilingEntry

    @CheckForNull
 public java.util.Map.Entry<K,​V> ceilingEntry​(K key)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a key-value mapping associated with the least key - greater than or equal to the given key, or null if - there is no such key.
    Specified by:
    ceilingEntry in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - the key
    -
    Returns:
    -
    an entry with the least key greater than or equal to - key, or null if there is no such key
    @@ -738,17 +603,9 @@

    ceilingEntry

    ceilingKey

    @CheckForNull
 public K ceilingKey​(K key)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns the least key greater than or equal to the given key, - or null if there is no such key.
    Specified by:
    ceilingKey in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - the key
    -
    Returns:
    -
    the least key greater than or equal to key, - or null if there is no such key
    @@ -762,18 +619,9 @@

    ceilingKey

    higherEntry

    @CheckForNull
 public java.util.Map.Entry<K,​V> higherEntry​(K key)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a key-value mapping associated with the least key - strictly greater than the given key, or null if there - is no such key.
    Specified by:
    higherEntry in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - the key
    -
    Returns:
    -
    an entry with the least key greater than key, - or null if there is no such key
    @@ -787,17 +635,9 @@

    higherEntry

    higherKey

    @CheckForNull
 public K higherKey​(K key)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns the least key strictly greater than the given key, or - null if there is no such key.
    Specified by:
    higherKey in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - the key
    -
    Returns:
    -
    the least key greater than key, - or null if there is no such key
    @@ -809,15 +649,9 @@

    higherKey

    firstEntry

    @CheckForNull
 public java.util.Map.Entry<K,​V> firstEntry()
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a key-value mapping associated with the least - key in this map, or null if the map is empty.
    Specified by:
    firstEntry in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    an entry with the least key, - or null if this map is empty
    @@ -829,15 +663,9 @@

    firstEntry

    lastEntry

    @CheckForNull
 public java.util.Map.Entry<K,​V> lastEntry()
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a key-value mapping associated with the greatest - key in this map, or null if the map is empty.
    Specified by:
    lastEntry in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    an entry with the greatest key, - or null if this map is empty
    @@ -849,15 +677,9 @@

    lastEntry

    pollFirstEntry

    @CheckForNull
 public java.util.Map.Entry<K,​V> pollFirstEntry()
    -
    Description copied from interface: java.util.NavigableMap
    -
    Removes and returns a key-value mapping associated with - the least key in this map, or null if the map is empty.
    Specified by:
    pollFirstEntry in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the removed first entry of this map, - or null if this map is empty
    @@ -869,15 +691,9 @@

    pollFirstEntry

    pollLastEntry

    @CheckForNull
 public java.util.Map.Entry<K,​V> pollLastEntry()
    -
    Description copied from interface: java.util.NavigableMap
    -
    Removes and returns a key-value mapping associated with - the greatest key in this map, or null if the map is empty.
    Specified by:
    pollLastEntry in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the removed last entry of this map, - or null if this map is empty
    @@ -888,23 +704,9 @@

    pollLastEntry

  • descendingMap

    public java.util.NavigableMap<K,​V> descendingMap()
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a reverse order view of the mappings contained in this map. - The descending map is backed by this map, so changes to the map are - reflected in the descending map, and vice-versa. If either map is - modified while an iteration over a collection view of either map - is in progress (except through the iterator's own remove - operation), the results of the iteration are undefined. - -

    The returned map has an ordering equivalent to - Collections.reverseOrder(comparator()). - The expression m.descendingMap().descendingMap() returns a - view of m essentially equivalent to m.

    Specified by:
    descendingMap in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a reverse order view of this map
    • @@ -915,19 +717,6 @@

    descendingMap

  • entrySet

    public java.util.Set<java.util.Map.Entry<K,​V>> entrySet()
    -
    Description copied from interface: java.util.Map
    -
    Returns a Set view of the mappings contained in this map. - The set is backed by the map, so changes to the map are - reflected in the set, and vice-versa. If the map is modified - while an iteration over the set is in progress (except through - the iterator's own remove operation, or through the - setValue operation on a map entry returned by the - iterator) the results of the iteration are undefined. The set - supports element removal, which removes the corresponding - mapping from the map, via the Iterator.remove, - Set.remove, removeAll, retainAll and - clear operations. It does not support the - add or addAll operations.
    Specified by:
    entrySet in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    @@ -935,8 +724,6 @@

    entrySet

    entrySet in interface java.util.SortedMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    entrySet in class ForwardingMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a set view of the mappings contained in this map
    • @@ -947,18 +734,6 @@

    entrySet

  • keySet

    public java.util.Set<K> keySet()
    -
    Description copied from interface: java.util.Map
    -
    Returns a Set view of the keys contained in this map. - The set is backed by the map, so changes to the map are - reflected in the set, and vice-versa. If the map is modified - while an iteration over the set is in progress (except through - the iterator's own remove operation), the results of - the iteration are undefined. The set supports element removal, - which removes the corresponding mapping from the map, via the - Iterator.remove, Set.remove, - removeAll, retainAll, and clear - operations. It does not support the add or addAll - operations.
    Specified by:
    keySet in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    @@ -966,8 +741,6 @@

    keySet

    keySet in interface java.util.SortedMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    keySet in class ForwardingMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a set view of the keys contained in this map
    • @@ -978,22 +751,9 @@

    keySet

  • navigableKeySet

    public java.util.NavigableSet<K> navigableKeySet()
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a NavigableSet view of the keys contained in this map. - The set's iterator returns the keys in ascending order. - The set is backed by the map, so changes to the map are reflected in - the set, and vice-versa. If the map is modified while an iteration - over the set is in progress (except through the iterator's own - remove operation), the results of the iteration are undefined. The - set supports element removal, which removes the corresponding mapping - from the map, via the Iterator.remove, Set.remove, - removeAll, retainAll, and clear operations. - It does not support the add or addAll operations.
    Specified by:
    navigableKeySet in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a navigable set view of the keys in this map
    • @@ -1004,22 +764,9 @@

    navigableKeySet

  • descendingKeySet

    public java.util.NavigableSet<K> descendingKeySet()
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a reverse order NavigableSet view of the keys contained in this map. - The set's iterator returns the keys in descending order. - The set is backed by the map, so changes to the map are reflected in - the set, and vice-versa. If the map is modified while an iteration - over the set is in progress (except through the iterator's own - remove operation), the results of the iteration are undefined. The - set supports element removal, which removes the corresponding mapping - from the map, via the Iterator.remove, Set.remove, - removeAll, retainAll, and clear operations. - It does not support the add or addAll operations.
    Specified by:
    descendingKeySet in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a reverse order navigable set view of the keys in this map
    • @@ -1035,31 +782,9 @@

    subMap

    boolean fromInclusive, K toKey, boolean toInclusive) -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a view of the portion of this map whose keys range from - fromKey to toKey. If fromKey and - toKey are equal, the returned map is empty unless - fromInclusive and toInclusive are both true. The - returned map is backed by this map, so changes in the returned map are - reflected in this map, and vice-versa. The returned map supports all - optional map operations that this map supports. - -

    The returned map will throw an IllegalArgumentException - on an attempt to insert a key outside of its range, or to construct a - submap either of whose endpoints lie outside its range.

    Specified by:
    subMap in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromKey - low endpoint of the keys in the returned map
    -
    fromInclusive - true if the low endpoint - is to be included in the returned view
    -
    toKey - high endpoint of the keys in the returned map
    -
    toInclusive - true if the high endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this map whose keys range from - fromKey to toKey
    @@ -1073,30 +798,11 @@

    subMap

    subMap

    public java.util.SortedMap<K,​V> subMap​(K fromKey,
                                              K toKey)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a view of the portion of this map whose keys range from - fromKey, inclusive, to toKey, exclusive. (If - fromKey and toKey are equal, the returned map - is empty.) The returned map is backed by this map, so changes - in the returned map are reflected in this map, and vice-versa. - The returned map supports all optional map operations that this - map supports. - -

    The returned map will throw an IllegalArgumentException - on an attempt to insert a key outside its range. - -

    Equivalent to subMap(fromKey, true, toKey, false).

    Specified by:
    subMap in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Specified by:
    subMap in interface java.util.SortedMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromKey - low endpoint (inclusive) of the keys in the returned map
    -
    toKey - high endpoint (exclusive) of the keys in the returned map
    -
    Returns:
    -
    a view of the portion of this map whose keys range from - fromKey, inclusive, to toKey, exclusive
    @@ -1110,25 +816,9 @@

    subMap

    headMap

    public java.util.NavigableMap<K,​V> headMap​(K toKey,
                                                  boolean inclusive)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a view of the portion of this map whose keys are less than (or - equal to, if inclusive is true) toKey. The returned - map is backed by this map, so changes in the returned map are reflected - in this map, and vice-versa. The returned map supports all optional - map operations that this map supports. - -

    The returned map will throw an IllegalArgumentException - on an attempt to insert a key outside its range.

    Specified by:
    headMap in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    toKey - high endpoint of the keys in the returned map
    -
    inclusive - true if the high endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this map whose keys are less than - (or equal to, if inclusive is true) toKey
    @@ -1141,27 +831,11 @@

    headMap

  • headMap

    public java.util.SortedMap<K,​V> headMap​(K toKey)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a view of the portion of this map whose keys are - strictly less than toKey. The returned map is backed - by this map, so changes in the returned map are reflected in - this map, and vice-versa. The returned map supports all - optional map operations that this map supports. - -

    The returned map will throw an IllegalArgumentException - on an attempt to insert a key outside its range. - -

    Equivalent to headMap(toKey, false).

    Specified by:
    headMap in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Specified by:
    headMap in interface java.util.SortedMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    toKey - high endpoint (exclusive) of the keys in the returned map
    -
    Returns:
    -
    a view of the portion of this map whose keys are strictly - less than toKey
    • @@ -1175,25 +849,9 @@

    headMap

    tailMap

    public java.util.NavigableMap<K,​V> tailMap​(K fromKey,
                                                  boolean inclusive)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a view of the portion of this map whose keys are greater than (or - equal to, if inclusive is true) fromKey. The returned - map is backed by this map, so changes in the returned map are reflected - in this map, and vice-versa. The returned map supports all optional - map operations that this map supports. - -

    The returned map will throw an IllegalArgumentException - on an attempt to insert a key outside its range.

    Specified by:
    tailMap in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromKey - low endpoint of the keys in the returned map
    -
    inclusive - true if the low endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this map whose keys are greater than - (or equal to, if inclusive is true) fromKey
    @@ -1206,27 +864,11 @@

    tailMap

  • tailMap

    public java.util.SortedMap<K,​V> tailMap​(K fromKey)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a view of the portion of this map whose keys are - greater than or equal to fromKey. The returned map is - backed by this map, so changes in the returned map are - reflected in this map, and vice-versa. The returned map - supports all optional map operations that this map supports. - -

    The returned map will throw an IllegalArgumentException - on an attempt to insert a key outside its range. - -

    Equivalent to tailMap(fromKey, true).

    Specified by:
    tailMap in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Specified by:
    tailMap in interface java.util.SortedMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromKey - low endpoint (inclusive) of the keys in the returned map
    -
    Returns:
    -
    a view of the portion of this map whose keys are greater - than or equal to fromKey
    • @@ -1237,18 +879,6 @@

    tailMap

  • values

    public java.util.Collection<V> values()
    -
    Description copied from interface: java.util.Map
    -
    Returns a Collection view of the values contained in this map. - The collection is backed by the map, so changes to the map are - reflected in the collection, and vice-versa. If the map is - modified while an iteration over the collection is in progress - (except through the iterator's own remove operation), - the results of the iteration are undefined. The collection - supports element removal, which removes the corresponding - mapping from the map, via the Iterator.remove, - Collection.remove, removeAll, - retainAll and clear operations. It does not - support the add or addAll operations.
    Specified by:
    values in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    @@ -1256,8 +886,6 @@

    values

    values in interface java.util.SortedMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    values in class ForwardingMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a collection view of the values contained in this map
    • @@ -1273,8 +901,6 @@

    toString

    Overrides:
    toString in class ForwardingObject
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingNavigableMap.StandardNavigableKeySet.html b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingNavigableMap.StandardNavigableKeySet.html index bcad59d7b169..55b19fc16c87 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingNavigableMap.StandardNavigableKeySet.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingNavigableMap.StandardNavigableKeySet.html @@ -206,162 +206,108 @@

    Method Summary

    K ceiling​(K e) - -
    Returns the least element in this set greater than or equal to - the given element, or null if there is no such element.
    - +  void clear() - -
    Removes all of the elements from this collection (optional operation).
    - +  java.util.Comparator<? super K> comparator() - -
    Returns the comparator used to order the elements in this set, - or null if this set uses the natural ordering of its elements.
    - +  boolean contains​(java.lang.Object o) - -
    Returns true if this collection contains the specified element.
    - +  java.util.Iterator<K> descendingIterator() - -
    Returns an iterator over the elements in this set, in descending order.
    - +  java.util.NavigableSet<K> descendingSet() - -
    Returns a reverse order view of the elements contained in this set.
    - +  K first() - -
    Returns the first (lowest) element currently in this set.
    - +  K floor​(K e) - -
    Returns the greatest element in this set less than or equal to - the given element, or null if there is no such element.
    - +  java.util.SortedSet<K> headSet​(K toElement) - -
    Returns a view of the portion of this set whose elements are - strictly less than toElement.
    - +  java.util.NavigableSet<K> headSet​(K toElement, boolean inclusive) - -
    Returns a view of the portion of this set whose elements are less than - (or equal to, if inclusive is true) toElement.
    - +  K higher​(K e) - -
    Returns the least element in this set strictly greater than the - given element, or null if there is no such element.
    - +  boolean isEmpty() - -
    Returns true if this collection contains no elements.
    - +  java.util.Iterator<K> iterator() - -
    Returns an iterator over the elements contained in this collection.
    - +  K last() - -
    Returns the last (highest) element currently in this set.
    - +  K lower​(K e) - -
    Returns the greatest element in this set strictly less than the - given element, or null if there is no such element.
    - +  K pollFirst() - -
    Retrieves and removes the first (lowest) element, - or returns null if this set is empty.
    - +  K pollLast() - -
    Retrieves and removes the last (highest) element, - or returns null if this set is empty.
    - +  boolean remove​(java.lang.Object o) - -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation).
    - +  boolean removeAll​(java.util.Collection<?> c) - -
    Removes from this set all of its elements that are contained in the - specified collection (optional operation).
    - +  boolean retainAll​(java.util.Collection<?> c) - -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation).
    - +  int size() - -
    Returns the number of elements in this collection.
    - +  java.util.NavigableSet<K> @@ -369,37 +315,24 @@

    Method Summary

    boolean fromInclusive, K toElement, boolean toInclusive) - -
    Returns a view of the portion of this set whose elements range from - fromElement to toElement.
    - +  java.util.SortedSet<K> subSet​(K fromElement, K toElement) - -
    Returns a view of the portion of this set whose elements range - from fromElement, inclusive, to toElement, - exclusive.
    - +  java.util.SortedSet<K> tailSet​(K fromElement) - -
    Returns a view of the portion of this set whose elements are - greater than or equal to fromElement.
    - +  java.util.NavigableSet<K> tailSet​(K fromElement, boolean inclusive) - -
    Returns a view of the portion of this set whose elements are greater - than (or equal to, if inclusive is true) fromElement.
    - + 
      @@ -504,17 +437,9 @@

      Method Detail

      lower

      @CheckForNull
 public K lower​(K e)
      -
      Description copied from interface: java.util.NavigableSet
      -
      Returns the greatest element in this set strictly less than the - given element, or null if there is no such element.
      Specified by:
      lower in interface java.util.NavigableSet<K extends @Nullable java.lang.Object>
      -
      Parameters:
      -
      e - the value to match
      -
      Returns:
      -
      the greatest element less than e, - or null if there is no such element
    @@ -528,17 +453,9 @@

    lower

    floor

    @CheckForNull
 public K floor​(K e)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns the greatest element in this set less than or equal to - the given element, or null if there is no such element.
    Specified by:
    floor in interface java.util.NavigableSet<K extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    e - the value to match
    -
    Returns:
    -
    the greatest element less than or equal to e, - or null if there is no such element
    @@ -552,17 +469,9 @@

    floor

    ceiling

    @CheckForNull
 public K ceiling​(K e)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns the least element in this set greater than or equal to - the given element, or null if there is no such element.
    Specified by:
    ceiling in interface java.util.NavigableSet<K extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    e - the value to match
    -
    Returns:
    -
    the least element greater than or equal to e, - or null if there is no such element
    @@ -576,17 +485,9 @@

    ceiling

    higher

    @CheckForNull
 public K higher​(K e)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns the least element in this set strictly greater than the - given element, or null if there is no such element.
    Specified by:
    higher in interface java.util.NavigableSet<K extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    e - the value to match
    -
    Returns:
    -
    the least element greater than e, - or null if there is no such element
    @@ -598,14 +499,9 @@

    higher

    pollFirst

    @CheckForNull
 public K pollFirst()
    -
    Description copied from interface: java.util.NavigableSet
    -
    Retrieves and removes the first (lowest) element, - or returns null if this set is empty.
    Specified by:
    pollFirst in interface java.util.NavigableSet<K extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the first element, or null if this set is empty
    @@ -617,14 +513,9 @@

    pollFirst

    pollLast

    @CheckForNull
 public K pollLast()
    -
    Description copied from interface: java.util.NavigableSet
    -
    Retrieves and removes the last (highest) element, - or returns null if this set is empty.
    Specified by:
    pollLast in interface java.util.NavigableSet<K extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the last element, or null if this set is empty
    @@ -635,23 +526,9 @@

    pollLast

  • descendingSet

    public java.util.NavigableSet<K> descendingSet()
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns a reverse order view of the elements contained in this set. - The descending set is backed by this set, so changes to the set are - reflected in the descending set, and vice-versa. If either set is - modified while an iteration over either set is in progress (except - through the iterator's own remove operation), the results of - the iteration are undefined. - -

    The returned set has an ordering equivalent to - Collections.reverseOrder(comparator()). - The expression s.descendingSet().descendingSet() returns a - view of s essentially equivalent to s.

    Specified by:
    descendingSet in interface java.util.NavigableSet<K extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a reverse order view of this set
    • @@ -662,14 +539,9 @@

    descendingSet

  • descendingIterator

    public java.util.Iterator<K> descendingIterator()
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns an iterator over the elements in this set, in descending order. - Equivalent in effect to descendingSet().iterator().
    Specified by:
    descendingIterator in interface java.util.NavigableSet<K extends @Nullable java.lang.Object>
    -
    Returns:
    -
    an iterator over the elements in this set, in descending order
    • @@ -685,30 +557,9 @@

    subSet

    boolean fromInclusive, K toElement, boolean toInclusive) -
    Description copied from interface: java.util.NavigableSet
    -
    Returns a view of the portion of this set whose elements range from - fromElement to toElement. If fromElement and - toElement are equal, the returned set is empty unless - fromInclusive and toInclusive are both true. The returned set - is backed by this set, so changes in the returned set are reflected in - this set, and vice-versa. The returned set supports all optional set - operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    subSet in interface java.util.NavigableSet<K extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromElement - low endpoint of the returned set
    -
    fromInclusive - true if the low endpoint - is to be included in the returned view
    -
    toElement - high endpoint of the returned set
    -
    toInclusive - true if the high endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this set whose elements range from - fromElement, inclusive, to toElement, exclusive
    @@ -722,28 +573,11 @@

    subSet

    subSet

    public java.util.SortedSet<K> subSet​(K fromElement,
                                      K toElement)
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns a view of the portion of this set whose elements range - from fromElement, inclusive, to toElement, - exclusive. (If fromElement and toElement are - equal, the returned set is empty.) The returned set is backed - by this set, so changes in the returned set are reflected in - this set, and vice-versa. The returned set supports all - optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    subSet in interface java.util.NavigableSet<K extends @Nullable java.lang.Object>
    Specified by:
    subSet in interface java.util.SortedSet<K extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromElement - low endpoint (inclusive) of the returned set
    -
    toElement - high endpoint (exclusive) of the returned set
    -
    Returns:
    -
    a view of the portion of this set whose elements range from - fromElement, inclusive, to toElement, exclusive
    @@ -757,25 +591,9 @@

    subSet

    headSet

    public java.util.NavigableSet<K> headSet​(K toElement,
                                          boolean inclusive)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns a view of the portion of this set whose elements are less than - (or equal to, if inclusive is true) toElement. The - returned set is backed by this set, so changes in the returned set are - reflected in this set, and vice-versa. The returned set supports all - optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    headSet in interface java.util.NavigableSet<K extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    toElement - high endpoint of the returned set
    -
    inclusive - true if the high endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this set whose elements are less than - (or equal to, if inclusive is true) toElement
    @@ -788,25 +606,11 @@

    headSet

  • headSet

    public java.util.SortedSet<K> headSet​(K toElement)
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns a view of the portion of this set whose elements are - strictly less than toElement. The returned set is - backed by this set, so changes in the returned set are - reflected in this set, and vice-versa. The returned set - supports all optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    headSet in interface java.util.NavigableSet<K extends @Nullable java.lang.Object>
    Specified by:
    headSet in interface java.util.SortedSet<K extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    toElement - high endpoint (exclusive) of the returned set
    -
    Returns:
    -
    a view of the portion of this set whose elements are strictly - less than toElement
    • @@ -820,25 +624,9 @@

    headSet

    tailSet

    public java.util.NavigableSet<K> tailSet​(K fromElement,
                                          boolean inclusive)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns a view of the portion of this set whose elements are greater - than (or equal to, if inclusive is true) fromElement. - The returned set is backed by this set, so changes in the returned set - are reflected in this set, and vice-versa. The returned set supports - all optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    tailSet in interface java.util.NavigableSet<K extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromElement - low endpoint of the returned set
    -
    inclusive - true if the low endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this set whose elements are greater - than or equal to fromElement
    @@ -851,25 +639,11 @@

    tailSet

  • tailSet

    public java.util.SortedSet<K> tailSet​(K fromElement)
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns a view of the portion of this set whose elements are - greater than or equal to fromElement. The returned - set is backed by this set, so changes in the returned set are - reflected in this set, and vice-versa. The returned set - supports all optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    tailSet in interface java.util.NavigableSet<K extends @Nullable java.lang.Object>
    Specified by:
    tailSet in interface java.util.SortedSet<K extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromElement - low endpoint (inclusive) of the returned set
    -
    Returns:
    -
    a view of the portion of this set whose elements are greater - than or equal to fromElement
    • @@ -881,16 +655,9 @@

    tailSet

    comparator

    @CheckForNull
 public java.util.Comparator<? super K> comparator()
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns the comparator used to order the elements in this set, - or null if this set uses the natural ordering of its elements.
    Specified by:
    comparator in interface java.util.SortedSet<K extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the comparator used to order the elements in this set, - or null if this set uses the natural ordering - of its elements
    @@ -901,13 +668,9 @@

    comparator

  • first

    public K first()
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns the first (lowest) element currently in this set.
    Specified by:
    first in interface java.util.SortedSet<K extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the first (lowest) element currently in this set
    • @@ -918,13 +681,9 @@

    first

  • last

    public K last()
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns the last (highest) element currently in this set.
    Specified by:
    last in interface java.util.SortedSet<K extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the last (highest) element currently in this set
    • @@ -935,8 +694,6 @@

    last

  • iterator

    public java.util.Iterator<K> iterator()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns an iterator over the elements contained in this collection.
    Specified by:
    iterator in interface java.util.Collection<K extends @Nullable java.lang.Object>
    @@ -946,8 +703,6 @@

    iterator

    iterator in interface java.util.Set<K extends @Nullable java.lang.Object>
    Specified by:
    iterator in class java.util.AbstractCollection<K extends @Nullable java.lang.Object>
    -
    Returns:
    -
    an iterator over the elements contained in this collection
    • @@ -958,10 +713,6 @@

    iterator

  • size

    public int size()
    -
    Description copied from interface: java.util.Collection
    -
    Returns the number of elements in this collection. If this collection - contains more than Integer.MAX_VALUE elements, returns - Integer.MAX_VALUE.
    Specified by:
    size in interface java.util.Collection<K extends @Nullable java.lang.Object>
    @@ -969,8 +720,6 @@

    size

    size in interface java.util.Set<K extends @Nullable java.lang.Object>
    Specified by:
    size in class java.util.AbstractCollection<K extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the number of elements in this collection
    • @@ -981,8 +730,6 @@

    size

  • isEmpty

    public boolean isEmpty()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains no elements.
    Specified by:
    isEmpty in interface java.util.Collection<K extends @Nullable java.lang.Object>
    @@ -990,8 +737,6 @@

    isEmpty

    isEmpty in interface java.util.Set<K extends @Nullable java.lang.Object>
    Overrides:
    isEmpty in class java.util.AbstractCollection<K extends @Nullable java.lang.Object>
    -
    Returns:
    -
    true if this collection contains no elements
    • @@ -1003,11 +748,6 @@

    isEmpty

    contains

    public boolean contains​(@CheckForNull
                         java.lang.Object o)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains the specified element. - More formally, returns true if and only if this collection - contains at least one element e such that - Objects.equals(o, e).
    Specified by:
    contains in interface java.util.Collection<K extends @Nullable java.lang.Object>
    @@ -1015,11 +755,6 @@

    contains

    contains in interface java.util.Set<K extends @Nullable java.lang.Object>
    Overrides:
    contains in class java.util.AbstractCollection<K extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    o - element whose presence in this collection is to be tested
    -
    Returns:
    -
    true if this collection contains the specified - element
    @@ -1031,14 +766,6 @@

    contains

    remove

    public boolean remove​(@CheckForNull
                       java.lang.Object o)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation). More formally, - removes an element e such that - Objects.equals(o, e), if - this collection contains one or more such elements. Returns - true if this collection contained the specified element (or - equivalently, if this collection changed as a result of the call).
    Specified by:
    remove in interface java.util.Collection<K extends @Nullable java.lang.Object>
    @@ -1046,10 +773,6 @@

    remove

    remove in interface java.util.Set<K extends @Nullable java.lang.Object>
    Overrides:
    remove in class java.util.AbstractCollection<K extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    o - element to be removed from this collection, if present
    -
    Returns:
    -
    true if an element was removed as a result of this call
    @@ -1060,9 +783,6 @@

    remove

  • clear

    public void clear()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes all of the elements from this collection (optional operation). - The collection will be empty after this method returns.
    Specified by:
    clear in interface java.util.Collection<K extends @Nullable java.lang.Object>
    @@ -1080,28 +800,6 @@

    clear

  • removeAll

    public boolean removeAll​(java.util.Collection<?> c)
    -
    Description copied from class: java.util.AbstractSet
    -
    Removes from this set all of its elements that are contained in the - specified collection (optional operation). If the specified - collection is also a set, this operation effectively modifies this - set so that its value is the asymmetric set difference of - the two sets. - -

    This implementation determines which is the smaller of this set - and the specified collection, by invoking the size - method on each. If this set has fewer elements, then the - implementation iterates over this set, checking each element - returned by the iterator in turn to see if it is contained in - the specified collection. If it is so contained, it is removed - from this set with the iterator's remove method. If - the specified collection has fewer elements, then the - implementation iterates over the specified collection, removing - from this set each element returned by the iterator, using this - set's remove method. - -

    Note that this implementation will throw an - UnsupportedOperationException if the iterator returned by the - iterator method does not implement the remove method.

    Specified by:
    removeAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -1109,13 +807,6 @@

    removeAll

    removeAll in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    removeAll in class java.util.AbstractSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    c - collection containing elements to be removed from this set
    -
    Returns:
    -
    true if this set changed as a result of the call
    -
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    • @@ -1126,11 +817,6 @@

    removeAll

  • retainAll

    public boolean retainAll​(java.util.Collection<?> c)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation). In other words, removes from - this collection all of its elements that are not contained in the - specified collection.
    Specified by:
    retainAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -1138,13 +824,6 @@

    retainAll

    retainAll in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    retainAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    c - collection containing elements to be retained in this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    -
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingNavigableMap.html b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingNavigableMap.html index f0fa500949a2..ea05ae79f45f 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingNavigableMap.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingNavigableMap.html @@ -237,7 +237,7 @@

    Nested classes/interfaces inherited from class com.google.common.collec

    Nested classes/interfaces inherited from interface java.util.Map

    -java.util.Map.Entry<K,​V>
    • +java.util.Map.Entry<K extends java.lang.Object,​V extends java.lang.Object> @@ -284,19 +284,12 @@

    Method Summary

    java.util.Map.Entry<K,​V> ceilingEntry​(K key) - -
    Returns a key-value mapping associated with the least key - greater than or equal to the given key, or null if - there is no such key.
    - +  K ceilingKey​(K key) - -
    Returns the least key greater than or equal to the given key, - or null if there is no such key.
    - +  protected abstract java.util.NavigableMap<K,​V> @@ -308,115 +301,73 @@

    Method Summary

    java.util.NavigableSet<K> descendingKeySet() - -
    Returns a reverse order NavigableSet view of the keys contained in this map.
    - +  java.util.NavigableMap<K,​V> descendingMap() - -
    Returns a reverse order view of the mappings contained in this map.
    - +  java.util.Map.Entry<K,​V> firstEntry() - -
    Returns a key-value mapping associated with the least - key in this map, or null if the map is empty.
    - +  java.util.Map.Entry<K,​V> floorEntry​(K key) - -
    Returns a key-value mapping associated with the greatest key - less than or equal to the given key, or null if there - is no such key.
    - +  K floorKey​(K key) - -
    Returns the greatest key less than or equal to the given key, - or null if there is no such key.
    - +  java.util.NavigableMap<K,​V> headMap​(K toKey, boolean inclusive) - -
    Returns a view of the portion of this map whose keys are less than (or - equal to, if inclusive is true) toKey.
    - +  java.util.Map.Entry<K,​V> higherEntry​(K key) - -
    Returns a key-value mapping associated with the least key - strictly greater than the given key, or null if there - is no such key.
    - +  K higherKey​(K key) - -
    Returns the least key strictly greater than the given key, or - null if there is no such key.
    - +  java.util.Map.Entry<K,​V> lastEntry() - -
    Returns a key-value mapping associated with the greatest - key in this map, or null if the map is empty.
    - +  java.util.Map.Entry<K,​V> lowerEntry​(K key) - -
    Returns a key-value mapping associated with the greatest key - strictly less than the given key, or null if there is - no such key.
    - +  K lowerKey​(K key) - -
    Returns the greatest key strictly less than the given key, or - null if there is no such key.
    - +  java.util.NavigableSet<K> navigableKeySet() - -
    Returns a NavigableSet view of the keys contained in this map.
    - +  java.util.Map.Entry<K,​V> pollFirstEntry() - -
    Removes and returns a key-value mapping associated with - the least key in this map, or null if the map is empty.
    - +  java.util.Map.Entry<K,​V> pollLastEntry() - -
    Removes and returns a key-value mapping associated with - the greatest key in this map, or null if the map is empty.
    - +  protected java.util.Map.Entry<K,​V> @@ -556,19 +507,13 @@

    Method Summary

    boolean fromInclusive, K toKey, boolean toInclusive) - -
    Returns a view of the portion of this map whose keys range from - fromKey to toKey.
    - +  java.util.NavigableMap<K,​V> tailMap​(K fromKey, boolean inclusive) - -
    Returns a view of the portion of this map whose keys are greater than (or - equal to, if inclusive is true) fromKey.
    - + 
      @@ -684,18 +629,9 @@

      delegate

      lowerEntry

      @CheckForNull
 public java.util.Map.Entry<K,​V> lowerEntry​(K key)
      -
      Description copied from interface: java.util.NavigableMap
      -
      Returns a key-value mapping associated with the greatest key - strictly less than the given key, or null if there is - no such key.
      Specified by:
      lowerEntry in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
      -
      Parameters:
      -
      key - the key
      -
      Returns:
      -
      an entry with the greatest key less than key, - or null if there is no such key
    @@ -723,17 +659,9 @@

    standardLowerEntry

    lowerKey

    @CheckForNull
 public K lowerKey​(K key)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns the greatest key strictly less than the given key, or - null if there is no such key.
    Specified by:
    lowerKey in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - the key
    -
    Returns:
    -
    the greatest key less than key, - or null if there is no such key
    @@ -762,18 +690,9 @@

    standardLowerKey

    floorEntry

    @CheckForNull
 public java.util.Map.Entry<K,​V> floorEntry​(K key)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a key-value mapping associated with the greatest key - less than or equal to the given key, or null if there - is no such key.
    Specified by:
    floorEntry in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - the key
    -
    Returns:
    -
    an entry with the greatest key less than or equal to - key, or null if there is no such key
    @@ -801,17 +720,9 @@

    standardFloorEntry

    floorKey

    @CheckForNull
 public K floorKey​(K key)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns the greatest key less than or equal to the given key, - or null if there is no such key.
    Specified by:
    floorKey in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - the key
    -
    Returns:
    -
    the greatest key less than or equal to key, - or null if there is no such key
    @@ -840,18 +751,9 @@

    standardFloorKey

    ceilingEntry

    @CheckForNull
 public java.util.Map.Entry<K,​V> ceilingEntry​(K key)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a key-value mapping associated with the least key - greater than or equal to the given key, or null if - there is no such key.
    Specified by:
    ceilingEntry in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - the key
    -
    Returns:
    -
    an entry with the least key greater than or equal to - key, or null if there is no such key
    @@ -879,17 +781,9 @@

    standardCeilingEntry

    ceilingKey

    @CheckForNull
 public K ceilingKey​(K key)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns the least key greater than or equal to the given key, - or null if there is no such key.
    Specified by:
    ceilingKey in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - the key
    -
    Returns:
    -
    the least key greater than or equal to key, - or null if there is no such key
    @@ -918,18 +812,9 @@

    standardCeilingKey

    higherEntry

    @CheckForNull
 public java.util.Map.Entry<K,​V> higherEntry​(K key)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a key-value mapping associated with the least key - strictly greater than the given key, or null if there - is no such key.
    Specified by:
    higherEntry in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - the key
    -
    Returns:
    -
    an entry with the least key greater than key, - or null if there is no such key
    @@ -957,17 +842,9 @@

    standardHigherEntry

    higherKey

    @CheckForNull
 public K higherKey​(K key)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns the least key strictly greater than the given key, or - null if there is no such key.
    Specified by:
    higherKey in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - the key
    -
    Returns:
    -
    the least key greater than key, - or null if there is no such key
    @@ -994,15 +871,9 @@

    standardHigherKey

    firstEntry

    @CheckForNull
 public java.util.Map.Entry<K,​V> firstEntry()
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a key-value mapping associated with the least - key in this map, or null if the map is empty.
    Specified by:
    firstEntry in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    an entry with the least key, - or null if this map is empty
    @@ -1038,15 +909,9 @@

    standardFirstKey

    lastEntry

    @CheckForNull
 public java.util.Map.Entry<K,​V> lastEntry()
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a key-value mapping associated with the greatest - key in this map, or null if the map is empty.
    Specified by:
    lastEntry in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    an entry with the greatest key, - or null if this map is empty
    @@ -1081,15 +946,9 @@

    standardLastKey

    pollFirstEntry

    @CheckForNull
 public java.util.Map.Entry<K,​V> pollFirstEntry()
    -
    Description copied from interface: java.util.NavigableMap
    -
    Removes and returns a key-value mapping associated with - the least key in this map, or null if the map is empty.
    Specified by:
    pollFirstEntry in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the removed first entry of this map, - or null if this map is empty
    @@ -1114,15 +973,9 @@

    standardPollFirstEntry

    pollLastEntry

    @CheckForNull
 public java.util.Map.Entry<K,​V> pollLastEntry()
    -
    Description copied from interface: java.util.NavigableMap
    -
    Removes and returns a key-value mapping associated with - the greatest key in this map, or null if the map is empty.
    Specified by:
    pollLastEntry in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the removed last entry of this map, - or null if this map is empty
    @@ -1146,23 +999,9 @@

    standardPollLastEntry

  • descendingMap

    public java.util.NavigableMap<K,​V> descendingMap()
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a reverse order view of the mappings contained in this map. - The descending map is backed by this map, so changes to the map are - reflected in the descending map, and vice-versa. If either map is - modified while an iteration over a collection view of either map - is in progress (except through the iterator's own remove - operation), the results of the iteration are undefined. - -

    The returned map has an ordering equivalent to - Collections.reverseOrder(comparator()). - The expression m.descendingMap().descendingMap() returns a - view of m essentially equivalent to m.

    Specified by:
    descendingMap in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a reverse order view of this map
    • @@ -1173,22 +1012,9 @@

    descendingMap

  • navigableKeySet

    public java.util.NavigableSet<K> navigableKeySet()
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a NavigableSet view of the keys contained in this map. - The set's iterator returns the keys in ascending order. - The set is backed by the map, so changes to the map are reflected in - the set, and vice-versa. If the map is modified while an iteration - over the set is in progress (except through the iterator's own - remove operation), the results of the iteration are undefined. The - set supports element removal, which removes the corresponding mapping - from the map, via the Iterator.remove, Set.remove, - removeAll, retainAll, and clear operations. - It does not support the add or addAll operations.
    Specified by:
    navigableKeySet in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a navigable set view of the keys in this map
    • @@ -1199,22 +1025,9 @@

    navigableKeySet

  • descendingKeySet

    public java.util.NavigableSet<K> descendingKeySet()
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a reverse order NavigableSet view of the keys contained in this map. - The set's iterator returns the keys in descending order. - The set is backed by the map, so changes to the map are reflected in - the set, and vice-versa. If the map is modified while an iteration - over the set is in progress (except through the iterator's own - remove operation), the results of the iteration are undefined. The - set supports element removal, which removes the corresponding mapping - from the map, via the Iterator.remove, Set.remove, - removeAll, retainAll, and clear operations. - It does not support the add or addAll operations.
    Specified by:
    descendingKeySet in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a reverse order navigable set view of the keys in this map
    • @@ -1263,31 +1076,9 @@

    subMap

    boolean fromInclusive, K toKey, boolean toInclusive) -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a view of the portion of this map whose keys range from - fromKey to toKey. If fromKey and - toKey are equal, the returned map is empty unless - fromInclusive and toInclusive are both true. The - returned map is backed by this map, so changes in the returned map are - reflected in this map, and vice-versa. The returned map supports all - optional map operations that this map supports. - -

    The returned map will throw an IllegalArgumentException - on an attempt to insert a key outside of its range, or to construct a - submap either of whose endpoints lie outside its range.

    Specified by:
    subMap in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromKey - low endpoint of the keys in the returned map
    -
    fromInclusive - true if the low endpoint - is to be included in the returned view
    -
    toKey - high endpoint of the keys in the returned map
    -
    toInclusive - true if the high endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this map whose keys range from - fromKey to toKey
    @@ -1301,25 +1092,9 @@

    subMap

    headMap

    public java.util.NavigableMap<K,​V> headMap​(K toKey,
                                                  boolean inclusive)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a view of the portion of this map whose keys are less than (or - equal to, if inclusive is true) toKey. The returned - map is backed by this map, so changes in the returned map are reflected - in this map, and vice-versa. The returned map supports all optional - map operations that this map supports. - -

    The returned map will throw an IllegalArgumentException - on an attempt to insert a key outside its range.

    Specified by:
    headMap in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    toKey - high endpoint of the keys in the returned map
    -
    inclusive - true if the high endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this map whose keys are less than - (or equal to, if inclusive is true) toKey
    @@ -1333,25 +1108,9 @@

    headMap

    tailMap

    public java.util.NavigableMap<K,​V> tailMap​(K fromKey,
                                                  boolean inclusive)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a view of the portion of this map whose keys are greater than (or - equal to, if inclusive is true) fromKey. The returned - map is backed by this map, so changes in the returned map are reflected - in this map, and vice-versa. The returned map supports all optional - map operations that this map supports. - -

    The returned map will throw an IllegalArgumentException - on an attempt to insert a key outside its range.

    Specified by:
    tailMap in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromKey - low endpoint of the keys in the returned map
    -
    inclusive - true if the low endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this map whose keys are greater than - (or equal to, if inclusive is true) fromKey
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingNavigableSet.StandardDescendingSet.html b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingNavigableSet.StandardDescendingSet.html index b5f07dc5377a..72eaddf11df1 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingNavigableSet.StandardDescendingSet.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingNavigableSet.StandardDescendingSet.html @@ -240,18 +240,12 @@

    Method Summary

    E ceiling​(E e) - -
    Returns the least element in this set greater than or equal to - the given element, or null if there is no such element.
    - +  java.util.Comparator<? super E> comparator() - -
    Returns the comparator used to order the elements in this set, - or null if this set uses the natural ordering of its elements.
    - +  protected java.util.NavigableSet<E> @@ -263,94 +257,63 @@

    Method Summary

    java.util.Iterator<E> descendingIterator() - -
    Returns an iterator over the elements in this set, in descending order.
    - +  java.util.NavigableSet<E> descendingSet() - -
    Returns a reverse order view of the elements contained in this set.
    - +  E first() - -
    Returns the first (lowest) element currently in this set.
    - +  E floor​(E e) - -
    Returns the greatest element in this set less than or equal to - the given element, or null if there is no such element.
    - +  java.util.SortedSet<E> headSet​(E toElement) - -
    Returns a view of the portion of this set whose elements are - strictly less than toElement.
    - +  java.util.NavigableSet<E> headSet​(E toElement, boolean inclusive) - -
    Returns a view of the portion of this set whose elements are less than - (or equal to, if inclusive is true) toElement.
    - +  E higher​(E e) - -
    Returns the least element in this set strictly greater than the - given element, or null if there is no such element.
    - +  java.util.Iterator<E> iterator() - -
    Returns an iterator over the elements in this collection.
    - +  E last() - -
    Returns the last (highest) element currently in this set.
    - +  E lower​(E e) - -
    Returns the greatest element in this set strictly less than the - given element, or null if there is no such element.
    - +  E pollFirst() - -
    Retrieves and removes the first (lowest) element, - or returns null if this set is empty.
    - +  E pollLast() - -
    Retrieves and removes the last (highest) element, - or returns null if this set is empty.
    - +  java.util.NavigableSet<E> @@ -358,52 +321,34 @@

    Method Summary

    boolean fromInclusive, E toElement, boolean toInclusive) - -
    Returns a view of the portion of this set whose elements range from - fromElement to toElement.
    - +  java.util.SortedSet<E> subSet​(E fromElement, E toElement) - -
    Returns a view of the portion of this set whose elements range - from fromElement, inclusive, to toElement, - exclusive.
    - +  java.util.SortedSet<E> tailSet​(E fromElement) - -
    Returns a view of the portion of this set whose elements are - greater than or equal to fromElement.
    - +  java.util.NavigableSet<E> tailSet​(E fromElement, boolean inclusive) - -
    Returns a view of the portion of this set whose elements are greater - than (or equal to, if inclusive is true) fromElement.
    - +  @Nullable java.lang.Object[] toArray() - -
    Returns an array containing all of the elements in this collection.
    - +  <T extends @Nullable java.lang.Object>
    T[]     toArray​(T[] array) - -
    Returns an array containing all of the elements in this collection; - the runtime type of the returned array is that of the specified array.
    - +  java.lang.String @@ -540,19 +485,11 @@

    delegate

    lower

    @CheckForNull
 public E lower​(E e)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns the greatest element in this set strictly less than the - given element, or null if there is no such element.
    Specified by:
    lower in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    Overrides:
    lower in class ForwardingNavigableSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    e - the value to match
    -
    Returns:
    -
    the greatest element less than e, - or null if there is no such element
    @@ -566,19 +503,11 @@

    lower

    floor

    @CheckForNull
 public E floor​(E e)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns the greatest element in this set less than or equal to - the given element, or null if there is no such element.
    Specified by:
    floor in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    Overrides:
    floor in class ForwardingNavigableSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    e - the value to match
    -
    Returns:
    -
    the greatest element less than or equal to e, - or null if there is no such element
    @@ -592,19 +521,11 @@

    floor

    ceiling

    @CheckForNull
 public E ceiling​(E e)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns the least element in this set greater than or equal to - the given element, or null if there is no such element.
    Specified by:
    ceiling in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    Overrides:
    ceiling in class ForwardingNavigableSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    e - the value to match
    -
    Returns:
    -
    the least element greater than or equal to e, - or null if there is no such element
    @@ -618,19 +539,11 @@

    ceiling

    higher

    @CheckForNull
 public E higher​(E e)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns the least element in this set strictly greater than the - given element, or null if there is no such element.
    Specified by:
    higher in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    Overrides:
    higher in class ForwardingNavigableSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    e - the value to match
    -
    Returns:
    -
    the least element greater than e, - or null if there is no such element
    @@ -642,16 +555,11 @@

    higher

    pollFirst

    @CheckForNull
 public E pollFirst()
    -
    Description copied from interface: java.util.NavigableSet
    -
    Retrieves and removes the first (lowest) element, - or returns null if this set is empty.
    Specified by:
    pollFirst in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    Overrides:
    pollFirst in class ForwardingNavigableSet<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the first element, or null if this set is empty
    @@ -663,16 +571,11 @@

    pollFirst

    pollLast

    @CheckForNull
 public E pollLast()
    -
    Description copied from interface: java.util.NavigableSet
    -
    Retrieves and removes the last (highest) element, - or returns null if this set is empty.
    Specified by:
    pollLast in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    Overrides:
    pollLast in class ForwardingNavigableSet<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the last element, or null if this set is empty
    @@ -683,25 +586,11 @@

    pollLast

  • descendingSet

    public java.util.NavigableSet<E> descendingSet()
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns a reverse order view of the elements contained in this set. - The descending set is backed by this set, so changes to the set are - reflected in the descending set, and vice-versa. If either set is - modified while an iteration over either set is in progress (except - through the iterator's own remove operation), the results of - the iteration are undefined. - -

    The returned set has an ordering equivalent to - Collections.reverseOrder(comparator()). - The expression s.descendingSet().descendingSet() returns a - view of s essentially equivalent to s.

    Specified by:
    descendingSet in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    Overrides:
    descendingSet in class ForwardingNavigableSet<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a reverse order view of this set
    • @@ -712,16 +601,11 @@

    descendingSet

  • descendingIterator

    public java.util.Iterator<E> descendingIterator()
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns an iterator over the elements in this set, in descending order. - Equivalent in effect to descendingSet().iterator().
    Specified by:
    descendingIterator in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    Overrides:
    descendingIterator in class ForwardingNavigableSet<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    an iterator over the elements in this set, in descending order
    • @@ -737,32 +621,11 @@

    subSet

    boolean fromInclusive, E toElement, boolean toInclusive) -
    Description copied from interface: java.util.NavigableSet
    -
    Returns a view of the portion of this set whose elements range from - fromElement to toElement. If fromElement and - toElement are equal, the returned set is empty unless - fromInclusive and toInclusive are both true. The returned set - is backed by this set, so changes in the returned set are reflected in - this set, and vice-versa. The returned set supports all optional set - operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    subSet in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    Overrides:
    subSet in class ForwardingNavigableSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromElement - low endpoint of the returned set
    -
    fromInclusive - true if the low endpoint - is to be included in the returned view
    -
    toElement - high endpoint of the returned set
    -
    toInclusive - true if the high endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this set whose elements range from - fromElement, inclusive, to toElement, exclusive
    @@ -776,17 +639,6 @@

    subSet

    subSet

    public java.util.SortedSet<E> subSet​(E fromElement,
                                      E toElement)
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns a view of the portion of this set whose elements range - from fromElement, inclusive, to toElement, - exclusive. (If fromElement and toElement are - equal, the returned set is empty.) The returned set is backed - by this set, so changes in the returned set are reflected in - this set, and vice-versa. The returned set supports all - optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    subSet in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    @@ -794,12 +646,6 @@

    subSet

    subSet in interface java.util.SortedSet<E extends @Nullable java.lang.Object>
    Overrides:
    subSet in class ForwardingSortedSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromElement - low endpoint (inclusive) of the returned set
    -
    toElement - high endpoint (exclusive) of the returned set
    -
    Returns:
    -
    a view of the portion of this set whose elements range from - fromElement, inclusive, to toElement, exclusive
    @@ -813,27 +659,11 @@

    subSet

    headSet

    public java.util.NavigableSet<E> headSet​(E toElement,
                                          boolean inclusive)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns a view of the portion of this set whose elements are less than - (or equal to, if inclusive is true) toElement. The - returned set is backed by this set, so changes in the returned set are - reflected in this set, and vice-versa. The returned set supports all - optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    headSet in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    Overrides:
    headSet in class ForwardingNavigableSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    toElement - high endpoint of the returned set
    -
    inclusive - true if the high endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this set whose elements are less than - (or equal to, if inclusive is true) toElement
    @@ -846,15 +676,6 @@

    headSet

  • headSet

    public java.util.SortedSet<E> headSet​(E toElement)
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns a view of the portion of this set whose elements are - strictly less than toElement. The returned set is - backed by this set, so changes in the returned set are - reflected in this set, and vice-versa. The returned set - supports all optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    headSet in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    @@ -862,11 +683,6 @@

    headSet

    headSet in interface java.util.SortedSet<E extends @Nullable java.lang.Object>
    Overrides:
    headSet in class ForwardingSortedSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    toElement - high endpoint (exclusive) of the returned set
    -
    Returns:
    -
    a view of the portion of this set whose elements are strictly - less than toElement
    • @@ -880,27 +696,11 @@

    headSet

    tailSet

    public java.util.NavigableSet<E> tailSet​(E fromElement,
                                          boolean inclusive)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns a view of the portion of this set whose elements are greater - than (or equal to, if inclusive is true) fromElement. - The returned set is backed by this set, so changes in the returned set - are reflected in this set, and vice-versa. The returned set supports - all optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    tailSet in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    Overrides:
    tailSet in class ForwardingNavigableSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromElement - low endpoint of the returned set
    -
    inclusive - true if the low endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this set whose elements are greater - than or equal to fromElement
    @@ -913,15 +713,6 @@

    tailSet

  • tailSet

    public java.util.SortedSet<E> tailSet​(E fromElement)
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns a view of the portion of this set whose elements are - greater than or equal to fromElement. The returned - set is backed by this set, so changes in the returned set are - reflected in this set, and vice-versa. The returned set - supports all optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    tailSet in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    @@ -929,11 +720,6 @@

    tailSet

    tailSet in interface java.util.SortedSet<E extends @Nullable java.lang.Object>
    Overrides:
    tailSet in class ForwardingSortedSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromElement - low endpoint (inclusive) of the returned set
    -
    Returns:
    -
    a view of the portion of this set whose elements are greater - than or equal to fromElement
    • @@ -944,18 +730,11 @@

    tailSet

  • comparator

    public java.util.Comparator<? super E> comparator()
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns the comparator used to order the elements in this set, - or null if this set uses the natural ordering of its elements.
    Specified by:
    comparator in interface java.util.SortedSet<E extends @Nullable java.lang.Object>
    Overrides:
    comparator in class ForwardingSortedSet<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the comparator used to order the elements in this set, - or null if this set uses the natural ordering - of its elements
    • @@ -966,15 +745,11 @@

    comparator

  • first

    public E first()
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns the first (lowest) element currently in this set.
    Specified by:
    first in interface java.util.SortedSet<E extends @Nullable java.lang.Object>
    Overrides:
    first in class ForwardingSortedSet<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the first (lowest) element currently in this set
    • @@ -985,15 +760,11 @@

    first

  • last

    public E last()
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns the last (highest) element currently in this set.
    Specified by:
    last in interface java.util.SortedSet<E extends @Nullable java.lang.Object>
    Overrides:
    last in class ForwardingSortedSet<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the last (highest) element currently in this set
    • @@ -1004,11 +775,6 @@

    last

  • iterator

    public java.util.Iterator<E> iterator()
    -
    Description copied from interface: java.util.Collection
    -
    Returns an iterator over the elements in this collection. There are no - guarantees concerning the order in which the elements are returned - (unless this collection is an instance of some class that provides a - guarantee).
    Specified by:
    iterator in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -1020,8 +786,6 @@

    iterator

    iterator in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    iterator in class ForwardingCollection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    an Iterator over the elements in this collection
    • @@ -1032,16 +796,6 @@

    iterator

  • toArray

    public @Nullable java.lang.Object[] toArray()
    -
    Description copied from interface: java.util.Collection
    -
    Returns an array containing all of the elements in this collection. - If this collection makes any guarantees as to what order its elements - are returned by its iterator, this method must return the elements in - the same order. The returned array's runtime component type is Object. - -

    The returned array will be "safe" in that no references to it are - maintained by this collection. (In other words, this method must - allocate a new array even if this collection is backed by an array). - The caller is thus free to modify the returned array.

    Specified by:
    toArray in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -1049,9 +803,6 @@

    toArray

    toArray in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    toArray in class ForwardingCollection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    an array, whose runtime component - type is Object, containing all of the elements in this collection
    • @@ -1064,23 +815,6 @@

    toArray

  • toArray

    public <T extends @Nullable java.lang.Object> T[] toArray​(T[] array)
    -
    Description copied from interface: java.util.Collection
    -
    Returns an array containing all of the elements in this collection; - the runtime type of the returned array is that of the specified array. - If the collection fits in the specified array, it is returned therein. - Otherwise, a new array is allocated with the runtime type of the - specified array and the size of this collection. - -

    If this collection fits in the specified array with room to spare - (i.e., the array has more elements than this collection), the element - in the array immediately following the end of the collection is set to - null. (This is useful in determining the length of this - collection only if the caller knows that this collection does - not contain any null elements.) - -

    If this collection makes any guarantees as to what order its elements - are returned by its iterator, this method must return the elements in - the same order.

    Specified by:
    toArray in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -1088,14 +822,6 @@

    toArray

    toArray in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    toArray in class ForwardingCollection<E extends @Nullable java.lang.Object>
    -
    Type Parameters:
    -
    T - the component type of the array to contain the collection
    -
    Parameters:
    -
    array - the array into which the elements of this collection are to be - stored, if it is big enough; otherwise, a new array of the same - runtime type is allocated for this purpose.
    -
    Returns:
    -
    an array containing all of the elements in this collection
    • @@ -1111,8 +837,6 @@

    toString

    Overrides:
    toString in class ForwardingObject
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingNavigableSet.html b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingNavigableSet.html index 7a0dddbdff01..504e6cbc5677 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingNavigableSet.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingNavigableSet.html @@ -264,10 +264,7 @@

    Method Summary

    E ceiling​(E e) - -
    Returns the least element in this set greater than or equal to - the given element, or null if there is no such element.
    - +  protected abstract java.util.NavigableSet<E> @@ -279,65 +276,43 @@

    Method Summary

    java.util.Iterator<E> descendingIterator() - -
    Returns an iterator over the elements in this set, in descending order.
    - +  java.util.NavigableSet<E> descendingSet() - -
    Returns a reverse order view of the elements contained in this set.
    - +  E floor​(E e) - -
    Returns the greatest element in this set less than or equal to - the given element, or null if there is no such element.
    - +  java.util.NavigableSet<E> headSet​(E toElement, boolean inclusive) - -
    Returns a view of the portion of this set whose elements are less than - (or equal to, if inclusive is true) toElement.
    - +  E higher​(E e) - -
    Returns the least element in this set strictly greater than the - given element, or null if there is no such element.
    - +  E lower​(E e) - -
    Returns the greatest element in this set strictly less than the - given element, or null if there is no such element.
    - +  E pollFirst() - -
    Retrieves and removes the first (lowest) element, - or returns null if this set is empty.
    - +  E pollLast() - -
    Retrieves and removes the last (highest) element, - or returns null if this set is empty.
    - +  protected E @@ -435,19 +410,13 @@

    Method Summary

    boolean fromInclusive, E toElement, boolean toInclusive) - -
    Returns a view of the portion of this set whose elements range from - fromElement to toElement.
    - +  java.util.NavigableSet<E> tailSet​(E fromElement, boolean inclusive) - -
    Returns a view of the portion of this set whose elements are greater - than (or equal to, if inclusive is true) fromElement.
    - + 
      @@ -584,17 +553,9 @@

      delegate

      lower

      @CheckForNull
 public E lower​(E e)
      -
      Description copied from interface: java.util.NavigableSet
      -
      Returns the greatest element in this set strictly less than the - given element, or null if there is no such element.
      Specified by:
      lower in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
      -
      Parameters:
      -
      e - the value to match
      -
      Returns:
      -
      the greatest element less than e, - or null if there is no such element
    @@ -623,17 +584,9 @@

    standardLower

    floor

    @CheckForNull
 public E floor​(E e)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns the greatest element in this set less than or equal to - the given element, or null if there is no such element.
    Specified by:
    floor in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    e - the value to match
    -
    Returns:
    -
    the greatest element less than or equal to e, - or null if there is no such element
    @@ -662,17 +615,9 @@

    standardFloor

    ceiling

    @CheckForNull
 public E ceiling​(E e)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns the least element in this set greater than or equal to - the given element, or null if there is no such element.
    Specified by:
    ceiling in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    e - the value to match
    -
    Returns:
    -
    the least element greater than or equal to e, - or null if there is no such element
    @@ -700,17 +645,9 @@

    standardCeiling

    higher

    @CheckForNull
 public E higher​(E e)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns the least element in this set strictly greater than the - given element, or null if there is no such element.
    Specified by:
    higher in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    e - the value to match
    -
    Returns:
    -
    the least element greater than e, - or null if there is no such element
    @@ -736,14 +673,9 @@

    standardHigher

    pollFirst

    @CheckForNull
 public E pollFirst()
    -
    Description copied from interface: java.util.NavigableSet
    -
    Retrieves and removes the first (lowest) element, - or returns null if this set is empty.
    Specified by:
    pollFirst in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the first element, or null if this set is empty
    @@ -768,14 +700,9 @@

    standardPollFirst

    pollLast

    @CheckForNull
 public E pollLast()
    -
    Description copied from interface: java.util.NavigableSet
    -
    Retrieves and removes the last (highest) element, - or returns null if this set is empty.
    Specified by:
    pollLast in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the last element, or null if this set is empty
    @@ -817,23 +744,9 @@

    standardLast

  • descendingSet

    public java.util.NavigableSet<E> descendingSet()
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns a reverse order view of the elements contained in this set. - The descending set is backed by this set, so changes to the set are - reflected in the descending set, and vice-versa. If either set is - modified while an iteration over either set is in progress (except - through the iterator's own remove operation), the results of - the iteration are undefined. - -

    The returned set has an ordering equivalent to - Collections.reverseOrder(comparator()). - The expression s.descendingSet().descendingSet() returns a - view of s essentially equivalent to s.

    Specified by:
    descendingSet in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a reverse order view of this set
    • @@ -844,14 +757,9 @@

    descendingSet

  • descendingIterator

    public java.util.Iterator<E> descendingIterator()
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns an iterator over the elements in this set, in descending order. - Equivalent in effect to descendingSet().iterator().
    Specified by:
    descendingIterator in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    an iterator over the elements in this set, in descending order
    • @@ -867,30 +775,9 @@

    subSet

    boolean fromInclusive, E toElement, boolean toInclusive) -
    Description copied from interface: java.util.NavigableSet
    -
    Returns a view of the portion of this set whose elements range from - fromElement to toElement. If fromElement and - toElement are equal, the returned set is empty unless - fromInclusive and toInclusive are both true. The returned set - is backed by this set, so changes in the returned set are reflected in - this set, and vice-versa. The returned set supports all optional set - operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    subSet in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromElement - low endpoint of the returned set
    -
    fromInclusive - true if the low endpoint - is to be included in the returned view
    -
    toElement - high endpoint of the returned set
    -
    toInclusive - true if the high endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this set whose elements range from - fromElement, inclusive, to toElement, exclusive
    @@ -941,25 +828,9 @@

    standardSubSet

    headSet

    public java.util.NavigableSet<E> headSet​(E toElement,
                                          boolean inclusive)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns a view of the portion of this set whose elements are less than - (or equal to, if inclusive is true) toElement. The - returned set is backed by this set, so changes in the returned set are - reflected in this set, and vice-versa. The returned set supports all - optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    headSet in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    toElement - high endpoint of the returned set
    -
    inclusive - true if the high endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this set whose elements are less than - (or equal to, if inclusive is true) toElement
    @@ -987,25 +858,9 @@

    standardHeadSet

    tailSet

    public java.util.NavigableSet<E> tailSet​(E fromElement,
                                          boolean inclusive)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns a view of the portion of this set whose elements are greater - than (or equal to, if inclusive is true) fromElement. - The returned set is backed by this set, so changes in the returned set - are reflected in this set, and vice-versa. The returned set supports - all optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    tailSet in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromElement - low endpoint of the returned set
    -
    inclusive - true if the low endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this set whose elements are greater - than or equal to fromElement
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingObject.html b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingObject.html index 0f6f73df97d8..37aa2b385fe2 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingObject.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingObject.html @@ -289,8 +289,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingQueue.html b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingQueue.html index e6f8295025c2..df220ce60b58 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingQueue.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingQueue.html @@ -230,40 +230,27 @@

    Method Summary

    E element() - -
    Retrieves, but does not remove, the head of this queue.
    - +  boolean offer​(E o) - -
    Inserts the specified element into this queue if it is possible to do - so immediately without violating capacity restrictions.
    - +  E peek() - -
    Retrieves, but does not remove, the head of this queue, - or returns null if this queue is empty.
    - +  E poll() - -
    Retrieves and removes the head of this queue, - or returns null if this queue is empty.
    - +  E remove() - -
    Retrieves and removes the head of this queue.
    - +  protected boolean @@ -393,20 +380,9 @@

    delegate

    offer

    @CanIgnoreReturnValue
 public boolean offer​(E o)
    -
    Description copied from interface: java.util.Queue
    -
    Inserts the specified element into this queue if it is possible to do - so immediately without violating capacity restrictions. - When using a capacity-restricted queue, this method is generally - preferable to Queue.add(E), which can fail to insert an element only - by throwing an exception.
    Specified by:
    offer in interface java.util.Queue<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    o - the element to add
    -
    Returns:
    -
    true if the element was added to this queue, else - false
    @@ -419,14 +395,9 @@

    poll

    @CanIgnoreReturnValue
 @CheckForNull
 public E poll()
    -
    Description copied from interface: java.util.Queue
    -
    Retrieves and removes the head of this queue, - or returns null if this queue is empty.
    Specified by:
    poll in interface java.util.Queue<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the head of this queue, or null if this queue is empty
    @@ -438,15 +409,9 @@

    poll

    remove

    @CanIgnoreReturnValue
 public E remove()
    -
    Description copied from interface: java.util.Queue
    -
    Retrieves and removes the head of this queue. This method differs - from poll() only in that it throws an exception if - this queue is empty.
    Specified by:
    remove in interface java.util.Queue<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the head of this queue
    @@ -458,14 +423,9 @@

    remove

    peek

    @CheckForNull
 public E peek()
    -
    Description copied from interface: java.util.Queue
    -
    Retrieves, but does not remove, the head of this queue, - or returns null if this queue is empty.
    Specified by:
    peek in interface java.util.Queue<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the head of this queue, or null if this queue is empty
    @@ -476,15 +436,9 @@

    peek

  • element

    public E element()
    -
    Description copied from interface: java.util.Queue
    -
    Retrieves, but does not remove, the head of this queue. This method - differs from peek only in that it throws an exception - if this queue is empty.
    Specified by:
    element in interface java.util.Queue<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the head of this queue
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingSet.html b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingSet.html index 0d9bacec274d..1790659cc236 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingSet.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingSet.html @@ -230,16 +230,12 @@

    Method Summary

    boolean equals​(java.lang.Object object) - -
    Indicates whether some other object is "equal to" this one.
    - +  int hashCode() - -
    Returns a hash code value for the object.
    - +  protected boolean @@ -367,45 +363,6 @@

    delegate

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object object)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    Specified by:
    equals in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -413,14 +370,6 @@

    equals

    equals in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -431,35 +380,6 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    Specified by:
    hashCode in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -467,11 +387,6 @@

    hashCode

    hashCode in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingSortedMap.StandardKeySet.html b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingSortedMap.StandardKeySet.html index ed769447abef..1157e0c796c8 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingSortedMap.StandardKeySet.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingSortedMap.StandardKeySet.html @@ -205,109 +205,73 @@

    Method Summary

    void clear() - -
    Removes all of the elements from this collection (optional operation).
    - +  java.util.Comparator<? super K> comparator() - -
    Returns the comparator used to order the elements in this set, - or null if this set uses the natural ordering of its elements.
    - +  boolean contains​(java.lang.Object o) - -
    Returns true if this collection contains the specified element.
    - +  K first() - -
    Returns the first (lowest) element currently in this set.
    - +  java.util.SortedSet<K> headSet​(K toElement) - -
    Returns a view of the portion of this set whose elements are - strictly less than toElement.
    - +  boolean isEmpty() - -
    Returns true if this collection contains no elements.
    - +  java.util.Iterator<K> iterator() - -
    Returns an iterator over the elements contained in this collection.
    - +  K last() - -
    Returns the last (highest) element currently in this set.
    - +  boolean remove​(java.lang.Object o) - -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation).
    - +  boolean removeAll​(java.util.Collection<?> c) - -
    Removes from this set all of its elements that are contained in the - specified collection (optional operation).
    - +  boolean retainAll​(java.util.Collection<?> c) - -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation).
    - +  int size() - -
    Returns the number of elements in this collection.
    - +  java.util.SortedSet<K> subSet​(K fromElement, K toElement) - -
    Returns a view of the portion of this set whose elements range - from fromElement, inclusive, to toElement, - exclusive.
    - +  java.util.SortedSet<K> tailSet​(K fromElement) - -
    Returns a view of the portion of this set whose elements are - greater than or equal to fromElement.
    - + 
      @@ -403,16 +367,9 @@

      Method Detail

      comparator

      @CheckForNull
 public java.util.Comparator<? super K> comparator()
      -
      Description copied from interface: java.util.SortedSet
      -
      Returns the comparator used to order the elements in this set, - or null if this set uses the natural ordering of its elements.
      Specified by:
      comparator in interface java.util.SortedSet<K extends @Nullable java.lang.Object>
      -
      Returns:
      -
      the comparator used to order the elements in this set, - or null if this set uses the natural ordering - of its elements
    @@ -426,26 +383,9 @@

    comparator

    subSet

    public java.util.SortedSet<K> subSet​(K fromElement,
                                      K toElement)
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns a view of the portion of this set whose elements range - from fromElement, inclusive, to toElement, - exclusive. (If fromElement and toElement are - equal, the returned set is empty.) The returned set is backed - by this set, so changes in the returned set are reflected in - this set, and vice-versa. The returned set supports all - optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    subSet in interface java.util.SortedSet<K extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromElement - low endpoint (inclusive) of the returned set
    -
    toElement - high endpoint (exclusive) of the returned set
    -
    Returns:
    -
    a view of the portion of this set whose elements range from - fromElement, inclusive, to toElement, exclusive
    @@ -458,23 +398,9 @@

    subSet

  • headSet

    public java.util.SortedSet<K> headSet​(K toElement)
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns a view of the portion of this set whose elements are - strictly less than toElement. The returned set is - backed by this set, so changes in the returned set are - reflected in this set, and vice-versa. The returned set - supports all optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    headSet in interface java.util.SortedSet<K extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    toElement - high endpoint (exclusive) of the returned set
    -
    Returns:
    -
    a view of the portion of this set whose elements are strictly - less than toElement
    • @@ -487,23 +413,9 @@

    headSet

  • tailSet

    public java.util.SortedSet<K> tailSet​(K fromElement)
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns a view of the portion of this set whose elements are - greater than or equal to fromElement. The returned - set is backed by this set, so changes in the returned set are - reflected in this set, and vice-versa. The returned set - supports all optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    tailSet in interface java.util.SortedSet<K extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromElement - low endpoint (inclusive) of the returned set
    -
    Returns:
    -
    a view of the portion of this set whose elements are greater - than or equal to fromElement
    • @@ -514,13 +426,9 @@

    tailSet

  • first

    public K first()
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns the first (lowest) element currently in this set.
    Specified by:
    first in interface java.util.SortedSet<K extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the first (lowest) element currently in this set
    • @@ -531,13 +439,9 @@

    first

  • last

    public K last()
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns the last (highest) element currently in this set.
    Specified by:
    last in interface java.util.SortedSet<K extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the last (highest) element currently in this set
    • @@ -548,8 +452,6 @@

    last

  • iterator

    public java.util.Iterator<K> iterator()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns an iterator over the elements contained in this collection.
    Specified by:
    iterator in interface java.util.Collection<K extends @Nullable java.lang.Object>
    @@ -559,8 +461,6 @@

    iterator

    iterator in interface java.util.Set<K extends @Nullable java.lang.Object>
    Specified by:
    iterator in class java.util.AbstractCollection<K extends @Nullable java.lang.Object>
    -
    Returns:
    -
    an iterator over the elements contained in this collection
    • @@ -571,10 +471,6 @@

    iterator

  • size

    public int size()
    -
    Description copied from interface: java.util.Collection
    -
    Returns the number of elements in this collection. If this collection - contains more than Integer.MAX_VALUE elements, returns - Integer.MAX_VALUE.
    Specified by:
    size in interface java.util.Collection<K extends @Nullable java.lang.Object>
    @@ -582,8 +478,6 @@

    size

    size in interface java.util.Set<K extends @Nullable java.lang.Object>
    Specified by:
    size in class java.util.AbstractCollection<K extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the number of elements in this collection
    • @@ -594,8 +488,6 @@

    size

  • isEmpty

    public boolean isEmpty()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains no elements.
    Specified by:
    isEmpty in interface java.util.Collection<K extends @Nullable java.lang.Object>
    @@ -603,8 +495,6 @@

    isEmpty

    isEmpty in interface java.util.Set<K extends @Nullable java.lang.Object>
    Overrides:
    isEmpty in class java.util.AbstractCollection<K extends @Nullable java.lang.Object>
    -
    Returns:
    -
    true if this collection contains no elements
    • @@ -616,11 +506,6 @@

    isEmpty

    contains

    public boolean contains​(@CheckForNull
                         java.lang.Object o)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains the specified element. - More formally, returns true if and only if this collection - contains at least one element e such that - Objects.equals(o, e).
    Specified by:
    contains in interface java.util.Collection<K extends @Nullable java.lang.Object>
    @@ -628,11 +513,6 @@

    contains

    contains in interface java.util.Set<K extends @Nullable java.lang.Object>
    Overrides:
    contains in class java.util.AbstractCollection<K extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    o - element whose presence in this collection is to be tested
    -
    Returns:
    -
    true if this collection contains the specified - element
    @@ -644,14 +524,6 @@

    contains

    remove

    public boolean remove​(@CheckForNull
                       java.lang.Object o)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation). More formally, - removes an element e such that - Objects.equals(o, e), if - this collection contains one or more such elements. Returns - true if this collection contained the specified element (or - equivalently, if this collection changed as a result of the call).
    Specified by:
    remove in interface java.util.Collection<K extends @Nullable java.lang.Object>
    @@ -659,10 +531,6 @@

    remove

    remove in interface java.util.Set<K extends @Nullable java.lang.Object>
    Overrides:
    remove in class java.util.AbstractCollection<K extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    o - element to be removed from this collection, if present
    -
    Returns:
    -
    true if an element was removed as a result of this call
    @@ -673,9 +541,6 @@

    remove

  • clear

    public void clear()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes all of the elements from this collection (optional operation). - The collection will be empty after this method returns.
    Specified by:
    clear in interface java.util.Collection<K extends @Nullable java.lang.Object>
    @@ -693,28 +558,6 @@

    clear

  • removeAll

    public boolean removeAll​(java.util.Collection<?> c)
    -
    Description copied from class: java.util.AbstractSet
    -
    Removes from this set all of its elements that are contained in the - specified collection (optional operation). If the specified - collection is also a set, this operation effectively modifies this - set so that its value is the asymmetric set difference of - the two sets. - -

    This implementation determines which is the smaller of this set - and the specified collection, by invoking the size - method on each. If this set has fewer elements, then the - implementation iterates over this set, checking each element - returned by the iterator in turn to see if it is contained in - the specified collection. If it is so contained, it is removed - from this set with the iterator's remove method. If - the specified collection has fewer elements, then the - implementation iterates over the specified collection, removing - from this set each element returned by the iterator, using this - set's remove method. - -

    Note that this implementation will throw an - UnsupportedOperationException if the iterator returned by the - iterator method does not implement the remove method.

    Specified by:
    removeAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -722,13 +565,6 @@

    removeAll

    removeAll in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    removeAll in class java.util.AbstractSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    c - collection containing elements to be removed from this set
    -
    Returns:
    -
    true if this set changed as a result of the call
    -
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    • @@ -739,11 +575,6 @@

    removeAll

  • retainAll

    public boolean retainAll​(java.util.Collection<?> c)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation). In other words, removes from - this collection all of its elements that are not contained in the - specified collection.
    Specified by:
    retainAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -751,13 +582,6 @@

    retainAll

    retainAll in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    retainAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    c - collection containing elements to be retained in this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    -
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingSortedMap.html b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingSortedMap.html index 99b26ea2a655..a8e83b6f3411 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingSortedMap.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingSortedMap.html @@ -220,7 +220,7 @@

    Nested classes/interfaces inherited from class com.google.common.collec

    Nested classes/interfaces inherited from interface java.util.Map

    -java.util.Map.Entry<K,​V>
    • +java.util.Map.Entry<K extends java.lang.Object,​V extends java.lang.Object> @@ -267,10 +267,7 @@

    Method Summary

    java.util.Comparator<? super K> comparator() - -
    Returns the comparator used to order the keys in this map, or - null if this map uses the natural ordering of its keys.
    - +  protected abstract java.util.SortedMap<K,​V> @@ -282,24 +279,17 @@

    Method Summary

    K firstKey() - -
    Returns the first (lowest) key currently in this map.
    - +  java.util.SortedMap<K,​V> headMap​(K toKey) - -
    Returns a view of the portion of this map whose keys are - strictly less than toKey.
    - +  K lastKey() - -
    Returns the last (highest) key currently in this map.
    - +  protected boolean @@ -321,18 +311,12 @@

    Method Summary

    java.util.SortedMap<K,​V> subMap​(K fromKey, K toKey) - -
    Returns a view of the portion of this map whose keys range from - fromKey, inclusive, to toKey, exclusive.
    - +  java.util.SortedMap<K,​V> tailMap​(K fromKey) - -
    Returns a view of the portion of this map whose keys are - greater than or equal to fromKey.
    - + 
      @@ -432,16 +416,9 @@

      delegate

      comparator

      @CheckForNull
 public java.util.Comparator<? super K> comparator()
      -
      Description copied from interface: java.util.SortedMap
      -
      Returns the comparator used to order the keys in this map, or - null if this map uses the natural ordering of its keys.
      Specified by:
      comparator in interface java.util.SortedMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
      -
      Returns:
      -
      the comparator used to order the keys in this map, - or null if this map uses the natural ordering - of its keys
    @@ -452,13 +429,9 @@

    comparator

  • firstKey

    public K firstKey()
    -
    Description copied from interface: java.util.SortedMap
    -
    Returns the first (lowest) key currently in this map.
    Specified by:
    firstKey in interface java.util.SortedMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the first (lowest) key currently in this map
    • @@ -471,23 +444,9 @@

    firstKey

  • headMap

    public java.util.SortedMap<K,​V> headMap​(K toKey)
    -
    Description copied from interface: java.util.SortedMap
    -
    Returns a view of the portion of this map whose keys are - strictly less than toKey. The returned map is backed - by this map, so changes in the returned map are reflected in - this map, and vice-versa. The returned map supports all - optional map operations that this map supports. - -

    The returned map will throw an IllegalArgumentException - on an attempt to insert a key outside its range.

    Specified by:
    headMap in interface java.util.SortedMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    toKey - high endpoint (exclusive) of the keys in the returned map
    -
    Returns:
    -
    a view of the portion of this map whose keys are strictly - less than toKey
    • @@ -498,13 +457,9 @@

    headMap

  • lastKey

    public K lastKey()
    -
    Description copied from interface: java.util.SortedMap
    -
    Returns the last (highest) key currently in this map.
    Specified by:
    lastKey in interface java.util.SortedMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the last (highest) key currently in this map
    • @@ -518,26 +473,9 @@

    lastKey

    subMap

    public java.util.SortedMap<K,​V> subMap​(K fromKey,
                                              K toKey)
    -
    Description copied from interface: java.util.SortedMap
    -
    Returns a view of the portion of this map whose keys range from - fromKey, inclusive, to toKey, exclusive. (If - fromKey and toKey are equal, the returned map - is empty.) The returned map is backed by this map, so changes - in the returned map are reflected in this map, and vice-versa. - The returned map supports all optional map operations that this - map supports. - -

    The returned map will throw an IllegalArgumentException - on an attempt to insert a key outside its range.

    Specified by:
    subMap in interface java.util.SortedMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromKey - low endpoint (inclusive) of the keys in the returned map
    -
    toKey - high endpoint (exclusive) of the keys in the returned map
    -
    Returns:
    -
    a view of the portion of this map whose keys range from - fromKey, inclusive, to toKey, exclusive
    @@ -550,23 +488,9 @@

    subMap

  • tailMap

    public java.util.SortedMap<K,​V> tailMap​(K fromKey)
    -
    Description copied from interface: java.util.SortedMap
    -
    Returns a view of the portion of this map whose keys are - greater than or equal to fromKey. The returned map is - backed by this map, so changes in the returned map are - reflected in this map, and vice-versa. The returned map - supports all optional map operations that this map supports. - -

    The returned map will throw an IllegalArgumentException - on an attempt to insert a key outside its range.

    Specified by:
    tailMap in interface java.util.SortedMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromKey - low endpoint (inclusive) of the keys in the returned map
    -
    Returns:
    -
    a view of the portion of this map whose keys are greater - than or equal to fromKey
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingSortedMultiset.StandardDescendingMultiset.html b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingSortedMultiset.StandardDescendingMultiset.html index a34ac471f537..115e65a3cf76 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingSortedMultiset.StandardDescendingMultiset.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingSortedMultiset.StandardDescendingMultiset.html @@ -292,9 +292,6 @@

    Method Summary

    java.util.Iterator<E> iterator() - -
    Returns an iterator over the elements in this collection.
    - Multiset.Entry<E> @@ -343,17 +340,12 @@

    Method Summary

    @Nullable java.lang.Object[] toArray() - -
    Returns an array containing all of the elements in this collection.
    - +  <T extends @Nullable java.lang.Object>
    T[]     toArray​(T[] array) - -
    Returns an array containing all of the elements in this collection; - the runtime type of the returned array is that of the specified array.
    - +  java.lang.String @@ -705,11 +697,14 @@

    entrySet

  • iterator

    public java.util.Iterator<E> iterator()
    -
    Description copied from interface: java.util.Collection
    -
    Returns an iterator over the elements in this collection. There are no - guarantees concerning the order in which the elements are returned - (unless this collection is an instance of some class that provides a - guarantee).
    +
    Description copied from interface: SortedMultiset
    +
    + +

    Elements that occur multiple times in the multiset will appear multiple times in this + iterator, though not necessarily sequentially. + +

    The iterator returns the elements in ascending order according to this multiset's + comparator.

    Specified by:
    iterator in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -721,8 +716,6 @@

    iterator

    iterator in interface SortedMultiset<E extends @Nullable java.lang.Object>
    Overrides:
    iterator in class ForwardingCollection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    an Iterator over the elements in this collection
    • @@ -733,24 +726,11 @@

    iterator

  • toArray

    public @Nullable java.lang.Object[] toArray()
    -
    Description copied from interface: java.util.Collection
    -
    Returns an array containing all of the elements in this collection. - If this collection makes any guarantees as to what order its elements - are returned by its iterator, this method must return the elements in - the same order. The returned array's runtime component type is Object. - -

    The returned array will be "safe" in that no references to it are - maintained by this collection. (In other words, this method must - allocate a new array even if this collection is backed by an array). - The caller is thus free to modify the returned array.

    Specified by:
    toArray in interface java.util.Collection<E extends @Nullable java.lang.Object>
    Overrides:
    toArray in class ForwardingCollection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    an array, whose runtime component - type is Object, containing all of the elements in this collection
    • @@ -763,36 +743,11 @@

    toArray

  • toArray

    public <T extends @Nullable java.lang.Object> T[] toArray​(T[] array)
    -
    Description copied from interface: java.util.Collection
    -
    Returns an array containing all of the elements in this collection; - the runtime type of the returned array is that of the specified array. - If the collection fits in the specified array, it is returned therein. - Otherwise, a new array is allocated with the runtime type of the - specified array and the size of this collection. - -

    If this collection fits in the specified array with room to spare - (i.e., the array has more elements than this collection), the element - in the array immediately following the end of the collection is set to - null. (This is useful in determining the length of this - collection only if the caller knows that this collection does - not contain any null elements.) - -

    If this collection makes any guarantees as to what order its elements - are returned by its iterator, this method must return the elements in - the same order.

    Specified by:
    toArray in interface java.util.Collection<E extends @Nullable java.lang.Object>
    Overrides:
    toArray in class ForwardingCollection<E extends @Nullable java.lang.Object>
    -
    Type Parameters:
    -
    T - the component type of the array to contain the collection
    -
    Parameters:
    -
    array - the array into which the elements of this collection are to be - stored, if it is big enough; otherwise, a new array of the same - runtime type is allocated for this purpose.
    -
    Returns:
    -
    an array containing all of the elements in this collection
    • @@ -810,8 +765,6 @@

    toString

    toString in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    toString in class ForwardingObject
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingSortedMultiset.StandardElementSet.html b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingSortedMultiset.StandardElementSet.html index ac3e6246428c..326980db5fab 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingSortedMultiset.StandardElementSet.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingSortedMultiset.StandardElementSet.html @@ -209,170 +209,113 @@

    Method Summary

    E ceiling​(E e) - -
    Returns the least element in this set greater than or equal to - the given element, or null if there is no such element.
    - +  void clear() - -
    Removes all of the elements from this collection (optional operation).
    - +  java.util.Comparator<? super E> comparator() - -
    Returns the comparator used to order the elements in this set, - or null if this set uses the natural ordering of its elements.
    - +  boolean contains​(java.lang.Object o) - -
    Returns true if this collection contains the specified element.
    - +  boolean containsAll​(java.util.Collection<?> c) - -
    Returns true if this collection contains all of the elements - in the specified collection.
    - +  java.util.Iterator<E> descendingIterator() - -
    Returns an iterator over the elements in this set, in descending order.
    - +  java.util.NavigableSet<E> descendingSet() - -
    Returns a reverse order view of the elements contained in this set.
    - +  E first() - -
    Returns the first (lowest) element currently in this set.
    - +  E floor​(E e) - -
    Returns the greatest element in this set less than or equal to - the given element, or null if there is no such element.
    - +  java.util.SortedSet<E> headSet​(E toElement) - -
    Returns a view of the portion of this set whose elements are - strictly less than toElement.
    - +  java.util.NavigableSet<E> headSet​(E toElement, boolean inclusive) - -
    Returns a view of the portion of this set whose elements are less than - (or equal to, if inclusive is true) toElement.
    - +  E higher​(E e) - -
    Returns the least element in this set strictly greater than the - given element, or null if there is no such element.
    - +  boolean isEmpty() - -
    Returns true if this collection contains no elements.
    - +  java.util.Iterator<E> iterator() - -
    Returns an iterator over the elements contained in this collection.
    - +  E last() - -
    Returns the last (highest) element currently in this set.
    - +  E lower​(E e) - -
    Returns the greatest element in this set strictly less than the - given element, or null if there is no such element.
    - +  E pollFirst() - -
    Retrieves and removes the first (lowest) element, - or returns null if this set is empty.
    - +  E pollLast() - -
    Retrieves and removes the last (highest) element, - or returns null if this set is empty.
    - +  boolean remove​(java.lang.Object o) - -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation).
    - +  boolean removeAll​(java.util.Collection<?> c) - -
    Removes from this set all of its elements that are contained in the - specified collection (optional operation).
    - +  boolean retainAll​(java.util.Collection<?> c) - -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation).
    - +  int size() - -
    Returns the number of elements in this collection.
    - +  java.util.NavigableSet<E> @@ -380,37 +323,24 @@

    Method Summary

    boolean fromInclusive, E toElement, boolean toInclusive) - -
    Returns a view of the portion of this set whose elements range from - fromElement to toElement.
    - +  java.util.SortedSet<E> subSet​(E fromElement, E toElement) - -
    Returns a view of the portion of this set whose elements range - from fromElement, inclusive, to toElement, - exclusive.
    - +  java.util.SortedSet<E> tailSet​(E fromElement) - -
    Returns a view of the portion of this set whose elements are - greater than or equal to fromElement.
    - +  java.util.NavigableSet<E> tailSet​(E fromElement, boolean inclusive) - -
    Returns a view of the portion of this set whose elements are greater - than (or equal to, if inclusive is true) fromElement.
    - + 
      @@ -515,17 +445,9 @@

      Method Detail

      lower

      @CheckForNull
 public E lower​(E e)
      -
      Description copied from interface: java.util.NavigableSet
      -
      Returns the greatest element in this set strictly less than the - given element, or null if there is no such element.
      Specified by:
      lower in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
      -
      Parameters:
      -
      e - the value to match
      -
      Returns:
      -
      the greatest element less than e, - or null if there is no such element
    @@ -539,17 +461,9 @@

    lower

    floor

    @CheckForNull
 public E floor​(E e)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns the greatest element in this set less than or equal to - the given element, or null if there is no such element.
    Specified by:
    floor in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    e - the value to match
    -
    Returns:
    -
    the greatest element less than or equal to e, - or null if there is no such element
    @@ -563,17 +477,9 @@

    floor

    ceiling

    @CheckForNull
 public E ceiling​(E e)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns the least element in this set greater than or equal to - the given element, or null if there is no such element.
    Specified by:
    ceiling in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    e - the value to match
    -
    Returns:
    -
    the least element greater than or equal to e, - or null if there is no such element
    @@ -587,17 +493,9 @@

    ceiling

    higher

    @CheckForNull
 public E higher​(E e)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns the least element in this set strictly greater than the - given element, or null if there is no such element.
    Specified by:
    higher in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    e - the value to match
    -
    Returns:
    -
    the least element greater than e, - or null if there is no such element
    @@ -608,23 +506,9 @@

    higher

  • descendingSet

    public java.util.NavigableSet<E> descendingSet()
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns a reverse order view of the elements contained in this set. - The descending set is backed by this set, so changes to the set are - reflected in the descending set, and vice-versa. If either set is - modified while an iteration over either set is in progress (except - through the iterator's own remove operation), the results of - the iteration are undefined. - -

    The returned set has an ordering equivalent to - Collections.reverseOrder(comparator()). - The expression s.descendingSet().descendingSet() returns a - view of s essentially equivalent to s.

    Specified by:
    descendingSet in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a reverse order view of this set
    • @@ -635,14 +519,9 @@

    descendingSet

  • descendingIterator

    public java.util.Iterator<E> descendingIterator()
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns an iterator over the elements in this set, in descending order. - Equivalent in effect to descendingSet().iterator().
    Specified by:
    descendingIterator in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    an iterator over the elements in this set, in descending order
    • @@ -654,14 +533,9 @@

    descendingIterator

    pollFirst

    @CheckForNull
 public E pollFirst()
    -
    Description copied from interface: java.util.NavigableSet
    -
    Retrieves and removes the first (lowest) element, - or returns null if this set is empty.
    Specified by:
    pollFirst in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the first element, or null if this set is empty
    @@ -673,14 +547,9 @@

    pollFirst

    pollLast

    @CheckForNull
 public E pollLast()
    -
    Description copied from interface: java.util.NavigableSet
    -
    Retrieves and removes the last (highest) element, - or returns null if this set is empty.
    Specified by:
    pollLast in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the last element, or null if this set is empty
    @@ -696,30 +565,9 @@

    subSet

    boolean fromInclusive, E toElement, boolean toInclusive) -
    Description copied from interface: java.util.NavigableSet
    -
    Returns a view of the portion of this set whose elements range from - fromElement to toElement. If fromElement and - toElement are equal, the returned set is empty unless - fromInclusive and toInclusive are both true. The returned set - is backed by this set, so changes in the returned set are reflected in - this set, and vice-versa. The returned set supports all optional set - operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    subSet in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromElement - low endpoint of the returned set
    -
    fromInclusive - true if the low endpoint - is to be included in the returned view
    -
    toElement - high endpoint of the returned set
    -
    toInclusive - true if the high endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this set whose elements range from - fromElement, inclusive, to toElement, exclusive
    @@ -733,25 +581,9 @@

    subSet

    headSet

    public java.util.NavigableSet<E> headSet​(E toElement,
                                          boolean inclusive)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns a view of the portion of this set whose elements are less than - (or equal to, if inclusive is true) toElement. The - returned set is backed by this set, so changes in the returned set are - reflected in this set, and vice-versa. The returned set supports all - optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    headSet in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    toElement - high endpoint of the returned set
    -
    inclusive - true if the high endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this set whose elements are less than - (or equal to, if inclusive is true) toElement
    @@ -765,25 +597,9 @@

    headSet

    tailSet

    public java.util.NavigableSet<E> tailSet​(E fromElement,
                                          boolean inclusive)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns a view of the portion of this set whose elements are greater - than (or equal to, if inclusive is true) fromElement. - The returned set is backed by this set, so changes in the returned set - are reflected in this set, and vice-versa. The returned set supports - all optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    tailSet in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromElement - low endpoint of the returned set
    -
    inclusive - true if the low endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this set whose elements are greater - than or equal to fromElement
    @@ -794,8 +610,6 @@

    tailSet

  • iterator

    public java.util.Iterator<E> iterator()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns an iterator over the elements contained in this collection.
    Specified by:
    iterator in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -803,8 +617,6 @@

    iterator

    iterator in interface java.lang.Iterable<E extends @Nullable java.lang.Object>
    Specified by:
    iterator in interface java.util.Set<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    an iterator over the elements contained in this collection
    • @@ -815,16 +627,9 @@

    iterator

  • comparator

    public java.util.Comparator<? super E> comparator()
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns the comparator used to order the elements in this set, - or null if this set uses the natural ordering of its elements.
    Specified by:
    comparator in interface java.util.SortedSet<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the comparator used to order the elements in this set, - or null if this set uses the natural ordering - of its elements
    • @@ -838,26 +643,9 @@

    comparator

    subSet

    public java.util.SortedSet<E> subSet​(E fromElement,
                                      E toElement)
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns a view of the portion of this set whose elements range - from fromElement, inclusive, to toElement, - exclusive. (If fromElement and toElement are - equal, the returned set is empty.) The returned set is backed - by this set, so changes in the returned set are reflected in - this set, and vice-versa. The returned set supports all - optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    subSet in interface java.util.SortedSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromElement - low endpoint (inclusive) of the returned set
    -
    toElement - high endpoint (exclusive) of the returned set
    -
    Returns:
    -
    a view of the portion of this set whose elements range from - fromElement, inclusive, to toElement, exclusive
    @@ -870,23 +658,9 @@

    subSet

  • headSet

    public java.util.SortedSet<E> headSet​(E toElement)
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns a view of the portion of this set whose elements are - strictly less than toElement. The returned set is - backed by this set, so changes in the returned set are - reflected in this set, and vice-versa. The returned set - supports all optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    headSet in interface java.util.SortedSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    toElement - high endpoint (exclusive) of the returned set
    -
    Returns:
    -
    a view of the portion of this set whose elements are strictly - less than toElement
    • @@ -899,23 +673,9 @@

    headSet

  • tailSet

    public java.util.SortedSet<E> tailSet​(E fromElement)
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns a view of the portion of this set whose elements are - greater than or equal to fromElement. The returned - set is backed by this set, so changes in the returned set are - reflected in this set, and vice-versa. The returned set - supports all optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    tailSet in interface java.util.SortedSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromElement - low endpoint (inclusive) of the returned set
    -
    Returns:
    -
    a view of the portion of this set whose elements are greater - than or equal to fromElement
    • @@ -926,13 +686,9 @@

    tailSet

  • first

    public E first()
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns the first (lowest) element currently in this set.
    Specified by:
    first in interface java.util.SortedSet<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the first (lowest) element currently in this set
    • @@ -943,13 +699,9 @@

    first

  • last

    public E last()
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns the last (highest) element currently in this set.
    Specified by:
    last in interface java.util.SortedSet<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the last (highest) element currently in this set
    • @@ -960,9 +712,6 @@

    last

  • clear

    public void clear()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes all of the elements from this collection (optional operation). - The collection will be empty after this method returns.
    Specified by:
    clear in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -981,11 +730,6 @@

    clear

    contains

    public boolean contains​(@CheckForNull
                         java.lang.Object o)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains the specified element. - More formally, returns true if and only if this collection - contains at least one element e such that - Objects.equals(o, e).
    Specified by:
    contains in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -993,11 +737,6 @@

    contains

    contains in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    contains in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    o - element whose presence in this collection is to be tested
    -
    Returns:
    -
    true if this collection contains the specified - element
    • @@ -1008,9 +747,6 @@

    contains

  • containsAll

    public boolean containsAll​(java.util.Collection<?> c)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains all of the elements - in the specified collection.
    Specified by:
    containsAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -1018,13 +754,6 @@

    containsAll

    containsAll in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    containsAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    c - collection to be checked for containment in this collection
    -
    Returns:
    -
    true if this collection contains all of the elements - in the specified collection
    -
    See Also:
    -
    AbstractCollection.contains(Object)
    • @@ -1035,8 +764,6 @@

    containsAll

  • isEmpty

    public boolean isEmpty()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains no elements.
    Specified by:
    isEmpty in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -1044,8 +771,6 @@

    isEmpty

    isEmpty in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    isEmpty in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    true if this collection contains no elements
    • @@ -1057,14 +782,6 @@

    isEmpty

    remove

    public boolean remove​(@CheckForNull
                       java.lang.Object o)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation). More formally, - removes an element e such that - Objects.equals(o, e), if - this collection contains one or more such elements. Returns - true if this collection contained the specified element (or - equivalently, if this collection changed as a result of the call).
    Specified by:
    remove in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -1072,10 +789,6 @@

    remove

    remove in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    remove in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    o - element to be removed from this collection, if present
    -
    Returns:
    -
    true if an element was removed as a result of this call
    @@ -1086,10 +799,6 @@

    remove

  • size

    public int size()
    -
    Description copied from interface: java.util.Collection
    -
    Returns the number of elements in this collection. If this collection - contains more than Integer.MAX_VALUE elements, returns - Integer.MAX_VALUE.
    Specified by:
    size in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -1097,8 +806,6 @@

    size

    size in interface java.util.Set<E extends @Nullable java.lang.Object>
    Specified by:
    size in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the number of elements in this collection
    • @@ -1109,28 +816,6 @@

    size

  • removeAll

    public boolean removeAll​(java.util.Collection<?> c)
    -
    Description copied from class: java.util.AbstractSet
    -
    Removes from this set all of its elements that are contained in the - specified collection (optional operation). If the specified - collection is also a set, this operation effectively modifies this - set so that its value is the asymmetric set difference of - the two sets. - -

    This implementation determines which is the smaller of this set - and the specified collection, by invoking the size - method on each. If this set has fewer elements, then the - implementation iterates over this set, checking each element - returned by the iterator in turn to see if it is contained in - the specified collection. If it is so contained, it is removed - from this set with the iterator's remove method. If - the specified collection has fewer elements, then the - implementation iterates over the specified collection, removing - from this set each element returned by the iterator, using this - set's remove method. - -

    Note that this implementation will throw an - UnsupportedOperationException if the iterator returned by the - iterator method does not implement the remove method.

    Specified by:
    removeAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -1138,13 +823,6 @@

    removeAll

    removeAll in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    removeAll in class java.util.AbstractSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    c - collection containing elements to be removed from this set
    -
    Returns:
    -
    true if this set changed as a result of the call
    -
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    • @@ -1155,11 +833,6 @@

    removeAll

  • retainAll

    public boolean retainAll​(java.util.Collection<?> c)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation). In other words, removes from - this collection all of its elements that are not contained in the - specified collection.
    Specified by:
    retainAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -1167,13 +840,6 @@

    retainAll

    retainAll in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    retainAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    c - collection containing elements to be retained in this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    -
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingSortedSet.html b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingSortedSet.html index 68a80feae01d..2c816e5f54a7 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingSortedSet.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingSortedSet.html @@ -234,10 +234,7 @@

    Method Summary

    java.util.Comparator<? super E> comparator() - -
    Returns the comparator used to order the elements in this set, - or null if this set uses the natural ordering of its elements.
    - +  protected abstract java.util.SortedSet<E> @@ -249,24 +246,17 @@

    Method Summary

    E first() - -
    Returns the first (lowest) element currently in this set.
    - +  java.util.SortedSet<E> headSet​(E toElement) - -
    Returns a view of the portion of this set whose elements are - strictly less than toElement.
    - +  E last() - -
    Returns the last (highest) element currently in this set.
    - +  protected boolean @@ -294,19 +284,12 @@

    Method Summary

    java.util.SortedSet<E> subSet​(E fromElement, E toElement) - -
    Returns a view of the portion of this set whose elements range - from fromElement, inclusive, to toElement, - exclusive.
    - +  java.util.SortedSet<E> tailSet​(E fromElement) - -
    Returns a view of the portion of this set whose elements are - greater than or equal to fromElement.
    - + 
      @@ -427,16 +410,9 @@

      delegate

      comparator

      @CheckForNull
 public java.util.Comparator<? super E> comparator()
      -
      Description copied from interface: java.util.SortedSet
      -
      Returns the comparator used to order the elements in this set, - or null if this set uses the natural ordering of its elements.
      Specified by:
      comparator in interface java.util.SortedSet<E extends @Nullable java.lang.Object>
      -
      Returns:
      -
      the comparator used to order the elements in this set, - or null if this set uses the natural ordering - of its elements
    @@ -447,13 +423,9 @@

    comparator

  • first

    public E first()
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns the first (lowest) element currently in this set.
    Specified by:
    first in interface java.util.SortedSet<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the first (lowest) element currently in this set
    • @@ -466,23 +438,9 @@

    first

  • headSet

    public java.util.SortedSet<E> headSet​(E toElement)
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns a view of the portion of this set whose elements are - strictly less than toElement. The returned set is - backed by this set, so changes in the returned set are - reflected in this set, and vice-versa. The returned set - supports all optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    headSet in interface java.util.SortedSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    toElement - high endpoint (exclusive) of the returned set
    -
    Returns:
    -
    a view of the portion of this set whose elements are strictly - less than toElement
    • @@ -493,13 +451,9 @@

    headSet

  • last

    public E last()
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns the last (highest) element currently in this set.
    Specified by:
    last in interface java.util.SortedSet<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the last (highest) element currently in this set
    • @@ -513,26 +467,9 @@

    last

    subSet

    public java.util.SortedSet<E> subSet​(E fromElement,
                                      E toElement)
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns a view of the portion of this set whose elements range - from fromElement, inclusive, to toElement, - exclusive. (If fromElement and toElement are - equal, the returned set is empty.) The returned set is backed - by this set, so changes in the returned set are reflected in - this set, and vice-versa. The returned set supports all - optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    subSet in interface java.util.SortedSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromElement - low endpoint (inclusive) of the returned set
    -
    toElement - high endpoint (exclusive) of the returned set
    -
    Returns:
    -
    a view of the portion of this set whose elements range from - fromElement, inclusive, to toElement, exclusive
    @@ -545,23 +482,9 @@

    subSet

  • tailSet

    public java.util.SortedSet<E> tailSet​(E fromElement)
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns a view of the portion of this set whose elements are - greater than or equal to fromElement. The returned - set is backed by this set, so changes in the returned set are - reflected in this set, and vice-versa. The returned set - supports all optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    tailSet in interface java.util.SortedSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromElement - low endpoint (inclusive) of the returned set
    -
    Returns:
    -
    a view of the portion of this set whose elements are greater - than or equal to fromElement
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingTable.html b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingTable.html index 173136003f83..1564ee24e7d9 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingTable.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ForwardingTable.html @@ -291,7 +291,7 @@

    Method Summary

    boolean equals​(java.lang.Object obj) -
    Indicates whether some other object is "equal to" this one.
    +
    Compares the specified object with this table for equality.
    @@ -307,7 +307,7 @@

    Method Summary

    int hashCode() -
    Returns a hash code value for the object.
    +
    Returns the hash code for this table.
    @@ -838,58 +838,14 @@

    values

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object obj)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    +
    Description copied from interface: Table
    +
    Compares the specified object with this table for equality. Two tables are equal when their + cell views, as returned by Table.cellSet(), are equal.
    Specified by:
    equals in interface Table<R extends @Nullable java.lang.Object,​C extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -900,45 +856,14 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    +
    Description copied from interface: Table
    +
    Returns the hash code for this table. The hash code of a table is defined as the hash code of + its cell view, as returned by Table.cellSet().
    Specified by:
    hashCode in interface Table<R extends @Nullable java.lang.Object,​C extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/HashBasedTable.html b/releases/snapshot-android/api/docs/com/google/common/collect/HashBasedTable.html index 00efe8f72fa9..11b68b81fa05 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/HashBasedTable.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/HashBasedTable.html @@ -291,7 +291,7 @@

    Method Summary

    boolean equals​(java.lang.Object obj) -
    Indicates whether some other object is "equal to" this one.
    +
    Compares the specified object with this table for equality.
    @@ -307,7 +307,7 @@

    Method Summary

    int hashCode() -
    Returns a hash code value for the object.
    +
    Returns the hash code for this table.
    @@ -858,58 +858,14 @@

    putAll

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object obj)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    +
    Description copied from interface: Table
    +
    Compares the specified object with this table for equality. Two tables are equal when their + cell views, as returned by Table.cellSet(), are equal.
    Specified by:
    equals in interface Table<R extends @Nullable java.lang.Object,​C extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -920,45 +876,14 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    +
    Description copied from interface: Table
    +
    Returns the hash code for this table. The hash code of a table is defined as the hash code of + its cell view, as returned by Table.cellSet().
    Specified by:
    hashCode in interface Table<R extends @Nullable java.lang.Object,​C extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -973,8 +898,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/HashBiMap.html b/releases/snapshot-android/api/docs/com/google/common/collect/HashBiMap.html index 5a94a8ee9e5a..7157d490d50d 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/HashBiMap.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/HashBiMap.html @@ -177,14 +177,14 @@

    Nested Class Summary

    Nested classes/interfaces inherited from class java.util.AbstractMap

    -java.util.AbstractMap.SimpleEntry<K,​V>, java.util.AbstractMap.SimpleImmutableEntry<K,​V> +java.util.AbstractMap.SimpleEntry<K extends java.lang.Object,​V extends java.lang.Object>, java.util.AbstractMap.SimpleImmutableEntry<K extends java.lang.Object,​V extends java.lang.Object>

    • Nested classes/interfaces inherited from interface java.util.Map

      -java.util.Map.Entry<K,​V>
      • +java.util.Map.Entry<K extends java.lang.Object,​V extends java.lang.Object>
    @@ -206,17 +206,12 @@

    Method Summary

    void clear() - -
    Removes all of the mappings from this map (optional operation).
    - +  boolean containsKey​(java.lang.Object key) - -
    Returns true if this map contains a mapping for the specified - key.
    - +  boolean @@ -250,9 +245,7 @@

    Method Summary

    java.util.Set<java.util.Map.Entry<K,​V>> entrySet() - -
    Returns a Set view of the mappings contained in this map.
    - +  V @@ -266,10 +259,7 @@

    Method Summary

    V get​(java.lang.Object key) - -
    Returns the value to which the specified key is mapped, - or null if this map contains no mapping for the key.
    - +  BiMap<V,​K> @@ -282,40 +272,26 @@

    Method Summary

    java.util.Set<K> keySet() - -
    Returns a Set view of the keys contained in this map.
    - +  V put​(K key, V value) - -
    Associates the specified value with the specified key in this map - (optional operation).
    - V remove​(java.lang.Object key) - -
    Removes the mapping for a key from this map if it is present - (optional operation).
    - +  int size() - -
    Returns the number of key-value mappings in this map.
    - +  java.util.Set<V> values() - -
    Returns a Collection view of the values contained in this map.
    -
      @@ -406,17 +382,11 @@

      create

    • size

      public int size()
      -
      Description copied from class: java.util.AbstractMap
      -
      Returns the number of key-value mappings in this map. If the - map contains more than Integer.MAX_VALUE elements, returns - Integer.MAX_VALUE.
      Specified by:
      size in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
      Overrides:
      size in class java.util.AbstractMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
      -
      Returns:
      -
      the number of key-value mappings in this map
    @@ -428,22 +398,11 @@

    size

    containsKey

    public boolean containsKey​(@CheckForNull
                            java.lang.Object key)
    -
    Description copied from class: java.util.AbstractMap
    -
    Returns true if this map contains a mapping for the specified - key. More formally, returns true if and only if - this map contains a mapping for a key k such that - Objects.equals(key, k). (There can be - at most one such mapping.)
    Specified by:
    containsKey in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    containsKey in class java.util.AbstractMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - key whose presence in this map is to be tested
    -
    Returns:
    -
    true if this map contains a mapping for the specified - key
    @@ -481,30 +440,11 @@

    get

    @CheckForNull
 public V get​(@CheckForNull
              java.lang.Object key)
    -
    Description copied from class: java.util.AbstractMap
    -
    Returns the value to which the specified key is mapped, - or null if this map contains no mapping for the key. - -

    More formally, if this map contains a mapping from a key - k to a value v such that - Objects.equals(key, k), - then this method returns v; otherwise - it returns null. (There can be at most one such mapping.) - -

    If this map permits null values, then a return value of - null does not necessarily indicate that the map - contains no mapping for the key; it's also possible that the map - explicitly maps the key to null. The containsKey operation may be used to distinguish these two cases.

    Specified by:
    get in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    get in class java.util.AbstractMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - the key whose associated value is to be returned
    -
    Returns:
    -
    the value to which the specified key is mapped, or - null if this map contains no mapping for the key
    @@ -520,13 +460,7 @@

    put

    @CheckForNull public V put​(K key, V value) -
    Description copied from class: java.util.AbstractMap
    -
    Associates the specified value with the specified key in this map - (optional operation). If the map previously contained a mapping for - the key, the old value is replaced by the specified value. (A map - m is said to contain a mapping for a key k if and only - if m.containsKey(k) would return - true.)
    +
    Description copied from interface: BiMap
    Specified by:
    put in interface BiMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    @@ -534,15 +468,6 @@

    put

    put in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    put in class java.util.AbstractMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - key with which the specified value is to be associated
    -
    value - value to be associated with the specified key
    -
    Returns:
    -
    the previous value associated with key, or - null if there was no mapping for key. - (A null return can also indicate that the map - previously associated null with key, - if the implementation supports null values.)
    @@ -592,33 +517,11 @@

    remove

    @CheckForNull public V remove​(@CheckForNull java.lang.Object key) -
    Description copied from class: java.util.AbstractMap
    -
    Removes the mapping for a key from this map if it is present - (optional operation). More formally, if this map contains a mapping - from key k to value v such that - Objects.equals(key, k), that mapping - is removed. (The map can contain at most one such mapping.) - -

    Returns the value to which this map previously associated the key, - or null if the map contained no mapping for the key. - -

    If this map permits null values, then a return value of - null does not necessarily indicate that the map - contained no mapping for the key; it's also possible that the map - explicitly mapped the key to null. - -

    The map will not contain a mapping for the specified key once the - call returns.

    Specified by:
    remove in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    remove in class java.util.AbstractMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - key whose mapping is to be removed from the map
    -
    Returns:
    -
    the previous value associated with key, or - null if there was no mapping for key.
    @@ -629,9 +532,6 @@

    remove

  • clear

    public void clear()
    -
    Description copied from class: java.util.AbstractMap
    -
    Removes all of the mappings from this map (optional operation). - The map will be empty after this call returns.
    Specified by:
    clear in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    @@ -647,25 +547,11 @@

    clear

  • keySet

    public java.util.Set<K> keySet()
    -
    Description copied from class: java.util.AbstractMap
    -
    Returns a Set view of the keys contained in this map. - The set is backed by the map, so changes to the map are - reflected in the set, and vice-versa. If the map is modified - while an iteration over the set is in progress (except through - the iterator's own remove operation), the results of - the iteration are undefined. The set supports element removal, - which removes the corresponding mapping from the map, via the - Iterator.remove, Set.remove, - removeAll, retainAll, and clear - operations. It does not support the add or addAll - operations.
    Specified by:
    keySet in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    keySet in class java.util.AbstractMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a set view of the keys contained in this map
    • @@ -676,18 +562,10 @@

    keySet

  • values

    public java.util.Set<V> values()
    -
    Description copied from class: java.util.AbstractMap
    -
    Returns a Collection view of the values contained in this map. - The collection is backed by the map, so changes to the map are - reflected in the collection, and vice-versa. If the map is - modified while an iteration over the collection is in progress - (except through the iterator's own remove operation), - the results of the iteration are undefined. The collection - supports element removal, which removes the corresponding - mapping from the map, via the Iterator.remove, - Collection.remove, removeAll, - retainAll and clear operations. It does not - support the add or addAll operations.
    +
    Description copied from interface: BiMap
    +
    + +

    Because a bimap has unique values, this method returns a Set, instead of the Collection specified in the Map interface.

    Specified by:
    values in interface BiMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    @@ -695,8 +573,6 @@

    values

    values in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    values in class java.util.AbstractMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a collection view of the values contained in this map
    • @@ -707,26 +583,11 @@

    values

  • entrySet

    public java.util.Set<java.util.Map.Entry<K,​V>> entrySet()
    -
    Description copied from interface: java.util.Map
    -
    Returns a Set view of the mappings contained in this map. - The set is backed by the map, so changes to the map are - reflected in the set, and vice-versa. If the map is modified - while an iteration over the set is in progress (except through - the iterator's own remove operation, or through the - setValue operation on a map entry returned by the - iterator) the results of the iteration are undefined. The set - supports element removal, which removes the corresponding - mapping from the map, via the Iterator.remove, - Set.remove, removeAll, retainAll and - clear operations. It does not support the - add or addAll operations.
    Specified by:
    entrySet in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Specified by:
    entrySet in class java.util.AbstractMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a set view of the mappings contained in this map
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/HashMultimap.html b/releases/snapshot-android/api/docs/com/google/common/collect/HashMultimap.html index e1d2bae3812c..069b09a4f5b2 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/HashMultimap.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/HashMultimap.html @@ -639,14 +639,6 @@

    equals

    equals in interface Multimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Specified by:
    equals in interface SetMultimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    • @@ -901,8 +893,6 @@

    hashCode

    hashCode in interface Multimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    See Also:
    Map.hashCode()
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/HashMultiset.html b/releases/snapshot-android/api/docs/com/google/common/collect/HashMultiset.html index c675be616755..76095d71e9bf 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/HashMultiset.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/HashMultiset.html @@ -195,8 +195,7 @@

    Method Summary

    boolean add​(E element) -
    Ensures that this collection contains the specified element (optional - operation).
    +
    Adds a single occurrence of the specified element to this multiset.
    @@ -210,23 +209,17 @@

    Method Summary

    boolean addAll​(java.util.Collection<? extends E> elementsToAdd) - -
    Adds all of the elements in the specified collection to this collection - (optional operation).
    - void clear() - -
    Removes all of the elements from this collection (optional operation).
    - +  boolean contains​(java.lang.Object element) -
    Returns true if this collection contains the specified element.
    +
    Determines whether this multiset contains the specified element.
    @@ -278,36 +271,30 @@

    Method Summary

    boolean equals​(java.lang.Object object) -
    Indicates whether some other object is "equal to" this one.
    +
    Compares the specified object with this multiset for equality.
    int hashCode() -
    Returns a hash code value for the object.
    +
    Returns the hash code for this multiset.
    boolean isEmpty() - -
    Returns true if this collection contains no elements.
    - +  java.util.Iterator<E> iterator() - -
    Returns an iterator over the elements contained in this collection.
    - boolean remove​(java.lang.Object element) -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation).
    +
    Removes a single occurrence of the specified element from this multiset, if present.
    @@ -321,18 +308,10 @@

    Method Summary

    boolean removeAll​(java.util.Collection<?> elementsToRemove) - -
    Removes all of this collection's elements that are also contained in the - specified collection (optional operation).
    - boolean retainAll​(java.util.Collection<?> elementsToRetain) - -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation).
    - int @@ -356,15 +335,12 @@

    Method Summary

    int size() -
    Returns the number of elements in this collection.
    +
    Returns the total number of all occurrences of all elements in this multiset.
    java.lang.String toString() - -
    Returns a string representation of this collection.
    -
      @@ -607,9 +583,6 @@

      setCount

    • clear

      public final void clear()
      -
      Description copied from class: java.util.AbstractCollection
      -
      Removes all of the elements from this collection (optional operation). - The collection will be empty after this method returns.
      Specified by:
      clear in interface java.util.Collection<E extends @Nullable java.lang.Object>
      @@ -623,8 +596,11 @@

      clear

    • iterator

      public final java.util.Iterator<E> iterator()
      -
      Description copied from class: java.util.AbstractCollection
      -
      Returns an iterator over the elements contained in this collection.
      +
      Description copied from interface: Multiset
      +
      + +

      Elements that occur multiple times in the multiset will appear multiple times in this + iterator, though not necessarily sequentially.

      Specified by:
      iterator in interface java.util.Collection<E extends @Nullable java.lang.Object>
      @@ -634,8 +610,6 @@

      iterator

      iterator in interface Multiset<E extends @Nullable java.lang.Object>
      Specified by:
      iterator in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
      -
      Returns:
      -
      an iterator over the elements contained in this collection
    @@ -646,10 +620,11 @@

    iterator

  • size

    public final int size()
    -
    Description copied from interface: java.util.Collection
    -
    Returns the number of elements in this collection. If this collection - contains more than Integer.MAX_VALUE elements, returns - Integer.MAX_VALUE.
    +
    Description copied from interface: Multiset
    +
    Returns the total number of all occurrences of all elements in this multiset. + +

    Note: this method does not return the number of distinct elements in the + multiset, which is given by entrySet().size().

    Specified by:
    size in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -657,8 +632,6 @@

    size

    size in interface Multiset<E extends @Nullable java.lang.Object>
    Specified by:
    size in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the number of elements in this collection
    • @@ -669,15 +642,11 @@

    size

  • isEmpty

    public boolean isEmpty()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains no elements.
    Specified by:
    isEmpty in interface java.util.Collection<E extends @Nullable java.lang.Object>
    Overrides:
    isEmpty in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    true if this collection contains no elements
    • @@ -689,11 +658,11 @@

    isEmpty

    contains

    public boolean contains​(@CheckForNull
                         java.lang.Object element)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains the specified element. - More formally, returns true if and only if this collection - contains at least one element e such that - Objects.equals(o, e).
    +
    Description copied from interface: Multiset
    +
    Determines whether this multiset contains the specified element. + +

    This method refines Collection.contains(java.lang.Object) to further specify that it may not + throw an exception in response to element being null or of the wrong type.

    Specified by:
    contains in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -702,10 +671,9 @@

    contains

    Overrides:
    contains in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    Parameters:
    -
    element - element whose presence in this collection is to be tested
    +
    element - the element to check for
    Returns:
    -
    true if this collection contains the specified - element
    +
    true if this multiset contains at least one occurrence of the element
    @@ -719,24 +687,14 @@

    contains

    add

    @CanIgnoreReturnValue
 public final boolean add​(E element)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Ensures that this collection contains the specified element (optional - operation). Returns true if this collection changed as a - result of the call. (Returns false if this collection does - not permit duplicates and already contains the specified element.)

    +

    Description copied from interface: Multiset
    +
    Adds a single occurrence of the specified element to this multiset. - Collections that support this operation may place limitations on what - elements may be added to this collection. In particular, some - collections will refuse to add null elements, and others will - impose restrictions on the type of elements that may be added. - Collection classes should clearly specify in their documentation any - restrictions on what elements may be added.

    +

    This method refines Collection.add(E), which only ensures the presence of the + element, to further specify that a successful call must always increment the count of the + element, and the overall size of the collection, by one. - If a collection refuses to add a particular element for any reason - other than that it already contains the element, it must throw - an exception (rather than returning false). This preserves - the invariant that a collection always contains the specified element - after this call returns.

    +

    To both add the element and obtain the previous count of that element, use add(element, 1) instead.

    Specified by:
    add in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -745,10 +703,11 @@

    add

    Overrides:
    add in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    Parameters:
    -
    element - element whose presence in this collection is to be ensured
    +
    element - the element to add one occurrence of; may be null only if explicitly allowed by + the implementation
    Returns:
    -
    true if this collection changed as a result of the - call
    +
    true always, since this call is required to modify the multiset, unlike other + Collection types
    @@ -761,14 +720,13 @@

    remove

    @CanIgnoreReturnValue
 public final boolean remove​(@CheckForNull
                             java.lang.Object element)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation). More formally, - removes an element e such that - Objects.equals(o, e), if - this collection contains one or more such elements. Returns - true if this collection contained the specified element (or - equivalently, if this collection changed as a result of the call).
    +
    Description copied from interface: Multiset
    +
    Removes a single occurrence of the specified element from this multiset, if present. + +

    This method refines Collection.remove(java.lang.Object) to further specify that it may not + throw an exception in response to element being null or of the wrong type. + +

    To both remove the element and obtain the previous count of that element, use remove(element, 1) instead.

    Specified by:
    remove in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -777,9 +735,9 @@

    remove

    Overrides:
    remove in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    Parameters:
    -
    element - element to be removed from this collection, if present
    +
    element - the element to remove one occurrence of
    Returns:
    -
    true if an element was removed as a result of this call
    +
    true if an occurrence was found and removed
    @@ -791,12 +749,7 @@

    remove

    addAll

    @CanIgnoreReturnValue
 public final boolean addAll​(java.util.Collection<? extends E> elementsToAdd)
    -
    Adds all of the elements in the specified collection to this collection - (optional operation). The behavior of this operation is undefined if - the specified collection is modified while the operation is in progress. - (This implies that the behavior of this call is undefined if the - specified collection is this collection, and this collection is - nonempty.) +

    This implementation is highly efficient when elementsToAdd is itself a Multiset.

    @@ -804,12 +757,6 @@

    addAll

    addAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    Overrides:
    addAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    elementsToAdd - collection containing elements to be added to this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    -
    See Also:
    -
    AbstractCollection.add(Object)
    @@ -821,11 +768,16 @@

    addAll

    removeAll

    @CanIgnoreReturnValue
 public final boolean removeAll​(java.util.Collection<?> elementsToRemove)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes all of this collection's elements that are also contained in the - specified collection (optional operation). After this call returns, - this collection will contain no elements in common with the specified - collection.
    +
    Description copied from interface: Multiset
    +
    + +

    Note: This method ignores how often any element might appear in c, and only + cares whether or not an element appears at all. If you wish to remove one occurrence in this + multiset for every occurrence in c, see Multisets.removeOccurrences(Multiset, + Multiset). + +

    This method refines Collection.removeAll(java.util.Collection<?>) to further specify that it may not + throw an exception in response to any of elements being null or of the wrong type.

    Specified by:
    removeAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -833,14 +785,6 @@

    removeAll

    removeAll in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    removeAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    elementsToRemove - collection containing elements to be removed from this collection
    -
    Returns:
    -
    true if this collection changed as a result of the - call
    -
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    @@ -852,11 +796,16 @@

    removeAll

    retainAll

    @CanIgnoreReturnValue
 public final boolean retainAll​(java.util.Collection<?> elementsToRetain)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation). In other words, removes from - this collection all of its elements that are not contained in the - specified collection.
    +
    Description copied from interface: Multiset
    +
    + +

    Note: This method ignores how often any element might appear in c, and only + cares whether or not an element appears at all. If you wish to remove one occurrence in this + multiset for every occurrence in c, see Multisets.retainOccurrences(Multiset, + Multiset). + +

    This method refines Collection.retainAll(java.util.Collection<?>) to further specify that it may not + throw an exception in response to any of elements being null or of the wrong type.

    Specified by:
    retainAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -864,13 +813,8 @@

    retainAll

    retainAll in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    retainAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    elementsToRetain - collection containing elements to be retained in this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    +
    Multisets.retainOccurrences(Multiset, Multiset)
    @@ -936,44 +880,9 @@

    entrySet

    equals

    public final boolean equals​(@CheckForNull
                             java.lang.Object object)
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes. +

    Compares the specified object with this multiset for equality. Returns true if the + given object is also a multiset and contains equal elements with equal counts, regardless of + order.

    This implementation returns true if object is a multiset of the same size and if, for each element, the two multisets have the same count.

    @@ -984,14 +893,6 @@

    equals

    equals in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -1002,34 +903,14 @@

    equals

  • hashCode

    public final int hashCode()
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.) +

    Returns the hash code for this multiset. This is defined as the sum of + + 
    
+ ((element == null) ? 0 : element.hashCode()) ^ count(element)
+
    + +

    over all distinct elements in the multiset. It follows that a multiset and its entry set + always have the same hash code.

    This implementation returns the hash code of Multiset.entrySet().

    @@ -1039,11 +920,6 @@

    hashCode

    hashCode in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -1054,12 +930,11 @@

    hashCode

  • toString

    public final java.lang.String toString()
    -
    Returns a string representation of this collection. The string - representation consists of a list of the collection's elements in the - order they are returned by its iterator, enclosed in square brackets - ("[]"). Adjacent elements are separated by the characters - ", " (comma and space). Elements are converted to strings as - by String.valueOf(Object). +
    + +

    It is recommended, though not mandatory, that this method return the result of invoking + Multiset.toString() on the Multiset.entrySet(), yielding a result such as [a x 3, c, d x 2, + e].

    This implementation returns the result of invoking toString on Multiset.entrySet().

    @@ -1067,8 +942,6 @@

    toString

    toString in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    toString in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a string representation of this collection
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableBiMap.html b/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableBiMap.html index 64c64e575d20..04660a4ed4ec 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableBiMap.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableBiMap.html @@ -190,7 +190,7 @@

    Nested Class Summary

    Nested classes/interfaces inherited from interface java.util.Map

    -java.util.Map.Entry<K,​V> +java.util.Map.Entry<K extends java.lang.Object,​V extends java.lang.Object> @@ -501,13 +501,6 @@

    of

    Returns the empty bimap.

    Performance note: the instance returned is a singleton.

    -
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Returns:
    -
    an empty Map
    -
    @@ -521,16 +514,6 @@

    of

    public static <K,​V> ImmutableBiMap<K,​V> of​(K k1,
                                                        V v1)
    Returns an immutable bimap containing a single entry.
    -
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the mapping's key
    -
    v1 - the mapping's value
    -
    Returns:
    -
    a Map containing the specified mapping
    -
    @@ -547,16 +530,6 @@

    of

    V v2)
    Returns an immutable map containing the given entries, in order.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if duplicate keys or values are added
    @@ -578,18 +551,6 @@

    of

    V v3)
    Returns an immutable map containing the given entries, in order.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if duplicate keys or values are added
    @@ -613,20 +574,6 @@

    of

    V v4)
    Returns an immutable map containing the given entries, in order.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if duplicate keys or values are added
    @@ -652,22 +599,6 @@

    of

    V v5)
    Returns an immutable map containing the given entries, in order.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if duplicate keys or values are added
    @@ -695,24 +626,6 @@

    of

    V v6)
    Returns an immutable map containing the given entries, in order.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    k6 - the sixth mapping's key
    -
    v6 - the sixth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if duplicate keys or values are added
    Since:
    @@ -744,26 +657,6 @@

    of

    V v7)
    Returns an immutable map containing the given entries, in order.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    k6 - the sixth mapping's key
    -
    v6 - the sixth mapping's value
    -
    k7 - the seventh mapping's key
    -
    v7 - the seventh mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if duplicate keys or values are added
    Since:
    @@ -797,28 +690,6 @@

    of

    V v8)
    Returns an immutable map containing the given entries, in order.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    k6 - the sixth mapping's key
    -
    v6 - the sixth mapping's value
    -
    k7 - the seventh mapping's key
    -
    v7 - the seventh mapping's value
    -
    k8 - the eighth mapping's key
    -
    v8 - the eighth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if duplicate keys or values are added
    Since:
    @@ -854,30 +725,6 @@

    of

    V v9)
    Returns an immutable map containing the given entries, in order.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    k6 - the sixth mapping's key
    -
    v6 - the sixth mapping's value
    -
    k7 - the seventh mapping's key
    -
    v7 - the seventh mapping's value
    -
    k8 - the eighth mapping's key
    -
    v8 - the eighth mapping's value
    -
    k9 - the ninth mapping's key
    -
    v9 - the ninth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if duplicate keys or values are added
    Since:
    @@ -915,32 +762,6 @@

    of

    V v10)
    Returns an immutable map containing the given entries, in order.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    k6 - the sixth mapping's key
    -
    v6 - the sixth mapping's value
    -
    k7 - the seventh mapping's key
    -
    v7 - the seventh mapping's value
    -
    k8 - the eighth mapping's key
    -
    v8 - the eighth mapping's value
    -
    k9 - the ninth mapping's key
    -
    v9 - the ninth mapping's value
    -
    k10 - the tenth mapping's key
    -
    v10 - the tenth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if duplicate keys or values are added
    Since:
    @@ -958,19 +779,10 @@

    ofEntries

    public static <K,​V>     ImmutableBiMap<K,​V> ofEntries​(java.util.Map.Entry<? extends K,​? extends V>... entries)
    Returns an immutable map containing the given entries, in order.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    entries - Map.Entrys containing the keys and values from which the map is populated
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if duplicate keys or values are provided
    Since:
    31.0
    -
    See Also:
    -
    Map.entry()
    @@ -1022,13 +834,6 @@

    copyOf

    safe to do so. The exact circumstances under which a copy will or will not be performed are undocumented and subject to change.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    map - a Map from which entries are drawn, must be non-null
    -
    Returns:
    -
    a Map containing the entries of the given Map
    Throws:
    java.lang.IllegalArgumentException - if two keys have the same value or two values have the same key
    @@ -1094,8 +899,6 @@

    values

    values in interface java.util.Map<K,​V>
    Overrides:
    values in class ImmutableMap<K,​V>
    -
    Returns:
    -
    a collection view of the values contained in this map
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableClassToInstanceMap.html b/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableClassToInstanceMap.html index d0b4b61446fd..3e105e4c435b 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableClassToInstanceMap.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableClassToInstanceMap.html @@ -201,7 +201,7 @@

    Nested classes/interfaces inherited from class com.google.common.collec

    Nested classes/interfaces inherited from interface java.util.Map

    -java.util.Map.Entry<K,​V> +java.util.Map.Entry<K extends java.lang.Object,​V extends java.lang.Object> @@ -330,10 +330,6 @@

    of

    Performance note: the instance returned is a singleton.

    -
    Type Parameters:
    -
    B - the Map's key type
    -
    Returns:
    -
    an empty Map
    Since:
    19.0
    @@ -351,14 +347,6 @@

    of

    T value)
    Returns an ImmutableClassToInstanceMap containing a single entry.
    -
    Type Parameters:
    -
    B - the Map's key type
    -
    T - the Map's value type
    -
    Parameters:
    -
    type - the mapping's key
    -
    value - the mapping's value
    -
    Returns:
    -
    a Map containing the specified mapping
    Since:
    19.0
    @@ -388,13 +376,6 @@

    copyOf

    Note: Despite what the method name suggests, if map is an ImmutableClassToInstanceMap, no copy will actually be performed.

    -
    Type Parameters:
    -
    B - the Map's key type
    -
    S - the Map's value type
    -
    Parameters:
    -
    map - a Map from which entries are drawn, must be non-null
    -
    Returns:
    -
    a Map containing the entries of the given Map
    Throws:
    java.lang.NullPointerException - if any key or value in map is null
    java.lang.ClassCastException - if any value is not an instance of the type specified by its key
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableCollection.html b/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableCollection.html index bb5b4b1badd2..81fd4f704b46 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableCollection.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableCollection.html @@ -354,9 +354,7 @@

    Method Summary

    abstract boolean contains​(java.lang.Object object) - -
    Returns true if this collection contains the specified element.
    - +  abstract UnmodifiableIterator<E> @@ -395,17 +393,12 @@

    Method Summary

    java.lang.Object[] toArray() - -
    Returns an array containing all of the elements in this collection.
    - +  <T extends @Nullable java.lang.Object>
    T[]     toArray​(T[] other) - -
    Returns an array containing all of the elements in this collection; - the runtime type of the returned array is that of the specified array.
    - + 
      @@ -467,8 +460,6 @@

      iterator

      iterator in interface java.lang.Iterable<E>
      Specified by:
      iterator in class java.util.AbstractCollection<E>
      -
      Returns:
      -
      an iterator over the elements contained in this collection
    @@ -479,24 +470,11 @@

    iterator

  • toArray

    public final java.lang.Object[] toArray()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns an array containing all of the elements in this collection. - If this collection makes any guarantees as to what order its elements - are returned by its iterator, this method must return the elements in - the same order. The returned array's runtime component type is Object. - -

    The returned array will be "safe" in that no references to it are - maintained by this collection. (In other words, this method must - allocate a new array even if this collection is backed by an array). - The caller is thus free to modify the returned array.

    Specified by:
    toArray in interface java.util.Collection<E>
    Overrides:
    toArray in class java.util.AbstractCollection<E>
    -
    Returns:
    -
    an array, whose runtime component - type is Object, containing all of the elements in this collection
    • @@ -510,36 +488,11 @@

    toArray

    toArray

    @CanIgnoreReturnValue
 public final <T extends @Nullable java.lang.Object> T[] toArray​(T[] other)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns an array containing all of the elements in this collection; - the runtime type of the returned array is that of the specified array. - If the collection fits in the specified array, it is returned therein. - Otherwise, a new array is allocated with the runtime type of the - specified array and the size of this collection. - -

    If this collection fits in the specified array with room to spare - (i.e., the array has more elements than this collection), the element - in the array immediately following the end of the collection is set to - null. (This is useful in determining the length of this - collection only if the caller knows that this collection does - not contain any null elements.) - -

    If this collection makes any guarantees as to what order its elements - are returned by its iterator, this method must return the elements in - the same order.

    Specified by:
    toArray in interface java.util.Collection<E>
    Overrides:
    toArray in class java.util.AbstractCollection<E>
    -
    Type Parameters:
    -
    T - the component type of the array to contain the collection
    -
    Parameters:
    -
    other - the array into which the elements of this collection are to be - stored, if it is big enough; otherwise, a new array of the same - runtime type is allocated for this purpose.
    -
    Returns:
    -
    an array containing all of the elements in this collection
    @@ -551,21 +504,11 @@

    toArray

    contains

    public abstract boolean contains​(@CheckForNull
                                  java.lang.Object object)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains the specified element. - More formally, returns true if and only if this collection - contains at least one element e such that - Objects.equals(o, e).
    Specified by:
    contains in interface java.util.Collection<E>
    Overrides:
    contains in class java.util.AbstractCollection<E>
    -
    Parameters:
    -
    object - element whose presence in this collection is to be tested
    -
    Returns:
    -
    true if this collection contains the specified - element
    @@ -589,11 +532,6 @@

    add

    add in interface java.util.Collection<E>
    Overrides:
    add in class java.util.AbstractCollection<E>
    -
    Parameters:
    -
    e - element whose presence in this collection is to be ensured
    -
    Returns:
    -
    true if this collection changed as a result of the - call
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -618,10 +556,6 @@

    remove

    remove in interface java.util.Collection<E>
    Overrides:
    remove in class java.util.AbstractCollection<E>
    -
    Parameters:
    -
    object - element to be removed from this collection, if present
    -
    Returns:
    -
    true if an element was removed as a result of this call
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -645,14 +579,8 @@

    addAll

    addAll in interface java.util.Collection<E>
    Overrides:
    addAll in class java.util.AbstractCollection<E>
    -
    Parameters:
    -
    newElements - collection containing elements to be added to this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    Throws:
    java.lang.UnsupportedOperationException - always
    -
    See Also:
    -
    AbstractCollection.add(Object)
    @@ -674,16 +602,8 @@

    removeAll

    removeAll in interface java.util.Collection<E>
    Overrides:
    removeAll in class java.util.AbstractCollection<E>
    -
    Parameters:
    -
    oldElements - collection containing elements to be removed from this collection
    -
    Returns:
    -
    true if this collection changed as a result of the - call
    Throws:
    java.lang.UnsupportedOperationException - always
    -
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    @@ -705,15 +625,8 @@

    retainAll

    retainAll in interface java.util.Collection<E>
    Overrides:
    retainAll in class java.util.AbstractCollection<E>
    -
    Parameters:
    -
    elementsToKeep - collection containing elements to be retained in this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    Throws:
    java.lang.UnsupportedOperationException - always
    -
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableList.html b/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableList.html index 7f5457d62198..d91dc44d5288 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableList.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableList.html @@ -257,9 +257,7 @@

    Method Summary

    boolean contains​(java.lang.Object object) - -
    Returns true if this collection contains the specified element.
    - +  static <E> ImmutableList<E> @@ -292,24 +290,17 @@

    Method Summary

    boolean equals​(java.lang.Object obj) - -
    Indicates whether some other object is "equal to" this one.
    - +  int hashCode() - -
    Returns a hash code value for the object.
    - +  int indexOf​(java.lang.Object object) - -
    Returns the index of the first occurrence of the specified element - in this list, or -1 if this list does not contain the element.
    - +  UnmodifiableIterator<E> @@ -321,26 +312,17 @@

    Method Summary

    int lastIndexOf​(java.lang.Object object) - -
    Returns the index of the last occurrence of the specified element - in this list, or -1 if this list does not contain the element.
    - +  UnmodifiableListIterator<E> listIterator() - -
    Returns a list iterator over the elements in this list (in proper - sequence).
    - +  UnmodifiableListIterator<E> listIterator​(int index) - -
    Returns a list iterator over the elements in this list (in proper - sequence), starting at the specified position in the list.
    - +  static <E> ImmutableList<E> @@ -622,12 +604,6 @@

    of

    code.

    Performance note: the instance returned is a singleton.

    -
    -
    Type Parameters:
    -
    E - the List's element type
    -
    Returns:
    -
    an empty List
    -
    @@ -643,12 +619,6 @@

    of

    comparably to Collections.singletonList(T), but will not accept a null element. It is preferable mainly for consistency and maintainability of your code.
    -
    Type Parameters:
    -
    E - the List's element type
    -
    Parameters:
    -
    element - the single element
    -
    Returns:
    -
    a List containing the specified element
    Throws:
    java.lang.NullPointerException - if element is null
    @@ -666,13 +636,6 @@

    of

    E e2)
    Returns an immutable list containing the given elements, in order.
    -
    Type Parameters:
    -
    E - the List's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    Returns:
    -
    a List containing the specified elements
    Throws:
    java.lang.NullPointerException - if any element is null
    @@ -691,14 +654,6 @@

    of

    E e3)
    Returns an immutable list containing the given elements, in order.
    -
    Type Parameters:
    -
    E - the List's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    Returns:
    -
    a List containing the specified elements
    Throws:
    java.lang.NullPointerException - if any element is null
    @@ -718,15 +673,6 @@

    of

    E e4)
    Returns an immutable list containing the given elements, in order.
    -
    Type Parameters:
    -
    E - the List's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    e4 - the fourth element
    -
    Returns:
    -
    a List containing the specified elements
    Throws:
    java.lang.NullPointerException - if any element is null
    @@ -747,16 +693,6 @@

    of

    E e5)
    Returns an immutable list containing the given elements, in order.
    -
    Type Parameters:
    -
    E - the List's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    e4 - the fourth element
    -
    e5 - the fifth element
    -
    Returns:
    -
    a List containing the specified elements
    Throws:
    java.lang.NullPointerException - if any element is null
    @@ -778,17 +714,6 @@

    of

    E e6)
    Returns an immutable list containing the given elements, in order.
    -
    Type Parameters:
    -
    E - the List's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    e4 - the fourth element
    -
    e5 - the fifth element
    -
    e6 - the sixth element
    -
    Returns:
    -
    a List containing the specified elements
    Throws:
    java.lang.NullPointerException - if any element is null
    @@ -811,18 +736,6 @@

    of

    E e7)
    Returns an immutable list containing the given elements, in order.
    -
    Type Parameters:
    -
    E - the List's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    e4 - the fourth element
    -
    e5 - the fifth element
    -
    e6 - the sixth element
    -
    e7 - the seventh element
    -
    Returns:
    -
    a List containing the specified elements
    Throws:
    java.lang.NullPointerException - if any element is null
    @@ -846,19 +759,6 @@

    of

    E e8)
    Returns an immutable list containing the given elements, in order.
    -
    Type Parameters:
    -
    E - the List's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    e4 - the fourth element
    -
    e5 - the fifth element
    -
    e6 - the sixth element
    -
    e7 - the seventh element
    -
    e8 - the eighth element
    -
    Returns:
    -
    a List containing the specified elements
    Throws:
    java.lang.NullPointerException - if any element is null
    @@ -883,20 +783,6 @@

    of

    E e9)
    Returns an immutable list containing the given elements, in order.
    -
    Type Parameters:
    -
    E - the List's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    e4 - the fourth element
    -
    e5 - the fifth element
    -
    e6 - the sixth element
    -
    e7 - the seventh element
    -
    e8 - the eighth element
    -
    e9 - the ninth element
    -
    Returns:
    -
    a List containing the specified elements
    Throws:
    java.lang.NullPointerException - if any element is null
    @@ -922,21 +808,6 @@

    of

    E e10)
    Returns an immutable list containing the given elements, in order.
    -
    Type Parameters:
    -
    E - the List's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    e4 - the fourth element
    -
    e5 - the fifth element
    -
    e6 - the sixth element
    -
    e7 - the seventh element
    -
    e8 - the eighth element
    -
    e9 - the ninth element
    -
    e10 - the tenth element
    -
    Returns:
    -
    a List containing the specified elements
    Throws:
    java.lang.NullPointerException - if any element is null
    @@ -1038,12 +909,6 @@

    copyOf

    This method is safe to use even when elements is a synchronized or concurrent collection that is currently being modified by another thread.

    -
    Type Parameters:
    -
    E - the List's element type
    -
    Parameters:
    -
    elements - a Collection from which elements are drawn, must be non-null
    -
    Returns:
    -
    a List containing the elements of the given Collection
    Throws:
    java.lang.NullPointerException - if elements contains a null element
    @@ -1150,8 +1015,6 @@

    iterator

    iterator in interface java.util.List<E>
    Specified by:
    iterator in class ImmutableCollection<E>
    -
    Returns:
    -
    an iterator over the elements contained in this collection
    @@ -1162,15 +1025,9 @@

    iterator

  • listIterator

    public UnmodifiableListIterator<E> listIterator()
    -
    Description copied from interface: java.util.List
    -
    Returns a list iterator over the elements in this list (in proper - sequence).
    Specified by:
    listIterator in interface java.util.List<E>
    -
    Returns:
    -
    a list iterator over the elements in this list (in proper - sequence)
    • @@ -1181,22 +1038,9 @@

    listIterator

  • listIterator

    public UnmodifiableListIterator<E> listIterator​(int index)
    -
    Description copied from interface: java.util.List
    -
    Returns a list iterator over the elements in this list (in proper - sequence), starting at the specified position in the list. - The specified index indicates the first element that would be - returned by an initial call to next. - An initial call to previous would - return the element with the specified index minus one.
    Specified by:
    listIterator in interface java.util.List<E>
    -
    Parameters:
    -
    index - index of the first element to be returned from the - list iterator (by a call to next)
    -
    Returns:
    -
    a list iterator over the elements in this list (in proper - sequence), starting at the specified position in the list
    • @@ -1208,20 +1052,9 @@

    listIterator

    indexOf

    public int indexOf​(@CheckForNull
                    java.lang.Object object)
    -
    Description copied from interface: java.util.List
    -
    Returns the index of the first occurrence of the specified element - in this list, or -1 if this list does not contain the element. - More formally, returns the lowest index i such that - Objects.equals(o, get(i)), - or -1 if there is no such index.
    Specified by:
    indexOf in interface java.util.List<E>
    -
    Parameters:
    -
    object - element to search for
    -
    Returns:
    -
    the index of the first occurrence of the specified element in - this list, or -1 if this list does not contain the element
    @@ -1233,20 +1066,9 @@

    indexOf

    lastIndexOf

    public int lastIndexOf​(@CheckForNull
                        java.lang.Object object)
    -
    Description copied from interface: java.util.List
    -
    Returns the index of the last occurrence of the specified element - in this list, or -1 if this list does not contain the element. - More formally, returns the highest index i such that - Objects.equals(o, get(i)), - or -1 if there is no such index.
    Specified by:
    lastIndexOf in interface java.util.List<E>
    -
    Parameters:
    -
    object - element to search for
    -
    Returns:
    -
    the index of the last occurrence of the specified element in - this list, or -1 if this list does not contain the element
    @@ -1258,11 +1080,6 @@

    lastIndexOf

    contains

    public boolean contains​(@CheckForNull
                         java.lang.Object object)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains the specified element. - More formally, returns true if and only if this collection - contains at least one element e such that - Objects.equals(o, e).
    Specified by:
    contains in interface java.util.Collection<E>
    @@ -1270,11 +1087,6 @@

    contains

    contains in interface java.util.List<E>
    Specified by:
    contains in class ImmutableCollection<E>
    -
    Parameters:
    -
    object - element whose presence in this collection is to be tested
    -
    Returns:
    -
    true if this collection contains the specified - element
    @@ -1292,11 +1104,6 @@

    subList

    Specified by:
    subList in interface java.util.List<E>
    -
    Parameters:
    -
    fromIndex - low endpoint (inclusive) of the subList
    -
    toIndex - high endpoint (exclusive) of the subList
    -
    Returns:
    -
    a view of the specified range within this list
    @@ -1317,12 +1124,6 @@

    addAll

    Specified by:
    addAll in interface java.util.List<E>
    -
    Parameters:
    -
    index - index at which to insert the first element from the - specified collection
    -
    newElements - collection containing elements to be added to this list
    -
    Returns:
    -
    true if this list changed as a result of the call
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -1347,11 +1148,6 @@

    set

    Specified by:
    set in interface java.util.List<E>
    -
    Parameters:
    -
    index - index of the element to replace
    -
    element - element to be stored at the specified position
    -
    Returns:
    -
    the element previously at the specified position
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -1375,9 +1171,6 @@

    add

    Specified by:
    add in interface java.util.List<E>
    -
    Parameters:
    -
    index - index at which the specified element is to be inserted
    -
    element - element to be inserted
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -1399,10 +1192,6 @@

    remove

    Specified by:
    remove in interface java.util.List<E>
    -
    Parameters:
    -
    index - the index of the element to be removed
    -
    Returns:
    -
    the element previously at the specified position
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -1454,45 +1243,6 @@

    reverse

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object obj)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    Specified by:
    equals in interface java.util.Collection<E>
    @@ -1500,14 +1250,6 @@

    equals

    equals in interface java.util.List<E>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -1518,35 +1260,6 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    Specified by:
    hashCode in interface java.util.Collection<E>
    @@ -1554,11 +1267,6 @@

    hashCode

    hashCode in interface java.util.List<E>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableListMultimap.html b/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableListMultimap.html index 9c1f6a99be6f..02becc6a6b41 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableListMultimap.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableListMultimap.html @@ -238,7 +238,7 @@

    Method Summary

    boolean equals​(java.lang.Object object) -
    Indicates whether some other object is "equal to" this one.
    +
    Compares the specified object with this multimap for equality.
    @@ -701,58 +701,23 @@

    containsEntry

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object object)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    +
    Description copied from interface: Multimap
    +
    Compares the specified object with this multimap for equality. Two multimaps are equal when + their map views, as returned by Multimap.asMap(), are also equal. + +

    In general, two multimaps with identical key-value mappings may or may not be equal, + depending on the implementation. For example, two SetMultimap instances with the same + key-value mappings are equal, but equality of two ListMultimap instances depends on the + ordering of the values for each key. + +

    A non-empty SetMultimap cannot be equal to a non-empty ListMultimap, since + their Multimap.asMap() views contain unequal collections as values. However, any two empty + multimaps are equal, because they both have empty Multimap.asMap() views.

    Specified by:
    equals in interface Multimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -772,8 +737,6 @@

    hashCode

    hashCode in interface Multimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    See Also:
    Map.hashCode()
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableMap.html b/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableMap.html index 2361a5d6a5f6..d4ebe38f2146 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableMap.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableMap.html @@ -192,7 +192,7 @@

    Nested Class Summary

    Nested classes/interfaces inherited from interface java.util.Map

    -java.util.Map.Entry<K,​V> +java.util.Map.Entry<K extends java.lang.Object,​V extends java.lang.Object> @@ -244,18 +244,12 @@

    Method Summary

    boolean containsKey​(java.lang.Object key) - -
    Returns true if this map contains a mapping for the specified - key.
    - +  boolean containsValue​(java.lang.Object value) - -
    Returns true if this map maps one or more keys to the - specified value.
    - +  static <K,​V>
    ImmutableMap<K,​V>     @@ -281,40 +275,27 @@

    Method Summary

    boolean equals​(java.lang.Object object) - -
    Indicates whether some other object is "equal to" this one.
    - +  abstract V get​(java.lang.Object key) - -
    Returns the value to which the specified key is mapped, - or null if this map contains no mapping for the key.
    - +  V getOrDefault​(java.lang.Object key, V defaultValue) - -
    Returns the value to which the specified key is mapped, or - defaultValue if this map contains no mapping for the key.
    - int hashCode() - -
    Returns a hash code value for the object.
    - +  boolean isEmpty() - -
    Returns true if this map contains no key-value mappings.
    - +  ImmutableSet<K> @@ -538,9 +519,7 @@

    Method Summary

    java.lang.String toString() - -
    Returns a string representation of the object.
    - +  ImmutableCollection<V> @@ -592,13 +571,6 @@

    of

    code.

    Performance note: the instance returned is a singleton. -

    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Returns:
    -
    an empty Map
    -
    @@ -614,16 +586,6 @@

    of

    Returns an immutable map containing a single entry. This map behaves and performs comparably to Collections.singletonMap(K, V) but will not accept a null key or value. It is preferable mainly for consistency and maintainability of your code.
    -
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the mapping's key
    -
    v1 - the mapping's value
    -
    Returns:
    -
    a Map containing the specified mapping
    -
     @@ -640,16 +602,6 @@

    of

    V v2)
    Returns an immutable map containing the given entries, in order.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if duplicate keys are provided
    @@ -671,18 +623,6 @@

    of

    V v3)
    Returns an immutable map containing the given entries, in order.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if duplicate keys are provided
    @@ -706,20 +646,6 @@

    of

    V v4)
    Returns an immutable map containing the given entries, in order.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if duplicate keys are provided
    @@ -745,22 +671,6 @@

    of

    V v5)
    Returns an immutable map containing the given entries, in order.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if duplicate keys are provided
    @@ -788,24 +698,6 @@

    of

    V v6)
    Returns an immutable map containing the given entries, in order.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    k6 - the sixth mapping's key
    -
    v6 - the sixth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if duplicate keys are provided
    Since:
    @@ -837,26 +729,6 @@

    of

    V v7)
    Returns an immutable map containing the given entries, in order.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    k6 - the sixth mapping's key
    -
    v6 - the sixth mapping's value
    -
    k7 - the seventh mapping's key
    -
    v7 - the seventh mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if duplicate keys are provided
    Since:
    @@ -890,28 +762,6 @@

    of

    V v8)
    Returns an immutable map containing the given entries, in order.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    k6 - the sixth mapping's key
    -
    v6 - the sixth mapping's value
    -
    k7 - the seventh mapping's key
    -
    v7 - the seventh mapping's value
    -
    k8 - the eighth mapping's key
    -
    v8 - the eighth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if duplicate keys are provided
    Since:
    @@ -947,30 +797,6 @@

    of

    V v9)
    Returns an immutable map containing the given entries, in order.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    k6 - the sixth mapping's key
    -
    v6 - the sixth mapping's value
    -
    k7 - the seventh mapping's key
    -
    v7 - the seventh mapping's value
    -
    k8 - the eighth mapping's key
    -
    v8 - the eighth mapping's value
    -
    k9 - the ninth mapping's key
    -
    v9 - the ninth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if duplicate keys are provided
    Since:
    @@ -1008,32 +834,6 @@

    of

    V v10)
    Returns an immutable map containing the given entries, in order.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    k6 - the sixth mapping's key
    -
    v6 - the sixth mapping's value
    -
    k7 - the seventh mapping's key
    -
    v7 - the seventh mapping's value
    -
    k8 - the eighth mapping's key
    -
    v8 - the eighth mapping's value
    -
    k9 - the ninth mapping's key
    -
    v9 - the ninth mapping's value
    -
    k10 - the tenth mapping's key
    -
    v10 - the tenth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if duplicate keys are provided
    Since:
    @@ -1051,19 +851,10 @@

    ofEntries

    public static <K,​V>     ImmutableMap<K,​V> ofEntries​(java.util.Map.Entry<? extends K,​? extends V>... entries)
    Returns an immutable map containing the given entries, in order.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    entries - Map.Entrys containing the keys and values from which the map is populated
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if duplicate keys are provided
    Since:
    31.0
    -
    See Also:
    -
    Map.entry()
    @@ -1113,13 +904,6 @@

    copyOf

    safe to do so. The exact circumstances under which a copy will or will not be performed are undocumented and subject to change.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    map - a Map from which entries are drawn, must be non-null
    -
    Returns:
    -
    a Map containing the entries of the given Map
    Throws:
    java.lang.NullPointerException - if any key or value in map is null
    @@ -1164,15 +948,6 @@

    put

    Specified by:
    put in interface java.util.Map<K,​V>
    -
    Parameters:
    -
    k - key with which the specified value is to be associated
    -
    v - value to be associated with the specified key
    -
    Returns:
    -
    the previous value associated with key, or - null if there was no mapping for key. - (A null return can also indicate that the map - previously associated null with key, - if the implementation supports null values.)
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -1196,11 +971,6 @@

    remove

    Specified by:
    remove in interface java.util.Map<K,​V>
    -
    Parameters:
    -
    o - key whose mapping is to be removed from the map
    -
    Returns:
    -
    the previous value associated with key, or - null if there was no mapping for key.
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -1221,8 +991,6 @@

    putAll

    Specified by:
    putAll in interface java.util.Map<K,​V>
    -
    Parameters:
    -
    map - mappings to be stored in this map
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -1255,13 +1023,9 @@

    clear

  • isEmpty

    public boolean isEmpty()
    -
    Description copied from interface: java.util.Map
    -
    Returns true if this map contains no key-value mappings.
    Specified by:
    isEmpty in interface java.util.Map<K,​V>
    -
    Returns:
    -
    true if this map contains no key-value mappings
    • @@ -1273,20 +1037,9 @@

    isEmpty

    containsKey

    public boolean containsKey​(@CheckForNull
                            java.lang.Object key)
    -
    Description copied from interface: java.util.Map
    -
    Returns true if this map contains a mapping for the specified - key. More formally, returns true if and only if - this map contains a mapping for a key k such that - Objects.equals(key, k). (There can be - at most one such mapping.)
    Specified by:
    containsKey in interface java.util.Map<K,​V>
    -
    Parameters:
    -
    key - key whose presence in this map is to be tested
    -
    Returns:
    -
    true if this map contains a mapping for the specified - key
    @@ -1298,21 +1051,9 @@

    containsKey

    containsValue

    public boolean containsValue​(@CheckForNull
                              java.lang.Object value)
    -
    Description copied from interface: java.util.Map
    -
    Returns true if this map maps one or more keys to the - specified value. More formally, returns true if and only if - this map contains at least one mapping to a value v such that - Objects.equals(value, v). This operation - will probably require time linear in the map size for most - implementations of the Map interface.
    Specified by:
    containsValue in interface java.util.Map<K,​V>
    -
    Parameters:
    -
    value - value whose presence in this map is to be tested
    -
    Returns:
    -
    true if this map maps one or more keys to the - specified value
    @@ -1325,28 +1066,9 @@

    get

    @CheckForNull
 public abstract V get​(@CheckForNull
                       java.lang.Object key)
    -
    Description copied from interface: java.util.Map
    -
    Returns the value to which the specified key is mapped, - or null if this map contains no mapping for the key. - -

    More formally, if this map contains a mapping from a key - k to a value v such that - Objects.equals(key, k), - then this method returns v; otherwise - it returns null. (There can be at most one such mapping.) - -

    If this map permits null values, then a return value of - null does not necessarily indicate that the map - contains no mapping for the key; it's also possible that the map - explicitly maps the key to null. The containsKey operation may be used to distinguish these two cases.

    Specified by:
    get in interface java.util.Map<K,​V>
    -
    Parameters:
    -
    key - the key whose associated value is to be returned
    -
    Returns:
    -
    the value to which the specified key is mapped, or - null if this map contains no mapping for the key
    @@ -1363,20 +1085,13 @@

    getOrDefault

    java.lang.Object key, @CheckForNull V defaultValue) -
    Returns the value to which the specified key is mapped, or - defaultValue if this map contains no mapping for the key. +

    See Map.getOrDefault.

    Specified by:
    getOrDefault in interface java.util.Map<K,​V>
    -
    Parameters:
    -
    key - the key whose associated value is to be returned
    -
    defaultValue - the default mapping of the key
    -
    Returns:
    -
    the value to which the specified key is mapped, or - defaultValue if this map contains no mapping for the key
    Since:
    23.5 (but since 21.0 in the JRE flavor). Note that API Level 24 users can call this method with any version of Guava.
    @@ -1395,8 +1110,6 @@

    entrySet

    Specified by:
    entrySet in interface java.util.Map<K,​V>
    -
    Returns:
    -
    a set view of the mappings contained in this map
    @@ -1411,8 +1124,6 @@

    keySet

    Specified by:
    keySet in interface java.util.Map<K,​V>
    -
    Returns:
    -
    a set view of the keys contained in this map
    @@ -1428,8 +1139,6 @@

    values

    Specified by:
    values in interface java.util.Map<K,​V>
    -
    Returns:
    -
    a collection view of the values contained in this map
    @@ -1455,58 +1164,11 @@

    asMultimap

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object object)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    Specified by:
    equals in interface java.util.Map<K,​V>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -1517,45 +1179,11 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    Specified by:
    hashCode in interface java.util.Map<K,​V>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -1566,29 +1194,9 @@

    hashCode

  • toString

    public java.lang.String toString()
    -
    Description copied from class: java.lang.Object
    -
    Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

    - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

    - 
    - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableMultimap.html b/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableMultimap.html index fd6ddb4129b7..995583c892cc 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableMultimap.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableMultimap.html @@ -291,7 +291,7 @@

    Method Summary

    boolean equals​(java.lang.Object object) -
    Indicates whether some other object is "equal to" this one.
    +
    Compares the specified object with this multimap for equality.
    @@ -1040,58 +1040,23 @@

    containsEntry

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object object)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    +
    Description copied from interface: Multimap
    +
    Compares the specified object with this multimap for equality. Two multimaps are equal when + their map views, as returned by Multimap.asMap(), are also equal. + +

    In general, two multimaps with identical key-value mappings may or may not be equal, + depending on the implementation. For example, two SetMultimap instances with the same + key-value mappings are equal, but equality of two ListMultimap instances depends on the + ordering of the values for each key. + +

    A non-empty SetMultimap cannot be equal to a non-empty ListMultimap, since + their Multimap.asMap() views contain unequal collections as values. However, any two empty + multimaps are equal, because they both have empty Multimap.asMap() views.

    Specified by:
    equals in interface Multimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -1111,8 +1076,6 @@

    hashCode

    hashCode in interface Multimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    See Also:
    Map.hashCode()
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableMultiset.html b/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableMultiset.html index c9066d11f199..c160c231b45b 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableMultiset.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableMultiset.html @@ -253,7 +253,7 @@

    Method Summary

    boolean contains​(java.lang.Object object) -
    Returns true if this collection contains the specified element.
    +
    Determines whether this multiset contains the specified element.
    @@ -299,14 +299,14 @@

    Method Summary

    boolean equals​(java.lang.Object object) -
    Indicates whether some other object is "equal to" this one.
    +
    Compares the specified object with this multiset for equality.
    int hashCode() -
    Returns a hash code value for the object.
    +
    Returns the hash code for this multiset.
    @@ -419,9 +419,6 @@

    Method Summary

    java.lang.String toString() - -
    Returns a string representation of this collection.
    -
    @@ -722,11 +717,11 @@

    asList

    contains

    public boolean contains​(@CheckForNull
                         java.lang.Object object)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains the specified element. - More formally, returns true if and only if this collection - contains at least one element e such that - Objects.equals(o, e).
    +
    Description copied from interface: Multiset
    +
    Determines whether this multiset contains the specified element. + +

    This method refines Collection.contains(java.lang.Object) to further specify that it may not + throw an exception in response to element being null or of the wrong type.

    Specified by:
    contains in interface java.util.Collection<E>
    @@ -735,10 +730,9 @@

    contains

    Specified by:
    contains in class ImmutableCollection<E>
    Parameters:
    -
    object - element whose presence in this collection is to be tested
    +
    object - the element to check for
    Returns:
    -
    true if this collection contains the specified - element
    +
    true if this multiset contains at least one occurrence of the element
    @@ -873,45 +867,10 @@

    setCount

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object object)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    +
    Description copied from interface: Multiset
    +
    Compares the specified object with this multiset for equality. Returns true if the + given object is also a multiset and contains equal elements with equal counts, regardless of + order.
    Specified by:
    equals in interface java.util.Collection<E>
    @@ -919,14 +878,6 @@

    equals

    equals in interface Multiset<E>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -937,35 +888,15 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    +
    Description copied from interface: Multiset
    +
    Returns the hash code for this multiset. This is defined as the sum of + + 
    
+ ((element == null) ? 0 : element.hashCode()) ^ count(element)
+
    + +

    over all distinct elements in the multiset. It follows that a multiset and its entry set + always have the same hash code.

    Specified by:
    hashCode in interface java.util.Collection<E>
    @@ -973,11 +904,6 @@

    hashCode

    hashCode in interface Multiset<E>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -988,20 +914,17 @@

    hashCode

  • toString

    public java.lang.String toString()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns a string representation of this collection. The string - representation consists of a list of the collection's elements in the - order they are returned by its iterator, enclosed in square brackets - ("[]"). Adjacent elements are separated by the characters - ", " (comma and space). Elements are converted to strings as - by String.valueOf(Object).
    +
    Description copied from interface: Multiset
    +
    + +

    It is recommended, though not mandatory, that this method return the result of invoking + Multiset.toString() on the Multiset.entrySet(), yielding a result such as [a x 3, c, d x 2, + e].

    Specified by:
    toString in interface Multiset<E>
    Overrides:
    toString in class java.util.AbstractCollection<E>
    -
    Returns:
    -
    a string representation of this collection
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableRangeMap.html b/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableRangeMap.html index fce2a25a1942..9104f42a6e0e 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableRangeMap.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableRangeMap.html @@ -235,7 +235,7 @@

    Method Summary

    boolean equals​(java.lang.Object o) -
    Indicates whether some other object is "equal to" this one.
    +
    Returns true if obj is another RangeMap that has an equivalent RangeMap.asMapOfRanges().
    @@ -257,7 +257,7 @@

    Method Summary

    int hashCode() -
    Returns a hash code value for the object.
    +
    Returns asMapOfRanges().hashCode().
    @@ -332,7 +332,7 @@

    Method Summary

    java.lang.String toString() -
    Returns a string representation of the object.
    +
    Returns a readable string representation of this range map.
    @@ -639,45 +639,13 @@

    subRangeMap

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    +
    Description copied from interface: RangeMap
    +
    Returns asMapOfRanges().hashCode().
    Specified by:
    hashCode in interface RangeMap<K extends java.lang.Comparable<?>,​V>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -689,58 +657,13 @@

    hashCode

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object o)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    +
    Description copied from interface: RangeMap
    +
    Returns true if obj is another RangeMap that has an equivalent RangeMap.asMapOfRanges().
    Specified by:
    equals in interface RangeMap<K extends java.lang.Comparable<?>,​V>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    o - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -751,31 +674,13 @@

    equals

  • toString

    public java.lang.String toString()
    -
    Description copied from class: java.lang.Object
    -
    Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

    - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

    - 
    - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
    +
    Description copied from interface: RangeMap
    +
    Returns a readable string representation of this range map.
    Specified by:
    toString in interface RangeMap<K extends java.lang.Comparable<?>,​V>
    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableRangeSet.html b/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableRangeSet.html index 7e4594046f7b..6d8e4a0f4f59 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableRangeSet.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableRangeSet.html @@ -323,14 +323,15 @@

    Method Summary

    boolean equals​(java.lang.Object obj) -
    Indicates whether some other object is "equal to" this one.
    +
    Returns true if obj is another RangeSet that contains the same ranges + according to Range.equals(Object).
    int hashCode() -
    Returns a hash code value for the object.
    +
    Returns asRanges().hashCode().
    @@ -423,7 +424,7 @@

    Method Summary

    java.lang.String toString() -
    Returns a string representation of the object.
    +
    Returns a readable string representation of this range set.
    @@ -972,58 +973,14 @@

    enclosesAll

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object obj)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    +
    Description copied from interface: RangeSet
    +
    Returns true if obj is another RangeSet that contains the same ranges + according to Range.equals(Object).
    Specified by:
    equals in interface RangeSet<C extends java.lang.Comparable>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -1034,45 +991,13 @@

    equals

  • hashCode

    public final int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    +
    Description copied from interface: RangeSet
    +
    Returns asRanges().hashCode().
    Specified by:
    hashCode in interface RangeSet<C extends java.lang.Comparable>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -1083,31 +1008,15 @@

    hashCode

  • toString

    public final java.lang.String toString()
    -
    Description copied from class: java.lang.Object
    -
    Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

    - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

    - 
    - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
    +
    Description copied from interface: RangeSet
    +
    Returns a readable string representation of this range set. For example, if this + RangeSet consisted of Range.closed(1, 3) and Range.greaterThan(4), this might + return " [1..3](4..+∞)"}.
    Specified by:
    toString in interface RangeSet<C extends java.lang.Comparable>
    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableSet.html b/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableSet.html index 7fd96ad97944..8c8b2e5c342c 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableSet.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableSet.html @@ -265,16 +265,12 @@

    Method Summary

    boolean equals​(java.lang.Object object) - -
    Indicates whether some other object is "equal to" this one.
    - +  int hashCode() - -
    Returns a hash code value for the object.
    - +  abstract UnmodifiableIterator<E> @@ -423,12 +419,6 @@

    of

    consistency, and because the return type conveys the immutability guarantee.

    Performance note: the instance returned is a singleton. -

    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Returns:
    -
    an empty Set
    -
    @@ -442,14 +432,6 @@

    of

    public static <E> ImmutableSet<E> of​(E element)
    Returns an immutable set containing element. Preferred over Collections.singleton(T) for code consistency, null rejection, and because the return type conveys the immutability guarantee.
    -
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    element - the single element
    -
    Returns:
    -
    a Set containing the specified element
    -
    @@ -465,15 +447,6 @@

    of

    Returns an immutable set containing the given elements, minus duplicates, in the order each was first specified. That is, if multiple elements are equal, all except the first are ignored.
    -
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    Returns:
    -
    a Set containing the specified elements
    -
     @@ -490,16 +463,6 @@

    of

    Returns an immutable set containing the given elements, minus duplicates, in the order each was first specified. That is, if multiple elements are equal, all except the first are ignored.
    -
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    Returns:
    -
    a Set containing the specified elements
    -
     @@ -517,17 +480,6 @@

    of

    Returns an immutable set containing the given elements, minus duplicates, in the order each was first specified. That is, if multiple elements are equal, all except the first are ignored.
    -
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    e4 - the fourth element
    -
    Returns:
    -
    a Set containing the specified elements
    -
     @@ -546,18 +498,6 @@

    of

    Returns an immutable set containing the given elements, minus duplicates, in the order each was first specified. That is, if multiple elements are equal, all except the first are ignored.
    -
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    e4 - the fourth element
    -
    e5 - the fifth element
    -
    Returns:
    -
    a Set containing the specified elements
    -
     @@ -582,18 +522,6 @@

    of

    The array others must not be longer than Integer.MAX_VALUE - 6.

    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    e4 - the fourth element
    -
    e5 - the fifth element
    -
    e6 - the sixth element
    -
    others - the seventh element
    -
    Returns:
    -
    a Set containing the specified elements
    Since:
    3.0 (source-compatible since 2.0)
    @@ -614,12 +542,6 @@

    copyOf

    This reduces the expense of habitually making defensive copies at API boundaries. However, the precise conditions for skipping the copy operation are undefined.
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    elements - a Collection from which elements are drawn, must be non-null
    -
    Returns:
    -
    a Set containing the elements of the given Collection
    Throws:
    java.lang.NullPointerException - if any of elements is null
    Since:
    @@ -690,45 +612,6 @@

    copyOf

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object object)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    Specified by:
    equals in interface java.util.Collection<E>
    @@ -736,14 +619,6 @@

    equals

    equals in interface java.util.Set<E>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -754,35 +629,6 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    Specified by:
    hashCode in interface java.util.Collection<E>
    @@ -790,11 +636,6 @@

    hashCode

    hashCode in interface java.util.Set<E>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -816,8 +657,6 @@

    iterator

    iterator in interface java.util.Set<E>
    Specified by:
    iterator in class ImmutableCollection<E>
    -
    Returns:
    -
    an iterator over the elements contained in this collection
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableSetMultimap.html b/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableSetMultimap.html index 2a8a7f1f0962..4b4a1225122d 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableSetMultimap.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableSetMultimap.html @@ -249,7 +249,7 @@

    Method Summary

    boolean equals​(java.lang.Object object) -
    Indicates whether some other object is "equal to" this one.
    +
    Compares the specified object with this multimap for equality.
    @@ -734,58 +734,23 @@

    containsEntry

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object object)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    +
    Description copied from interface: Multimap
    +
    Compares the specified object with this multimap for equality. Two multimaps are equal when + their map views, as returned by Multimap.asMap(), are also equal. + +

    In general, two multimaps with identical key-value mappings may or may not be equal, + depending on the implementation. For example, two SetMultimap instances with the same + key-value mappings are equal, but equality of two ListMultimap instances depends on the + ordering of the values for each key. + +

    A non-empty SetMultimap cannot be equal to a non-empty ListMultimap, since + their Multimap.asMap() views contain unequal collections as values. However, any two empty + multimaps are equal, because they both have empty Multimap.asMap() views.

    Specified by:
    equals in interface Multimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -805,8 +770,6 @@

    hashCode

    hashCode in interface Multimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    See Also:
    Map.hashCode()
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableSortedMap.html b/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableSortedMap.html index 7d497bcb3ef1..dc013fafd02d 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableSortedMap.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableSortedMap.html @@ -197,7 +197,7 @@

    Nested Class Summary

    Nested classes/interfaces inherited from interface java.util.Map

    -java.util.Map.Entry<K,​V> +java.util.Map.Entry<K extends java.lang.Object,​V extends java.lang.Object> @@ -237,19 +237,12 @@

    Method Summary

    java.util.Map.Entry<K,​V> ceilingEntry​(K key) - -
    Returns a key-value mapping associated with the least key - greater than or equal to the given key, or null if - there is no such key.
    - +  K ceilingKey​(K key) - -
    Returns the least key greater than or equal to the given key, - or null if there is no such key.
    - +  java.util.Comparator<? super K> @@ -304,16 +297,12 @@

    Method Summary

    ImmutableSortedSet<K> descendingKeySet() - -
    Returns a reverse order NavigableSet view of the keys contained in this map.
    - +  ImmutableSortedMap<K,​V> descendingMap() - -
    Returns a reverse order view of the mappings contained in this map.
    - +  ImmutableSet<java.util.Map.Entry<K,​V>> @@ -325,42 +314,27 @@

    Method Summary

    java.util.Map.Entry<K,​V> firstEntry() - -
    Returns a key-value mapping associated with the least - key in this map, or null if the map is empty.
    - +  K firstKey() - -
    Returns the first (lowest) key currently in this map.
    - +  java.util.Map.Entry<K,​V> floorEntry​(K key) - -
    Returns a key-value mapping associated with the greatest key - less than or equal to the given key, or null if there - is no such key.
    - +  K floorKey​(K key) - -
    Returns the greatest key less than or equal to the given key, - or null if there is no such key.
    - +  V get​(java.lang.Object key) - -
    Returns the value to which the specified key is mapped, - or null if this map contains no mapping for the key.
    - +  ImmutableSortedMap<K,​V> @@ -382,19 +356,12 @@

    Method Summary

    java.util.Map.Entry<K,​V> higherEntry​(K key) - -
    Returns a key-value mapping associated with the least key - strictly greater than the given key, or null if there - is no such key.
    - +  K higherKey​(K key) - -
    Returns the least key strictly greater than the given key, or - null if there is no such key.
    - +  ImmutableSortedSet<K> @@ -406,34 +373,22 @@

    Method Summary

    java.util.Map.Entry<K,​V> lastEntry() - -
    Returns a key-value mapping associated with the greatest - key in this map, or null if the map is empty.
    - +  K lastKey() - -
    Returns the last (highest) key currently in this map.
    - +  java.util.Map.Entry<K,​V> lowerEntry​(K key) - -
    Returns a key-value mapping associated with the greatest key - strictly less than the given key, or null if there is - no such key.
    - +  K lowerKey​(K key) - -
    Returns the greatest key strictly less than the given key, or - null if there is no such key.
    - +  static <K extends java.lang.Comparable<?>,​V>
    ImmutableSortedMap.Builder<K,​V>     @@ -446,9 +401,7 @@

    Method Summary

    ImmutableSortedSet<K> navigableKeySet() - -
    Returns a NavigableSet view of the keys contained in this map.
    - +  static <K,​V>
    ImmutableSortedMap<K,​V>     @@ -878,9 +831,7 @@

    Method Summary

    int size() - -
    Returns the number of key-value mappings in this map.
    - +  ImmutableSortedMap<K,​V> @@ -976,13 +927,6 @@

    of

    Returns the empty sorted map.

    Performance note: the instance returned is a singleton.

    -
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Returns:
    -
    an empty Map
    -
    @@ -996,16 +940,6 @@

    of

    public static <K extends java.lang.Comparable<? super K>,​V> ImmutableSortedMap<K,​V> of​(K k1,
                                                                                                    V v1)
    Returns an immutable map containing a single entry.
    -
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the mapping's key
    -
    v1 - the mapping's value
    -
    Returns:
    -
    a Map containing the specified mapping
    -
    @@ -1023,16 +957,6 @@

    of

    Returns an immutable sorted map containing the given entries, sorted by the natural ordering of their keys.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if the two keys are equal according to their natural ordering
    @@ -1055,18 +979,6 @@

    of

    Returns an immutable sorted map containing the given entries, sorted by the natural ordering of their keys.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if any two keys are equal according to their natural ordering
    @@ -1091,20 +1003,6 @@

    of

    Returns an immutable sorted map containing the given entries, sorted by the natural ordering of their keys.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if any two keys are equal according to their natural ordering
    @@ -1131,22 +1029,6 @@

    of

    Returns an immutable sorted map containing the given entries, sorted by the natural ordering of their keys.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if any two keys are equal according to their natural ordering
    @@ -1175,24 +1057,6 @@

    of

    Returns an immutable sorted map containing the given entries, sorted by the natural ordering of their keys.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    k6 - the sixth mapping's key
    -
    v6 - the sixth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if any two keys are equal according to their natural ordering
    Since:
    @@ -1225,26 +1089,6 @@

    of

    Returns an immutable sorted map containing the given entries, sorted by the natural ordering of their keys.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    k6 - the sixth mapping's key
    -
    v6 - the sixth mapping's value
    -
    k7 - the seventh mapping's key
    -
    v7 - the seventh mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if any two keys are equal according to their natural ordering
    Since:
    @@ -1279,28 +1123,6 @@

    of

    Returns an immutable sorted map containing the given entries, sorted by the natural ordering of their keys.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    k6 - the sixth mapping's key
    -
    v6 - the sixth mapping's value
    -
    k7 - the seventh mapping's key
    -
    v7 - the seventh mapping's value
    -
    k8 - the eighth mapping's key
    -
    v8 - the eighth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if any two keys are equal according to their natural ordering
    Since:
    @@ -1337,30 +1159,6 @@

    of

    Returns an immutable sorted map containing the given entries, sorted by the natural ordering of their keys.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    k6 - the sixth mapping's key
    -
    v6 - the sixth mapping's value
    -
    k7 - the seventh mapping's key
    -
    v7 - the seventh mapping's value
    -
    k8 - the eighth mapping's key
    -
    v8 - the eighth mapping's value
    -
    k9 - the ninth mapping's key
    -
    v9 - the ninth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if any two keys are equal according to their natural ordering
    Since:
    @@ -1399,32 +1197,6 @@

    of

    Returns an immutable sorted map containing the given entries, sorted by the natural ordering of their keys.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    k6 - the sixth mapping's key
    -
    v6 - the sixth mapping's value
    -
    k7 - the seventh mapping's key
    -
    v7 - the seventh mapping's value
    -
    k8 - the eighth mapping's key
    -
    v8 - the eighth mapping's value
    -
    k9 - the ninth mapping's key
    -
    v9 - the ninth mapping's value
    -
    k10 - the tenth mapping's key
    -
    v10 - the tenth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if any two keys are equal according to their natural ordering
    Since:
    @@ -1449,13 +1221,6 @@

    copyOf

    This method is not type-safe, as it may be called on a map with keys that are not mutually comparable.

    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    map - a Map from which entries are drawn, must be non-null
    -
    Returns:
    -
    a Map containing the entries of the given Map
    Throws:
    java.lang.ClassCastException - if the keys in map are not mutually comparable
    java.lang.NullPointerException - if any key or value in map is null
    @@ -1591,15 +1356,9 @@

    reverseOrder

  • size

    public int size()
    -
    Description copied from interface: java.util.Map
    -
    Returns the number of key-value mappings in this map. If the - map contains more than Integer.MAX_VALUE elements, returns - Integer.MAX_VALUE.
    Specified by:
    size in interface java.util.Map<K,​V>
    -
    Returns:
    -
    the number of key-value mappings in this map
    • @@ -1612,30 +1371,11 @@

    get

    @CheckForNull
 public V get​(@CheckForNull
              java.lang.Object key)
    -
    Description copied from interface: java.util.Map
    -
    Returns the value to which the specified key is mapped, - or null if this map contains no mapping for the key. - -

    More formally, if this map contains a mapping from a key - k to a value v such that - Objects.equals(key, k), - then this method returns v; otherwise - it returns null. (There can be at most one such mapping.) - -

    If this map permits null values, then a return value of - null does not necessarily indicate that the map - contains no mapping for the key; it's also possible that the map - explicitly maps the key to null. The containsKey operation may be used to distinguish these two cases.

    Specified by:
    get in interface java.util.Map<K,​V>
    Specified by:
    get in class ImmutableMap<K,​V>
    -
    Parameters:
    -
    key - the key whose associated value is to be returned
    -
    Returns:
    -
    the value to which the specified key is mapped, or - null if this map contains no mapping for the key
    @@ -1654,8 +1394,6 @@

    entrySet

    entrySet in interface java.util.SortedMap<K,​V>
    Overrides:
    entrySet in class ImmutableMap<K,​V>
    -
    Returns:
    -
    a set view of the mappings contained in this map
    @@ -1674,8 +1412,6 @@

    keySet

    keySet in interface java.util.SortedMap<K,​V>
    Overrides:
    keySet in class ImmutableMap<K,​V>
    -
    Returns:
    -
    a set view of the keys contained in this map
    @@ -1695,8 +1431,6 @@

    values

    values in interface java.util.SortedMap<K,​V>
    Overrides:
    values in class ImmutableMap<K,​V>
    -
    Returns:
    -
    a collection view of the values contained in this map
    @@ -1712,10 +1446,6 @@

    comparator

    Specified by:
    comparator in interface java.util.SortedMap<K,​V>
    -
    Returns:
    -
    the comparator used to order the keys in this map, - or null if this map uses the natural ordering - of its keys
    @@ -1726,13 +1456,9 @@

    comparator

  • firstKey

    public K firstKey()
    -
    Description copied from interface: java.util.SortedMap
    -
    Returns the first (lowest) key currently in this map.
    Specified by:
    firstKey in interface java.util.SortedMap<K,​V>
    -
    Returns:
    -
    the first (lowest) key currently in this map
    • @@ -1743,13 +1469,9 @@

    firstKey

  • lastKey

    public K lastKey()
    -
    Description copied from interface: java.util.SortedMap
    -
    Returns the last (highest) key currently in this map.
    Specified by:
    lastKey in interface java.util.SortedMap<K,​V>
    -
    Returns:
    -
    the last (highest) key currently in this map
    • @@ -1774,11 +1496,6 @@

    headMap

    headMap in interface java.util.NavigableMap<K,​V>
    Specified by:
    headMap in interface java.util.SortedMap<K,​V>
    -
    Parameters:
    -
    toKey - high endpoint (exclusive) of the keys in the returned map
    -
    Returns:
    -
    a view of the portion of this map whose keys are strictly - less than toKey
    @@ -1802,13 +1519,6 @@

    headMap

    Specified by:
    headMap in interface java.util.NavigableMap<K,​V>
    -
    Parameters:
    -
    toKey - high endpoint of the keys in the returned map
    -
    inclusive - true if the high endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this map whose keys are less than - (or equal to, if inclusive is true) toKey
    Since:
    12.0
    @@ -1836,12 +1546,6 @@

    subMap

    subMap in interface java.util.NavigableMap<K,​V>
    Specified by:
    subMap in interface java.util.SortedMap<K,​V>
    -
    Parameters:
    -
    fromKey - low endpoint (inclusive) of the keys in the returned map
    -
    toKey - high endpoint (exclusive) of the keys in the returned map
    -
    Returns:
    -
    a view of the portion of this map whose keys range from - fromKey, inclusive, to toKey, exclusive
    @@ -1868,16 +1572,6 @@

    subMap

    Specified by:
    subMap in interface java.util.NavigableMap<K,​V>
    -
    Parameters:
    -
    fromKey - low endpoint of the keys in the returned map
    -
    fromInclusive - true if the low endpoint - is to be included in the returned view
    -
    toKey - high endpoint of the keys in the returned map
    -
    toInclusive - true if the high endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this map whose keys range from - fromKey to toKey
    Since:
    12.0
    @@ -1904,11 +1598,6 @@

    tailMap

    tailMap in interface java.util.NavigableMap<K,​V>
    Specified by:
    tailMap in interface java.util.SortedMap<K,​V>
    -
    Parameters:
    -
    fromKey - low endpoint (inclusive) of the keys in the returned map
    -
    Returns:
    -
    a view of the portion of this map whose keys are greater - than or equal to fromKey
    @@ -1932,13 +1621,6 @@

    tailMap

    Specified by:
    tailMap in interface java.util.NavigableMap<K,​V>
    -
    Parameters:
    -
    fromKey - low endpoint of the keys in the returned map
    -
    inclusive - true if the low endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this map whose keys are greater than - (or equal to, if inclusive is true) fromKey
    Since:
    12.0
    @@ -1954,18 +1636,9 @@

    tailMap

    lowerEntry

    @CheckForNull
 public java.util.Map.Entry<K,​V> lowerEntry​(K key)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a key-value mapping associated with the greatest key - strictly less than the given key, or null if there is - no such key.
    Specified by:
    lowerEntry in interface java.util.NavigableMap<K,​V>
    -
    Parameters:
    -
    key - the key
    -
    Returns:
    -
    an entry with the greatest key less than key, - or null if there is no such key
    @@ -1979,17 +1652,9 @@

    lowerEntry

    lowerKey

    @CheckForNull
 public K lowerKey​(K key)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns the greatest key strictly less than the given key, or - null if there is no such key.
    Specified by:
    lowerKey in interface java.util.NavigableMap<K,​V>
    -
    Parameters:
    -
    key - the key
    -
    Returns:
    -
    the greatest key less than key, - or null if there is no such key
    @@ -2003,18 +1668,9 @@

    lowerKey

    floorEntry

    @CheckForNull
 public java.util.Map.Entry<K,​V> floorEntry​(K key)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a key-value mapping associated with the greatest key - less than or equal to the given key, or null if there - is no such key.
    Specified by:
    floorEntry in interface java.util.NavigableMap<K,​V>
    -
    Parameters:
    -
    key - the key
    -
    Returns:
    -
    an entry with the greatest key less than or equal to - key, or null if there is no such key
    @@ -2028,17 +1684,9 @@

    floorEntry

    floorKey

    @CheckForNull
 public K floorKey​(K key)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns the greatest key less than or equal to the given key, - or null if there is no such key.
    Specified by:
    floorKey in interface java.util.NavigableMap<K,​V>
    -
    Parameters:
    -
    key - the key
    -
    Returns:
    -
    the greatest key less than or equal to key, - or null if there is no such key
    @@ -2052,18 +1700,9 @@

    floorKey

    ceilingEntry

    @CheckForNull
 public java.util.Map.Entry<K,​V> ceilingEntry​(K key)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a key-value mapping associated with the least key - greater than or equal to the given key, or null if - there is no such key.
    Specified by:
    ceilingEntry in interface java.util.NavigableMap<K,​V>
    -
    Parameters:
    -
    key - the key
    -
    Returns:
    -
    an entry with the least key greater than or equal to - key, or null if there is no such key
    @@ -2077,17 +1716,9 @@

    ceilingEntry

    ceilingKey

    @CheckForNull
 public K ceilingKey​(K key)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns the least key greater than or equal to the given key, - or null if there is no such key.
    Specified by:
    ceilingKey in interface java.util.NavigableMap<K,​V>
    -
    Parameters:
    -
    key - the key
    -
    Returns:
    -
    the least key greater than or equal to key, - or null if there is no such key
    @@ -2101,18 +1732,9 @@

    ceilingKey

    higherEntry

    @CheckForNull
 public java.util.Map.Entry<K,​V> higherEntry​(K key)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a key-value mapping associated with the least key - strictly greater than the given key, or null if there - is no such key.
    Specified by:
    higherEntry in interface java.util.NavigableMap<K,​V>
    -
    Parameters:
    -
    key - the key
    -
    Returns:
    -
    an entry with the least key greater than key, - or null if there is no such key
    @@ -2126,17 +1748,9 @@

    higherEntry

    higherKey

    @CheckForNull
 public K higherKey​(K key)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns the least key strictly greater than the given key, or - null if there is no such key.
    Specified by:
    higherKey in interface java.util.NavigableMap<K,​V>
    -
    Parameters:
    -
    key - the key
    -
    Returns:
    -
    the least key greater than key, - or null if there is no such key
    @@ -2148,15 +1762,9 @@

    higherKey

    firstEntry

    @CheckForNull
 public java.util.Map.Entry<K,​V> firstEntry()
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a key-value mapping associated with the least - key in this map, or null if the map is empty.
    Specified by:
    firstEntry in interface java.util.NavigableMap<K,​V>
    -
    Returns:
    -
    an entry with the least key, - or null if this map is empty
    @@ -2168,15 +1776,9 @@

    firstEntry

    lastEntry

    @CheckForNull
 public java.util.Map.Entry<K,​V> lastEntry()
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a key-value mapping associated with the greatest - key in this map, or null if the map is empty.
    Specified by:
    lastEntry in interface java.util.NavigableMap<K,​V>
    -
    Returns:
    -
    an entry with the greatest key, - or null if this map is empty
    @@ -2197,9 +1799,6 @@

    pollFirstEntry

    Specified by:
    pollFirstEntry in interface java.util.NavigableMap<K,​V>
    -
    Returns:
    -
    the removed first entry of this map, - or null if this map is empty
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -2222,9 +1821,6 @@

    pollLastEntry

    Specified by:
    pollLastEntry in interface java.util.NavigableMap<K,​V>
    -
    Returns:
    -
    the removed last entry of this map, - or null if this map is empty
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -2237,23 +1833,9 @@

    pollLastEntry

  • descendingMap

    public ImmutableSortedMap<K,​V> descendingMap()
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a reverse order view of the mappings contained in this map. - The descending map is backed by this map, so changes to the map are - reflected in the descending map, and vice-versa. If either map is - modified while an iteration over a collection view of either map - is in progress (except through the iterator's own remove - operation), the results of the iteration are undefined. - -

    The returned map has an ordering equivalent to - Collections.reverseOrder(comparator()). - The expression m.descendingMap().descendingMap() returns a - view of m essentially equivalent to m.

    Specified by:
    descendingMap in interface java.util.NavigableMap<K,​V>
    -
    Returns:
    -
    a reverse order view of this map
    • @@ -2264,22 +1846,9 @@

    descendingMap

  • navigableKeySet

    public ImmutableSortedSet<K> navigableKeySet()
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a NavigableSet view of the keys contained in this map. - The set's iterator returns the keys in ascending order. - The set is backed by the map, so changes to the map are reflected in - the set, and vice-versa. If the map is modified while an iteration - over the set is in progress (except through the iterator's own - remove operation), the results of the iteration are undefined. The - set supports element removal, which removes the corresponding mapping - from the map, via the Iterator.remove, Set.remove, - removeAll, retainAll, and clear operations. - It does not support the add or addAll operations.
    Specified by:
    navigableKeySet in interface java.util.NavigableMap<K,​V>
    -
    Returns:
    -
    a navigable set view of the keys in this map
    • @@ -2290,22 +1859,9 @@

    navigableKeySet

  • descendingKeySet

    public ImmutableSortedSet<K> descendingKeySet()
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a reverse order NavigableSet view of the keys contained in this map. - The set's iterator returns the keys in descending order. - The set is backed by the map, so changes to the map are reflected in - the set, and vice-versa. If the map is modified while an iteration - over the set is in progress (except through the iterator's own - remove operation), the results of the iteration are undefined. The - set supports element removal, which removes the corresponding mapping - from the map, via the Iterator.remove, Set.remove, - removeAll, retainAll, and clear operations. - It does not support the add or addAll operations.
    Specified by:
    descendingKeySet in interface java.util.NavigableMap<K,​V>
    -
    Returns:
    -
    a reverse order navigable set view of the keys in this map
    • @@ -2365,14 +1921,6 @@

    of

    key. Proper calls will resolve to the version in ImmutableSortedMap, not this dummy version.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the mapping's key
    -
    v1 - the mapping's value
    -
    Returns:
    -
    a Map containing the specified mapping
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -2398,16 +1946,6 @@

    of

    keys. Proper calls will resolve to the version in ImmutableSortedMap, not this dummy version.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -2435,18 +1973,6 @@

    of

    keys. Proper calls to will resolve to the version in ImmutableSortedMap, not this dummy version.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -2477,20 +2003,6 @@

    of

    keys. Proper calls will resolve to the version in ImmutableSortedMap, not this dummy version.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -2523,22 +2035,6 @@

    of

    keys. Proper calls will resolve to the version in ImmutableSortedMap, not this dummy version.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -2573,24 +2069,6 @@

    of

    keys. Proper calls will resolve to the version in ImmutableSortedMap, not this dummy version.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    k6 - the sixth mapping's key
    -
    v6 - the sixth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -2627,26 +2105,6 @@

    of

    keys. Proper calls will resolve to the version in ImmutableSortedMap, not this dummy version.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    k6 - the sixth mapping's key
    -
    v6 - the sixth mapping's value
    -
    k7 - the seventh mapping's key
    -
    v7 - the seventh mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -2685,28 +2143,6 @@

    of

    keys. Proper calls will resolve to the version in ImmutableSortedMap, not this dummy version.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    k6 - the sixth mapping's key
    -
    v6 - the sixth mapping's value
    -
    k7 - the seventh mapping's key
    -
    v7 - the seventh mapping's value
    -
    k8 - the eighth mapping's key
    -
    v8 - the eighth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -2747,30 +2183,6 @@

    of

    keys. Proper calls will resolve to the version in ImmutableSortedMap, not this dummy version.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    k6 - the sixth mapping's key
    -
    v6 - the sixth mapping's value
    -
    k7 - the seventh mapping's key
    -
    v7 - the seventh mapping's value
    -
    k8 - the eighth mapping's key
    -
    v8 - the eighth mapping's value
    -
    k9 - the ninth mapping's key
    -
    v9 - the ninth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -2813,32 +2225,6 @@

    of

    keys. Proper calls will resolve to the version in ImmutableSortedMap, not this dummy version.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    k6 - the sixth mapping's key
    -
    v6 - the sixth mapping's value
    -
    k7 - the seventh mapping's key
    -
    v7 - the seventh mapping's value
    -
    k8 - the eighth mapping's key
    -
    v8 - the eighth mapping's value
    -
    k9 - the ninth mapping's key
    -
    v9 - the ninth mapping's value
    -
    k10 - the tenth mapping's key
    -
    v10 - the tenth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -2856,17 +2242,6 @@

    ofEntries

    Use ImmutableSortedMap.copyOf(ImmutableMap.ofEntries(...)).
    Not supported. Use ImmutableSortedMap.copyOf(ImmutableMap.ofEntries(...)).
    -
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    entries - Map.Entrys containing the keys and values from which the map is populated
    -
    Returns:
    -
    a Map containing the specified mappings
    -
    See Also:
    -
    Map.entry()
    -
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableSortedSet.html b/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableSortedSet.html index 4c60c7de90b1..219c471b93e1 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableSortedSet.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableSortedSet.html @@ -244,10 +244,7 @@

    Method Summary

    E ceiling​(E e) - -
    Returns the least element in this set greater than or equal to - the given element, or null if there is no such element.
    - +  java.util.Comparator<? super E> @@ -332,56 +329,37 @@

    Method Summary

    abstract UnmodifiableIterator<E> descendingIterator() - -
    Returns an iterator over the elements in this set, in descending order.
    - +  ImmutableSortedSet<E> descendingSet() - -
    Returns a reverse order view of the elements contained in this set.
    - +  E first() - -
    Returns the first (lowest) element currently in this set.
    - +  E floor​(E e) - -
    Returns the greatest element in this set less than or equal to - the given element, or null if there is no such element.
    - +  ImmutableSortedSet<E> headSet​(E toElement) - -
    Returns a view of the portion of this set whose elements are - strictly less than toElement.
    - ImmutableSortedSet<E> headSet​(E toElement, boolean inclusive) - -
    Returns a view of the portion of this set whose elements are less than - (or equal to, if inclusive is true) toElement.
    - +  E higher​(E e) - -
    Returns the least element in this set strictly greater than the - given element, or null if there is no such element.
    - +  abstract UnmodifiableIterator<E> @@ -393,17 +371,12 @@

    Method Summary

    E last() - -
    Returns the last (highest) element currently in this set.
    - +  E lower​(E e) - -
    Returns the greatest element in this set strictly less than the - given element, or null if there is no such element.
    - +  static <E extends java.lang.Comparable<?>>
    ImmutableSortedSet.Builder<E>     @@ -588,37 +561,22 @@

    Method Summary

    boolean fromInclusive, E toElement, boolean toInclusive) - -
    Returns a view of the portion of this set whose elements range from - fromElement to toElement.
    - +  ImmutableSortedSet<E> subSet​(E fromElement, E toElement) - -
    Returns a view of the portion of this set whose elements range - from fromElement, inclusive, to toElement, - exclusive.
    - ImmutableSortedSet<E> tailSet​(E fromElement) - -
    Returns a view of the portion of this set whose elements are - greater than or equal to fromElement.
    - ImmutableSortedSet<E> tailSet​(E fromElement, boolean inclusive) - -
    Returns a view of the portion of this set whose elements are greater - than (or equal to, if inclusive is true) fromElement.
    - + 
      @@ -703,12 +661,6 @@

      of

      Returns the empty immutable sorted set.

      Performance note: the instance returned is a singleton.

      -
      -
      Type Parameters:
      -
      E - the Set's element type
      -
      Returns:
      -
      an empty Set
      -
    @@ -721,14 +673,6 @@

    of

    of

    public static <E extends java.lang.Comparable<? super E>> ImmutableSortedSet<E> of​(E element)
    Returns an immutable sorted set containing a single element.
    -
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    element - the single element
    -
    Returns:
    -
    a Set containing the specified element
    -
    @@ -745,13 +689,6 @@

    of

    When multiple elements are equivalent according to Comparable.compareTo(T), only the first one specified is included.
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    Returns:
    -
    a Set containing the specified elements
    Throws:
    java.lang.NullPointerException - if any element is null
    @@ -772,14 +709,6 @@

    of

    When multiple elements are equivalent according to Comparable.compareTo(T), only the first one specified is included.
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    Returns:
    -
    a Set containing the specified elements
    Throws:
    java.lang.NullPointerException - if any element is null
    @@ -801,15 +730,6 @@

    of

    When multiple elements are equivalent according to Comparable.compareTo(T), only the first one specified is included.
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    e4 - the fourth element
    -
    Returns:
    -
    a Set containing the specified elements
    Throws:
    java.lang.NullPointerException - if any element is null
    @@ -832,16 +752,6 @@

    of

    When multiple elements are equivalent according to Comparable.compareTo(T), only the first one specified is included.
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    e4 - the fourth element
    -
    e5 - the fifth element
    -
    Returns:
    -
    a Set containing the specified elements
    Throws:
    java.lang.NullPointerException - if any element is null
    @@ -866,18 +776,6 @@

    of

    When multiple elements are equivalent according to Comparable.compareTo(T), only the first one specified is included.
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    e4 - the fourth element
    -
    e5 - the fifth element
    -
    e6 - the sixth element
    -
    remaining - the seventh element
    -
    Returns:
    -
    a Set containing the specified elements
    Throws:
    java.lang.NullPointerException - if any element is null
    Since:
    @@ -961,12 +859,6 @@

    copyOf

    This method is safe to use even when elements is a synchronized or concurrent collection that is currently being modified by another thread.

    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    elements - a Collection from which elements are drawn, must be non-null
    -
    Returns:
    -
    a Set containing the elements of the given Collection
    Throws:
    java.lang.ClassCastException - if the elements are not mutually comparable
    java.lang.NullPointerException - if any of elements is null
    @@ -1135,10 +1027,6 @@

    comparator

    Specified by:
    comparator in interface java.util.SortedSet<E>
    -
    Returns:
    -
    the comparator used to order the elements in this set, - or null if this set uses the natural ordering - of its elements
    @@ -1162,8 +1050,6 @@

    iterator

    iterator in interface java.util.Set<E>
    Specified by:
    iterator in class ImmutableSet<E>
    -
    Returns:
    -
    an iterator over the elements contained in this collection
    @@ -1176,16 +1062,7 @@

    iterator

  • headSet

    public ImmutableSortedSet<E> headSet​(E toElement)
    -
    Returns a view of the portion of this set whose elements are - strictly less than toElement. The returned set is - backed by this set, so changes in the returned set are - reflected in this set, and vice-versa. The returned set - supports all optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range. - -

    Equivalent to headSet(toElement, false). +

    This method returns a serializable ImmutableSortedSet. @@ -1198,11 +1075,6 @@

    headSet

    headSet in interface java.util.NavigableSet<E>
    Specified by:
    headSet in interface java.util.SortedSet<E>
    -
    Parameters:
    -
    toElement - high endpoint (exclusive) of the returned set
    -
    Returns:
    -
    a view of the portion of this set whose elements are strictly - less than toElement
    • @@ -1216,25 +1088,9 @@

    headSet

    headSet

    public ImmutableSortedSet<E> headSet​(E toElement,
                                      boolean inclusive)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns a view of the portion of this set whose elements are less than - (or equal to, if inclusive is true) toElement. The - returned set is backed by this set, so changes in the returned set are - reflected in this set, and vice-versa. The returned set supports all - optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    headSet in interface java.util.NavigableSet<E>
    -
    Parameters:
    -
    toElement - high endpoint of the returned set
    -
    inclusive - true if the high endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this set whose elements are less than - (or equal to, if inclusive is true) toElement
    Since:
    12.0
    @@ -1250,18 +1106,7 @@

    headSet

    subSet

    public ImmutableSortedSet<E> subSet​(E fromElement,
                                     E toElement)
    -
    Returns a view of the portion of this set whose elements range - from fromElement, inclusive, to toElement, - exclusive. (If fromElement and toElement are - equal, the returned set is empty.) The returned set is backed - by this set, so changes in the returned set are reflected in - this set, and vice-versa. The returned set supports all - optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range. - -

    Equivalent to subSet(fromElement, true, toElement, false). +

    This method returns a serializable ImmutableSortedSet. @@ -1275,12 +1120,6 @@

    subSet

    subSet in interface java.util.NavigableSet<E>
    Specified by:
    subSet in interface java.util.SortedSet<E>
    -
    Parameters:
    -
    fromElement - low endpoint (inclusive) of the returned set
    -
    toElement - high endpoint (exclusive) of the returned set
    -
    Returns:
    -
    a view of the portion of this set whose elements range from - fromElement, inclusive, to toElement, exclusive
    @@ -1297,30 +1136,9 @@

    subSet

    boolean fromInclusive, E toElement, boolean toInclusive) -
    Description copied from interface: java.util.NavigableSet
    -
    Returns a view of the portion of this set whose elements range from - fromElement to toElement. If fromElement and - toElement are equal, the returned set is empty unless - fromInclusive and toInclusive are both true. The returned set - is backed by this set, so changes in the returned set are reflected in - this set, and vice-versa. The returned set supports all optional set - operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    subSet in interface java.util.NavigableSet<E>
    -
    Parameters:
    -
    fromElement - low endpoint of the returned set
    -
    fromInclusive - true if the low endpoint - is to be included in the returned view
    -
    toElement - high endpoint of the returned set
    -
    toInclusive - true if the high endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this set whose elements range from - fromElement, inclusive, to toElement, exclusive
    Since:
    12.0
    @@ -1335,16 +1153,7 @@

    subSet

  • tailSet

    public ImmutableSortedSet<E> tailSet​(E fromElement)
    -
    Returns a view of the portion of this set whose elements are - greater than or equal to fromElement. The returned - set is backed by this set, so changes in the returned set are - reflected in this set, and vice-versa. The returned set - supports all optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range. - -

    Equivalent to tailSet(fromElement, true). +

    This method returns a serializable ImmutableSortedSet. @@ -1357,11 +1166,6 @@

    tailSet

    tailSet in interface java.util.NavigableSet<E>
    Specified by:
    tailSet in interface java.util.SortedSet<E>
    -
    Parameters:
    -
    fromElement - low endpoint (inclusive) of the returned set
    -
    Returns:
    -
    a view of the portion of this set whose elements are greater - than or equal to fromElement
    • @@ -1375,25 +1179,9 @@

    tailSet

    tailSet

    public ImmutableSortedSet<E> tailSet​(E fromElement,
                                      boolean inclusive)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns a view of the portion of this set whose elements are greater - than (or equal to, if inclusive is true) fromElement. - The returned set is backed by this set, so changes in the returned set - are reflected in this set, and vice-versa. The returned set supports - all optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    tailSet in interface java.util.NavigableSet<E>
    -
    Parameters:
    -
    fromElement - low endpoint of the returned set
    -
    inclusive - true if the low endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this set whose elements are greater - than or equal to fromElement
    Since:
    12.0
    @@ -1410,17 +1198,9 @@

    lower

    @GwtIncompatible
 @CheckForNull
 public E lower​(E e)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns the greatest element in this set strictly less than the - given element, or null if there is no such element.
    Specified by:
    lower in interface java.util.NavigableSet<E>
    -
    Parameters:
    -
    e - the value to match
    -
    Returns:
    -
    the greatest element less than e, - or null if there is no such element
    Since:
    12.0
    @@ -1436,17 +1216,9 @@

    lower

    floor

    @CheckForNull
 public E floor​(E e)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns the greatest element in this set less than or equal to - the given element, or null if there is no such element.
    Specified by:
    floor in interface java.util.NavigableSet<E>
    -
    Parameters:
    -
    e - the value to match
    -
    Returns:
    -
    the greatest element less than or equal to e, - or null if there is no such element
    Since:
    12.0
    @@ -1462,17 +1234,9 @@

    floor

    ceiling

    @CheckForNull
 public E ceiling​(E e)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns the least element in this set greater than or equal to - the given element, or null if there is no such element.
    Specified by:
    ceiling in interface java.util.NavigableSet<E>
    -
    Parameters:
    -
    e - the value to match
    -
    Returns:
    -
    the least element greater than or equal to e, - or null if there is no such element
    Since:
    12.0
    @@ -1489,17 +1253,9 @@

    higher

    @GwtIncompatible
 @CheckForNull
 public E higher​(E e)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns the least element in this set strictly greater than the - given element, or null if there is no such element.
    Specified by:
    higher in interface java.util.NavigableSet<E>
    -
    Parameters:
    -
    e - the value to match
    -
    Returns:
    -
    the least element greater than e, - or null if there is no such element
    Since:
    12.0
    @@ -1512,13 +1268,9 @@

    higher

  • first

    public E first()
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns the first (lowest) element currently in this set.
    Specified by:
    first in interface java.util.SortedSet<E>
    -
    Returns:
    -
    the first (lowest) element currently in this set
    • @@ -1529,13 +1281,9 @@

    first

  • last

    public E last()
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns the last (highest) element currently in this set.
    Specified by:
    last in interface java.util.SortedSet<E>
    -
    Returns:
    -
    the last (highest) element currently in this set
    • @@ -1557,8 +1305,6 @@

    pollFirst

    Specified by:
    pollFirst in interface java.util.NavigableSet<E>
    -
    Returns:
    -
    the first element, or null if this set is empty
    Throws:
    java.lang.UnsupportedOperationException - always
    Since:
    @@ -1584,8 +1330,6 @@

    pollLast

    Specified by:
    pollLast in interface java.util.NavigableSet<E>
    -
    Returns:
    -
    the last element, or null if this set is empty
    Throws:
    java.lang.UnsupportedOperationException - always
    Since:
    @@ -1601,23 +1345,9 @@

    pollLast

    descendingSet

    @GwtIncompatible
 public ImmutableSortedSet<E> descendingSet()
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns a reverse order view of the elements contained in this set. - The descending set is backed by this set, so changes to the set are - reflected in the descending set, and vice-versa. If either set is - modified while an iteration over either set is in progress (except - through the iterator's own remove operation), the results of - the iteration are undefined. - -

    The returned set has an ordering equivalent to - Collections.reverseOrder(comparator()). - The expression s.descendingSet().descendingSet() returns a - view of s essentially equivalent to s.

    Specified by:
    descendingSet in interface java.util.NavigableSet<E>
    -
    Returns:
    -
    a reverse order view of this set
    Since:
    12.0
    @@ -1631,14 +1361,9 @@

    descendingSet

    descendingIterator

    @GwtIncompatible
 public abstract UnmodifiableIterator<E> descendingIterator()
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns an iterator over the elements in this set, in descending order. - Equivalent in effect to descendingSet().iterator().
    Specified by:
    descendingIterator in interface java.util.NavigableSet<E>
    -
    Returns:
    -
    an iterator over the elements in this set, in descending order
    Since:
    12.0
    @@ -1700,12 +1425,6 @@

    of

    element. Proper calls will resolve to the version in ImmutableSortedSet, not this dummy version.
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    element - the single element
    -
    Returns:
    -
    a Set containing the specified element
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -1729,13 +1448,6 @@

    of

    element. Proper calls will resolve to the version in ImmutableSortedSet, not this dummy version.
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    Returns:
    -
    a Set containing the specified elements
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -1760,14 +1472,6 @@

    of

    element. Proper calls will resolve to the version in ImmutableSortedSet, not this dummy version.
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    Returns:
    -
    a Set containing the specified elements
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -1793,15 +1497,6 @@

    of

    element. Proper calls will resolve to the version in ImmutableSortedSet, not this dummy version.
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    e4 - the fourth element
    -
    Returns:
    -
    a Set containing the specified elements
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -1828,16 +1523,6 @@

    of

    element. Proper calls will resolve to the version in ImmutableSortedSet, not this dummy version.
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    e4 - the fourth element
    -
    e5 - the fifth element
    -
    Returns:
    -
    a Set containing the specified elements
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -1867,18 +1552,6 @@

    of

    element. Proper calls will resolve to the version in ImmutableSortedSet, not this dummy version.
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    e4 - the fourth element
    -
    e5 - the fifth element
    -
    e6 - the sixth element
    -
    remaining - the seventh element
    -
    Returns:
    -
    a Set containing the specified elements
    Throws:
    java.lang.UnsupportedOperationException - always
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableTable.html b/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableTable.html index dec363272002..7758c6373bfb 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableTable.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableTable.html @@ -290,7 +290,7 @@

    Method Summary

    boolean equals​(java.lang.Object obj) -
    Indicates whether some other object is "equal to" this one.
    +
    Compares the specified object with this table for equality.
    @@ -306,7 +306,7 @@

    Method Summary

    int hashCode() -
    Returns a hash code value for the object.
    +
    Returns the hash code for this table.
    @@ -886,58 +886,14 @@

    isEmpty

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object obj)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    +
    Description copied from interface: Table
    +
    Compares the specified object with this table for equality. Two tables are equal when their + cell views, as returned by Table.cellSet(), are equal.
    Specified by:
    equals in interface Table<R extends @Nullable java.lang.Object,​C extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -948,45 +904,14 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    +
    Description copied from interface: Table
    +
    Returns the hash code for this table. The hash code of a table is defined as the hash code of + its cell view, as returned by Table.cellSet().
    Specified by:
    hashCode in interface Table<R extends @Nullable java.lang.Object,​C extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -1001,8 +926,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/LinkedHashMultimap.html b/releases/snapshot-android/api/docs/com/google/common/collect/LinkedHashMultimap.html index 7277c93ef581..64e6c018bf8e 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/LinkedHashMultimap.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/LinkedHashMultimap.html @@ -699,14 +699,6 @@

    equals

    equals in interface Multimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Specified by:
    equals in interface SetMultimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -906,8 +898,6 @@

    hashCode

    hashCode in interface Multimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    See Also:
    Map.hashCode()
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/LinkedHashMultiset.html b/releases/snapshot-android/api/docs/com/google/common/collect/LinkedHashMultiset.html index 210330609f06..b844e44852be 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/LinkedHashMultiset.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/LinkedHashMultiset.html @@ -201,8 +201,7 @@

    Method Summary

    boolean add​(E element) -
    Ensures that this collection contains the specified element (optional - operation).
    +
    Adds a single occurrence of the specified element to this multiset.
    @@ -216,23 +215,17 @@

    Method Summary

    boolean addAll​(java.util.Collection<? extends E> elementsToAdd) - -
    Adds all of the elements in the specified collection to this collection - (optional operation).
    - void clear() - -
    Removes all of the elements from this collection (optional operation).
    - +  boolean contains​(java.lang.Object element) -
    Returns true if this collection contains the specified element.
    +
    Determines whether this multiset contains the specified element.
    @@ -284,36 +277,30 @@

    Method Summary

    boolean equals​(java.lang.Object object) -
    Indicates whether some other object is "equal to" this one.
    +
    Compares the specified object with this multiset for equality.
    int hashCode() -
    Returns a hash code value for the object.
    +
    Returns the hash code for this multiset.
    boolean isEmpty() - -
    Returns true if this collection contains no elements.
    - +  java.util.Iterator<E> iterator() - -
    Returns an iterator over the elements contained in this collection.
    - boolean remove​(java.lang.Object element) -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation).
    +
    Removes a single occurrence of the specified element from this multiset, if present.
    @@ -327,18 +314,10 @@

    Method Summary

    boolean removeAll​(java.util.Collection<?> elementsToRemove) - -
    Removes all of this collection's elements that are also contained in the - specified collection (optional operation).
    - boolean retainAll​(java.util.Collection<?> elementsToRetain) - -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation).
    - int @@ -362,15 +341,12 @@

    Method Summary

    int size() -
    Returns the number of elements in this collection.
    +
    Returns the total number of all occurrences of all elements in this multiset.
    java.lang.String toString() - -
    Returns a string representation of this collection.
    - @@ -652,10 +626,11 @@

    iterator

  • size

    public final int size()
    -
    Description copied from interface: java.util.Collection
    -
    Returns the number of elements in this collection. If this collection - contains more than Integer.MAX_VALUE elements, returns - Integer.MAX_VALUE.
    +
    Description copied from interface: Multiset
    +
    Returns the total number of all occurrences of all elements in this multiset. + +

    Note: this method does not return the number of distinct elements in the + multiset, which is given by entrySet().size().

    Specified by:
    size in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -663,8 +638,6 @@

    size

    size in interface Multiset<E extends @Nullable java.lang.Object>
    Specified by:
    size in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the number of elements in this collection
    • @@ -675,15 +648,11 @@

    size

  • isEmpty

    public boolean isEmpty()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains no elements.
    Specified by:
    isEmpty in interface java.util.Collection<E extends @Nullable java.lang.Object>
    Overrides:
    isEmpty in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    true if this collection contains no elements
    • @@ -695,11 +664,11 @@

    isEmpty

    contains

    public boolean contains​(@CheckForNull
                         java.lang.Object element)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains the specified element. - More formally, returns true if and only if this collection - contains at least one element e such that - Objects.equals(o, e).
    +
    Description copied from interface: Multiset
    +
    Determines whether this multiset contains the specified element. + +

    This method refines Collection.contains(java.lang.Object) to further specify that it may not + throw an exception in response to element being null or of the wrong type.

    Specified by:
    contains in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -708,10 +677,9 @@

    contains

    Overrides:
    contains in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    Parameters:
    -
    element - element whose presence in this collection is to be tested
    +
    element - the element to check for
    Returns:
    -
    true if this collection contains the specified - element
    +
    true if this multiset contains at least one occurrence of the element
    @@ -725,24 +693,14 @@

    contains

    add

    @CanIgnoreReturnValue
 public final boolean add​(E element)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Ensures that this collection contains the specified element (optional - operation). Returns true if this collection changed as a - result of the call. (Returns false if this collection does - not permit duplicates and already contains the specified element.)

    +

    Description copied from interface: Multiset
    +
    Adds a single occurrence of the specified element to this multiset. - Collections that support this operation may place limitations on what - elements may be added to this collection. In particular, some - collections will refuse to add null elements, and others will - impose restrictions on the type of elements that may be added. - Collection classes should clearly specify in their documentation any - restrictions on what elements may be added.

    +

    This method refines Collection.add(E), which only ensures the presence of the + element, to further specify that a successful call must always increment the count of the + element, and the overall size of the collection, by one. - If a collection refuses to add a particular element for any reason - other than that it already contains the element, it must throw - an exception (rather than returning false). This preserves - the invariant that a collection always contains the specified element - after this call returns.

    +

    To both add the element and obtain the previous count of that element, use add(element, 1) instead.

    Specified by:
    add in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -751,10 +709,11 @@

    add

    Overrides:
    add in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    Parameters:
    -
    element - element whose presence in this collection is to be ensured
    +
    element - the element to add one occurrence of; may be null only if explicitly allowed by + the implementation
    Returns:
    -
    true if this collection changed as a result of the - call
    +
    true always, since this call is required to modify the multiset, unlike other + Collection types
    @@ -767,14 +726,13 @@

    remove

    @CanIgnoreReturnValue
 public final boolean remove​(@CheckForNull
                             java.lang.Object element)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation). More formally, - removes an element e such that - Objects.equals(o, e), if - this collection contains one or more such elements. Returns - true if this collection contained the specified element (or - equivalently, if this collection changed as a result of the call).
    +
    Description copied from interface: Multiset
    +
    Removes a single occurrence of the specified element from this multiset, if present. + +

    This method refines Collection.remove(java.lang.Object) to further specify that it may not + throw an exception in response to element being null or of the wrong type. + +

    To both remove the element and obtain the previous count of that element, use remove(element, 1) instead.

    Specified by:
    remove in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -783,9 +741,9 @@

    remove

    Overrides:
    remove in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    Parameters:
    -
    element - element to be removed from this collection, if present
    +
    element - the element to remove one occurrence of
    Returns:
    -
    true if an element was removed as a result of this call
    +
    true if an occurrence was found and removed
    @@ -797,12 +755,7 @@

    remove

    addAll

    @CanIgnoreReturnValue
 public final boolean addAll​(java.util.Collection<? extends E> elementsToAdd)
    -
    Adds all of the elements in the specified collection to this collection - (optional operation). The behavior of this operation is undefined if - the specified collection is modified while the operation is in progress. - (This implies that the behavior of this call is undefined if the - specified collection is this collection, and this collection is - nonempty.) +

    This implementation is highly efficient when elementsToAdd is itself a Multiset.

    @@ -810,12 +763,6 @@

    addAll

    addAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    Overrides:
    addAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    elementsToAdd - collection containing elements to be added to this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    -
    See Also:
    -
    AbstractCollection.add(Object)
    @@ -827,11 +774,16 @@

    addAll

    removeAll

    @CanIgnoreReturnValue
 public final boolean removeAll​(java.util.Collection<?> elementsToRemove)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes all of this collection's elements that are also contained in the - specified collection (optional operation). After this call returns, - this collection will contain no elements in common with the specified - collection.
    +
    Description copied from interface: Multiset
    +
    + +

    Note: This method ignores how often any element might appear in c, and only + cares whether or not an element appears at all. If you wish to remove one occurrence in this + multiset for every occurrence in c, see Multisets.removeOccurrences(Multiset, + Multiset). + +

    This method refines Collection.removeAll(java.util.Collection<?>) to further specify that it may not + throw an exception in response to any of elements being null or of the wrong type.

    Specified by:
    removeAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -839,14 +791,6 @@

    removeAll

    removeAll in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    removeAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    elementsToRemove - collection containing elements to be removed from this collection
    -
    Returns:
    -
    true if this collection changed as a result of the - call
    -
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    @@ -858,11 +802,16 @@

    removeAll

    retainAll

    @CanIgnoreReturnValue
 public final boolean retainAll​(java.util.Collection<?> elementsToRetain)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation). In other words, removes from - this collection all of its elements that are not contained in the - specified collection.
    +
    Description copied from interface: Multiset
    +
    + +

    Note: This method ignores how often any element might appear in c, and only + cares whether or not an element appears at all. If you wish to remove one occurrence in this + multiset for every occurrence in c, see Multisets.retainOccurrences(Multiset, + Multiset). + +

    This method refines Collection.retainAll(java.util.Collection<?>) to further specify that it may not + throw an exception in response to any of elements being null or of the wrong type.

    Specified by:
    retainAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -870,13 +819,8 @@

    retainAll

    retainAll in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    retainAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    elementsToRetain - collection containing elements to be retained in this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    +
    Multisets.retainOccurrences(Multiset, Multiset)
    @@ -942,44 +886,9 @@

    entrySet

    equals

    public final boolean equals​(@CheckForNull
                             java.lang.Object object)
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes. +

    Compares the specified object with this multiset for equality. Returns true if the + given object is also a multiset and contains equal elements with equal counts, regardless of + order.

    This implementation returns true if object is a multiset of the same size and if, for each element, the two multisets have the same count.

    @@ -990,14 +899,6 @@

    equals

    equals in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -1008,34 +909,14 @@

    equals

  • hashCode

    public final int hashCode()
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.) +

    Returns the hash code for this multiset. This is defined as the sum of + + 
    
+ ((element == null) ? 0 : element.hashCode()) ^ count(element)
+
    + +

    over all distinct elements in the multiset. It follows that a multiset and its entry set + always have the same hash code.

    This implementation returns the hash code of Multiset.entrySet().

    @@ -1045,11 +926,6 @@

    hashCode

    hashCode in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -1060,12 +936,11 @@

    hashCode

  • toString

    public final java.lang.String toString()
    -
    Returns a string representation of this collection. The string - representation consists of a list of the collection's elements in the - order they are returned by its iterator, enclosed in square brackets - ("[]"). Adjacent elements are separated by the characters - ", " (comma and space). Elements are converted to strings as - by String.valueOf(Object). +
    + +

    It is recommended, though not mandatory, that this method return the result of invoking + Multiset.toString() on the Multiset.entrySet(), yielding a result such as [a x 3, c, d x 2, + e].

    This implementation returns the result of invoking toString on Multiset.entrySet().

    @@ -1073,8 +948,6 @@

    toString

    toString in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    toString in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a string representation of this collection
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/LinkedListMultimap.html b/releases/snapshot-android/api/docs/com/google/common/collect/LinkedListMultimap.html index f1dc57916294..4b9b1a6a1b02 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/LinkedListMultimap.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/LinkedListMultimap.html @@ -288,7 +288,7 @@

    Method Summary

    boolean equals​(java.lang.Object object) -
    Indicates whether some other object is "equal to" this one.
    +
    Compares the specified object with this multimap for equality.
    @@ -893,58 +893,23 @@

    asMap

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object object)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    +
    Description copied from interface: Multimap
    +
    Compares the specified object with this multimap for equality. Two multimaps are equal when + their map views, as returned by Multimap.asMap(), are also equal. + +

    In general, two multimaps with identical key-value mappings may or may not be equal, + depending on the implementation. For example, two SetMultimap instances with the same + key-value mappings are equal, but equality of two ListMultimap instances depends on the + ordering of the values for each key. + +

    A non-empty SetMultimap cannot be equal to a non-empty ListMultimap, since + their Multimap.asMap() views contain unequal collections as values. However, any two empty + multimaps are equal, because they both have empty Multimap.asMap() views.

    Specified by:
    equals in interface Multimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -964,8 +929,6 @@

    hashCode

    hashCode in interface Multimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    See Also:
    Map.hashCode()
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/ListMultimap.html b/releases/snapshot-android/api/docs/com/google/common/collect/ListMultimap.html index 4ff576b09050..49df3a1cfb9c 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/ListMultimap.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/ListMultimap.html @@ -352,14 +352,6 @@

    equals

    equals in interface Multimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/MapDifference.ValueDifference.html b/releases/snapshot-android/api/docs/com/google/common/collect/MapDifference.ValueDifference.html index 5629c4e04102..28111751d818 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/MapDifference.ValueDifference.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/MapDifference.ValueDifference.html @@ -235,14 +235,6 @@

    equals

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    other - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -257,11 +249,6 @@

    hashCode

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/MapDifference.html b/releases/snapshot-android/api/docs/com/google/common/collect/MapDifference.html index 6df040295d62..e06a4af051d1 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/MapDifference.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/MapDifference.html @@ -322,14 +322,6 @@

    equals

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -349,11 +341,6 @@

    hashCode

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/MapMaker.html b/releases/snapshot-android/api/docs/com/google/common/collect/MapMaker.html index eb31f27ce4df..4ef368abdf5b 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/MapMaker.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/MapMaker.html @@ -443,8 +443,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/MinMaxPriorityQueue.html b/releases/snapshot-android/api/docs/com/google/common/collect/MinMaxPriorityQueue.html index 1cf75d4d0a3e..057c17124df9 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/MinMaxPriorityQueue.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/MinMaxPriorityQueue.html @@ -255,17 +255,12 @@

    Method Summary

    boolean addAll​(java.util.Collection<? extends E> newElements) - -
    Adds all of the elements in the specified collection to this - queue.
    - +  void clear() - -
    Removes all of the elements from this queue.
    - +  java.util.Comparator<? super E> @@ -332,10 +327,7 @@

    Method Summary

    E peek() - -
    Retrieves, but does not remove, the head of this queue, - or returns null if this queue is empty.
    - +  E @@ -356,10 +348,7 @@

    Method Summary

    E poll() - -
    Retrieves and removes the head of this queue, - or returns null if this queue is empty.
    - +  E @@ -394,16 +383,12 @@

    Method Summary

    int size() - -
    Returns the number of elements in this collection.
    - +  java.lang.Object[] toArray() - -
    Returns an array containing all of the elements in this collection.
    - +  @@ -555,8 +534,6 @@

    add

    add in interface java.util.Queue<E>
    Overrides:
    add in class java.util.AbstractQueue<E>
    -
    Parameters:
    -
    element - the element to add
    Returns:
    true always
    @@ -570,31 +547,11 @@

    add

    addAll

    @CanIgnoreReturnValue
 public boolean addAll​(java.util.Collection<? extends E> newElements)
    -
    Description copied from class: java.util.AbstractQueue
    -
    Adds all of the elements in the specified collection to this - queue. Attempts to addAll of a queue to itself result in - IllegalArgumentException. Further, the behavior of - this operation is undefined if the specified collection is - modified while the operation is in progress. - -

    This implementation iterates over the specified collection, - and adds each element returned by the iterator to this - queue, in turn. A runtime exception encountered while - trying to add an element (including, in particular, a - null element) may result in only some of the elements - having been successfully added when the associated exception is - thrown.

    Specified by:
    addAll in interface java.util.Collection<E>
    Overrides:
    addAll in class java.util.AbstractQueue<E>
    -
    Parameters:
    -
    newElements - collection containing elements to be added to this queue
    -
    Returns:
    -
    true if this queue changed as a result of the call
    -
    See Also:
    -
    AbstractQueue.add(Object)
    @@ -611,13 +568,6 @@

    offer

    Adds the given element to this queue. If this queue has a maximum size, after adding element the queue will automatically evict its greatest element (according to its comparator), which may be element itself.
    -
    -
    Parameters:
    -
    element - the element to add
    -
    Returns:
    -
    true if the element was added to this queue, else - false
    -
    @@ -629,13 +579,6 @@

    poll

    @CanIgnoreReturnValue
 @CheckForNull
 public E poll()
    -
    Description copied from interface: java.util.Queue
    -
    Retrieves and removes the head of this queue, - or returns null if this queue is empty.
    -
    -
    Returns:
    -
    the head of this queue, or null if this queue is empty
    -
    @@ -646,13 +589,6 @@

    poll

    peek

    @CheckForNull
 public E peek()
    -
    Description copied from interface: java.util.Queue
    -
    Retrieves, but does not remove, the head of this queue, - or returns null if this queue is empty.
    -
    -
    Returns:
    -
    the head of this queue, or null if this queue is empty
    -
    @@ -776,12 +712,6 @@

    iterator

  • clear

    public void clear()
    -
    Description copied from class: java.util.AbstractQueue
    -
    Removes all of the elements from this queue. - The queue will be empty after this call returns. - -

    This implementation repeatedly invokes poll until it - returns null.

    Specified by:
    clear in interface java.util.Collection<E>
    @@ -797,24 +727,11 @@

    clear

  • toArray

    public java.lang.Object[] toArray()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns an array containing all of the elements in this collection. - If this collection makes any guarantees as to what order its elements - are returned by its iterator, this method must return the elements in - the same order. The returned array's runtime component type is Object. - -

    The returned array will be "safe" in that no references to it are - maintained by this collection. (In other words, this method must - allocate a new array even if this collection is backed by an array). - The caller is thus free to modify the returned array.

    Specified by:
    toArray in interface java.util.Collection<E>
    Overrides:
    toArray in class java.util.AbstractCollection<E>
    -
    Returns:
    -
    an array, whose runtime component - type is Object, containing all of the elements in this collection
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/Multimap.html b/releases/snapshot-android/api/docs/com/google/common/collect/Multimap.html index 6075302e585f..7db413ac2408 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/Multimap.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/Multimap.html @@ -762,14 +762,6 @@

    equals

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    • @@ -792,11 +784,6 @@

    hashCode

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/Multiset.Entry.html b/releases/snapshot-android/api/docs/com/google/common/collect/Multiset.Entry.html index d0c48f46b24b..6f5dec4eddd6 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/Multiset.Entry.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/Multiset.Entry.html @@ -160,9 +160,6 @@

    Method Summary

    boolean equals​(java.lang.Object o) - -
    Indicates whether some other object is "equal to" this one.
    - int @@ -181,9 +178,6 @@

    Method Summary

    int hashCode() - -
    Returns a hash code value for the object.
    - java.lang.String @@ -250,44 +244,7 @@

    getCount

    equals

    boolean equals​(@CheckForNull
                java.lang.Object o)
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes. +

    Returns true if the given object is also a multiset entry and the two entries represent the same element and count. That is, two entries a and b are equal @@ -300,14 +257,6 @@

    equals

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    o - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -318,34 +267,7 @@

    equals

  • hashCode

    int hashCode()
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.) +

    The hash code of a multiset entry for element element and count count is defined as: @@ -356,11 +278,6 @@

    hashCode

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -378,8 +295,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/Multiset.html b/releases/snapshot-android/api/docs/com/google/common/collect/Multiset.html index 914e10dbf50f..4239c8674b7c 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/Multiset.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/Multiset.html @@ -304,9 +304,6 @@

    Method Summary

    java.util.Iterator<E> iterator() - -
    Returns an iterator over the elements in this collection.
    - boolean @@ -326,18 +323,10 @@

    Method Summary

    boolean removeAll​(java.util.Collection<?> c) - -
    Removes all of this collection's elements that are also contained in the - specified collection (optional operation).
    - boolean retainAll​(java.util.Collection<?> c) - -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation).
    - int @@ -367,9 +356,6 @@

    Method Summary

    java.lang.String toString() - -
    Returns a string representation of the object.
    -
      @@ -416,8 +402,6 @@

      size

      Specified by:
      size in interface java.util.Collection<E extends @Nullable java.lang.Object>
      -
      Returns:
      -
      the number of elements in this collection
    @@ -686,14 +670,6 @@

    equals

    equals in interface java.util.Collection<E extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -717,11 +693,6 @@

    hashCode

    hashCode in interface java.util.Collection<E extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    @@ -732,23 +703,7 @@

    hashCode

  • toString

    java.lang.String toString()
    -
    Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

    - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

    - 
    - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
    +

    It is recommended, though not mandatory, that this method return the result of invoking toString() on the entrySet(), yielding a result such as [a x 3, c, d x 2, @@ -756,8 +711,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    • @@ -768,10 +721,7 @@

    toString

  • iterator

    java.util.Iterator<E> iterator()
    -
    Returns an iterator over the elements in this collection. There are no - guarantees concerning the order in which the elements are returned - (unless this collection is an instance of some class that provides a - guarantee). +

    Elements that occur multiple times in the multiset will appear multiple times in this iterator, though not necessarily sequentially.

    @@ -780,8 +730,6 @@

    iterator

    iterator in interface java.util.Collection<E extends @Nullable java.lang.Object>
    Specified by:
    iterator in interface java.lang.Iterable<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    an Iterator over the elements in this collection
    • @@ -834,8 +782,6 @@

    containsAll

    contained in elements
    Throws:
    java.lang.NullPointerException - if elements is null
    -
    See Also:
    -
    Collection.contains(Object)
    @@ -847,10 +793,7 @@

    containsAll

    removeAll

    @CanIgnoreReturnValue
 boolean removeAll​(java.util.Collection<?> c)
    -
    Removes all of this collection's elements that are also contained in the - specified collection (optional operation). After this call returns, - this collection will contain no elements in common with the specified - collection. +

    Note: This method ignores how often any element might appear in c, and only cares whether or not an element appears at all. If you wish to remove one occurrence in this @@ -862,14 +805,6 @@

    removeAll

    Specified by:
    removeAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    c - collection containing elements to be removed from this collection
    -
    Returns:
    -
    true if this collection changed as a result of the - call
    -
    See Also:
    -
    Collection.remove(Object), -Collection.contains(Object)
    @@ -881,10 +816,7 @@

    removeAll

    retainAll

    @CanIgnoreReturnValue
 boolean retainAll​(java.util.Collection<?> c)
    -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation). In other words, removes from - this collection all of its elements that are not contained in the - specified collection. +

    Note: This method ignores how often any element might appear in c, and only cares whether or not an element appears at all. If you wish to remove one occurrence in this @@ -896,10 +828,6 @@

    retainAll

    Specified by:
    retainAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    c - collection containing elements to be retained in this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    See Also:
    Multisets.retainOccurrences(Multiset, Multiset)
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/MutableClassToInstanceMap.html b/releases/snapshot-android/api/docs/com/google/common/collect/MutableClassToInstanceMap.html index e8479ab362f7..d491eb564ce5 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/MutableClassToInstanceMap.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/MutableClassToInstanceMap.html @@ -190,7 +190,7 @@

    Nested classes/interfaces inherited from class com.google.common.collec

    Nested classes/interfaces inherited from interface java.util.Map

    -java.util.Map.Entry<K,​V> +java.util.Map.Entry<K extends java.lang.Object,​V extends java.lang.Object> @@ -235,9 +235,7 @@

    Method Summary

    java.util.Set<java.util.Map.Entry<java.lang.Class<? extends B>,​B>> entrySet() - -
    Returns a Set view of the mappings contained in this map.
    - +  <T extends B>
    T     @@ -251,18 +249,12 @@

    Method Summary

    B put​(java.lang.Class<? extends B> key, B value) - -
    Associates the specified value with the specified key in this map - (optional operation).
    - +  void putAll​(java.util.Map<? extends java.lang.Class<? extends B>,​? extends B> map) - -
    Copies all of the mappings from the specified map to this map - (optional operation).
    - +  <T extends B>
    T     @@ -365,26 +357,11 @@

    delegate

  • entrySet

    public java.util.Set<java.util.Map.Entry<java.lang.Class<? extends B>,​B>> entrySet()
    -
    Description copied from interface: java.util.Map
    -
    Returns a Set view of the mappings contained in this map. - The set is backed by the map, so changes to the map are - reflected in the set, and vice-versa. If the map is modified - while an iteration over the set is in progress (except through - the iterator's own remove operation, or through the - setValue operation on a map entry returned by the - iterator) the results of the iteration are undefined. The set - supports element removal, which removes the corresponding - mapping from the map, via the Iterator.remove, - Set.remove, removeAll, retainAll and - clear operations. It does not support the - add or addAll operations.
    Specified by:
    entrySet in interface java.util.Map<java.lang.Class<? extends B>,​B>
    Overrides:
    entrySet in class ForwardingMap<java.lang.Class<? extends B>,​B>
    -
    Returns:
    -
    a set view of the mappings contained in this map
    • @@ -400,27 +377,11 @@

    put

    @CheckForNull public B put​(java.lang.Class<? extends B> key, B value) -
    Description copied from interface: java.util.Map
    -
    Associates the specified value with the specified key in this map - (optional operation). If the map previously contained a mapping for - the key, the old value is replaced by the specified value. (A map - m is said to contain a mapping for a key k if and only - if m.containsKey(k) would return - true.)
    Specified by:
    put in interface java.util.Map<java.lang.Class<? extends B>,​B>
    Overrides:
    put in class ForwardingMap<java.lang.Class<? extends B>,​B>
    -
    Parameters:
    -
    key - key with which the specified value is to be associated
    -
    value - value to be associated with the specified key
    -
    Returns:
    -
    the previous value associated with key, or - null if there was no mapping for key. - (A null return can also indicate that the map - previously associated null with key, - if the implementation supports null values.)
    @@ -431,20 +392,11 @@

    put

  • putAll

    public void putAll​(java.util.Map<? extends java.lang.Class<? extends B>,​? extends B> map)
    -
    Description copied from interface: java.util.Map
    -
    Copies all of the mappings from the specified map to this map - (optional operation). The effect of this call is equivalent to that - of calling put(k, v) on this map once - for each mapping from key k to value v in the - specified map. The behavior of this operation is undefined if the - specified map is modified while the operation is in progress.
    Specified by:
    putAll in interface java.util.Map<java.lang.Class<? extends B>,​B>
    Overrides:
    putAll in class ForwardingMap<java.lang.Class<? extends B>,​B>
    -
    Parameters:
    -
    map - mappings to be stored in this map
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/Ordering.html b/releases/snapshot-android/api/docs/com/google/common/collect/Ordering.html index a98bcb414bcf..916976c10f28 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/Ordering.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/Ordering.html @@ -318,9 +318,7 @@

    Method Summary

    abstract int compare​(T left, T right) - -
    Compares its two arguments for order.
    - +  static <T extends @Nullable java.lang.Object>
    Ordering<T>     @@ -949,45 +947,9 @@

    lexicographical

    compare

    public abstract int compare​(T left,
                             T right)
    -
    Description copied from interface: java.util.Comparator
    -
    Compares its two arguments for order. Returns a negative integer, - zero, or a positive integer as the first argument is less than, equal - to, or greater than the second.

    - - The implementor must ensure that sgn(compare(x, y)) == - -sgn(compare(y, x)) for all x and y. (This - implies that compare(x, y) must throw an exception if and only - if compare(y, x) throws an exception.)

    - - The implementor must also ensure that the relation is transitive: - ((compare(x, y)>0) && (compare(y, z)>0)) implies - compare(x, z)>0.

    - - Finally, the implementor must ensure that compare(x, y)==0 - implies that sgn(compare(x, z))==sgn(compare(y, z)) for all - z.

    - - It is generally the case, but not strictly required that - (compare(x, y)==0) == (x.equals(y)). Generally speaking, - any comparator that violates this condition should clearly indicate - this fact. The recommended language is "Note: this comparator - imposes orderings that are inconsistent with equals."

    - - In the foregoing description, the notation - sgn(expression) designates the mathematical - signum function, which is defined to return one of -1, - 0, or 1 according to whether the value of - expression is negative, zero, or positive, respectively.

    Specified by:
    compare in interface java.util.Comparator<T extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    left - the first object to be compared.
    -
    right - the second object to be compared.
    -
    Returns:
    -
    a negative integer, zero, or a positive integer as the - first argument is less than, equal to, or greater than the - second.
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/PeekingIterator.html b/releases/snapshot-android/api/docs/com/google/common/collect/PeekingIterator.html index 849cb8c9c4d9..1f1b6f8c0d9d 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/PeekingIterator.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/PeekingIterator.html @@ -165,9 +165,6 @@

    Method Summary

    E next() - -
    Returns the next element in the iteration.
    - E @@ -179,10 +176,6 @@

    Method Summary

    void remove() - -
    Removes from the underlying collection the last element returned - by this iterator (optional operation).
    -
      @@ -233,15 +226,13 @@

      peek

      next

      @CanIgnoreReturnValue
 E next()
      -
      Returns the next element in the iteration. +

      The objects returned by consecutive calls to peek() then next() are guaranteed to be equal to each other.

      Specified by:
      next in interface java.util.Iterator<E extends @Nullable java.lang.Object>
      -
      Returns:
      -
      the next element in the iteration
    @@ -252,17 +243,7 @@

    next

  • remove

    void remove()
    -
    Removes from the underlying collection the last element returned - by this iterator (optional operation). This method can be called - only once per call to Iterator.next(). -

    - The behavior of an iterator is unspecified if the underlying collection - is modified while the iteration is in progress in any way other than by - calling this method, unless an overriding class has specified a - concurrent modification policy. -

    - The behavior of an iterator is unspecified if this method is called - after a call to the forEachRemaining method. +

    Implementations may or may not support removal when a call to peek() has occurred since the most recent call to next().

    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/Range.html b/releases/snapshot-android/api/docs/com/google/common/collect/Range.html index db739d6719fa..d56de7d58627 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/Range.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/Range.html @@ -1114,14 +1114,6 @@

    equals

    equals in interface Predicate<C extends java.lang.Comparable>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    • @@ -1136,11 +1128,6 @@

    hashCode

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    @@ -1156,8 +1143,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/RangeMap.html b/releases/snapshot-android/api/docs/com/google/common/collect/RangeMap.html index 286dc62d5512..2e8503c9cff1 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/RangeMap.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/RangeMap.html @@ -477,14 +477,6 @@

    equals

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    o - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -499,11 +491,6 @@

    hashCode

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    @@ -518,8 +505,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/RangeSet.html b/releases/snapshot-android/api/docs/com/google/common/collect/RangeSet.html index 5afb8c35f55e..2bc36a3547f2 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/RangeSet.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/RangeSet.html @@ -673,14 +673,6 @@

    equals

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -695,11 +687,6 @@

    hashCode

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    @@ -716,8 +703,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/SetMultimap.html b/releases/snapshot-android/api/docs/com/google/common/collect/SetMultimap.html index 19da5c2bbe87..d89af939db9d 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/SetMultimap.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/SetMultimap.html @@ -398,14 +398,6 @@

    equals

    equals in interface Multimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/Sets.SetView.html b/releases/snapshot-android/api/docs/com/google/common/collect/Sets.SetView.html index 37e72c10fac7..0c8358c4da81 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/Sets.SetView.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/Sets.SetView.html @@ -371,11 +371,6 @@

    add

    add in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    add in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    e - element whose presence in this collection is to be ensured
    -
    Returns:
    -
    true if this collection changed as a result of the - call
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -402,10 +397,6 @@

    remove

    remove in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    remove in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    object - element to be removed from this collection, if present
    -
    Returns:
    -
    true if an element was removed as a result of this call
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -431,14 +422,8 @@

    addAll

    addAll in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    addAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    newElements - collection containing elements to be added to this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    Throws:
    java.lang.UnsupportedOperationException - always
    -
    See Also:
    -
    AbstractCollection.add(Object)
    @@ -462,15 +447,8 @@

    removeAll

    removeAll in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    removeAll in class java.util.AbstractSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    oldElements - collection containing elements to be removed from this set
    -
    Returns:
    -
    true if this set changed as a result of the call
    Throws:
    java.lang.UnsupportedOperationException - always
    -
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    @@ -494,15 +472,8 @@

    retainAll

    retainAll in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    retainAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    elementsToKeep - collection containing elements to be retained in this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    Throws:
    java.lang.UnsupportedOperationException - always
    -
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    @@ -547,8 +518,6 @@

    iterator

    iterator in interface java.util.Set<E extends @Nullable java.lang.Object>
    Specified by:
    iterator in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    an iterator over the elements contained in this collection
    Since:
    20.0 (present with return type Iterator since 2.0)
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/SortedMultiset.html b/releases/snapshot-android/api/docs/com/google/common/collect/SortedMultiset.html index 66509dc69ea6..082a1077aca6 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/SortedMultiset.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/SortedMultiset.html @@ -237,9 +237,6 @@

    Method Summary

    java.util.Iterator<E> iterator() - -
    Returns an iterator over the elements in this collection.
    - Multiset.Entry<E> @@ -437,10 +434,7 @@

    entrySet

  • iterator

    java.util.Iterator<E> iterator()
    -
    Returns an iterator over the elements in this collection. There are no - guarantees concerning the order in which the elements are returned - (unless this collection is an instance of some class that provides a - guarantee). +

    Elements that occur multiple times in the multiset will appear multiple times in this iterator, though not necessarily sequentially. @@ -454,8 +448,6 @@

    iterator

    iterator in interface java.lang.Iterable<E extends @Nullable java.lang.Object>
    Specified by:
    iterator in interface Multiset<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    an Iterator over the elements in this collection
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/Table.Cell.html b/releases/snapshot-android/api/docs/com/google/common/collect/Table.Cell.html index 725db0e9a132..973a315fa1a1 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/Table.Cell.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/Table.Cell.html @@ -249,14 +249,6 @@

    equals

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -274,11 +266,6 @@

    hashCode

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/Table.html b/releases/snapshot-android/api/docs/com/google/common/collect/Table.html index 251cede94df1..6a2c690d6ed6 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/Table.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/Table.html @@ -497,14 +497,6 @@

    equals

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -520,11 +512,6 @@

    hashCode

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/TreeBasedTable.html b/releases/snapshot-android/api/docs/com/google/common/collect/TreeBasedTable.html index e09f4d5db83a..22b970e6f1e0 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/TreeBasedTable.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/TreeBasedTable.html @@ -310,7 +310,7 @@

    Method Summary

    boolean equals​(java.lang.Object obj) -
    Indicates whether some other object is "equal to" this one.
    +
    Compares the specified object with this table for equality.
    @@ -326,7 +326,7 @@

    Method Summary

    int hashCode() -
    Returns a hash code value for the object.
    +
    Returns the hash code for this table.
    @@ -932,58 +932,14 @@

    putAll

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object obj)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    +
    Description copied from interface: Table
    +
    Compares the specified object with this table for equality. Two tables are equal when their + cell views, as returned by Table.cellSet(), are equal.
    Specified by:
    equals in interface Table<R extends @Nullable java.lang.Object,​C extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -994,45 +950,14 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    +
    Description copied from interface: Table
    +
    Returns the hash code for this table. The hash code of a table is defined as the hash code of + its cell view, as returned by Table.cellSet().
    Specified by:
    hashCode in interface Table<R extends @Nullable java.lang.Object,​C extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -1047,8 +972,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/TreeMultimap.html b/releases/snapshot-android/api/docs/com/google/common/collect/TreeMultimap.html index d7cc70685424..7596dea843b4 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/TreeMultimap.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/TreeMultimap.html @@ -740,14 +740,6 @@

    equals

    equals in interface Multimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Specified by:
    equals in interface SetMultimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -962,8 +954,6 @@

    hashCode

    hashCode in interface Multimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    See Also:
    Map.hashCode()
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/TreeMultiset.html b/releases/snapshot-android/api/docs/com/google/common/collect/TreeMultiset.html index 760b5b1bfc24..f6fa8f5b4554 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/TreeMultiset.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/TreeMultiset.html @@ -202,8 +202,7 @@

    Method Summary

    boolean add​(E element) -
    Ensures that this collection contains the specified element (optional - operation).
    +
    Adds a single occurrence of the specified element to this multiset.
    @@ -217,17 +216,11 @@

    Method Summary

    boolean addAll​(java.util.Collection<? extends E> elementsToAdd) - -
    Adds all of the elements in the specified collection to this collection - (optional operation).
    - void clear() - -
    Removes all of the elements from this collection (optional operation).
    - +  java.util.Comparator<? super E> @@ -241,7 +234,7 @@

    Method Summary

    boolean contains​(java.lang.Object element) -
    Returns true if this collection contains the specified element.
    +
    Determines whether this multiset contains the specified element.
    @@ -300,7 +293,7 @@

    Method Summary

    boolean equals​(java.lang.Object object) -
    Indicates whether some other object is "equal to" this one.
    +
    Compares the specified object with this multiset for equality.
    @@ -315,7 +308,7 @@

    Method Summary

    int hashCode() -
    Returns a hash code value for the object.
    +
    Returns the hash code for this multiset.
    @@ -330,16 +323,11 @@

    Method Summary

    boolean isEmpty() - -
    Returns true if this collection contains no elements.
    - +  java.util.Iterator<E> iterator() - -
    Returns an iterator over the elements contained in this collection.
    - Multiset.Entry<E> @@ -369,8 +357,7 @@

    Method Summary

    boolean remove​(java.lang.Object element) -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation).
    +
    Removes a single occurrence of the specified element from this multiset, if present.
    @@ -384,18 +371,10 @@

    Method Summary

    boolean removeAll​(java.util.Collection<?> elementsToRemove) - -
    Removes all of this collection's elements that are also contained in the - specified collection (optional operation).
    - boolean retainAll​(java.util.Collection<?> elementsToRetain) - -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation).
    - int @@ -419,7 +398,7 @@

    Method Summary

    int size() -
    Returns the number of elements in this collection.
    +
    Returns the total number of all occurrences of all elements in this multiset.
    @@ -445,9 +424,6 @@

    Method Summary

    java.lang.String toString() - -
    Returns a string representation of this collection.
    -
      @@ -571,10 +547,11 @@

      create

    • size

      public int size()
      -
      Description copied from interface: java.util.Collection
      -
      Returns the number of elements in this collection. If this collection - contains more than Integer.MAX_VALUE elements, returns - Integer.MAX_VALUE.
      +
      Description copied from interface: Multiset
      +
      Returns the total number of all occurrences of all elements in this multiset. + +

      Note: this method does not return the number of distinct elements in the + multiset, which is given by entrySet().size().

      Specified by:
      size in interface java.util.Collection<E extends @Nullable java.lang.Object>
      @@ -582,8 +559,6 @@

      size

      size in interface Multiset<E extends @Nullable java.lang.Object>
      Specified by:
      size in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
      -
      Returns:
      -
      the number of elements in this collection
    @@ -733,9 +708,6 @@

    setCount

  • clear

    public void clear()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes all of the elements from this collection (optional operation). - The collection will be empty after this method returns.
    Specified by:
    clear in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -749,8 +721,14 @@

    clear

  • iterator

    public java.util.Iterator<E> iterator()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns an iterator over the elements contained in this collection.
    +
    Description copied from interface: SortedMultiset
    +
    + +

    Elements that occur multiple times in the multiset will appear multiple times in this + iterator, though not necessarily sequentially. + +

    The iterator returns the elements in ascending order according to this multiset's + comparator.

    Specified by:
    iterator in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -762,8 +740,6 @@

    iterator

    iterator in interface SortedMultiset<E extends @Nullable java.lang.Object>
    Specified by:
    iterator in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    an iterator over the elements contained in this collection
    • @@ -979,15 +955,11 @@

    descendingMultiset

  • isEmpty

    public boolean isEmpty()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains no elements.
    Specified by:
    isEmpty in interface java.util.Collection<E extends @Nullable java.lang.Object>
    Overrides:
    isEmpty in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    true if this collection contains no elements
    • @@ -999,11 +971,11 @@

    isEmpty

    contains

    public boolean contains​(@CheckForNull
                         java.lang.Object element)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains the specified element. - More formally, returns true if and only if this collection - contains at least one element e such that - Objects.equals(o, e).
    +
    Description copied from interface: Multiset
    +
    Determines whether this multiset contains the specified element. + +

    This method refines Collection.contains(java.lang.Object) to further specify that it may not + throw an exception in response to element being null or of the wrong type.

    Specified by:
    contains in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -1012,10 +984,9 @@

    contains

    Overrides:
    contains in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    Parameters:
    -
    element - element whose presence in this collection is to be tested
    +
    element - the element to check for
    Returns:
    -
    true if this collection contains the specified - element
    +
    true if this multiset contains at least one occurrence of the element
    • @@ -1029,24 +1000,14 @@

    contains

    add

    @CanIgnoreReturnValue
 public final boolean add​(E element)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Ensures that this collection contains the specified element (optional - operation). Returns true if this collection changed as a - result of the call. (Returns false if this collection does - not permit duplicates and already contains the specified element.)

    +

    Description copied from interface: Multiset
    +
    Adds a single occurrence of the specified element to this multiset. - Collections that support this operation may place limitations on what - elements may be added to this collection. In particular, some - collections will refuse to add null elements, and others will - impose restrictions on the type of elements that may be added. - Collection classes should clearly specify in their documentation any - restrictions on what elements may be added.

    +

    This method refines Collection.add(E), which only ensures the presence of the + element, to further specify that a successful call must always increment the count of the + element, and the overall size of the collection, by one. - If a collection refuses to add a particular element for any reason - other than that it already contains the element, it must throw - an exception (rather than returning false). This preserves - the invariant that a collection always contains the specified element - after this call returns.

    +

    To both add the element and obtain the previous count of that element, use add(element, 1) instead.

    Specified by:
    add in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -1055,10 +1016,11 @@

    add

    Overrides:
    add in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    Parameters:
    -
    element - element whose presence in this collection is to be ensured
    +
    element - the element to add one occurrence of; may be null only if explicitly allowed by + the implementation
    Returns:
    -
    true if this collection changed as a result of the - call
    +
    true always, since this call is required to modify the multiset, unlike other + Collection types
    @@ -1071,14 +1033,13 @@

    remove

    @CanIgnoreReturnValue
 public final boolean remove​(@CheckForNull
                             java.lang.Object element)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation). More formally, - removes an element e such that - Objects.equals(o, e), if - this collection contains one or more such elements. Returns - true if this collection contained the specified element (or - equivalently, if this collection changed as a result of the call).
    +
    Description copied from interface: Multiset
    +
    Removes a single occurrence of the specified element from this multiset, if present. + +

    This method refines Collection.remove(java.lang.Object) to further specify that it may not + throw an exception in response to element being null or of the wrong type. + +

    To both remove the element and obtain the previous count of that element, use remove(element, 1) instead.

    Specified by:
    remove in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -1087,9 +1048,9 @@

    remove

    Overrides:
    remove in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    Parameters:
    -
    element - element to be removed from this collection, if present
    +
    element - the element to remove one occurrence of
    Returns:
    -
    true if an element was removed as a result of this call
    +
    true if an occurrence was found and removed
    @@ -1101,12 +1062,7 @@

    remove

    addAll

    @CanIgnoreReturnValue
 public final boolean addAll​(java.util.Collection<? extends E> elementsToAdd)
    -
    Adds all of the elements in the specified collection to this collection - (optional operation). The behavior of this operation is undefined if - the specified collection is modified while the operation is in progress. - (This implies that the behavior of this call is undefined if the - specified collection is this collection, and this collection is - nonempty.) +

    This implementation is highly efficient when elementsToAdd is itself a Multiset.

    @@ -1114,12 +1070,6 @@

    addAll

    addAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    Overrides:
    addAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    elementsToAdd - collection containing elements to be added to this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    -
    See Also:
    -
    AbstractCollection.add(Object)
    @@ -1131,11 +1081,16 @@

    addAll

    removeAll

    @CanIgnoreReturnValue
 public final boolean removeAll​(java.util.Collection<?> elementsToRemove)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes all of this collection's elements that are also contained in the - specified collection (optional operation). After this call returns, - this collection will contain no elements in common with the specified - collection.
    +
    Description copied from interface: Multiset
    +
    + +

    Note: This method ignores how often any element might appear in c, and only + cares whether or not an element appears at all. If you wish to remove one occurrence in this + multiset for every occurrence in c, see Multisets.removeOccurrences(Multiset, + Multiset). + +

    This method refines Collection.removeAll(java.util.Collection<?>) to further specify that it may not + throw an exception in response to any of elements being null or of the wrong type.

    Specified by:
    removeAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -1143,14 +1098,6 @@

    removeAll

    removeAll in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    removeAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    elementsToRemove - collection containing elements to be removed from this collection
    -
    Returns:
    -
    true if this collection changed as a result of the - call
    -
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    @@ -1162,11 +1109,16 @@

    removeAll

    retainAll

    @CanIgnoreReturnValue
 public final boolean retainAll​(java.util.Collection<?> elementsToRetain)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation). In other words, removes from - this collection all of its elements that are not contained in the - specified collection.
    +
    Description copied from interface: Multiset
    +
    + +

    Note: This method ignores how often any element might appear in c, and only + cares whether or not an element appears at all. If you wish to remove one occurrence in this + multiset for every occurrence in c, see Multisets.retainOccurrences(Multiset, + Multiset). + +

    This method refines Collection.retainAll(java.util.Collection<?>) to further specify that it may not + throw an exception in response to any of elements being null or of the wrong type.

    Specified by:
    retainAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -1174,13 +1126,8 @@

    retainAll

    retainAll in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    retainAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    elementsToRetain - collection containing elements to be retained in this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    +
    Multisets.retainOccurrences(Multiset, Multiset)
    @@ -1220,44 +1167,9 @@

    entrySet

    equals

    public final boolean equals​(@CheckForNull
                             java.lang.Object object)
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes. +

    Compares the specified object with this multiset for equality. Returns true if the + given object is also a multiset and contains equal elements with equal counts, regardless of + order.

    This implementation returns true if object is a multiset of the same size and if, for each element, the two multisets have the same count.

    @@ -1268,14 +1180,6 @@

    equals

    equals in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -1286,34 +1190,14 @@

    equals

  • hashCode

    public final int hashCode()
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.) +

    Returns the hash code for this multiset. This is defined as the sum of + + 
    
+ ((element == null) ? 0 : element.hashCode()) ^ count(element)
+
    + +

    over all distinct elements in the multiset. It follows that a multiset and its entry set + always have the same hash code.

    This implementation returns the hash code of Multiset.entrySet().

    @@ -1323,11 +1207,6 @@

    hashCode

    hashCode in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -1338,12 +1217,11 @@

    hashCode

  • toString

    public final java.lang.String toString()
    -
    Returns a string representation of this collection. The string - representation consists of a list of the collection's elements in the - order they are returned by its iterator, enclosed in square brackets - ("[]"). Adjacent elements are separated by the characters - ", " (comma and space). Elements are converted to strings as - by String.valueOf(Object). +
    + +

    It is recommended, though not mandatory, that this method return the result of invoking + Multiset.toString() on the Multiset.entrySet(), yielding a result such as [a x 3, c, d x 2, + e].

    This implementation returns the result of invoking toString on Multiset.entrySet().

    @@ -1351,8 +1229,6 @@

    toString

    toString in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    toString in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a string representation of this collection
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/TreeRangeMap.html b/releases/snapshot-android/api/docs/com/google/common/collect/TreeRangeMap.html index 320505c6c018..1a0f76c22016 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/TreeRangeMap.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/TreeRangeMap.html @@ -201,7 +201,7 @@

    Method Summary

    boolean equals​(java.lang.Object o) -
    Indicates whether some other object is "equal to" this one.
    +
    Returns true if obj is another RangeMap that has an equivalent RangeMap.asMapOfRanges().
    @@ -223,7 +223,7 @@

    Method Summary

    int hashCode() -
    Returns a hash code value for the object.
    +
    Returns asMapOfRanges().hashCode().
    @@ -276,7 +276,7 @@

    Method Summary

    java.lang.String toString() -
    Returns a string representation of the object.
    +
    Returns a readable string representation of this range map.
    @@ -546,58 +546,13 @@

    subRangeMap

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object o)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    +
    Description copied from interface: RangeMap
    +
    Returns true if obj is another RangeMap that has an equivalent RangeMap.asMapOfRanges().
    Specified by:
    equals in interface RangeMap<K extends java.lang.Comparable,​V>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    o - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -608,45 +563,13 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    +
    Description copied from interface: RangeMap
    +
    Returns asMapOfRanges().hashCode().
    Specified by:
    hashCode in interface RangeMap<K extends java.lang.Comparable,​V>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -657,31 +580,13 @@

    hashCode

  • toString

    public java.lang.String toString()
    -
    Description copied from class: java.lang.Object
    -
    Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

    - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

    - 
    - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
    +
    Description copied from interface: RangeMap
    +
    Returns a readable string representation of this range map.
    Specified by:
    toString in interface RangeMap<K extends java.lang.Comparable,​V>
    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/TreeRangeSet.html b/releases/snapshot-android/api/docs/com/google/common/collect/TreeRangeSet.html index d7caabc19524..4e8b92ecdc2d 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/TreeRangeSet.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/TreeRangeSet.html @@ -276,14 +276,15 @@

    Method Summary

    boolean equals​(java.lang.Object obj) -
    Indicates whether some other object is "equal to" this one.
    +
    Returns true if obj is another RangeSet that contains the same ranges + according to Range.equals(Object).
    int hashCode() -
    Returns a hash code value for the object.
    +
    Returns asRanges().hashCode().
    @@ -350,7 +351,7 @@

    Method Summary

    java.lang.String toString() -
    Returns a string representation of the object.
    +
    Returns a readable string representation of this range set.
    @@ -765,58 +766,14 @@

    removeAll

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object obj)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    +
    Description copied from interface: RangeSet
    +
    Returns true if obj is another RangeSet that contains the same ranges + according to Range.equals(Object).
    Specified by:
    equals in interface RangeSet<C extends java.lang.Comparable>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -827,45 +784,13 @@

    equals

  • hashCode

    public final int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    +
    Description copied from interface: RangeSet
    +
    Returns asRanges().hashCode().
    Specified by:
    hashCode in interface RangeSet<C extends java.lang.Comparable>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -876,31 +801,15 @@

    hashCode

  • toString

    public final java.lang.String toString()
    -
    Description copied from class: java.lang.Object
    -
    Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

    - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

    - 
    - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
    +
    Description copied from interface: RangeSet
    +
    Returns a readable string representation of this range set. For example, if this + RangeSet consisted of Range.closed(1, 3) and Range.greaterThan(4), this might + return " [1..3](4..+∞)"}.
    Specified by:
    toString in interface RangeSet<C extends java.lang.Comparable>
    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/UnmodifiableListIterator.html b/releases/snapshot-android/api/docs/com/google/common/collect/UnmodifiableListIterator.html index dd1bf43d77d1..cef401535bb3 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/UnmodifiableListIterator.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/UnmodifiableListIterator.html @@ -297,8 +297,6 @@

    add

    Specified by:
    add in interface java.util.ListIterator<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    e - the element to insert
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -321,9 +319,6 @@

    set

    Specified by:
    set in interface java.util.ListIterator<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    e - the element with which to replace the last element returned by - next or previous
    Throws:
    java.lang.UnsupportedOperationException - always
    diff --git a/releases/snapshot-android/api/docs/com/google/common/collect/class-use/ImmutableSortedSet.html b/releases/snapshot-android/api/docs/com/google/common/collect/class-use/ImmutableSortedSet.html index 6f4604c01d86..ef9e45622c1a 100644 --- a/releases/snapshot-android/api/docs/com/google/common/collect/class-use/ImmutableSortedSet.html +++ b/releases/snapshot-android/api/docs/com/google/common/collect/class-use/ImmutableSortedSet.html @@ -245,10 +245,6 @@

    Uses of ImmutableSortedSet<E> ImmutableSortedSet.headSet​(E toElement) - -
    Returns a view of the portion of this set whose elements are - strictly less than toElement.
    - ImmutableSortedSet<E> @@ -345,19 +341,10 @@

    Uses of ImmutableSortedSet<E> ImmutableSortedSet.subSet​(E fromElement, E toElement) - -
    Returns a view of the portion of this set whose elements range - from fromElement, inclusive, to toElement, - exclusive.
    - ImmutableSortedSet<E> ImmutableSortedSet.tailSet​(E fromElement) - -
    Returns a view of the portion of this set whose elements are - greater than or equal to fromElement.
    - ImmutableSortedSet<E> diff --git a/releases/snapshot-android/api/docs/com/google/common/eventbus/DeadEvent.html b/releases/snapshot-android/api/docs/com/google/common/eventbus/DeadEvent.html index 511a42747db4..7442686dbab8 100644 --- a/releases/snapshot-android/api/docs/com/google/common/eventbus/DeadEvent.html +++ b/releases/snapshot-android/api/docs/com/google/common/eventbus/DeadEvent.html @@ -207,9 +207,7 @@

    Method Summary

    java.lang.String toString() - -
    Returns a string representation of the object.
    - + 
      @@ -298,29 +296,9 @@

      getEvent

    • toString

      public java.lang.String toString()
      -
      Description copied from class: java.lang.Object
      -
      Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

      - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

      - 
      - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
      Overrides:
      toString in class java.lang.Object
      -
      Returns:
      -
      a string representation of the object.
    diff --git a/releases/snapshot-android/api/docs/com/google/common/eventbus/EventBus.html b/releases/snapshot-android/api/docs/com/google/common/eventbus/EventBus.html index d4cf79e2868a..feb2a5b9d42c 100644 --- a/releases/snapshot-android/api/docs/com/google/common/eventbus/EventBus.html +++ b/releases/snapshot-android/api/docs/com/google/common/eventbus/EventBus.html @@ -328,9 +328,7 @@

    Method Summary

    java.lang.String toString() - -
    Returns a string representation of the object.
    - +  void @@ -484,29 +482,9 @@

    post

  • toString

    public java.lang.String toString()
    -
    Description copied from class: java.lang.Object
    -
    Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

    - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

    - 
    - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/graph/AbstractGraph.html b/releases/snapshot-android/api/docs/com/google/common/graph/AbstractGraph.html index 66ae057df962..097583c64816 100644 --- a/releases/snapshot-android/api/docs/com/google/common/graph/AbstractGraph.html +++ b/releases/snapshot-android/api/docs/com/google/common/graph/AbstractGraph.html @@ -221,7 +221,8 @@

    Method Summary

    boolean equals​(java.lang.Object obj) -
    Indicates whether some other object is "equal to" this one.
    +
    Returns true iff object is a Graph that has the same elements and the + same structural relationships as those in this graph.
    @@ -239,7 +240,7 @@

    Method Summary

    int hashCode() -
    Returns a hash code value for the object.
    +
    Returns the hash code for this graph.
    @@ -343,58 +344,29 @@

    Method Detail

    equals

    public final boolean equals​(@CheckForNull
                             java.lang.Object obj)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: +

    Description copied from interface: Graph
    +
    Returns true iff object is a Graph that has the same elements and the + same structural relationships as those in this graph. + +

    Thus, two graphs A and B are equal if all of the following are true: +

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. +
    • A and B have equal directedness. +
    • A and B have equal node sets. +
    • A and B have equal edge sets.
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    + +

    Graph properties besides directedness do not affect equality. + For example, two graphs may be considered equal even if one allows self-loops and the other + doesn't. Additionally, the order in which nodes or edges are added to the graph, and the order + in which they are iterated over, are irrelevant. + +

    A reference implementation of this is provided by equals(Object).

    Specified by:
    equals in interface Graph<N>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -405,45 +377,16 @@

    equals

  • hashCode

    public final int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    +
    Description copied from interface: Graph
    +
    Returns the hash code for this graph. The hash code of a graph is defined as the hash code of + the set returned by Graph.edges(). + +

    A reference implementation of this is provided by hashCode().

    Specified by:
    hashCode in interface Graph<N>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -458,8 +401,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-android/api/docs/com/google/common/graph/AbstractNetwork.html b/releases/snapshot-android/api/docs/com/google/common/graph/AbstractNetwork.html index 62bf03861852..a876751c4ce4 100644 --- a/releases/snapshot-android/api/docs/com/google/common/graph/AbstractNetwork.html +++ b/releases/snapshot-android/api/docs/com/google/common/graph/AbstractNetwork.html @@ -261,7 +261,8 @@

    Method Summary

    boolean equals​(java.lang.Object obj) -
    Indicates whether some other object is "equal to" this one.
    +
    Returns true iff object is a Network that has the same elements and the + same structural relationships as those in this network.
    @@ -284,7 +285,7 @@

    Method Summary

    int hashCode() -
    Returns a hash code value for the object.
    +
    Returns the hash code for this network.
    @@ -633,58 +634,30 @@

    isOrderingCompatible

    equals

    public final boolean equals​(@CheckForNull
                             java.lang.Object obj)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: +

    Description copied from interface: Network
    +
    Returns true iff object is a Network that has the same elements and the + same structural relationships as those in this network. + +

    Thus, two networks A and B are equal if all of the following are true: +

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. +
    • A and B have equal directedness. +
    • A and B have equal node sets. +
    • A and B have equal edge sets. +
    • Every edge in A and B connects the same nodes in the same direction (if any).
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    + +

    Network properties besides directedness do not affect equality. + For example, two networks may be considered equal even if one allows parallel edges and the + other doesn't. Additionally, the order in which nodes or edges are added to the network, and + the order in which they are iterated over, are irrelevant. + +

    A reference implementation of this is provided by equals(Object).

    Specified by:
    equals in interface Network<N,​E>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -695,45 +668,16 @@

    equals

  • hashCode

    public final int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    +
    Description copied from interface: Network
    +
    Returns the hash code for this network. The hash code of a network is defined as the hash code + of a map from each of its edges to their incident nodes. + +

    A reference implementation of this is provided by hashCode().

    Specified by:
    hashCode in interface Network<N,​E>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -748,8 +692,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-android/api/docs/com/google/common/graph/AbstractValueGraph.html b/releases/snapshot-android/api/docs/com/google/common/graph/AbstractValueGraph.html index b61966daf053..63c63c9a953a 100644 --- a/releases/snapshot-android/api/docs/com/google/common/graph/AbstractValueGraph.html +++ b/releases/snapshot-android/api/docs/com/google/common/graph/AbstractValueGraph.html @@ -232,7 +232,8 @@

    Method Summary

    boolean equals​(java.lang.Object obj) -
    Indicates whether some other object is "equal to" this one.
    +
    Returns true iff object is a ValueGraph that has the same elements and + the same structural relationships as those in this graph.
    @@ -250,7 +251,7 @@

    Method Summary

    int hashCode() -
    Returns a hash code value for the object.
    +
    Returns the hash code for this graph.
    @@ -370,58 +371,30 @@

    asGraph

    equals

    public final boolean equals​(@CheckForNull
                             java.lang.Object obj)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: +

    Description copied from interface: ValueGraph
    +
    Returns true iff object is a ValueGraph that has the same elements and + the same structural relationships as those in this graph. + +

    Thus, two value graphs A and B are equal if all of the following are true: +

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. +
    • A and B have equal directedness. +
    • A and B have equal node sets. +
    • A and B have equal edge sets. +
    • The value of a given edge is the same in both A and B.
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    + +

    Graph properties besides directedness do not affect equality. + For example, two graphs may be considered equal even if one allows self-loops and the other + doesn't. Additionally, the order in which nodes or edges are added to the graph, and the order + in which they are iterated over, are irrelevant. + +

    A reference implementation of this is provided by equals(Object).

    Specified by:
    equals in interface ValueGraph<N,​V>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -432,45 +405,16 @@

    equals

  • hashCode

    public final int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    +
    Description copied from interface: ValueGraph
    +
    Returns the hash code for this graph. The hash code of a graph is defined as the hash code of a + map from each of its edges to the associated edge value. + +

    A reference implementation of this is provided by hashCode().

    Specified by:
    hashCode in interface ValueGraph<N,​V>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -485,8 +429,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-android/api/docs/com/google/common/graph/ElementOrder.html b/releases/snapshot-android/api/docs/com/google/common/graph/ElementOrder.html index 92991cf188d1..1dc5eb791181 100644 --- a/releases/snapshot-android/api/docs/com/google/common/graph/ElementOrder.html +++ b/releases/snapshot-android/api/docs/com/google/common/graph/ElementOrder.html @@ -206,16 +206,12 @@

    Method Summary

    boolean equals​(java.lang.Object obj) - -
    Indicates whether some other object is "equal to" this one.
    - +  int hashCode() - -
    Returns a hash code value for the object.
    - +  static <S> ElementOrder<S> @@ -250,9 +246,7 @@

    Method Summary

    java.lang.String toString() - -
    Returns a string representation of the object.
    - +  ElementOrder.Type @@ -410,56 +404,9 @@

    comparator

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object obj)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -470,43 +417,9 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -517,29 +430,9 @@

    hashCode

  • toString

    public java.lang.String toString()
    -
    Description copied from class: java.lang.Object
    -
    Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

    - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

    - 
    - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/graph/EndpointPair.html b/releases/snapshot-android/api/docs/com/google/common/graph/EndpointPair.html index 5343b9e6612d..ac9997a441b5 100644 --- a/releases/snapshot-android/api/docs/com/google/common/graph/EndpointPair.html +++ b/releases/snapshot-android/api/docs/com/google/common/graph/EndpointPair.html @@ -403,8 +403,6 @@

    iterator

    Specified by:
    iterator in interface java.lang.Iterable<N>
    -
    Returns:
    -
    an Iterator.
    @@ -422,14 +420,6 @@

    equals

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -446,11 +436,6 @@

    hashCode

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    diff --git a/releases/snapshot-android/api/docs/com/google/common/graph/Graph.html b/releases/snapshot-android/api/docs/com/google/common/graph/Graph.html index 5fe311663e56..3546628c9747 100644 --- a/releases/snapshot-android/api/docs/com/google/common/graph/Graph.html +++ b/releases/snapshot-android/api/docs/com/google/common/graph/Graph.html @@ -660,14 +660,6 @@

    equals

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -685,11 +677,6 @@

    hashCode

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    diff --git a/releases/snapshot-android/api/docs/com/google/common/graph/Network.html b/releases/snapshot-android/api/docs/com/google/common/graph/Network.html index 8ba8ff016b7e..274a9d59deaf 100644 --- a/releases/snapshot-android/api/docs/com/google/common/graph/Network.html +++ b/releases/snapshot-android/api/docs/com/google/common/graph/Network.html @@ -930,14 +930,6 @@

    equals

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -955,11 +947,6 @@

    hashCode

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    diff --git a/releases/snapshot-android/api/docs/com/google/common/graph/ValueGraph.html b/releases/snapshot-android/api/docs/com/google/common/graph/ValueGraph.html index a994fa57248f..58ca5faf3620 100644 --- a/releases/snapshot-android/api/docs/com/google/common/graph/ValueGraph.html +++ b/releases/snapshot-android/api/docs/com/google/common/graph/ValueGraph.html @@ -752,14 +752,6 @@

    equals

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -777,11 +769,6 @@

    hashCode

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    diff --git a/releases/snapshot-android/api/docs/com/google/common/hash/BloomFilter.html b/releases/snapshot-android/api/docs/com/google/common/hash/BloomFilter.html index 9fd2cbb1e144..3cc775fb6d0f 100644 --- a/releases/snapshot-android/api/docs/com/google/common/hash/BloomFilter.html +++ b/releases/snapshot-android/api/docs/com/google/common/hash/BloomFilter.html @@ -258,7 +258,7 @@

    Method Summary

    boolean equals​(java.lang.Object object) -
    Indicates whether some other object is "equal to" this one.
    +
    Indicates whether another object is equal to this predicate.
    @@ -272,9 +272,7 @@

    Method Summary

    int hashCode() - -
    Returns a hash code value for the object.
    - +  boolean @@ -516,58 +514,20 @@

    putAll

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object object)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    +
    Description copied from interface: Predicate
    +
    Indicates whether another object is equal to this predicate. + +

    Most implementations will have no reason to override the behavior of Object.equals(java.lang.Object). + However, an implementation may also choose to return true whenever object is a + Predicate that it considers interchangeable with this one. "Interchangeable" + typically means that this.apply(t) == that.apply(t) for all t of type + T). Note that a false result from this method does not imply that the + predicates are known not to be interchangeable.

    Specified by:
    equals in interface Predicate<T extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -578,43 +538,9 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/hash/HashCode.html b/releases/snapshot-android/api/docs/com/google/common/hash/HashCode.html index edc175c8c08b..1ed5f06d370f 100644 --- a/releases/snapshot-android/api/docs/com/google/common/hash/HashCode.html +++ b/releases/snapshot-android/api/docs/com/google/common/hash/HashCode.html @@ -457,14 +457,6 @@

    equals

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -481,11 +473,6 @@

    hashCode

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    @@ -508,8 +495,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-android/api/docs/com/google/common/hash/Hasher.html b/releases/snapshot-android/api/docs/com/google/common/hash/Hasher.html index 398718d5b161..f4666adc15c1 100644 --- a/releases/snapshot-android/api/docs/com/google/common/hash/Hasher.html +++ b/releases/snapshot-android/api/docs/com/google/common/hash/Hasher.html @@ -599,42 +599,9 @@

    hashCode

    This returns Object.hashCode(); you almost certainly mean to call hash().asInt().
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    diff --git a/releases/snapshot-android/api/docs/com/google/common/hash/HashingInputStream.html b/releases/snapshot-android/api/docs/com/google/common/hash/HashingInputStream.html index 817784db4cc1..22b866f988c0 100644 --- a/releases/snapshot-android/api/docs/com/google/common/hash/HashingInputStream.html +++ b/releases/snapshot-android/api/docs/com/google/common/hash/HashingInputStream.html @@ -340,13 +340,8 @@

    read

    Overrides:
    read in class java.io.FilterInputStream
    -
    Returns:
    -
    the next byte of data, or -1 if the end of the - stream is reached.
    Throws:
    -
    java.io.IOException - if an I/O error occurs.
    -
    See Also:
    -
    FilterInputStream.in
    +
    java.io.IOException
    @@ -366,18 +361,8 @@

    read

    Overrides:
    read in class java.io.FilterInputStream
    -
    Parameters:
    -
    bytes - the buffer into which the data is read.
    -
    off - the start offset in the destination array b
    -
    len - the maximum number of bytes read.
    -
    Returns:
    -
    the total number of bytes read into the buffer, or - -1 if there is no more data because the end of - the stream has been reached.
    Throws:
    -
    java.io.IOException - if an I/O error occurs.
    -
    See Also:
    -
    FilterInputStream.in
    +
    java.io.IOException
    @@ -394,10 +379,6 @@

    markSupported

    markSupported in class java.io.FilterInputStream
    Returns:
    false always
    -
    See Also:
    -
    FilterInputStream.in, -InputStream.mark(int), -InputStream.reset()
    @@ -412,12 +393,6 @@

    mark

    Overrides:
    mark in class java.io.FilterInputStream
    -
    Parameters:
    -
    readlimit - the maximum limit of bytes that can be read before - the mark position becomes invalid.
    -
    See Also:
    -
    FilterInputStream.in, -FilterInputStream.reset()
    @@ -435,9 +410,6 @@

    reset

    reset in class java.io.FilterInputStream
    Throws:
    java.io.IOException - this operation is not supported
    -
    See Also:
    -
    FilterInputStream.in, -FilterInputStream.mark(int)
    diff --git a/releases/snapshot-android/api/docs/com/google/common/hash/HashingOutputStream.html b/releases/snapshot-android/api/docs/com/google/common/hash/HashingOutputStream.html index 92693e66d46c..179848cd4bef 100644 --- a/releases/snapshot-android/api/docs/com/google/common/hash/HashingOutputStream.html +++ b/releases/snapshot-android/api/docs/com/google/common/hash/HashingOutputStream.html @@ -221,10 +221,7 @@

    Method Summary

    void close() - -
    Closes this output stream and releases any system resources - associated with the stream.
    - +  HashCode @@ -238,18 +235,12 @@

    Method Summary

    write​(byte[] bytes, int off, int len) - -
    Writes len bytes from the specified - byte array starting at offset off to - this output stream.
    - +  void write​(int b) - -
    Writes the specified byte to this output stream.
    - + 
      @@ -321,21 +312,11 @@

      Method Detail

      write

      public void write​(int b)
            throws java.io.IOException
      -
      Description copied from class: java.io.FilterOutputStream
      -
      Writes the specified byte to this output stream. -

      - The write method of FilterOutputStream - calls the write method of its underlying output stream, - that is, it performs out.write(b). -

      - Implements the abstract write method of OutputStream.

      Overrides:
      write in class java.io.FilterOutputStream
      -
      Parameters:
      -
      b - the byte.
      Throws:
      -
      java.io.IOException - if an I/O error occurs.
      +
      java.io.IOException
    @@ -349,30 +330,11 @@

    write

    int off, int len) throws java.io.IOException -
    Description copied from class: java.io.FilterOutputStream
    -
    Writes len bytes from the specified - byte array starting at offset off to - this output stream. -

    - The write method of FilterOutputStream - calls the write method of one argument on each - byte to output. -

    - Note that this method does not call the write method - of its underlying output stream with the same arguments. Subclasses - of FilterOutputStream should provide a more efficient - implementation of this method.

    Overrides:
    write in class java.io.FilterOutputStream
    -
    Parameters:
    -
    bytes - the data.
    -
    off - the start offset in the data.
    -
    len - the number of bytes to write.
    Throws:
    -
    java.io.IOException - if an I/O error occurs.
    -
    See Also:
    -
    FilterOutputStream.write(int)
    +
    java.io.IOException
    @@ -395,13 +357,6 @@

    hash

    close

    public void close()
            throws java.io.IOException
    -
    Description copied from class: java.io.FilterOutputStream
    -
    Closes this output stream and releases any system resources - associated with the stream. -

    - When not already closed, the close method of - FilterOutputStream calls its flush method, and then - calls the close method of its underlying output stream.

    Specified by:
    close in interface java.lang.AutoCloseable
    @@ -410,10 +365,7 @@

    close

    Overrides:
    close in class java.io.FilterOutputStream
    Throws:
    -
    java.io.IOException - if an I/O error occurs.
    -
    See Also:
    -
    FilterOutputStream.flush(), -FilterOutputStream.out
    +
    java.io.IOException
    diff --git a/releases/snapshot-android/api/docs/com/google/common/io/ByteArrayDataInput.html b/releases/snapshot-android/api/docs/com/google/common/io/ByteArrayDataInput.html index 2b160c470890..06fee8a3c705 100644 --- a/releases/snapshot-android/api/docs/com/google/common/io/ByteArrayDataInput.html +++ b/releases/snapshot-android/api/docs/com/google/common/io/ByteArrayDataInput.html @@ -166,131 +166,79 @@

    Method Summary

    boolean readBoolean() - -
    Reads one input byte and returns - true if that byte is nonzero, - false if that byte is zero.
    - +  byte readByte() - -
    Reads and returns one input byte.
    - +  char readChar() - -
    Reads two input bytes and returns a char value.
    - +  double readDouble() - -
    Reads eight input bytes and returns - a double value.
    - +  float readFloat() - -
    Reads four input bytes and returns - a float value.
    - +  void readFully​(byte[] b) - -
    Reads some bytes from an input - stream and stores them into the buffer - array b.
    - +  void readFully​(byte[] b, int off, int len) - -
    Reads len - bytes from - an input stream.
    - +  int readInt() - -
    Reads four input bytes and returns an - int value.
    - +  java.lang.String readLine() - -
    Reads the next line of text from the input stream.
    - +  long readLong() - -
    Reads eight input bytes and returns - a long value.
    - +  short readShort() - -
    Reads two input bytes and returns - a short value.
    - +  int readUnsignedByte() - -
    Reads one input byte, zero-extends - it to type int, and returns - the result, which is therefore in the range - 0 - through 255.
    - +  int readUnsignedShort() - -
    Reads two input bytes and returns - an int value in the range 0 - through 65535.
    - +  java.lang.String readUTF() - -
    Reads in a string that has been encoded using a - modified UTF-8 - format.
    - +  int skipBytes​(int n) - -
    Makes an attempt to skip over - n bytes - of data from the input - stream, discarding the skipped bytes.
    - +  @@ -316,45 +264,9 @@

    Method Detail

  • readFully

    void readFully​(byte[] b)
    -
    Description copied from interface: java.io.DataInput
    -
    Reads some bytes from an input - stream and stores them into the buffer - array b. The number of bytes - read is equal - to the length of b. -

    - This method blocks until one of the - following conditions occurs: -

      -
    • b.length - bytes of input data are available, in which - case a normal return is made. - -
    • End of - file is detected, in which case an EOFException - is thrown. - -
    • An I/O error occurs, in - which case an IOException other - than EOFException is thrown. -
    -

    - If b is null, - a NullPointerException is thrown. - If b.length is zero, then - no bytes are read. Otherwise, the first - byte read is stored into element b[0], - the next one into b[1], and - so on. - If an exception is thrown from - this method, then it may be that some but - not all bytes of b have been - updated with data from the input stream.

    Specified by:
    readFully in interface java.io.DataInput
    -
    Parameters:
    -
    b - the buffer into which the data is read.
    • @@ -367,48 +279,9 @@

    readFully

    void readFully​(byte[] b,
                int off,
                int len)
    -
    Description copied from interface: java.io.DataInput
    -
    Reads len - bytes from - an input stream. -

    - This method - blocks until one of the following conditions - occurs: -

      -
    • len bytes - of input data are available, in which case - a normal return is made. - -
    • End of file - is detected, in which case an EOFException - is thrown. - -
    • An I/O error occurs, in - which case an IOException other - than EOFException is thrown. -
    -

    - If b is null, - a NullPointerException is thrown. - If off is negative, or len - is negative, or off+len is - greater than the length of the array b, - then an IndexOutOfBoundsException - is thrown. - If len is zero, - then no bytes are read. Otherwise, the first - byte read is stored into element b[off], - the next one into b[off+1], - and so on. The number of bytes read is, - at most, equal to len.

    Specified by:
    readFully in interface java.io.DataInput
    -
    Parameters:
    -
    b - the buffer into which the data is read.
    -
    off - an int specifying the offset in the data array b.
    -
    len - an int specifying the number of bytes to read.
    @@ -419,29 +292,9 @@

    readFully

  • skipBytes

    int skipBytes​(int n)
    -
    Description copied from interface: java.io.DataInput
    -
    Makes an attempt to skip over - n bytes - of data from the input - stream, discarding the skipped bytes. However, - it may skip - over some smaller number of - bytes, possibly zero. This may result from - any of a - number of conditions; reaching - end of file before n bytes - have been skipped is - only one possibility. - This method never throws an EOFException. - The actual - number of bytes skipped is returned.
    Specified by:
    skipBytes in interface java.io.DataInput
    -
    Parameters:
    -
    n - the number of bytes to be skipped.
    -
    Returns:
    -
    the number of bytes actually skipped.
    • @@ -453,18 +306,9 @@

    skipBytes

    readBoolean

    @CanIgnoreReturnValue
 boolean readBoolean()
    -
    Description copied from interface: java.io.DataInput
    -
    Reads one input byte and returns - true if that byte is nonzero, - false if that byte is zero. - This method is suitable for reading - the byte written by the writeBoolean - method of interface DataOutput.
    Specified by:
    readBoolean in interface java.io.DataInput
    -
    Returns:
    -
    the boolean value read.
    @@ -476,19 +320,9 @@

    readBoolean

    readByte

    @CanIgnoreReturnValue
 byte readByte()
    -
    Description copied from interface: java.io.DataInput
    -
    Reads and returns one input byte. - The byte is treated as a signed value in - the range -128 through 127, - inclusive. - This method is suitable for - reading the byte written by the writeByte - method of interface DataOutput.
    Specified by:
    readByte in interface java.io.DataInput
    -
    Returns:
    -
    the 8-bit value read.
    @@ -500,23 +334,9 @@

    readByte

    readUnsignedByte

    @CanIgnoreReturnValue
 int readUnsignedByte()
    -
    Description copied from interface: java.io.DataInput
    -
    Reads one input byte, zero-extends - it to type int, and returns - the result, which is therefore in the range - 0 - through 255. - This method is suitable for reading - the byte written by the writeByte - method of interface DataOutput - if the argument to writeByte - was intended to be a value in the range - 0 through 255.
    Specified by:
    readUnsignedByte in interface java.io.DataInput
    -
    Returns:
    -
    the unsigned 8-bit value read.
    @@ -528,24 +348,9 @@

    readUnsignedByte

    readShort

    @CanIgnoreReturnValue
 short readShort()
    -
    Description copied from interface: java.io.DataInput
    -
    Reads two input bytes and returns - a short value. Let a - be the first byte read and b - be the second byte. The value - returned - is: - 
    (short)((a << 8) | (b & 0xff))
-
    - This method - is suitable for reading the bytes written - by the writeShort method of - interface DataOutput.
    Specified by:
    readShort in interface java.io.DataInput
    -
    Returns:
    -
    the 16-bit value read.
    @@ -557,26 +362,9 @@

    readShort

    readUnsignedShort

    @CanIgnoreReturnValue
 int readUnsignedShort()
    -
    Description copied from interface: java.io.DataInput
    -
    Reads two input bytes and returns - an int value in the range 0 - through 65535. Let a - be the first byte read and - b - be the second byte. The value returned is: - 
    (((a & 0xff) << 8) | (b & 0xff))
-
    - This method is suitable for reading the bytes - written by the writeShort method - of interface DataOutput if - the argument to writeShort - was intended to be a value in the range - 0 through 65535.
    Specified by:
    readUnsignedShort in interface java.io.DataInput
    -
    Returns:
    -
    the unsigned 16-bit value read.
    @@ -588,23 +376,9 @@

    readUnsignedShort

    readChar

    @CanIgnoreReturnValue
 char readChar()
    -
    Description copied from interface: java.io.DataInput
    -
    Reads two input bytes and returns a char value. - Let a - be the first byte read and b - be the second byte. The value - returned is: - 
    (char)((a << 8) | (b & 0xff))
-
    - This method - is suitable for reading bytes written by - the writeChar method of interface - DataOutput.
    Specified by:
    readChar in interface java.io.DataInput
    -
    Returns:
    -
    the char value read.
    @@ -616,22 +390,9 @@

    readChar

    readInt

    @CanIgnoreReturnValue
 int readInt()
    -
    Description copied from interface: java.io.DataInput
    -
    Reads four input bytes and returns an - int value. Let a-d - be the first through fourth bytes read. The value returned is: - 
    
- (((a & 0xff) << 24) | ((b & 0xff) << 16) |
-  ((c & 0xff) <<  8) | (d & 0xff))
-
    - This method is suitable - for reading bytes written by the writeInt - method of interface DataOutput.
    Specified by:
    readInt in interface java.io.DataInput
    -
    Returns:
    -
    the int value read.
    @@ -643,30 +404,9 @@

    readInt

    readLong

    @CanIgnoreReturnValue
 long readLong()
    -
    Description copied from interface: java.io.DataInput
    -
    Reads eight input bytes and returns - a long value. Let a-h - be the first through eighth bytes read. - The value returned is: - 
    
- (((long)(a & 0xff) << 56) |
-  ((long)(b & 0xff) << 48) |
-  ((long)(c & 0xff) << 40) |
-  ((long)(d & 0xff) << 32) |
-  ((long)(e & 0xff) << 24) |
-  ((long)(f & 0xff) << 16) |
-  ((long)(g & 0xff) <<  8) |
-  ((long)(h & 0xff)))
-
    -

    - This method is suitable - for reading bytes written by the writeLong - method of interface DataOutput.

    Specified by:
    readLong in interface java.io.DataInput
    -
    Returns:
    -
    the long value read.
    @@ -678,23 +418,9 @@

    readLong

    readFloat

    @CanIgnoreReturnValue
 float readFloat()
    -
    Description copied from interface: java.io.DataInput
    -
    Reads four input bytes and returns - a float value. It does this - by first constructing an int - value in exactly the manner - of the readInt - method, then converting this int - value to a float in - exactly the manner of the method Float.intBitsToFloat. - This method is suitable for reading - bytes written by the writeFloat - method of interface DataOutput.
    Specified by:
    readFloat in interface java.io.DataInput
    -
    Returns:
    -
    the float value read.
    @@ -706,23 +432,9 @@

    readFloat

    readDouble

    @CanIgnoreReturnValue
 double readDouble()
    -
    Description copied from interface: java.io.DataInput
    -
    Reads eight input bytes and returns - a double value. It does this - by first constructing a long - value in exactly the manner - of the readLong - method, then converting this long - value to a double in exactly - the manner of the method Double.longBitsToDouble. - This method is suitable for reading - bytes written by the writeDouble - method of interface DataOutput.
    Specified by:
    readDouble in interface java.io.DataInput
    -
    Returns:
    -
    the double value read.
    @@ -735,46 +447,9 @@

    readLine

    @CanIgnoreReturnValue
 @CheckForNull
 java.lang.String readLine()
    -
    Description copied from interface: java.io.DataInput
    -
    Reads the next line of text from the input stream. - It reads successive bytes, converting - each byte separately into a character, - until it encounters a line terminator or - end of - file; the characters read are then - returned as a String. Note - that because this - method processes bytes, - it does not support input of the full Unicode - character set. -

    - If end of file is encountered - before even one byte can be read, then null - is returned. Otherwise, each byte that is - read is converted to type char - by zero-extension. If the character '\n' - is encountered, it is discarded and reading - ceases. If the character '\r' - is encountered, it is discarded and, if - the following byte converts to the - character '\n', then that is - discarded also; reading then ceases. If - end of file is encountered before either - of the characters '\n' and - '\r' is encountered, reading - ceases. Once reading has ceased, a String - is returned that contains all the characters - read and not discarded, taken in order. - Note that every character in this string - will have a value less than \u0100, - that is, (char)256.

    Specified by:
    readLine in interface java.io.DataInput
    -
    Returns:
    -
    the next line of text from the input stream, - or null if the end of file is - encountered before a byte can be read.
    @@ -786,89 +461,9 @@

    readLine

    readUTF

    @CanIgnoreReturnValue
 java.lang.String readUTF()
    -
    Description copied from interface: java.io.DataInput
    -
    Reads in a string that has been encoded using a - modified UTF-8 - format. - The general contract of readUTF - is that it reads a representation of a Unicode - character string encoded in modified - UTF-8 format; this string of characters - is then returned as a String. -

    - First, two bytes are read and used to - construct an unsigned 16-bit integer in - exactly the manner of the readUnsignedShort - method . This integer value is called the - UTF length and specifies the number - of additional bytes to be read. These bytes - are then converted to characters by considering - them in groups. The length of each group - is computed from the value of the first - byte of the group. The byte following a - group, if any, is the first byte of the - next group. -

    - If the first byte of a group - matches the bit pattern 0xxxxxxx - (where x means "may be 0 - or 1"), then the group consists - of just that byte. The byte is zero-extended - to form a character. -

    - If the first byte - of a group matches the bit pattern 110xxxxx, - then the group consists of that byte a - and a second byte b. If there - is no byte b (because byte - a was the last of the bytes - to be read), or if byte b does - not match the bit pattern 10xxxxxx, - then a UTFDataFormatException - is thrown. Otherwise, the group is converted - to the character: - 

    (char)(((a & 0x1F) << 6) | (b & 0x3F))
-
    - If the first byte of a group - matches the bit pattern 1110xxxx, - then the group consists of that byte a - and two more bytes b and c. - If there is no byte c (because - byte a was one of the last - two of the bytes to be read), or either - byte b or byte c - does not match the bit pattern 10xxxxxx, - then a UTFDataFormatException - is thrown. Otherwise, the group is converted - to the character: - 
    
- (char)(((a & 0x0F) << 12) | ((b & 0x3F) << 6) | (c & 0x3F))
-
    - If the first byte of a group matches the - pattern 1111xxxx or the pattern - 10xxxxxx, then a UTFDataFormatException - is thrown. -

    - If end of file is encountered - at any time during this entire process, - then an EOFException is thrown. -

    - After every group has been converted to - a character by this process, the characters - are gathered, in the same order in which - their corresponding groups were read from - the input stream, to form a String, - which is returned. -

    - The writeUTF - method of interface DataOutput - may be used to write data that is suitable - for reading by this method.

    Specified by:
    readUTF in interface java.io.DataInput
    -
    Returns:
    -
    a Unicode string.
    diff --git a/releases/snapshot-android/api/docs/com/google/common/io/ByteArrayDataOutput.html b/releases/snapshot-android/api/docs/com/google/common/io/ByteArrayDataOutput.html index 57c9f1d9446d..21f239d1f6d1 100644 --- a/releases/snapshot-android/api/docs/com/google/common/io/ByteArrayDataOutput.html +++ b/releases/snapshot-android/api/docs/com/google/common/io/ByteArrayDataOutput.html @@ -169,43 +169,29 @@

    Method Summary

    void write​(byte[] b) - -
    Writes to the output stream all the bytes in array b.
    - +  void write​(byte[] b, int off, int len) - -
    Writes len bytes from array - b, in order, to - the output stream.
    - +  void write​(int b) - -
    Writes to the output stream the eight - low-order bits of the argument b.
    - +  void writeBoolean​(boolean v) - -
    Writes a boolean value to this output stream.
    - +  void writeByte​(int v) - -
    Writes to the output stream the eight low- - order bits of the argument v.
    - +  void @@ -219,72 +205,42 @@

    Method Summary

    void writeChar​(int v) - -
    Writes a char value, which - is comprised of two bytes, to the - output stream.
    - +  void writeChars​(java.lang.String s) - -
    Writes every character in the string s, - to the output stream, in order, - two bytes per character.
    - +  void writeDouble​(double v) - -
    Writes a double value, - which is comprised of eight bytes, to the output stream.
    - +  void writeFloat​(float v) - -
    Writes a float value, - which is comprised of four bytes, to the output stream.
    - +  void writeInt​(int v) - -
    Writes an int value, which is - comprised of four bytes, to the output stream.
    - +  void writeLong​(long v) - -
    Writes a long value, which is - comprised of eight bytes, to the output stream.
    - +  void writeShort​(int v) - -
    Writes two bytes to the output - stream to represent the value of the argument.
    - +  void writeUTF​(java.lang.String s) - -
    Writes two bytes of length information - to the output stream, followed - by the - modified UTF-8 - representation - of every character in the string s.
    - +  @@ -310,16 +266,9 @@

    Method Detail

  • write

    void write​(int b)
    -
    Description copied from interface: java.io.DataOutput
    -
    Writes to the output stream the eight - low-order bits of the argument b. - The 24 high-order bits of b - are ignored.
    Specified by:
    write in interface java.io.DataOutput
    -
    Parameters:
    -
    b - the byte to be written.
    • @@ -330,20 +279,9 @@

    write

  • write

    void write​(byte[] b)
    -
    Description copied from interface: java.io.DataOutput
    -
    Writes to the output stream all the bytes in array b. - If b is null, - a NullPointerException is thrown. - If b.length is zero, then - no bytes are written. Otherwise, the byte - b[0] is written first, then - b[1], and so on; the last byte - written is b[b.length-1].
    Specified by:
    write in interface java.io.DataOutput
    -
    Parameters:
    -
    b - the data.
    • @@ -356,27 +294,9 @@

    write

    void write​(byte[] b,
            int off,
            int len)
    -
    Description copied from interface: java.io.DataOutput
    -
    Writes len bytes from array - b, in order, to - the output stream. If b - is null, a NullPointerException - is thrown. If off is negative, - or len is negative, or off+len - is greater than the length of the array - b, then an IndexOutOfBoundsException - is thrown. If len is zero, - then no bytes are written. Otherwise, the - byte b[off] is written first, - then b[off+1], and so on; the - last byte written is b[off+len-1].
    Specified by:
    write in interface java.io.DataOutput
    -
    Parameters:
    -
    b - the data.
    -
    off - the start offset in the data.
    -
    len - the number of bytes to write.
    @@ -387,22 +307,9 @@

    write

  • writeBoolean

    void writeBoolean​(boolean v)
    -
    Description copied from interface: java.io.DataOutput
    -
    Writes a boolean value to this output stream. - If the argument v - is true, the value (byte)1 - is written; if v is false, - the value (byte)0 is written. - The byte written by this method may - be read by the readBoolean - method of interface DataInput, - which will then return a boolean - equal to v.
    Specified by:
    writeBoolean in interface java.io.DataOutput
    -
    Parameters:
    -
    v - the boolean to be written.
    • @@ -413,22 +320,9 @@

    writeBoolean

  • writeByte

    void writeByte​(int v)
    -
    Description copied from interface: java.io.DataOutput
    -
    Writes to the output stream the eight low- - order bits of the argument v. - The 24 high-order bits of v - are ignored. (This means that writeByte - does exactly the same thing as write - for an integer argument.) The byte written - by this method may be read by the readByte - method of interface DataInput, - which will then return a byte - equal to (byte)v.
    Specified by:
    writeByte in interface java.io.DataOutput
    -
    Parameters:
    -
    v - the byte value to be written.
    • @@ -439,25 +333,9 @@

    writeByte

  • writeShort

    void writeShort​(int v)
    -
    Description copied from interface: java.io.DataOutput
    -
    Writes two bytes to the output - stream to represent the value of the argument. - The byte values to be written, in the order - shown, are: - 
    
- (byte)(0xff & (v >> 8))
- (byte)(0xff & v)
-

    - The bytes written by this method may be - read by the readShort method - of interface DataInput , which - will then return a short equal - to (short)v.

    Specified by:
    writeShort in interface java.io.DataOutput
    -
    Parameters:
    -
    v - the short value to be written.
    • @@ -468,26 +346,9 @@

    writeShort

  • writeChar

    void writeChar​(int v)
    -
    Description copied from interface: java.io.DataOutput
    -
    Writes a char value, which - is comprised of two bytes, to the - output stream. - The byte values to be written, in the order - shown, are: - 
    
- (byte)(0xff & (v >> 8))
- (byte)(0xff & v)
-

    - The bytes written by this method may be - read by the readChar method - of interface DataInput , which - will then return a char equal - to (char)v.

    Specified by:
    writeChar in interface java.io.DataOutput
    -
    Parameters:
    -
    v - the char value to be written.
    • @@ -498,26 +359,9 @@

    writeChar

  • writeInt

    void writeInt​(int v)
    -
    Description copied from interface: java.io.DataOutput
    -
    Writes an int value, which is - comprised of four bytes, to the output stream. - The byte values to be written, in the order - shown, are: - 
    
- (byte)(0xff & (v >> 24))
- (byte)(0xff & (v >> 16))
- (byte)(0xff & (v >>  8))
- (byte)(0xff & v)
-

    - The bytes written by this method may be read - by the readInt method of interface - DataInput , which will then - return an int equal to v.

    Specified by:
    writeInt in interface java.io.DataOutput
    -
    Parameters:
    -
    v - the int value to be written.
    • @@ -528,31 +372,9 @@

    writeInt

  • writeLong

    void writeLong​(long v)
    -
    Description copied from interface: java.io.DataOutput
    -
    Writes a long value, which is - comprised of eight bytes, to the output stream. - The byte values to be written, in the order - shown, are: - 
    
- (byte)(0xff & (v >> 56))
- (byte)(0xff & (v >> 48))
- (byte)(0xff & (v >> 40))
- (byte)(0xff & (v >> 32))
- (byte)(0xff & (v >> 24))
- (byte)(0xff & (v >> 16))
- (byte)(0xff & (v >>  8))
- (byte)(0xff & v)
-

    - The bytes written by this method may be - read by the readLong method - of interface DataInput , which - will then return a long equal - to v.

    Specified by:
    writeLong in interface java.io.DataOutput
    -
    Parameters:
    -
    v - the long value to be written.
    • @@ -563,24 +385,9 @@

    writeLong

  • writeFloat

    void writeFloat​(float v)
    -
    Description copied from interface: java.io.DataOutput
    -
    Writes a float value, - which is comprised of four bytes, to the output stream. - It does this as if it first converts this - float value to an int - in exactly the manner of the Float.floatToIntBits - method and then writes the int - value in exactly the manner of the writeInt - method. The bytes written by this method - may be read by the readFloat - method of interface DataInput, - which will then return a float - equal to v.
    Specified by:
    writeFloat in interface java.io.DataOutput
    -
    Parameters:
    -
    v - the float value to be written.
    • @@ -591,24 +398,9 @@

    writeFloat

  • writeDouble

    void writeDouble​(double v)
    -
    Description copied from interface: java.io.DataOutput
    -
    Writes a double value, - which is comprised of eight bytes, to the output stream. - It does this as if it first converts this - double value to a long - in exactly the manner of the Double.doubleToLongBits - method and then writes the long - value in exactly the manner of the writeLong - method. The bytes written by this method - may be read by the readDouble - method of interface DataInput, - which will then return a double - equal to v.
    Specified by:
    writeDouble in interface java.io.DataOutput
    -
    Parameters:
    -
    v - the double value to be written.
    • @@ -619,25 +411,9 @@

    writeDouble

  • writeChars

    void writeChars​(java.lang.String s)
    -
    Description copied from interface: java.io.DataOutput
    -
    Writes every character in the string s, - to the output stream, in order, - two bytes per character. If s - is null, a NullPointerException - is thrown. If s.length - is zero, then no characters are written. - Otherwise, the character s[0] - is written first, then s[1], - and so on; the last character written is - s[s.length-1]. For each character, - two bytes are actually written, high-order - byte first, in exactly the manner of the - writeChar method.
    Specified by:
    writeChars in interface java.io.DataOutput
    -
    Parameters:
    -
    s - the string value to be written.
    • @@ -648,59 +424,9 @@

    writeChars

  • writeUTF

    void writeUTF​(java.lang.String s)
    -
    Description copied from interface: java.io.DataOutput
    -
    Writes two bytes of length information - to the output stream, followed - by the - modified UTF-8 - representation - of every character in the string s. - If s is null, - a NullPointerException is thrown. - Each character in the string s - is converted to a group of one, two, or - three bytes, depending on the value of the - character.

    - If a character c - is in the range \u0001 through - \u007f, it is represented - by one byte: - 

    (byte)c

    - If a character c is \u0000 - or is in the range \u0080 - through \u07ff, then it is - represented by two bytes, to be written - in the order shown: 

    
- (byte)(0xc0 | (0x1f & (c >> 6)))
- (byte)(0x80 | (0x3f & c))
-

    If a character - c is in the range \u0800 - through uffff, then it is - represented by three bytes, to be written - in the order shown: 

    
- (byte)(0xe0 | (0x0f & (c >> 12)))
- (byte)(0x80 | (0x3f & (c >>  6)))
- (byte)(0x80 | (0x3f & c))
-

    First, - the total number of bytes needed to represent - all the characters of s is - calculated. If this number is larger than - 65535, then a UTFDataFormatException - is thrown. Otherwise, this length is written - to the output stream in exactly the manner - of the writeShort method; - after this, the one-, two-, or three-byte - representation of each character in the - string s is written.

    The - bytes written by this method may be read - by the readUTF method of interface - DataInput , which will then - return a String equal to s.

    Specified by:
    writeUTF in interface java.io.DataOutput
    -
    Parameters:
    -
    s - the string value to be written.
    • @@ -716,27 +442,9 @@

    writeBytes

    This method is dangerous as it discards the high byte of every character. For UTF-8, use write(s.getBytes(StandardCharsets.UTF_8)).
    -
    Description copied from interface: java.io.DataOutput
    -
    Writes a string to the output stream. - For every character in the string - s, taken in order, one byte - is written to the output stream. If - s is null, a NullPointerException - is thrown.

    If s.length - is zero, then no bytes are written. Otherwise, - the character s[0] is written - first, then s[1], and so on; - the last character written is s[s.length-1]. - For each character, one byte is written, - the low-order byte, in exactly the manner - of the writeByte method . The - high-order eight bits of each character - in the string are ignored.

    Specified by:
    writeBytes in interface java.io.DataOutput
    -
    Parameters:
    -
    s - the string of bytes to be written.
    diff --git a/releases/snapshot-android/api/docs/com/google/common/io/Closer.html b/releases/snapshot-android/api/docs/com/google/common/io/Closer.html index 806f93ece564..caf0f5b07549 100644 --- a/releases/snapshot-android/api/docs/com/google/common/io/Closer.html +++ b/releases/snapshot-android/api/docs/com/google/common/io/Closer.html @@ -414,7 +414,7 @@

    close

    Specified by:
    close in interface java.io.Closeable
    Throws:
    -
    java.io.IOException - if an I/O error occurs
    +
    java.io.IOException
    diff --git a/releases/snapshot-android/api/docs/com/google/common/io/CountingInputStream.html b/releases/snapshot-android/api/docs/com/google/common/io/CountingInputStream.html index a0d85edcfb9b..268564fe521d 100644 --- a/releases/snapshot-android/api/docs/com/google/common/io/CountingInputStream.html +++ b/releases/snapshot-android/api/docs/com/google/common/io/CountingInputStream.html @@ -227,42 +227,29 @@

    Method Summary

    void mark​(int readlimit) - -
    Marks the current position in this input stream.
    - +  int read() - -
    Reads the next byte of data from this input stream.
    - +  int read​(byte[] b, int off, int len) - -
    Reads up to len bytes of data from this input stream - into an array of bytes.
    - +  void reset() - -
    Repositions this stream to the position at the time the - mark method was last called on this input stream.
    - +  long skip​(long n) - -
    Skips over and discards n bytes of data from the - input stream.
    - + 
      @@ -344,27 +331,11 @@

      getCount

      read

      public int read()
          throws java.io.IOException
      -
      Description copied from class: java.io.FilterInputStream
      -
      Reads the next byte of data from this input stream. The value - byte is returned as an int in the range - 0 to 255. If no byte is available - because the end of the stream has been reached, the value - -1 is returned. This method blocks until input data - is available, the end of the stream is detected, or an exception - is thrown. -

      - This method - simply performs in.read() and returns the result.

      Overrides:
      read in class java.io.FilterInputStream
      -
      Returns:
      -
      the next byte of data, or -1 if the end of the - stream is reached.
      Throws:
      -
      java.io.IOException - if an I/O error occurs.
      -
      See Also:
      -
      FilterInputStream.in
      +
      java.io.IOException
    @@ -378,29 +349,11 @@

    read

    int off, int len) throws java.io.IOException -
    Description copied from class: java.io.FilterInputStream
    -
    Reads up to len bytes of data from this input stream - into an array of bytes. If len is not zero, the method - blocks until some input is available; otherwise, no - bytes are read and 0 is returned. -

    - This method simply performs in.read(b, off, len) - and returns the result.

    Overrides:
    read in class java.io.FilterInputStream
    -
    Parameters:
    -
    b - the buffer into which the data is read.
    -
    off - the start offset in the destination array b
    -
    len - the maximum number of bytes read.
    -
    Returns:
    -
    the total number of bytes read into the buffer, or - -1 if there is no more data because the end of - the stream has been reached.
    Throws:
    -
    java.io.IOException - if an I/O error occurs.
    -
    See Also:
    -
    FilterInputStream.in
    +
    java.io.IOException
    @@ -412,23 +365,11 @@

    read

    skip

    public long skip​(long n)
           throws java.io.IOException
    -
    Description copied from class: java.io.FilterInputStream
    -
    Skips over and discards n bytes of data from the - input stream. The skip method may, for a variety of - reasons, end up skipping over some smaller number of bytes, - possibly 0. The actual number of bytes skipped is - returned. -

    - This method simply performs in.skip(n).

    Overrides:
    skip in class java.io.FilterInputStream
    -
    Parameters:
    -
    n - the number of bytes to be skipped.
    -
    Returns:
    -
    the actual number of bytes skipped.
    Throws:
    -
    java.io.IOException - if in.skip(n) throws an IOException.
    +
    java.io.IOException
    @@ -439,25 +380,9 @@

    skip

  • mark

    public void mark​(int readlimit)
    -
    Description copied from class: java.io.FilterInputStream
    -
    Marks the current position in this input stream. A subsequent - call to the reset method repositions this stream at - the last marked position so that subsequent reads re-read the same bytes. -

    - The readlimit argument tells this input stream to - allow that many bytes to be read before the mark position gets - invalidated. -

    - This method simply performs in.mark(readlimit).

    Overrides:
    mark in class java.io.FilterInputStream
    -
    Parameters:
    -
    readlimit - the maximum limit of bytes that can be read before - the mark position becomes invalid.
    -
    See Also:
    -
    FilterInputStream.in, -FilterInputStream.reset()
    • @@ -469,30 +394,11 @@

    mark

    reset

    public void reset()
            throws java.io.IOException
    -
    Description copied from class: java.io.FilterInputStream
    -
    Repositions this stream to the position at the time the - mark method was last called on this input stream. -

    - This method - simply performs in.reset(). -

    - Stream marks are intended to be used in - situations where you need to read ahead a little to see what's in - the stream. Often this is most easily done by invoking some - general parser. If the stream is of the type handled by the - parse, it just chugs along happily. If the stream is not of - that type, the parser should toss an exception when it fails. - If this happens within readlimit bytes, it allows the outer - code to reset the stream and try another parser.

    Overrides:
    reset in class java.io.FilterInputStream
    Throws:
    -
    java.io.IOException - if the stream has not been marked or if the - mark has been invalidated.
    -
    See Also:
    -
    FilterInputStream.in, -FilterInputStream.mark(int)
    +
    java.io.IOException
    diff --git a/releases/snapshot-android/api/docs/com/google/common/io/CountingOutputStream.html b/releases/snapshot-android/api/docs/com/google/common/io/CountingOutputStream.html index 18191330ec4d..3d78ee1ae664 100644 --- a/releases/snapshot-android/api/docs/com/google/common/io/CountingOutputStream.html +++ b/releases/snapshot-android/api/docs/com/google/common/io/CountingOutputStream.html @@ -219,10 +219,7 @@

    Method Summary

    void close() - -
    Closes this output stream and releases any system resources - associated with the stream.
    - +  long @@ -236,18 +233,12 @@

    Method Summary

    write​(byte[] b, int off, int len) - -
    Writes len bytes from the specified - byte array starting at offset off to - this output stream.
    - +  void write​(int b) - -
    Writes the specified byte to this output stream.
    - + 
      @@ -331,30 +322,11 @@

      write

      int off, int len) throws java.io.IOException -
      Description copied from class: java.io.FilterOutputStream
      -
      Writes len bytes from the specified - byte array starting at offset off to - this output stream. -

      - The write method of FilterOutputStream - calls the write method of one argument on each - byte to output. -

      - Note that this method does not call the write method - of its underlying output stream with the same arguments. Subclasses - of FilterOutputStream should provide a more efficient - implementation of this method.

      Overrides:
      write in class java.io.FilterOutputStream
      -
      Parameters:
      -
      b - the data.
      -
      off - the start offset in the data.
      -
      len - the number of bytes to write.
      Throws:
      -
      java.io.IOException - if an I/O error occurs.
      -
      See Also:
      -
      FilterOutputStream.write(int)
      +
      java.io.IOException
    @@ -366,21 +338,11 @@

    write

    write

    public void write​(int b)
            throws java.io.IOException
    -
    Description copied from class: java.io.FilterOutputStream
    -
    Writes the specified byte to this output stream. -

    - The write method of FilterOutputStream - calls the write method of its underlying output stream, - that is, it performs out.write(b). -

    - Implements the abstract write method of OutputStream.

    Overrides:
    write in class java.io.FilterOutputStream
    -
    Parameters:
    -
    b - the byte.
    Throws:
    -
    java.io.IOException - if an I/O error occurs.
    +
    java.io.IOException
    @@ -392,13 +354,6 @@

    write

    close

    public void close()
            throws java.io.IOException
    -
    Description copied from class: java.io.FilterOutputStream
    -
    Closes this output stream and releases any system resources - associated with the stream. -

    - When not already closed, the close method of - FilterOutputStream calls its flush method, and then - calls the close method of its underlying output stream.

    Specified by:
    close in interface java.lang.AutoCloseable
    @@ -407,10 +362,7 @@

    close

    Overrides:
    close in class java.io.FilterOutputStream
    Throws:
    -
    java.io.IOException - if an I/O error occurs.
    -
    See Also:
    -
    FilterOutputStream.flush(), -FilterOutputStream.out
    +
    java.io.IOException
    diff --git a/releases/snapshot-android/api/docs/com/google/common/io/FileBackedOutputStream.html b/releases/snapshot-android/api/docs/com/google/common/io/FileBackedOutputStream.html index 4f7c256adae0..4b644e2c3970 100644 --- a/releases/snapshot-android/api/docs/com/google/common/io/FileBackedOutputStream.html +++ b/releases/snapshot-android/api/docs/com/google/common/io/FileBackedOutputStream.html @@ -226,18 +226,12 @@

    Method Summary

    void close() - -
    Closes this output stream and releases any system resources - associated with this stream.
    - +  void flush() - -
    Flushes this output stream and forces any buffered output bytes - to be written out.
    - +  void @@ -250,27 +244,19 @@

    Method Summary

    void write​(byte[] b) - -
    Writes b.length bytes from the specified byte array - to this output stream.
    - +  void write​(byte[] b, int off, int len) - -
    Writes len bytes from the specified byte array - starting at offset off to this output stream.
    - +  void write​(int b) - -
    Writes the specified byte to this output stream.
    - + 
      @@ -383,24 +369,11 @@

      reset

      write

      public void write​(int b)
            throws java.io.IOException
      -
      Description copied from class: java.io.OutputStream
      -
      Writes the specified byte to this output stream. The general - contract for write is that one byte is written - to the output stream. The byte to be written is the eight - low-order bits of the argument b. The 24 - high-order bits of b are ignored. -

      - Subclasses of OutputStream must provide an - implementation for this method.

      Specified by:
      write in class java.io.OutputStream
      -
      Parameters:
      -
      b - the byte.
      Throws:
      -
      java.io.IOException - if an I/O error occurs. In particular, - an IOException may be thrown if the - output stream has been closed.
      +
      java.io.IOException
    @@ -412,20 +385,11 @@

    write

    write

    public void write​(byte[] b)
            throws java.io.IOException
    -
    Description copied from class: java.io.OutputStream
    -
    Writes b.length bytes from the specified byte array - to this output stream. The general contract for write(b) - is that it should have exactly the same effect as the call - write(b, 0, b.length).
    Overrides:
    write in class java.io.OutputStream
    -
    Parameters:
    -
    b - the data.
    Throws:
    -
    java.io.IOException - if an I/O error occurs.
    -
    See Also:
    -
    OutputStream.write(byte[], int, int)
    +
    java.io.IOException
    @@ -439,37 +403,11 @@

    write

    int off, int len) throws java.io.IOException -
    Description copied from class: java.io.OutputStream
    -
    Writes len bytes from the specified byte array - starting at offset off to this output stream. - The general contract for write(b, off, len) is that - some of the bytes in the array b are written to the - output stream in order; element b[off] is the first - byte written and b[off+len-1] is the last byte written - by this operation. -

    - The write method of OutputStream calls - the write method of one argument on each of the bytes to be - written out. Subclasses are encouraged to override this method and - provide a more efficient implementation. -

    - If b is null, a - NullPointerException is thrown. -

    - If off is negative, or len is negative, or - off+len is greater than the length of the array - b, then an IndexOutOfBoundsException is thrown.

    Overrides:
    write in class java.io.OutputStream
    -
    Parameters:
    -
    b - the data.
    -
    off - the start offset in the data.
    -
    len - the number of bytes to write.
    Throws:
    -
    java.io.IOException - if an I/O error occurs. In particular, - an IOException is thrown if the output - stream is closed.
    +
    java.io.IOException
    @@ -481,13 +419,6 @@

    write

    close

    public void close()
            throws java.io.IOException
    -
    Description copied from class: java.io.OutputStream
    -
    Closes this output stream and releases any system resources - associated with this stream. The general contract of close - is that it closes the output stream. A closed stream cannot perform - output operations and cannot be reopened. -

    - The close method of OutputStream does nothing.

    Specified by:
    close in interface java.lang.AutoCloseable
    @@ -496,7 +427,7 @@

    close

    Overrides:
    close in class java.io.OutputStream
    Throws:
    -
    java.io.IOException - if an I/O error occurs.
    +
    java.io.IOException
    @@ -508,28 +439,13 @@

    close

    flush

    public void flush()
            throws java.io.IOException
    -
    Description copied from class: java.io.OutputStream
    -
    Flushes this output stream and forces any buffered output bytes - to be written out. The general contract of flush is - that calling it is an indication that, if any bytes previously - written have been buffered by the implementation of the output - stream, such bytes should immediately be written to their - intended destination. -

    - If the intended destination of this stream is an abstraction provided by - the underlying operating system, for example a file, then flushing the - stream guarantees only that bytes previously written to the stream are - passed to the operating system for writing; it does not guarantee that - they are actually written to a physical device such as a disk drive. -

    - The flush method of OutputStream does nothing.

    Specified by:
    flush in interface java.io.Flushable
    Overrides:
    flush in class java.io.OutputStream
    Throws:
    -
    java.io.IOException - if an I/O error occurs.
    +
    java.io.IOException
    diff --git a/releases/snapshot-android/api/docs/com/google/common/io/LittleEndianDataInputStream.html b/releases/snapshot-android/api/docs/com/google/common/io/LittleEndianDataInputStream.html index 9bdc12df328b..a73584ebf1cd 100644 --- a/releases/snapshot-android/api/docs/com/google/common/io/LittleEndianDataInputStream.html +++ b/releases/snapshot-android/api/docs/com/google/common/io/LittleEndianDataInputStream.html @@ -225,18 +225,12 @@

    Method Summary

    boolean readBoolean() - -
    Reads one input byte and returns - true if that byte is nonzero, - false if that byte is zero.
    - +  byte readByte() - -
    Reads and returns one input byte.
    - +  char @@ -265,22 +259,14 @@

    Method Summary

    void readFully​(byte[] b) - -
    Reads some bytes from an input - stream and stores them into the buffer - array b.
    - +  void readFully​(byte[] b, int off, int len) - -
    Reads len - bytes from - an input stream.
    - +  int @@ -316,13 +302,7 @@

    Method Summary

    int readUnsignedByte() - -
    Reads one input byte, zero-extends - it to type int, and returns - the result, which is therefore in the range - 0 - through 255.
    - +  int @@ -335,21 +315,12 @@

    Method Summary

    java.lang.String readUTF() - -
    Reads in a string that has been encoded using a - modified UTF-8 - format.
    - +  int skipBytes​(int n) - -
    Makes an attempt to skip over - n bytes - of data from the input - stream, discarding the skipped bytes.
    - + 
      @@ -425,10 +396,6 @@

      readLine

      Specified by:
      readLine in interface java.io.DataInput
      -
      Returns:
      -
      the next line of text from the input stream, - or null if the end of file is - encountered before a byte can be read.
    @@ -440,49 +407,11 @@

    readLine

    readFully

    public void readFully​(byte[] b)
                throws java.io.IOException
    -
    Description copied from interface: java.io.DataInput
    -
    Reads some bytes from an input - stream and stores them into the buffer - array b. The number of bytes - read is equal - to the length of b. -

    - This method blocks until one of the - following conditions occurs: -

      -
    • b.length - bytes of input data are available, in which - case a normal return is made. - -
    • End of - file is detected, in which case an EOFException - is thrown. - -
    • An I/O error occurs, in - which case an IOException other - than EOFException is thrown. -
    -

    - If b is null, - a NullPointerException is thrown. - If b.length is zero, then - no bytes are read. Otherwise, the first - byte read is stored into element b[0], - the next one into b[1], and - so on. - If an exception is thrown from - this method, then it may be that some but - not all bytes of b have been - updated with data from the input stream.

    Specified by:
    readFully in interface java.io.DataInput
    -
    Parameters:
    -
    b - the buffer into which the data is read.
    Throws:
    -
    java.io.EOFException - if this stream reaches the end before reading - all the bytes.
    -
    java.io.IOException - if an I/O error occurs.
    +
    java.io.IOException
    @@ -496,52 +425,11 @@

    readFully

    int off, int len) throws java.io.IOException -
    Description copied from interface: java.io.DataInput
    -
    Reads len - bytes from - an input stream. -

    - This method - blocks until one of the following conditions - occurs: -

      -
    • len bytes - of input data are available, in which case - a normal return is made. - -
    • End of file - is detected, in which case an EOFException - is thrown. - -
    • An I/O error occurs, in - which case an IOException other - than EOFException is thrown. -
    -

    - If b is null, - a NullPointerException is thrown. - If off is negative, or len - is negative, or off+len is - greater than the length of the array b, - then an IndexOutOfBoundsException - is thrown. - If len is zero, - then no bytes are read. Otherwise, the first - byte read is stored into element b[off], - the next one into b[off+1], - and so on. The number of bytes read is, - at most, equal to len.

    Specified by:
    readFully in interface java.io.DataInput
    -
    Parameters:
    -
    b - the buffer into which the data is read.
    -
    off - an int specifying the offset in the data array b.
    -
    len - an int specifying the number of bytes to read.
    Throws:
    -
    java.io.EOFException - if this stream reaches the end before reading - all the bytes.
    -
    java.io.IOException - if an I/O error occurs.
    +
    java.io.IOException
    @@ -553,31 +441,11 @@

    readFully

    skipBytes

    public int skipBytes​(int n)
               throws java.io.IOException
    -
    Description copied from interface: java.io.DataInput
    -
    Makes an attempt to skip over - n bytes - of data from the input - stream, discarding the skipped bytes. However, - it may skip - over some smaller number of - bytes, possibly zero. This may result from - any of a - number of conditions; reaching - end of file before n bytes - have been skipped is - only one possibility. - This method never throws an EOFException. - The actual - number of bytes skipped is returned.
    Specified by:
    skipBytes in interface java.io.DataInput
    -
    Parameters:
    -
    n - the number of bytes to be skipped.
    -
    Returns:
    -
    the number of bytes actually skipped.
    Throws:
    -
    java.io.IOException - if an I/O error occurs.
    +
    java.io.IOException
    @@ -590,27 +458,11 @@

    readUnsignedByte

    @CanIgnoreReturnValue
 public int readUnsignedByte()
                      throws java.io.IOException
    -
    Description copied from interface: java.io.DataInput
    -
    Reads one input byte, zero-extends - it to type int, and returns - the result, which is therefore in the range - 0 - through 255. - This method is suitable for reading - the byte written by the writeByte - method of interface DataOutput - if the argument to writeByte - was intended to be a value in the range - 0 through 255.
    Specified by:
    readUnsignedByte in interface java.io.DataInput
    -
    Returns:
    -
    the unsigned 8-bit value read.
    Throws:
    -
    java.io.EOFException - if this stream reaches the end before reading - all the bytes.
    -
    java.io.IOException - if an I/O error occurs.
    +
    java.io.IOException
    @@ -733,95 +585,11 @@

    readUTF

    @CanIgnoreReturnValue
 public java.lang.String readUTF()
                          throws java.io.IOException
    -
    Description copied from interface: java.io.DataInput
    -
    Reads in a string that has been encoded using a - modified UTF-8 - format. - The general contract of readUTF - is that it reads a representation of a Unicode - character string encoded in modified - UTF-8 format; this string of characters - is then returned as a String. -

    - First, two bytes are read and used to - construct an unsigned 16-bit integer in - exactly the manner of the readUnsignedShort - method . This integer value is called the - UTF length and specifies the number - of additional bytes to be read. These bytes - are then converted to characters by considering - them in groups. The length of each group - is computed from the value of the first - byte of the group. The byte following a - group, if any, is the first byte of the - next group. -

    - If the first byte of a group - matches the bit pattern 0xxxxxxx - (where x means "may be 0 - or 1"), then the group consists - of just that byte. The byte is zero-extended - to form a character. -

    - If the first byte - of a group matches the bit pattern 110xxxxx, - then the group consists of that byte a - and a second byte b. If there - is no byte b (because byte - a was the last of the bytes - to be read), or if byte b does - not match the bit pattern 10xxxxxx, - then a UTFDataFormatException - is thrown. Otherwise, the group is converted - to the character: - 

    (char)(((a & 0x1F) << 6) | (b & 0x3F))
-
    - If the first byte of a group - matches the bit pattern 1110xxxx, - then the group consists of that byte a - and two more bytes b and c. - If there is no byte c (because - byte a was one of the last - two of the bytes to be read), or either - byte b or byte c - does not match the bit pattern 10xxxxxx, - then a UTFDataFormatException - is thrown. Otherwise, the group is converted - to the character: - 
    
- (char)(((a & 0x0F) << 12) | ((b & 0x3F) << 6) | (c & 0x3F))
-
    - If the first byte of a group matches the - pattern 1111xxxx or the pattern - 10xxxxxx, then a UTFDataFormatException - is thrown. -

    - If end of file is encountered - at any time during this entire process, - then an EOFException is thrown. -

    - After every group has been converted to - a character by this process, the characters - are gathered, in the same order in which - their corresponding groups were read from - the input stream, to form a String, - which is returned. -

    - The writeUTF - method of interface DataOutput - may be used to write data that is suitable - for reading by this method.

    Specified by:
    readUTF in interface java.io.DataInput
    -
    Returns:
    -
    a Unicode string.
    Throws:
    -
    java.io.EOFException - if this stream reaches the end - before reading all the bytes.
    -
    java.io.IOException - if an I/O error occurs.
    -
    java.io.UTFDataFormatException - if the bytes do not represent a - valid modified UTF-8 encoding of a string.
    +
    java.io.IOException
    @@ -878,23 +646,11 @@

    readByte

    @CanIgnoreReturnValue
 public byte readByte()
               throws java.io.IOException
    -
    Description copied from interface: java.io.DataInput
    -
    Reads and returns one input byte. - The byte is treated as a signed value in - the range -128 through 127, - inclusive. - This method is suitable for - reading the byte written by the writeByte - method of interface DataOutput.
    Specified by:
    readByte in interface java.io.DataInput
    -
    Returns:
    -
    the 8-bit value read.
    Throws:
    -
    java.io.EOFException - if this stream reaches the end before reading - all the bytes.
    -
    java.io.IOException - if an I/O error occurs.
    +
    java.io.IOException
    @@ -907,22 +663,11 @@

    readBoolean

    @CanIgnoreReturnValue
 public boolean readBoolean()
                     throws java.io.IOException
    -
    Description copied from interface: java.io.DataInput
    -
    Reads one input byte and returns - true if that byte is nonzero, - false if that byte is zero. - This method is suitable for reading - the byte written by the writeBoolean - method of interface DataOutput.
    Specified by:
    readBoolean in interface java.io.DataInput
    -
    Returns:
    -
    the boolean value read.
    Throws:
    -
    java.io.EOFException - if this stream reaches the end before reading - all the bytes.
    -
    java.io.IOException - if an I/O error occurs.
    +
    java.io.IOException
    diff --git a/releases/snapshot-android/api/docs/com/google/common/io/LittleEndianDataOutputStream.html b/releases/snapshot-android/api/docs/com/google/common/io/LittleEndianDataOutputStream.html index 1cc198419baf..184359c62c9c 100644 --- a/releases/snapshot-android/api/docs/com/google/common/io/LittleEndianDataOutputStream.html +++ b/releases/snapshot-android/api/docs/com/google/common/io/LittleEndianDataOutputStream.html @@ -225,36 +225,24 @@

    Method Summary

    void close() - -
    Closes this output stream and releases any system resources - associated with the stream.
    - +  void write​(byte[] b, int off, int len) - -
    Writes len bytes from the specified - byte array starting at offset off to - this output stream.
    - +  void writeBoolean​(boolean v) - -
    Writes a boolean value to this output stream.
    - +  void writeByte​(int v) - -
    Writes to the output stream the eight low- - order bits of the argument v.
    - +  void @@ -324,14 +312,7 @@

    Method Summary

    void writeUTF​(java.lang.String str) - -
    Writes two bytes of length information - to the output stream, followed - by the - modified UTF-8 - representation - of every character in the string s.
    - + 
      @@ -412,32 +393,13 @@

      write

      int off, int len) throws java.io.IOException -
      Description copied from class: java.io.FilterOutputStream
      -
      Writes len bytes from the specified - byte array starting at offset off to - this output stream. -

      - The write method of FilterOutputStream - calls the write method of one argument on each - byte to output. -

      - Note that this method does not call the write method - of its underlying output stream with the same arguments. Subclasses - of FilterOutputStream should provide a more efficient - implementation of this method.

      Specified by:
      write in interface java.io.DataOutput
      Overrides:
      write in class java.io.FilterOutputStream
      -
      Parameters:
      -
      b - the data.
      -
      off - the start offset in the data.
      -
      len - the number of bytes to write.
      Throws:
      -
      java.io.IOException - if an I/O error occurs.
      -
      See Also:
      -
      FilterOutputStream.write(int)
      +
      java.io.IOException
    @@ -449,24 +411,11 @@

    write

    writeBoolean

    public void writeBoolean​(boolean v)
                   throws java.io.IOException
    -
    Description copied from interface: java.io.DataOutput
    -
    Writes a boolean value to this output stream. - If the argument v - is true, the value (byte)1 - is written; if v is false, - the value (byte)0 is written. - The byte written by this method may - be read by the readBoolean - method of interface DataInput, - which will then return a boolean - equal to v.
    Specified by:
    writeBoolean in interface java.io.DataOutput
    -
    Parameters:
    -
    v - the boolean to be written.
    Throws:
    -
    java.io.IOException - if an I/O error occurs.
    +
    java.io.IOException
    @@ -478,24 +427,11 @@

    writeBoolean

    writeByte

    public void writeByte​(int v)
                throws java.io.IOException
    -
    Description copied from interface: java.io.DataOutput
    -
    Writes to the output stream the eight low- - order bits of the argument v. - The 24 high-order bits of v - are ignored. (This means that writeByte - does exactly the same thing as write - for an integer argument.) The byte written - by this method may be read by the readByte - method of interface DataInput, - which will then return a byte - equal to (byte)v.
    Specified by:
    writeByte in interface java.io.DataOutput
    -
    Parameters:
    -
    v - the byte value to be written.
    Throws:
    -
    java.io.IOException - if an I/O error occurs.
    +
    java.io.IOException
    @@ -512,29 +448,11 @@

    writeBytes

    The semantics of writeBytes(String s) are considered dangerous. Please use writeUTF(String s), writeChars(String s) or another write method instead.
    -
    Description copied from interface: java.io.DataOutput
    -
    Writes a string to the output stream. - For every character in the string - s, taken in order, one byte - is written to the output stream. If - s is null, a NullPointerException - is thrown.

    If s.length - is zero, then no bytes are written. Otherwise, - the character s[0] is written - first, then s[1], and so on; - the last character written is s[s.length-1]. - For each character, one byte is written, - the low-order byte, in exactly the manner - of the writeByte method . The - high-order eight bits of each character - in the string are ignored.

    Specified by:
    writeBytes in interface java.io.DataOutput
    -
    Parameters:
    -
    s - the string of bytes to be written.
    Throws:
    -
    java.io.IOException - if an I/O error occurs.
    +
    java.io.IOException
    @@ -551,8 +469,6 @@

    writeChar

    Specified by:
    writeChar in interface java.io.DataOutput
    -
    Parameters:
    -
    v - the char value to be written.
    Throws:
    java.io.IOException - if an I/O error occurs
    @@ -571,8 +487,6 @@

    writeChars

    Specified by:
    writeChars in interface java.io.DataOutput
    -
    Parameters:
    -
    s - the string value to be written.
    Throws:
    java.io.IOException - if an I/O error occurs
    @@ -591,8 +505,6 @@

    writeDouble

    Specified by:
    writeDouble in interface java.io.DataOutput
    -
    Parameters:
    -
    v - the double value to be written.
    Throws:
    java.io.IOException - if an I/O error occurs
    @@ -611,8 +523,6 @@

    writeFloat

    Specified by:
    writeFloat in interface java.io.DataOutput
    -
    Parameters:
    -
    v - the float value to be written.
    Throws:
    java.io.IOException - if an I/O error occurs
    @@ -631,8 +541,6 @@

    writeInt

    Specified by:
    writeInt in interface java.io.DataOutput
    -
    Parameters:
    -
    v - the int value to be written.
    Throws:
    java.io.IOException - if an I/O error occurs
    @@ -651,8 +559,6 @@

    writeLong

    Specified by:
    writeLong in interface java.io.DataOutput
    -
    Parameters:
    -
    v - the long value to be written.
    Throws:
    java.io.IOException - if an I/O error occurs
    @@ -671,8 +577,6 @@

    writeShort

    Specified by:
    writeShort in interface java.io.DataOutput
    -
    Parameters:
    -
    v - the short value to be written.
    Throws:
    java.io.IOException - if an I/O error occurs
    @@ -686,61 +590,11 @@

    writeShort

    writeUTF

    public void writeUTF​(java.lang.String str)
               throws java.io.IOException
    -
    Description copied from interface: java.io.DataOutput
    -
    Writes two bytes of length information - to the output stream, followed - by the - modified UTF-8 - representation - of every character in the string s. - If s is null, - a NullPointerException is thrown. - Each character in the string s - is converted to a group of one, two, or - three bytes, depending on the value of the - character.

    - If a character c - is in the range \u0001 through - \u007f, it is represented - by one byte: - 

    (byte)c

    - If a character c is \u0000 - or is in the range \u0080 - through \u07ff, then it is - represented by two bytes, to be written - in the order shown: 

    
- (byte)(0xc0 | (0x1f & (c >> 6)))
- (byte)(0x80 | (0x3f & c))
-

    If a character - c is in the range \u0800 - through uffff, then it is - represented by three bytes, to be written - in the order shown: 

    
- (byte)(0xe0 | (0x0f & (c >> 12)))
- (byte)(0x80 | (0x3f & (c >>  6)))
- (byte)(0x80 | (0x3f & c))
-

    First, - the total number of bytes needed to represent - all the characters of s is - calculated. If this number is larger than - 65535, then a UTFDataFormatException - is thrown. Otherwise, this length is written - to the output stream in exactly the manner - of the writeShort method; - after this, the one-, two-, or three-byte - representation of each character in the - string s is written.

    The - bytes written by this method may be read - by the readUTF method of interface - DataInput , which will then - return a String equal to s.

    Specified by:
    writeUTF in interface java.io.DataOutput
    -
    Parameters:
    -
    str - the string value to be written.
    Throws:
    -
    java.io.IOException - if an I/O error occurs.
    +
    java.io.IOException
    @@ -752,13 +606,6 @@

    writeUTF

    close

    public void close()
            throws java.io.IOException
    -
    Description copied from class: java.io.FilterOutputStream
    -
    Closes this output stream and releases any system resources - associated with the stream. -

    - When not already closed, the close method of - FilterOutputStream calls its flush method, and then - calls the close method of its underlying output stream.

    Specified by:
    close in interface java.lang.AutoCloseable
    @@ -767,10 +614,7 @@

    close

    Overrides:
    close in class java.io.FilterOutputStream
    Throws:
    -
    java.io.IOException - if an I/O error occurs.
    -
    See Also:
    -
    FilterOutputStream.flush(), -FilterOutputStream.out
    +
    java.io.IOException
    diff --git a/releases/snapshot-android/api/docs/com/google/common/io/PatternFilenameFilter.html b/releases/snapshot-android/api/docs/com/google/common/io/PatternFilenameFilter.html index 39d963077963..e692bb365d1d 100644 --- a/releases/snapshot-android/api/docs/com/google/common/io/PatternFilenameFilter.html +++ b/releases/snapshot-android/api/docs/com/google/common/io/PatternFilenameFilter.html @@ -202,9 +202,7 @@

    Method Summary

    boolean accept​(java.io.File dir, java.lang.String fileName) - -
    Tests if a specified file should be included in a file list.
    - + 
      @@ -278,17 +276,9 @@

      Method Detail

      accept

      public boolean accept​(java.io.File dir,
                       java.lang.String fileName)
      -
      Description copied from interface: java.io.FilenameFilter
      -
      Tests if a specified file should be included in a file list.
      Specified by:
      accept in interface java.io.FilenameFilter
      -
      Parameters:
      -
      dir - the directory in which the file was found.
      -
      fileName - the name of the file.
      -
      Returns:
      -
      true if and only if the name should be - included in the file list; false otherwise.
    diff --git a/releases/snapshot-android/api/docs/com/google/common/math/PairedStats.html b/releases/snapshot-android/api/docs/com/google/common/math/PairedStats.html index 07a7997b995e..2be2891b2356 100644 --- a/releases/snapshot-android/api/docs/com/google/common/math/PairedStats.html +++ b/releases/snapshot-android/api/docs/com/google/common/math/PairedStats.html @@ -181,9 +181,6 @@

    Method Summary

    boolean equals​(java.lang.Object obj) - -
    Indicates whether some other object is "equal to" this one.
    - static PairedStats @@ -196,9 +193,6 @@

    Method Summary

    int hashCode() - -
    Returns a hash code value for the object.
    - LinearTransformation @@ -240,9 +234,7 @@

    Method Summary

    java.lang.String toString() - -
    Returns a string representation of the object.
    - +  Stats @@ -424,44 +416,7 @@

    Non-finite values

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object obj)
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes. +

    Note: This tests exact equality of the calculated statistics, including the floating point values. Two instances are guaranteed to be considered equal if one is copied from the @@ -477,14 +432,6 @@

    equals

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -495,45 +442,13 @@

    equals

  • hashCode

    public int hashCode()
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.) +

    Note: This hash code is consistent with exact equality of the calculated statistics, including the floating point values. See the note on equals(java.lang.Object) for details.

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -544,29 +459,9 @@

    hashCode

  • toString

    public java.lang.String toString()
    -
    Description copied from class: java.lang.Object
    -
    Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

    - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

    - 
    - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/math/Stats.html b/releases/snapshot-android/api/docs/com/google/common/math/Stats.html index ba2b2a2b1328..e759cf0c51f1 100644 --- a/releases/snapshot-android/api/docs/com/google/common/math/Stats.html +++ b/releases/snapshot-android/api/docs/com/google/common/math/Stats.html @@ -197,9 +197,6 @@

    Method Summary

    boolean equals​(java.lang.Object obj) - -
    Indicates whether some other object is "equal to" this one.
    - static Stats @@ -211,9 +208,6 @@

    Method Summary

    int hashCode() - -
    Returns a hash code value for the object.
    - double @@ -361,9 +355,7 @@

    Method Summary

    java.lang.String toString() - -
    Returns a string representation of the object.
    - + 
      @@ -662,44 +654,7 @@

      Non-finite values

      equals

      public boolean equals​(@CheckForNull
                       java.lang.Object obj)
      -
      Indicates whether some other object is "equal to" this one. -

      - The equals method implements an equivalence relation - on non-null object references: -

        -
      • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
      • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
      • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
      • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
      • For any non-null reference value x, - x.equals(null) should return false. -
      -

      - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

      - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes. +

      Note: This tests exact equality of the calculated statistics, including the floating point values. Two instances are guaranteed to be considered equal if one is copied from the @@ -715,14 +670,6 @@

      equals

      Overrides:
      equals in class java.lang.Object
      -
      Parameters:
      -
      obj - the reference object with which to compare.
      -
      Returns:
      -
      true if this object is the same as the obj - argument; false otherwise.
      -
      See Also:
      -
      Object.hashCode(), -HashMap
    @@ -733,45 +680,13 @@

    equals

  • hashCode

    public int hashCode()
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.) +

    Note: This hash code is consistent with exact equality of the calculated statistics, including the floating point values. See the note on equals(java.lang.Object) for details.

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -782,29 +697,9 @@

    hashCode

  • toString

    public java.lang.String toString()
    -
    Description copied from class: java.lang.Object
    -
    Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

    - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

    - 
    - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/net/HostAndPort.html b/releases/snapshot-android/api/docs/com/google/common/net/HostAndPort.html index 193e98729486..1cc56f96cda5 100644 --- a/releases/snapshot-android/api/docs/com/google/common/net/HostAndPort.html +++ b/releases/snapshot-android/api/docs/com/google/common/net/HostAndPort.html @@ -200,9 +200,7 @@

    Method Summary

    boolean equals​(java.lang.Object other) - -
    Indicates whether some other object is "equal to" this one.
    - +  static HostAndPort @@ -251,9 +249,7 @@

    Method Summary

    int hashCode() - -
    Returns a hash code value for the object.
    - +  boolean @@ -482,56 +478,9 @@

    requireBracketsForIPv6

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object other)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    other - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -542,43 +491,9 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -593,8 +508,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-android/api/docs/com/google/common/net/HostSpecifier.html b/releases/snapshot-android/api/docs/com/google/common/net/HostSpecifier.html index 14e1973dd284..2cc8a7f551fb 100644 --- a/releases/snapshot-android/api/docs/com/google/common/net/HostSpecifier.html +++ b/releases/snapshot-android/api/docs/com/google/common/net/HostSpecifier.html @@ -178,9 +178,7 @@

    Method Summary

    boolean equals​(java.lang.Object other) - -
    Indicates whether some other object is "equal to" this one.
    - +  static HostSpecifier @@ -201,9 +199,7 @@

    Method Summary

    int hashCode() - -
    Returns a hash code value for the object.
    - +  static boolean @@ -306,56 +302,9 @@

    isValid

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object other)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    other - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -366,43 +315,9 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -420,8 +335,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-android/api/docs/com/google/common/net/InternetDomainName.html b/releases/snapshot-android/api/docs/com/google/common/net/InternetDomainName.html index 2dcee6c65441..d4bcca8cec39 100644 --- a/releases/snapshot-android/api/docs/com/google/common/net/InternetDomainName.html +++ b/releases/snapshot-android/api/docs/com/google/common/net/InternetDomainName.html @@ -221,9 +221,7 @@

    Method Summary

    int hashCode() - -
    Returns a hash code value for the object.
    - +  boolean @@ -768,8 +766,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    @@ -787,14 +783,6 @@

    equals

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -805,43 +793,9 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/net/MediaType.html b/releases/snapshot-android/api/docs/com/google/common/net/MediaType.html index 327fc0f81c17..8c88eda2eace 100644 --- a/releases/snapshot-android/api/docs/com/google/common/net/MediaType.html +++ b/releases/snapshot-android/api/docs/com/google/common/net/MediaType.html @@ -959,16 +959,12 @@

    Method Summary

    boolean equals​(java.lang.Object obj) - -
    Indicates whether some other object is "equal to" this one.
    - +  int hashCode() - -
    Returns a hash code value for the object.
    - +  boolean @@ -2703,56 +2699,9 @@

    parse

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object obj)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -2763,43 +2712,9 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -2814,8 +2729,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-android/api/docs/com/google/common/primitives/ImmutableDoubleArray.html b/releases/snapshot-android/api/docs/com/google/common/primitives/ImmutableDoubleArray.html index 394375212f97..e27cb93b2356 100644 --- a/releases/snapshot-android/api/docs/com/google/common/primitives/ImmutableDoubleArray.html +++ b/releases/snapshot-android/api/docs/com/google/common/primitives/ImmutableDoubleArray.html @@ -747,14 +747,6 @@

    equals

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -769,11 +761,6 @@

    hashCode

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    @@ -788,8 +775,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-android/api/docs/com/google/common/primitives/ImmutableIntArray.html b/releases/snapshot-android/api/docs/com/google/common/primitives/ImmutableIntArray.html index 375cf5727c28..51545ae09175 100644 --- a/releases/snapshot-android/api/docs/com/google/common/primitives/ImmutableIntArray.html +++ b/releases/snapshot-android/api/docs/com/google/common/primitives/ImmutableIntArray.html @@ -745,14 +745,6 @@

    equals

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -767,11 +759,6 @@

    hashCode

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    @@ -786,8 +773,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-android/api/docs/com/google/common/primitives/ImmutableLongArray.html b/releases/snapshot-android/api/docs/com/google/common/primitives/ImmutableLongArray.html index 1923c3da4969..8e0314ad5add 100644 --- a/releases/snapshot-android/api/docs/com/google/common/primitives/ImmutableLongArray.html +++ b/releases/snapshot-android/api/docs/com/google/common/primitives/ImmutableLongArray.html @@ -746,14 +746,6 @@

    equals

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -768,11 +760,6 @@

    hashCode

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    @@ -787,8 +774,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-android/api/docs/com/google/common/primitives/UnsignedInteger.html b/releases/snapshot-android/api/docs/com/google/common/primitives/UnsignedInteger.html index 8e29a99dbc84..7ca0a1247b2f 100644 --- a/releases/snapshot-android/api/docs/com/google/common/primitives/UnsignedInteger.html +++ b/releases/snapshot-android/api/docs/com/google/common/primitives/UnsignedInteger.html @@ -245,9 +245,7 @@

    Method Summary

    boolean equals​(java.lang.Object obj) - -
    Indicates whether some other object is "equal to" this one.
    - +  float @@ -267,9 +265,7 @@

    Method Summary

    int hashCode() - -
    Returns a hash code value for the object.
    - +  int @@ -598,9 +594,6 @@

    intValue

    Specified by:
    intValue in class java.lang.Number
    -
    Returns:
    -
    the numeric value represented by this object after conversion - to type int.
    @@ -615,9 +608,6 @@

    longValue

    Specified by:
    longValue in class java.lang.Number
    -
    Returns:
    -
    the numeric value represented by this object after conversion - to type long.
    @@ -633,9 +623,6 @@

    floatValue

    Specified by:
    floatValue in class java.lang.Number
    -
    Returns:
    -
    the numeric value represented by this object after conversion - to type float.
    @@ -651,9 +638,6 @@

    doubleValue

    Specified by:
    doubleValue in class java.lang.Number
    -
    Returns:
    -
    the numeric value represented by this object after conversion - to type double.
    @@ -680,11 +664,6 @@

    compareTo

    Specified by:
    compareTo in interface java.lang.Comparable<UnsignedInteger>
    -
    Parameters:
    -
    other - the object to be compared.
    -
    Returns:
    -
    a negative integer, zero, or a positive integer as this object - is less than, equal to, or greater than the specified object.
    @@ -695,43 +674,9 @@

    compareTo

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -743,56 +688,9 @@

    hashCode

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object obj)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -807,8 +705,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-android/api/docs/com/google/common/primitives/UnsignedLong.html b/releases/snapshot-android/api/docs/com/google/common/primitives/UnsignedLong.html index f338435ac80a..efe407b48266 100644 --- a/releases/snapshot-android/api/docs/com/google/common/primitives/UnsignedLong.html +++ b/releases/snapshot-android/api/docs/com/google/common/primitives/UnsignedLong.html @@ -223,9 +223,7 @@

    Method Summary

    int compareTo​(UnsignedLong o) - -
    Compares this object with the specified object for order.
    - +  UnsignedLong @@ -245,9 +243,7 @@

    Method Summary

    boolean equals​(java.lang.Object obj) - -
    Indicates whether some other object is "equal to" this one.
    - +  float @@ -267,9 +263,7 @@

    Method Summary

    int hashCode() - -
    Returns a hash code value for the object.
    - +  int @@ -600,9 +594,6 @@

    intValue

    Specified by:
    intValue in class java.lang.Number
    -
    Returns:
    -
    the numeric value represented by this object after conversion - to type int.
    @@ -621,9 +612,6 @@

    longValue

    Specified by:
    longValue in class java.lang.Number
    -
    Returns:
    -
    the numeric value represented by this object after conversion - to type long.
    @@ -639,9 +627,6 @@

    floatValue

    Specified by:
    floatValue in class java.lang.Number
    -
    Returns:
    -
    the numeric value represented by this object after conversion - to type float.
    @@ -657,9 +642,6 @@

    doubleValue

    Specified by:
    doubleValue in class java.lang.Number
    -
    Returns:
    -
    the numeric value represented by this object after conversion - to type double.
    @@ -680,45 +662,9 @@

    bigIntegerValue

  • compareTo

    public int compareTo​(UnsignedLong o)
    -
    Description copied from interface: java.lang.Comparable
    -
    Compares this object with the specified object for order. Returns a - negative integer, zero, or a positive integer as this object is less - than, equal to, or greater than the specified object. - -

    The implementor must ensure - sgn(x.compareTo(y)) == -sgn(y.compareTo(x)) - for all x and y. (This - implies that x.compareTo(y) must throw an exception iff - y.compareTo(x) throws an exception.) - -

    The implementor must also ensure that the relation is transitive: - (x.compareTo(y) > 0 && y.compareTo(z) > 0) implies - x.compareTo(z) > 0. - -

    Finally, the implementor must ensure that x.compareTo(y)==0 - implies that sgn(x.compareTo(z)) == sgn(y.compareTo(z)), for - all z. - -

    It is strongly recommended, but not strictly required that - (x.compareTo(y)==0) == (x.equals(y)). Generally speaking, any - class that implements the Comparable interface and violates - this condition should clearly indicate this fact. The recommended - language is "Note: this class has a natural ordering that is - inconsistent with equals." - -

    In the foregoing description, the notation - sgn(expression) designates the mathematical - signum function, which is defined to return one of -1, - 0, or 1 according to whether the value of - expression is negative, zero, or positive, respectively.

    Specified by:
    compareTo in interface java.lang.Comparable<UnsignedLong>
    -
    Parameters:
    -
    o - the object to be compared.
    -
    Returns:
    -
    a negative integer, zero, or a positive integer as this object - is less than, equal to, or greater than the specified object.
    • @@ -729,43 +675,9 @@

    compareTo

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -777,56 +689,9 @@

    hashCode

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object obj)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -841,8 +706,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-android/api/docs/com/google/common/reflect/AbstractInvocationHandler.html b/releases/snapshot-android/api/docs/com/google/common/reflect/AbstractInvocationHandler.html index 80aeff383563..a721fe8dbdcf 100644 --- a/releases/snapshot-android/api/docs/com/google/common/reflect/AbstractInvocationHandler.html +++ b/releases/snapshot-android/api/docs/com/google/common/reflect/AbstractInvocationHandler.html @@ -228,8 +228,17 @@

    Method Summary

    java.lang.reflect.Method method, @Nullable java.lang.Object[] args)     -
    Processes a method invocation on a proxy instance and returns - the result.
    +
    + + + proxy.hashCode() delegates to hashCode() + proxy.toString() delegates to toString() + proxy.equals(argument) returns true if: + + proxy and argument are of the same type + and equals(java.lang.Object) returns true for the InvocationHandler of argument + + other method calls are dispatched to handleInvocation(java.lang.Object, java.lang.reflect.Method, java.lang.Object[]).
    @@ -294,10 +303,7 @@

    invoke

    @CheckForNull @Nullable java.lang.Object[] args) throws java.lang.Throwable -
    Processes a method invocation on a proxy instance and returns - the result. This method will be invoked on an invocation handler - when a method is invoked on a proxy instance that it is - associated with. +
    • proxy.hashCode() delegates to hashCode() @@ -312,48 +318,8 @@

      invoke

      Specified by:
      invoke in interface java.lang.reflect.InvocationHandler
      -
      Parameters:
      -
      proxy - the proxy instance that the method was invoked on
      -
      method - the Method instance corresponding to - the interface method invoked on the proxy instance. The declaring - class of the Method object will be the interface that - the method was declared in, which may be a superinterface of the - proxy interface that the proxy class inherits the method through.
      -
      args - an array of objects containing the values of the - arguments passed in the method invocation on the proxy instance, - or null if interface method takes no arguments. - Arguments of primitive types are wrapped in instances of the - appropriate primitive wrapper class, such as - java.lang.Integer or java.lang.Boolean.
      -
      Returns:
      -
      the value to return from the method invocation on the - proxy instance. If the declared return type of the interface - method is a primitive type, then the value returned by - this method must be an instance of the corresponding primitive - wrapper class; otherwise, it must be a type assignable to the - declared return type. If the value returned by this method is - null and the interface method's return type is - primitive, then a NullPointerException will be - thrown by the method invocation on the proxy instance. If the - value returned by this method is otherwise not compatible with - the interface method's declared return type as described above, - a ClassCastException will be thrown by the method - invocation on the proxy instance.
      Throws:
      -
      java.lang.Throwable - the exception to throw from the method - invocation on the proxy instance. The exception's type must be - assignable either to any of the exception types declared in the - throws clause of the interface method or to the - unchecked exception types java.lang.RuntimeException - or java.lang.Error. If a checked exception is - thrown by this method that is not assignable to any of the - exception types declared in the throws clause of - the interface method, then an - UndeclaredThrowableException containing the - exception that was thrown by this method will be thrown by the - method invocation on the proxy instance.
      -
      See Also:
      -
      UndeclaredThrowableException
      +
      java.lang.Throwable
    @@ -400,14 +366,6 @@

    equals

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -423,11 +381,6 @@

    hashCode

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    @@ -444,8 +397,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-android/api/docs/com/google/common/reflect/ClassPath.ClassInfo.html b/releases/snapshot-android/api/docs/com/google/common/reflect/ClassPath.ClassInfo.html index 2b728533a2a5..165d8a4f7d82 100644 --- a/releases/snapshot-android/api/docs/com/google/common/reflect/ClassPath.ClassInfo.html +++ b/releases/snapshot-android/api/docs/com/google/common/reflect/ClassPath.ClassInfo.html @@ -207,9 +207,7 @@

    Method Summary

    java.lang.String toString() - -
    Returns a string representation of the object.
    - + 
      @@ -328,29 +326,9 @@

      load

    • toString

      public java.lang.String toString()
      -
      Description copied from class: java.lang.Object
      -
      Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

      - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

      - 
      - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
      Overrides:
      toString in class ClassPath.ResourceInfo
      -
      Returns:
      -
      a string representation of the object.
    diff --git a/releases/snapshot-android/api/docs/com/google/common/reflect/ClassPath.ResourceInfo.html b/releases/snapshot-android/api/docs/com/google/common/reflect/ClassPath.ResourceInfo.html index 0d8c4ac30e32..f636f2432fd8 100644 --- a/releases/snapshot-android/api/docs/com/google/common/reflect/ClassPath.ResourceInfo.html +++ b/releases/snapshot-android/api/docs/com/google/common/reflect/ClassPath.ResourceInfo.html @@ -186,9 +186,7 @@

    Method Summary

    boolean equals​(java.lang.Object obj) - -
    Indicates whether some other object is "equal to" this one.
    - +  java.lang.String @@ -200,16 +198,12 @@

    Method Summary

    int hashCode() - -
    Returns a hash code value for the object.
    - +  java.lang.String toString() - -
    Returns a string representation of the object.
    - +  java.net.URL @@ -311,43 +305,9 @@

    getResourceName

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -359,56 +319,9 @@

    hashCode

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object obj)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -419,29 +332,9 @@

    equals

  • toString

    public java.lang.String toString()
    -
    Description copied from class: java.lang.Object
    -
    Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

    - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

    - 
    - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/reflect/ImmutableTypeToInstanceMap.html b/releases/snapshot-android/api/docs/com/google/common/reflect/ImmutableTypeToInstanceMap.html index f3eb7e180f22..631e1adb78da 100644 --- a/releases/snapshot-android/api/docs/com/google/common/reflect/ImmutableTypeToInstanceMap.html +++ b/releases/snapshot-android/api/docs/com/google/common/reflect/ImmutableTypeToInstanceMap.html @@ -196,7 +196,7 @@

    Nested classes/interfaces inherited from class com.google.common.collec

    Nested classes/interfaces inherited from interface java.util.Map

    -java.util.Map.Entry<K,​V> +java.util.Map.Entry<K extends java.lang.Object,​V extends java.lang.Object> @@ -344,12 +344,6 @@

    Method Detail

    of

    public static <B> ImmutableTypeToInstanceMap<B> of()
    Returns an empty type to instance map.
    -
    -
    Type Parameters:
    -
    B - the Map's key type
    -
    Returns:
    -
    an empty Map
    -
    @@ -479,15 +473,6 @@

    put

    put in interface java.util.Map<TypeToken<? extends B>,​B>
    Overrides:
    put in class ForwardingMap<TypeToken<? extends B>,​B>
    -
    Parameters:
    -
    key - key with which the specified value is to be associated
    -
    value - value to be associated with the specified key
    -
    Returns:
    -
    the previous value associated with key, or - null if there was no mapping for key. - (A null return can also indicate that the map - previously associated null with key, - if the implementation supports null values.)
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -510,8 +495,6 @@

    putAll

    putAll in interface java.util.Map<TypeToken<? extends B>,​B>
    Overrides:
    putAll in class ForwardingMap<TypeToken<? extends B>,​B>
    -
    Parameters:
    -
    map - mappings to be stored in this map
    Throws:
    java.lang.UnsupportedOperationException - always
    diff --git a/releases/snapshot-android/api/docs/com/google/common/reflect/Invokable.html b/releases/snapshot-android/api/docs/com/google/common/reflect/Invokable.html index 39dbb7c630c3..aee24bfd853f 100644 --- a/releases/snapshot-android/api/docs/com/google/common/reflect/Invokable.html +++ b/releases/snapshot-android/api/docs/com/google/common/reflect/Invokable.html @@ -210,9 +210,7 @@

    Method Summary

    boolean equals​(java.lang.Object obj) - -
    Indicates whether some other object is "equal to" this one.
    - +  static <T> Invokable<T,​T> @@ -231,32 +229,22 @@

    Method Summary

    <A extends java.lang.annotation.Annotation>
    A     getAnnotation​(java.lang.Class<A> annotationClass) - -
    Returns this element's annotation for the specified type if - such an annotation is present, else null.
    - +  java.lang.annotation.Annotation[] getAnnotations() - -
    Returns annotations that are present on this element.
    - +  java.lang.annotation.Annotation[] getDeclaredAnnotations() - -
    Returns annotations that are directly present on this element.
    - +  java.lang.Class<? super T> getDeclaringClass() - -
    Returns the Class object representing the class or interface - that declares the member or constructor represented by this Member.
    - +  ImmutableList<TypeToken<? extends java.lang.Throwable>> @@ -268,18 +256,12 @@

    Method Summary

    int getModifiers() - -
    Returns the Java language modifiers for the member or - constructor represented by this Member, as an integer.
    - +  java.lang.String getName() - -
    Returns the simple name of the underlying member or constructor - represented by this Member.
    - +  TypeToken<T> @@ -312,9 +294,7 @@

    Method Summary

    int hashCode() - -
    Returns a hash code value for the object.
    - +  R @@ -343,10 +323,7 @@

    Method Summary

    boolean isAnnotationPresent​(java.lang.Class<? extends java.lang.annotation.Annotation> annotationClass) - -
    Returns true if an annotation for the specified type - is present on this element, else false.
    - +  boolean @@ -414,10 +391,7 @@

    Method Summary

    boolean isSynthetic() - -
    Returns true if this member was introduced by - the compiler; returns false otherwise.
    - +  abstract boolean @@ -450,9 +424,7 @@

    Method Summary

    java.lang.String toString() - -
    Returns a string representation of the object.
    - +  boolean @@ -519,25 +491,9 @@

    from

  • isAnnotationPresent

    public final boolean isAnnotationPresent​(java.lang.Class<? extends java.lang.annotation.Annotation> annotationClass)
    -
    Description copied from interface: java.lang.reflect.AnnotatedElement
    -
    Returns true if an annotation for the specified type - is present on this element, else false. This method - is designed primarily for convenient access to marker annotations. - -

    The truth value returned by this method is equivalent to: - getAnnotation(annotationClass) != null - -

    The body of the default method is specified to be the code - above.

    Specified by:
    isAnnotationPresent in interface java.lang.reflect.AnnotatedElement
    -
    Parameters:
    -
    annotationClass - the Class object corresponding to the - annotation type
    -
    Returns:
    -
    true if an annotation for the specified annotation - type is present on this element, else false
    • @@ -549,20 +505,9 @@

    isAnnotationPresent

    getAnnotation

    @CheckForNull
 public final <A extends java.lang.annotation.Annotation> A getAnnotation​(java.lang.Class<A> annotationClass)
    -
    Description copied from interface: java.lang.reflect.AnnotatedElement
    -
    Returns this element's annotation for the specified type if - such an annotation is present, else null.
    Specified by:
    getAnnotation in interface java.lang.reflect.AnnotatedElement
    -
    Type Parameters:
    -
    A - the type of the annotation to query for and return if present
    -
    Parameters:
    -
    annotationClass - the Class object corresponding to the - annotation type
    -
    Returns:
    -
    this element's annotation for the specified annotation type if - present on this element, else null
    @@ -573,19 +518,9 @@

    getAnnotation

  • getAnnotations

    public final java.lang.annotation.Annotation[] getAnnotations()
    -
    Description copied from interface: java.lang.reflect.AnnotatedElement
    -
    Returns annotations that are present on this element. - - If there are no annotations present on this element, the return - value is an array of length 0. - - The caller of this method is free to modify the returned array; it will - have no effect on the arrays returned to other callers.
    Specified by:
    getAnnotations in interface java.lang.reflect.AnnotatedElement
    -
    Returns:
    -
    annotations present on this element
    • @@ -596,20 +531,9 @@

    getAnnotations

  • getDeclaredAnnotations

    public final java.lang.annotation.Annotation[] getDeclaredAnnotations()
    -
    Description copied from interface: java.lang.reflect.AnnotatedElement
    -
    Returns annotations that are directly present on this element. - This method ignores inherited annotations. - - If there are no annotations directly present on this element, - the return value is an array of length 0. - - The caller of this method is free to modify the returned array; it will - have no effect on the arrays returned to other callers.
    Specified by:
    getDeclaredAnnotations in interface java.lang.reflect.AnnotatedElement
    -
    Returns:
    -
    annotations directly present on this element
    • @@ -660,14 +584,9 @@

    isAccessible

  • getName

    public final java.lang.String getName()
    -
    Description copied from interface: java.lang.reflect.Member
    -
    Returns the simple name of the underlying member or constructor - represented by this Member.
    Specified by:
    getName in interface java.lang.reflect.Member
    -
    Returns:
    -
    the simple name of the underlying member
    • @@ -678,18 +597,9 @@

    getName

  • getModifiers

    public final int getModifiers()
    -
    Description copied from interface: java.lang.reflect.Member
    -
    Returns the Java language modifiers for the member or - constructor represented by this Member, as an integer. The - Modifier class should be used to decode the modifiers in - the integer.
    Specified by:
    getModifiers in interface java.lang.reflect.Member
    -
    Returns:
    -
    the Java language modifiers for the underlying member
    -
    See Also:
    -
    Modifier
    • @@ -700,15 +610,9 @@

    getModifiers

  • isSynthetic

    public final boolean isSynthetic()
    -
    Description copied from interface: java.lang.reflect.Member
    -
    Returns true if this member was introduced by - the compiler; returns false otherwise.
    Specified by:
    isSynthetic in interface java.lang.reflect.Member
    -
    Returns:
    -
    true if and only if this member was introduced by - the compiler.
    • @@ -814,56 +718,9 @@

    isSynchronized

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object obj)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -874,43 +731,9 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -921,29 +744,9 @@

    hashCode

  • toString

    public java.lang.String toString()
    -
    Description copied from class: java.lang.Object
    -
    Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

    - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

    - 
    - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    • @@ -1062,15 +865,9 @@

    returning

  • getDeclaringClass

    public final java.lang.Class<? super T> getDeclaringClass()
    -
    Description copied from interface: java.lang.reflect.Member
    -
    Returns the Class object representing the class or interface - that declares the member or constructor represented by this Member.
    Specified by:
    getDeclaringClass in interface java.lang.reflect.Member
    -
    Returns:
    -
    an object representing the declaring class of the - underlying member
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/reflect/MutableTypeToInstanceMap.html b/releases/snapshot-android/api/docs/com/google/common/reflect/MutableTypeToInstanceMap.html index ecc2eee172f0..1dd5d408f6ad 100644 --- a/releases/snapshot-android/api/docs/com/google/common/reflect/MutableTypeToInstanceMap.html +++ b/releases/snapshot-android/api/docs/com/google/common/reflect/MutableTypeToInstanceMap.html @@ -184,7 +184,7 @@

    Nested classes/interfaces inherited from class com.google.common.collec

    Nested classes/interfaces inherited from interface java.util.Map

    -java.util.Map.Entry<K,​V> +java.util.Map.Entry<K extends java.lang.Object,​V extends java.lang.Object> @@ -234,9 +234,7 @@

    Method Summary

    java.util.Set<java.util.Map.Entry<TypeToken<? extends B>,​B>> entrySet() - -
    Returns a Set view of the mappings contained in this map.
    - +  <T extends B>
    T     @@ -465,15 +463,6 @@

    put

    put in interface java.util.Map<TypeToken<? extends B>,​B>
    Overrides:
    put in class ForwardingMap<TypeToken<? extends B>,​B>
    -
    Parameters:
    -
    key - key with which the specified value is to be associated
    -
    value - value to be associated with the specified key
    -
    Returns:
    -
    the previous value associated with key, or - null if there was no mapping for key. - (A null return can also indicate that the map - previously associated null with key, - if the implementation supports null values.)
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -496,8 +485,6 @@

    putAll

    putAll in interface java.util.Map<TypeToken<? extends B>,​B>
    Overrides:
    putAll in class ForwardingMap<TypeToken<? extends B>,​B>
    -
    Parameters:
    -
    map - mappings to be stored in this map
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -510,26 +497,11 @@

    putAll

  • entrySet

    public java.util.Set<java.util.Map.Entry<TypeToken<? extends B>,​B>> entrySet()
    -
    Description copied from interface: java.util.Map
    -
    Returns a Set view of the mappings contained in this map. - The set is backed by the map, so changes to the map are - reflected in the set, and vice-versa. If the map is modified - while an iteration over the set is in progress (except through - the iterator's own remove operation, or through the - setValue operation on a map entry returned by the - iterator) the results of the iteration are undefined. The set - supports element removal, which removes the corresponding - mapping from the map, via the Iterator.remove, - Set.remove, removeAll, retainAll and - clear operations. It does not support the - add or addAll operations.
    Specified by:
    entrySet in interface java.util.Map<TypeToken<? extends B>,​B>
    Overrides:
    entrySet in class ForwardingMap<TypeToken<? extends B>,​B>
    -
    Returns:
    -
    a set view of the mappings contained in this map
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/reflect/Parameter.html b/releases/snapshot-android/api/docs/com/google/common/reflect/Parameter.html index 5bb974616233..30c48ada3d87 100644 --- a/releases/snapshot-android/api/docs/com/google/common/reflect/Parameter.html +++ b/releases/snapshot-android/api/docs/com/google/common/reflect/Parameter.html @@ -174,55 +174,37 @@

    Method Summary

    boolean equals​(java.lang.Object obj) - -
    Indicates whether some other object is "equal to" this one.
    - +  <A extends java.lang.annotation.Annotation>
    A     getAnnotation​(java.lang.Class<A> annotationType) - -
    Returns this element's annotation for the specified type if - such an annotation is present, else null.
    - +  java.lang.annotation.Annotation[] getAnnotations() - -
    Returns annotations that are present on this element.
    - +  <A extends java.lang.annotation.Annotation>
    A[]     getAnnotationsByType​(java.lang.Class<A> annotationType) - -
    Returns annotations that are associated with this element.
    - +  <A extends java.lang.annotation.Annotation>
    A     getDeclaredAnnotation​(java.lang.Class<A> annotationType) - -
    Returns this element's annotation for the specified type if - such an annotation is directly present, else null.
    - +  java.lang.annotation.Annotation[] getDeclaredAnnotations() - -
    Returns annotations that are directly present on this element.
    - +  <A extends java.lang.annotation.Annotation>
    A[]     getDeclaredAnnotationsByType​(java.lang.Class<A> annotationType) - -
    Returns this element's annotation(s) for the specified type if - such annotations are either directly present or - indirectly present.
    - +  Invokable<?,​?> @@ -241,24 +223,17 @@

    Method Summary

    int hashCode() - -
    Returns a hash code value for the object.
    - +  boolean isAnnotationPresent​(java.lang.Class<? extends java.lang.annotation.Annotation> annotationType) - -
    Returns true if an annotation for the specified type - is present on this element, else false.
    - +  java.lang.String toString() - -
    Returns a string representation of the object.
    - + 
      @@ -311,25 +286,9 @@

      getDeclaringInvokable

    • isAnnotationPresent

      public boolean isAnnotationPresent​(java.lang.Class<? extends java.lang.annotation.Annotation> annotationType)
      -
      Description copied from interface: java.lang.reflect.AnnotatedElement
      -
      Returns true if an annotation for the specified type - is present on this element, else false. This method - is designed primarily for convenient access to marker annotations. - -

      The truth value returned by this method is equivalent to: - getAnnotation(annotationClass) != null - -

      The body of the default method is specified to be the code - above.

      Specified by:
      isAnnotationPresent in interface java.lang.reflect.AnnotatedElement
      -
      Parameters:
      -
      annotationType - the Class object corresponding to the - annotation type
      -
      Returns:
      -
      true if an annotation for the specified annotation - type is present on this element, else false
    @@ -341,20 +300,9 @@

    isAnnotationPresent

    getAnnotation

    @CheckForNull
 public <A extends java.lang.annotation.Annotation> A getAnnotation​(java.lang.Class<A> annotationType)
    -
    Description copied from interface: java.lang.reflect.AnnotatedElement
    -
    Returns this element's annotation for the specified type if - such an annotation is present, else null.
    Specified by:
    getAnnotation in interface java.lang.reflect.AnnotatedElement
    -
    Type Parameters:
    -
    A - the type of the annotation to query for and return if present
    -
    Parameters:
    -
    annotationType - the Class object corresponding to the - annotation type
    -
    Returns:
    -
    this element's annotation for the specified annotation type if - present on this element, else null
    @@ -365,19 +313,9 @@

    getAnnotation

  • getAnnotations

    public java.lang.annotation.Annotation[] getAnnotations()
    -
    Description copied from interface: java.lang.reflect.AnnotatedElement
    -
    Returns annotations that are present on this element. - - If there are no annotations present on this element, the return - value is an array of length 0. - - The caller of this method is free to modify the returned array; it will - have no effect on the arrays returned to other callers.
    Specified by:
    getAnnotations in interface java.lang.reflect.AnnotatedElement
    -
    Returns:
    -
    annotations present on this element
    • @@ -388,31 +326,9 @@

    getAnnotations

  • getAnnotationsByType

    public <A extends java.lang.annotation.Annotation> A[] getAnnotationsByType​(java.lang.Class<A> annotationType)
    -
    Description copied from interface: java.lang.reflect.AnnotatedElement
    -
    Returns annotations that are associated with this element. - - If there are no annotations associated with this element, the return - value is an array of length 0. - - The difference between this method and AnnotatedElement.getAnnotation(Class) - is that this method detects if its argument is a repeatable - annotation type (JLS 9.6), and if so, attempts to find one or - more annotations of that type by "looking through" a container - annotation. - - The caller of this method is free to modify the returned array; it will - have no effect on the arrays returned to other callers.
    Specified by:
    getAnnotationsByType in interface java.lang.reflect.AnnotatedElement
    -
    Type Parameters:
    -
    A - the type of the annotation to query for and return if present
    -
    Parameters:
    -
    annotationType - the Class object corresponding to the - annotation type
    -
    Returns:
    -
    all this element's annotations for the specified annotation type if - associated with this element, else an array of length zero
    Since:
    18.0
    @@ -425,20 +341,9 @@

    getAnnotationsByType

  • getDeclaredAnnotations

    public java.lang.annotation.Annotation[] getDeclaredAnnotations()
    -
    Description copied from interface: java.lang.reflect.AnnotatedElement
    -
    Returns annotations that are directly present on this element. - This method ignores inherited annotations. - - If there are no annotations directly present on this element, - the return value is an array of length 0. - - The caller of this method is free to modify the returned array; it will - have no effect on the arrays returned to other callers.
    Specified by:
    getDeclaredAnnotations in interface java.lang.reflect.AnnotatedElement
    -
    Returns:
    -
    annotations directly present on this element
    Since:
    18.0
    @@ -452,23 +357,9 @@

    getDeclaredAnnotations

    getDeclaredAnnotation

    @CheckForNull
 public <A extends java.lang.annotation.Annotation> A getDeclaredAnnotation​(java.lang.Class<A> annotationType)
    -
    Description copied from interface: java.lang.reflect.AnnotatedElement
    -
    Returns this element's annotation for the specified type if - such an annotation is directly present, else null. - - This method ignores inherited annotations. (Returns null if no - annotations are directly present on this element.)
    Specified by:
    getDeclaredAnnotation in interface java.lang.reflect.AnnotatedElement
    -
    Type Parameters:
    -
    A - the type of the annotation to query for and return if directly present
    -
    Parameters:
    -
    annotationType - the Class object corresponding to the - annotation type
    -
    Returns:
    -
    this element's annotation for the specified annotation type if - directly present on this element, else null
    Since:
    18.0
    @@ -481,35 +372,9 @@

    getDeclaredAnnotation

  • getDeclaredAnnotationsByType

    public <A extends java.lang.annotation.Annotation> A[] getDeclaredAnnotationsByType​(java.lang.Class<A> annotationType)
    -
    Description copied from interface: java.lang.reflect.AnnotatedElement
    -
    Returns this element's annotation(s) for the specified type if - such annotations are either directly present or - indirectly present. This method ignores inherited - annotations. - - If there are no specified annotations directly or indirectly - present on this element, the return value is an array of length - 0. - - The difference between this method and AnnotatedElement.getDeclaredAnnotation(Class) is that this method detects if its - argument is a repeatable annotation type (JLS 9.6), and if so, - attempts to find one or more annotations of that type by "looking - through" a container annotation if one is present. - - The caller of this method is free to modify the returned array; it will - have no effect on the arrays returned to other callers.
    Specified by:
    getDeclaredAnnotationsByType in interface java.lang.reflect.AnnotatedElement
    -
    Type Parameters:
    -
    A - the type of the annotation to query for and return - if directly or indirectly present
    -
    Parameters:
    -
    annotationType - the Class object corresponding to the - annotation type
    -
    Returns:
    -
    all this element's annotations for the specified annotation type if - directly or indirectly present on this element, else an array of length zero
    Since:
    18.0
    @@ -523,56 +388,9 @@

    getDeclaredAnnotationsByType

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object obj)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    • @@ -583,43 +401,9 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -630,29 +414,9 @@

    hashCode

  • toString

    public java.lang.String toString()
    -
    Description copied from class: java.lang.Object
    -
    Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

    - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

    - 
    - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/reflect/TypeParameter.html b/releases/snapshot-android/api/docs/com/google/common/reflect/TypeParameter.html index 8c5b3af1b2aa..0df1a30715d9 100644 --- a/releases/snapshot-android/api/docs/com/google/common/reflect/TypeParameter.html +++ b/releases/snapshot-android/api/docs/com/google/common/reflect/TypeParameter.html @@ -194,23 +194,17 @@

    Method Summary

    boolean equals​(java.lang.Object o) - -
    Indicates whether some other object is "equal to" this one.
    - +  int hashCode() - -
    Returns a hash code value for the object.
    - +  java.lang.String toString() - -
    Returns a string representation of the object.
    - + 
      @@ -262,43 +256,9 @@

      Method Detail

    • hashCode

      public final int hashCode()
      -
      Description copied from class: java.lang.Object
      -
      Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

      - The general contract of hashCode is: -

        -
      • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
      • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
      • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
      -

      - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

      Overrides:
      hashCode in class java.lang.Object
      -
      Returns:
      -
      a hash code value for this object.
      -
      See Also:
      -
      Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    @@ -310,56 +270,9 @@

    hashCode

    equals

    public final boolean equals​(@CheckForNull
                             java.lang.Object o)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    o - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -370,29 +283,9 @@

    equals

  • toString

    public java.lang.String toString()
    -
    Description copied from class: java.lang.Object
    -
    Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

    - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

    - 
    - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/reflect/TypeToInstanceMap.html b/releases/snapshot-android/api/docs/com/google/common/reflect/TypeToInstanceMap.html index da3f7f00c6c0..5493670ef9dc 100644 --- a/releases/snapshot-android/api/docs/com/google/common/reflect/TypeToInstanceMap.html +++ b/releases/snapshot-android/api/docs/com/google/common/reflect/TypeToInstanceMap.html @@ -178,7 +178,7 @@

    Nested Class Summary

    Nested classes/interfaces inherited from interface java.util.Map

    -java.util.Map.Entry<K,​V> +java.util.Map.Entry<K extends java.lang.Object,​V extends java.lang.Object> diff --git a/releases/snapshot-android/api/docs/com/google/common/reflect/TypeToken.html b/releases/snapshot-android/api/docs/com/google/common/reflect/TypeToken.html index fcac8efe8f99..0f603247d8cf 100644 --- a/releases/snapshot-android/api/docs/com/google/common/reflect/TypeToken.html +++ b/releases/snapshot-android/api/docs/com/google/common/reflect/TypeToken.html @@ -326,9 +326,7 @@

    Method Summary

    int hashCode() - -
    Returns a hash code value for the object.
    - +  boolean @@ -404,9 +402,7 @@

    Method Summary

    java.lang.String toString() - -
    Returns a string representation of the object.
    - +  TypeToken<T> @@ -867,14 +863,6 @@

    equals

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    o - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -885,43 +873,9 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -932,29 +886,9 @@

    hashCode

  • toString

    public java.lang.String toString()
    -
    Description copied from class: java.lang.Object
    -
    Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

    - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

    - 
    - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/util/concurrent/AbstractExecutionThreadService.html b/releases/snapshot-android/api/docs/com/google/common/util/concurrent/AbstractExecutionThreadService.html index ec89c942cd9c..ae4f87902078 100644 --- a/releases/snapshot-android/api/docs/com/google/common/util/concurrent/AbstractExecutionThreadService.html +++ b/releases/snapshot-android/api/docs/com/google/common/util/concurrent/AbstractExecutionThreadService.html @@ -326,9 +326,7 @@

    Method Summary

    java.lang.String toString() - -
    Returns a string representation of the object.
    - +  protected void @@ -484,29 +482,9 @@

    executor

  • toString

    public java.lang.String toString()
    -
    Description copied from class: java.lang.Object
    -
    Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

    - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

    - 
    - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/util/concurrent/AbstractFuture.html b/releases/snapshot-android/api/docs/com/google/common/util/concurrent/AbstractFuture.html index f77d6d4b9b9e..93ba312aa58c 100644 --- a/releases/snapshot-android/api/docs/com/google/common/util/concurrent/AbstractFuture.html +++ b/releases/snapshot-android/api/docs/com/google/common/util/concurrent/AbstractFuture.html @@ -227,26 +227,15 @@

    Method Summary

    boolean cancel​(boolean mayInterruptIfRunning) - -
    Attempts to cancel execution of this task.
    - V get() - -
    Waits if necessary for the computation to complete, and then - retrieves its result.
    - V get​(long timeout, java.util.concurrent.TimeUnit unit) - -
    Waits if necessary for at most the given time for the computation - to complete, and then retrieves its result, if available.
    - protected void @@ -258,17 +247,12 @@

    Method Summary

    boolean isCancelled() - -
    Returns true if this task was cancelled before it completed - normally.
    - +  boolean isDone() - -
    Returns true if this task completed.
    - +  protected java.lang.String @@ -305,9 +289,7 @@

    Method Summary

    java.lang.String toString() - -
    Returns a string representation of the object.
    - +  protected java.lang.Throwable @@ -381,26 +363,18 @@

    get

    throws java.lang.InterruptedException, java.util.concurrent.TimeoutException, java.util.concurrent.ExecutionException -
    Waits if necessary for at most the given time for the computation - to complete, and then retrieves its result, if available. +

    The default AbstractFuture implementation throws InterruptedException if the current thread is interrupted during the call, even if the value is already available.

    Specified by:
    get in interface java.util.concurrent.Future<V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    timeout - the maximum time to wait
    -
    unit - the time unit of the timeout argument
    -
    Returns:
    -
    the computed result
    Throws:
    -
    java.util.concurrent.CancellationException - if the computation was cancelled
    -
    java.lang.InterruptedException - if the current thread was interrupted - while waiting
    -
    java.util.concurrent.TimeoutException - if the wait timed out
    -
    java.util.concurrent.ExecutionException - if the computation threw an - exception
    +
    java.util.concurrent.CancellationException
    +
    java.lang.InterruptedException
    +
    java.util.concurrent.TimeoutException
    +
    java.util.concurrent.ExecutionException
    @@ -414,22 +388,17 @@

    get

    public V get() throws java.lang.InterruptedException, java.util.concurrent.ExecutionException -
    Waits if necessary for the computation to complete, and then - retrieves its result. +

    The default AbstractFuture implementation throws InterruptedException if the current thread is interrupted during the call, even if the value is already available.

    Specified by:
    get in interface java.util.concurrent.Future<V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the computed result
    Throws:
    -
    java.util.concurrent.CancellationException - if the computation was cancelled
    -
    java.lang.InterruptedException - if the current thread was interrupted - while waiting
    -
    java.util.concurrent.ExecutionException - if the computation threw an - exception
    +
    java.util.concurrent.CancellationException
    +
    java.lang.InterruptedException
    +
    java.util.concurrent.ExecutionException
    @@ -440,17 +409,9 @@

    get

  • isDone

    public boolean isDone()
    -
    Description copied from interface: java.util.concurrent.Future
    -
    Returns true if this task completed. - - Completion may be due to normal termination, an exception, or - cancellation -- in all of these cases, this method will return - true.
    Specified by:
    isDone in interface java.util.concurrent.Future<V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    true if this task completed
    • @@ -461,14 +422,9 @@

    isDone

  • isCancelled

    public boolean isCancelled()
    -
    Description copied from interface: java.util.concurrent.Future
    -
    Returns true if this task was cancelled before it completed - normally.
    Specified by:
    isCancelled in interface java.util.concurrent.Future<V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    true if this task was cancelled before it completed
    • @@ -480,18 +436,7 @@

    isCancelled

    cancel

    @CanIgnoreReturnValue
 public boolean cancel​(boolean mayInterruptIfRunning)
    -
    Attempts to cancel execution of this task. This attempt will - fail if the task has already completed, has already been cancelled, - or could not be cancelled for some other reason. If successful, - and this task has not started when cancel is called, - this task should never run. If the task has already started, - then the mayInterruptIfRunning parameter determines - whether the thread executing this task should be interrupted in - an attempt to stop the task. - -

    After this method returns, subsequent calls to Future.isDone() will - always return true. Subsequent calls to Future.isCancelled() - will always return true if this method returned true. +

    If a cancellation attempt succeeds on a Future that had previously been set asynchronously, then the cancellation will also be propagated to the delegate Future that was supplied in the setFuture call. @@ -506,14 +451,6 @@

    cancel

    Specified by:
    cancel in interface java.util.concurrent.Future<V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    mayInterruptIfRunning - true if the thread executing this - task should be interrupted; otherwise, in-progress tasks are allowed - to complete
    -
    Returns:
    -
    false if the task could not be cancelled, - typically because it has already completed normally; - true otherwise
    @@ -749,29 +686,9 @@

    tryInternalFastPathGetFailure

  • toString

    public java.lang.String toString()
    -
    Description copied from class: java.lang.Object
    -
    Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

    - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

    - 
    - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/util/concurrent/AbstractIdleService.html b/releases/snapshot-android/api/docs/com/google/common/util/concurrent/AbstractIdleService.html index 140c37f803e2..1f06cd8f3c65 100644 --- a/releases/snapshot-android/api/docs/com/google/common/util/concurrent/AbstractIdleService.html +++ b/releases/snapshot-android/api/docs/com/google/common/util/concurrent/AbstractIdleService.html @@ -319,9 +319,7 @@

    Method Summary

    java.lang.String toString() - -
    Returns a string representation of the object.
    - + 
      @@ -417,29 +415,9 @@

      executor

    • toString

      public java.lang.String toString()
      -
      Description copied from class: java.lang.Object
      -
      Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

      - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

      - 
      - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
      Overrides:
      toString in class java.lang.Object
      -
      Returns:
      -
      a string representation of the object.
    diff --git a/releases/snapshot-android/api/docs/com/google/common/util/concurrent/AbstractListeningExecutorService.html b/releases/snapshot-android/api/docs/com/google/common/util/concurrent/AbstractListeningExecutorService.html index 643898440b98..ecb6d0682297 100644 --- a/releases/snapshot-android/api/docs/com/google/common/util/concurrent/AbstractListeningExecutorService.html +++ b/releases/snapshot-android/api/docs/com/google/common/util/concurrent/AbstractListeningExecutorService.html @@ -204,42 +204,28 @@

    Method Summary

    protected <T extends @Nullable java.lang.Object>
    java.util.concurrent.RunnableFuture<T>     newTaskFor​(java.lang.Runnable runnable, T value) - -
    Returns a RunnableFuture for the given runnable and default - value.
    - +  protected <T extends @Nullable java.lang.Object>
    java.util.concurrent.RunnableFuture<T>     newTaskFor​(java.util.concurrent.Callable<T> callable) - -
    Returns a RunnableFuture for the given callable task.
    - +  ListenableFuture<?> submit​(java.lang.Runnable task) - -
    Submits a Runnable task for execution and returns a Future - representing that task.
    - +  <T extends @Nullable java.lang.Object>
    ListenableFuture<T>     submit​(java.lang.Runnable task, T result) - -
    Submits a Runnable task for execution and returns a Future - representing that task.
    - +  <T extends @Nullable java.lang.Object>
    ListenableFuture<T>     submit​(java.util.concurrent.Callable<T> task) - -
    Submits a value-returning task for execution and returns a - Future representing the pending results of the task.
    - + 
      @@ -323,22 +309,9 @@

      newTaskFor

      @CanIgnoreReturnValue
 protected final <T extends @Nullable java.lang.Object> java.util.concurrent.RunnableFuture<T> newTaskFor​(java.lang.Runnable runnable,
                                                                                                          T value)
      -
      Description copied from class: java.util.concurrent.AbstractExecutorService
      -
      Returns a RunnableFuture for the given runnable and default - value.
      Overrides:
      newTaskFor in class java.util.concurrent.AbstractExecutorService
      -
      Type Parameters:
      -
      T - the type of the given value
      -
      Parameters:
      -
      runnable - the runnable task being wrapped
      -
      value - the default value for the returned future
      -
      Returns:
      -
      a RunnableFuture which, when run, will run the - underlying runnable and which, as a Future, will yield - the given value as its result and provide for cancellation of - the underlying task
      Since:
      19.0 (present with return type ListenableFutureTask since 14.0)
      @@ -352,20 +325,9 @@

      newTaskFor

      newTaskFor

      @CanIgnoreReturnValue
 protected final <T extends @Nullable java.lang.Object> java.util.concurrent.RunnableFuture<T> newTaskFor​(java.util.concurrent.Callable<T> callable)
      -
      Description copied from class: java.util.concurrent.AbstractExecutorService
      -
      Returns a RunnableFuture for the given callable task.
      Overrides:
      newTaskFor in class java.util.concurrent.AbstractExecutorService
      -
      Type Parameters:
      -
      T - the type of the callable's result
      -
      Parameters:
      -
      callable - the callable task being wrapped
      -
      Returns:
      -
      a RunnableFuture which, when run, will call the - underlying callable and which, as a Future, will yield - the callable's result as its result and provide for - cancellation of the underlying task
      Since:
      19.0 (present with return type ListenableFutureTask since 14.0)
      @@ -379,10 +341,6 @@

      newTaskFor

      submit

      @CanIgnoreReturnValue
 public ListenableFuture<?> submit​(java.lang.Runnable task)
      -
      Description copied from interface: java.util.concurrent.ExecutorService
      -
      Submits a Runnable task for execution and returns a Future - representing that task. The Future's get method will - return null upon successful completion.
      Specified by:
      submit in interface java.util.concurrent.ExecutorService
      @@ -390,10 +348,8 @@

      submit

      submit in interface ListeningExecutorService
      Overrides:
      submit in class java.util.concurrent.AbstractExecutorService
      -
      Parameters:
      -
      task - the task to submit
      Returns:
      -
      a Future representing pending completion of the task
      +
      a ListenableFuture representing pending completion of the task
    @@ -408,10 +364,6 @@

    submit

    @CanIgnoreReturnValue
 public <T extends @Nullable java.lang.Object> ListenableFuture<T> submit​(java.lang.Runnable task,
                                                                          T result)
    -
    Description copied from interface: java.util.concurrent.ExecutorService
    -
    Submits a Runnable task for execution and returns a Future - representing that task. The Future's get method will - return the given result upon successful completion.
    Specified by:
    submit in interface java.util.concurrent.ExecutorService
    @@ -419,13 +371,8 @@

    submit

    submit in interface ListeningExecutorService
    Overrides:
    submit in class java.util.concurrent.AbstractExecutorService
    -
    Type Parameters:
    -
    T - the type of the result
    -
    Parameters:
    -
    task - the task to submit
    -
    result - the result to return
    Returns:
    -
    a Future representing pending completion of the task
    +
    a ListenableFuture representing pending completion of the task
    @@ -437,21 +384,6 @@

    submit

    submit

    @CanIgnoreReturnValue
 public <T extends @Nullable java.lang.Object> ListenableFuture<T> submit​(java.util.concurrent.Callable<T> task)
    -
    Description copied from interface: java.util.concurrent.ExecutorService
    -
    Submits a value-returning task for execution and returns a - Future representing the pending results of the task. The - Future's get method will return the task's result upon - successful completion. - -

    - If you would like to immediately block waiting - for a task, you can use constructions of the form - result = exec.submit(aCallable).get(); - -

    Note: The Executors class includes a set of methods - that can convert some other common closure-like objects, - for example, PrivilegedAction to - Callable form so they can be submitted.

    Specified by:
    submit in interface java.util.concurrent.ExecutorService
    @@ -459,12 +391,8 @@

    submit

    submit in interface ListeningExecutorService
    Overrides:
    submit in class java.util.concurrent.AbstractExecutorService
    -
    Type Parameters:
    -
    T - the type of the task's result
    -
    Parameters:
    -
    task - the task to submit
    Returns:
    -
    a Future representing pending completion of the task
    +
    a ListenableFuture representing pending completion of the task
    diff --git a/releases/snapshot-android/api/docs/com/google/common/util/concurrent/AbstractScheduledService.html b/releases/snapshot-android/api/docs/com/google/common/util/concurrent/AbstractScheduledService.html index b1f4dccfafd6..f56db37c60e7 100644 --- a/releases/snapshot-android/api/docs/com/google/common/util/concurrent/AbstractScheduledService.html +++ b/releases/snapshot-android/api/docs/com/google/common/util/concurrent/AbstractScheduledService.html @@ -404,9 +404,7 @@

    Method Summary

    java.lang.String toString() - -
    Returns a string representation of the object.
    - + 
      @@ -555,29 +553,9 @@

      serviceName

    • toString

      public java.lang.String toString()
      -
      Description copied from class: java.lang.Object
      -
      Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

      - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

      - 
      - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
      Overrides:
      toString in class java.lang.Object
      -
      Returns:
      -
      a string representation of the object.
    diff --git a/releases/snapshot-android/api/docs/com/google/common/util/concurrent/AbstractService.html b/releases/snapshot-android/api/docs/com/google/common/util/concurrent/AbstractService.html index 5c2010b6f5bf..aae84c6f7227 100644 --- a/releases/snapshot-android/api/docs/com/google/common/util/concurrent/AbstractService.html +++ b/releases/snapshot-android/api/docs/com/google/common/util/concurrent/AbstractService.html @@ -333,9 +333,7 @@

    Method Summary

    java.lang.String toString() - -
    Returns a string representation of the object.
    - + 
      @@ -689,29 +687,9 @@

      addListener

    • toString

      public java.lang.String toString()
      -
      Description copied from class: java.lang.Object
      -
      Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

      - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

      - 
      - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
      Overrides:
      toString in class java.lang.Object
      -
      Returns:
      -
      a string representation of the object.
    diff --git a/releases/snapshot-android/api/docs/com/google/common/util/concurrent/AtomicDouble.html b/releases/snapshot-android/api/docs/com/google/common/util/concurrent/AtomicDouble.html index 55b41a5cb0de..69c7d0d24d65 100644 --- a/releases/snapshot-android/api/docs/com/google/common/util/concurrent/AtomicDouble.html +++ b/releases/snapshot-android/api/docs/com/google/common/util/concurrent/AtomicDouble.html @@ -545,9 +545,6 @@

    intValue

    Specified by:
    intValue in class java.lang.Number
    -
    Returns:
    -
    the numeric value represented by this object after conversion - to type int.
    @@ -563,9 +560,6 @@

    longValue

    Specified by:
    longValue in class java.lang.Number
    -
    Returns:
    -
    the numeric value represented by this object after conversion - to type long.
    @@ -581,9 +575,6 @@

    floatValue

    Specified by:
    floatValue in class java.lang.Number
    -
    Returns:
    -
    the numeric value represented by this object after conversion - to type float.
    @@ -598,9 +589,6 @@

    doubleValue

    Specified by:
    doubleValue in class java.lang.Number
    -
    Returns:
    -
    the numeric value represented by this object after conversion - to type double.
    diff --git a/releases/snapshot-android/api/docs/com/google/common/util/concurrent/AtomicLongMap.html b/releases/snapshot-android/api/docs/com/google/common/util/concurrent/AtomicLongMap.html index 88147f4239f4..21f5fe90b6e7 100644 --- a/releases/snapshot-android/api/docs/com/google/common/util/concurrent/AtomicLongMap.html +++ b/releases/snapshot-android/api/docs/com/google/common/util/concurrent/AtomicLongMap.html @@ -334,9 +334,7 @@

    Method Summary

    java.lang.String toString() - -
    Returns a string representation of the object.
    - + 
      @@ -623,29 +621,9 @@

      clear

    • toString

      public java.lang.String toString()
      -
      Description copied from class: java.lang.Object
      -
      Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

      - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

      - 
      - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
      Overrides:
      toString in class java.lang.Object
      -
      Returns:
      -
      a string representation of the object.
    diff --git a/releases/snapshot-android/api/docs/com/google/common/util/concurrent/ClosingFuture.html b/releases/snapshot-android/api/docs/com/google/common/util/concurrent/ClosingFuture.html index 25ba172734a7..1fc11cd65e12 100644 --- a/releases/snapshot-android/api/docs/com/google/common/util/concurrent/ClosingFuture.html +++ b/releases/snapshot-android/api/docs/com/google/common/util/concurrent/ClosingFuture.html @@ -440,10 +440,7 @@

    Method Summary

    protected void finalize() - -
    Called by the garbage collector on an object when garbage collection - determines that there are no more references to the object.
    - +  FluentFuture<V> @@ -493,9 +490,7 @@

    Method Summary

    java.lang.String toString() - -
    Returns a string representation of the object.
    - +  <U extends @Nullable java.lang.Object>
    ClosingFuture<U>     @@ -1248,29 +1243,9 @@

    cancel

  • toString

    public java.lang.String toString()
    -
    Description copied from class: java.lang.Object
    -
    Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

    - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

    - 
    - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    • @@ -1281,56 +1256,9 @@

    toString

  • finalize

    protected void finalize()
    -
    Description copied from class: java.lang.Object
    -
    Called by the garbage collector on an object when garbage collection - determines that there are no more references to the object. - A subclass overrides the finalize method to dispose of - system resources or to perform other cleanup. -

    - The general contract of finalize is that it is invoked - if and when the Java™ virtual - machine has determined that there is no longer any - means by which this object can be accessed by any thread that has - not yet died, except as a result of an action taken by the - finalization of some other object or class which is ready to be - finalized. The finalize method may take any action, including - making this object available again to other threads; the usual purpose - of finalize, however, is to perform cleanup actions before - the object is irrevocably discarded. For example, the finalize method - for an object that represents an input/output connection might perform - explicit I/O transactions to break the connection before the object is - permanently discarded. -

    - The finalize method of class Object performs no - special action; it simply returns normally. Subclasses of - Object may override this definition. -

    - The Java programming language does not guarantee which thread will - invoke the finalize method for any given object. It is - guaranteed, however, that the thread that invokes finalize will not - be holding any user-visible synchronization locks when finalize is - invoked. If an uncaught exception is thrown by the finalize method, - the exception is ignored and finalization of that object terminates. -

    - After the finalize method has been invoked for an object, no - further action is taken until the Java virtual machine has again - determined that there is no longer any means by which this object can - be accessed by any thread that has not yet died, including possible - actions by other objects or classes which are ready to be finalized, - at which point the object may be discarded. -

    - The finalize method is never invoked more than once by a Java - virtual machine for any given object. -

    - Any exception thrown by the finalize method causes - the finalization of this object to be halted, but is otherwise - ignored.

    Overrides:
    finalize in class java.lang.Object
    -
    See Also:
    -
    WeakReference, -PhantomReference
    • diff --git a/releases/snapshot-android/api/docs/com/google/common/util/concurrent/CycleDetectingLockFactory.PotentialDeadlockException.html b/releases/snapshot-android/api/docs/com/google/common/util/concurrent/CycleDetectingLockFactory.PotentialDeadlockException.html index debbfaf86f3d..447c860cfc12 100644 --- a/releases/snapshot-android/api/docs/com/google/common/util/concurrent/CycleDetectingLockFactory.PotentialDeadlockException.html +++ b/releases/snapshot-android/api/docs/com/google/common/util/concurrent/CycleDetectingLockFactory.PotentialDeadlockException.html @@ -270,9 +270,6 @@

    getMessage

    Overrides:
    getMessage in class java.lang.Throwable
    -
    Returns:
    -
    the detail message string of this Throwable instance - (which may be null).
    diff --git a/releases/snapshot-android/api/docs/com/google/common/util/concurrent/ForwardingBlockingDeque.html b/releases/snapshot-android/api/docs/com/google/common/util/concurrent/ForwardingBlockingDeque.html index a83e5313ed01..1fc362f8da66 100644 --- a/releases/snapshot-android/api/docs/com/google/common/util/concurrent/ForwardingBlockingDeque.html +++ b/releases/snapshot-android/api/docs/com/google/common/util/concurrent/ForwardingBlockingDeque.html @@ -237,142 +237,87 @@

    Method Summary

    int drainTo​(java.util.Collection<? super E> c) - -
    Removes all available elements from this queue and adds them - to the given collection.
    - +  int drainTo​(java.util.Collection<? super E> c, int maxElements) - -
    Removes at most the given number of available elements from - this queue and adds them to the given collection.
    - +  boolean offer​(E e, long timeout, java.util.concurrent.TimeUnit unit) - -
    Inserts the specified element into the queue represented by this deque - (in other words, at the tail of this deque), waiting up to the - specified wait time if necessary for space to become available.
    - +  boolean offerFirst​(E e, long timeout, java.util.concurrent.TimeUnit unit) - -
    Inserts the specified element at the front of this deque, - waiting up to the specified wait time if necessary for space to - become available.
    - +  boolean offerLast​(E e, long timeout, java.util.concurrent.TimeUnit unit) - -
    Inserts the specified element at the end of this deque, - waiting up to the specified wait time if necessary for space to - become available.
    - +  E poll​(long timeout, java.util.concurrent.TimeUnit unit) - -
    Retrieves and removes the head of the queue represented by this deque - (in other words, the first element of this deque), waiting up to the - specified wait time if necessary for an element to become available.
    - +  E pollFirst​(long timeout, java.util.concurrent.TimeUnit unit) - -
    Retrieves and removes the first element of this deque, waiting - up to the specified wait time if necessary for an element to - become available.
    - +  E pollLast​(long timeout, java.util.concurrent.TimeUnit unit) - -
    Retrieves and removes the last element of this deque, waiting - up to the specified wait time if necessary for an element to - become available.
    - +  void put​(E e) - -
    Inserts the specified element into the queue represented by this deque - (in other words, at the tail of this deque), waiting if necessary for - space to become available.
    - +  void putFirst​(E e) - -
    Inserts the specified element at the front of this deque, - waiting if necessary for space to become available.
    - +  void putLast​(E e) - -
    Inserts the specified element at the end of this deque, - waiting if necessary for space to become available.
    - +  int remainingCapacity() - -
    Returns the number of additional elements that this queue can ideally - (in the absence of memory or resource constraints) accept without - blocking, or Integer.MAX_VALUE if there is no intrinsic - limit.
    - +  E take() - -
    Retrieves and removes the head of the queue represented by this deque - (in other words, the first element of this deque), waiting if - necessary until an element becomes available.
    - +  E takeFirst() - -
    Retrieves and removes the first element of this deque, waiting - if necessary until an element becomes available.
    - +  E takeLast() - -
    Retrieves and removes the last element of this deque, waiting - if necessary until an element becomes available.
    - + 
      @@ -499,21 +444,9 @@

      delegate

    • remainingCapacity

      public int remainingCapacity()
      -
      Description copied from interface: java.util.concurrent.BlockingQueue
      -
      Returns the number of additional elements that this queue can ideally - (in the absence of memory or resource constraints) accept without - blocking, or Integer.MAX_VALUE if there is no intrinsic - limit. - -

      Note that you cannot always tell if an attempt to insert - an element will succeed by inspecting remainingCapacity - because it may be the case that another thread is about to - insert or remove an element.

      Specified by:
      remainingCapacity in interface java.util.concurrent.BlockingQueue<E>
      -
      Returns:
      -
      the remaining capacity
    @@ -527,16 +460,11 @@

    remainingCapacity

    putFirst

    public void putFirst​(E e)
               throws java.lang.InterruptedException
    -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Inserts the specified element at the front of this deque, - waiting if necessary for space to become available.
    Specified by:
    putFirst in interface java.util.concurrent.BlockingDeque<E>
    -
    Parameters:
    -
    e - the element to add
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -550,16 +478,11 @@

    putFirst

    putLast

    public void putLast​(E e)
              throws java.lang.InterruptedException
    -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Inserts the specified element at the end of this deque, - waiting if necessary for space to become available.
    Specified by:
    putLast in interface java.util.concurrent.BlockingDeque<E>
    -
    Parameters:
    -
    e - the element to add
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -575,24 +498,11 @@

    offerFirst

    long timeout, java.util.concurrent.TimeUnit unit) throws java.lang.InterruptedException -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Inserts the specified element at the front of this deque, - waiting up to the specified wait time if necessary for space to - become available.
    Specified by:
    offerFirst in interface java.util.concurrent.BlockingDeque<E>
    -
    Parameters:
    -
    e - the element to add
    -
    timeout - how long to wait before giving up, in units of - unit
    -
    unit - a TimeUnit determining how to interpret the - timeout parameter
    -
    Returns:
    -
    true if successful, or false if - the specified waiting time elapses before space is available
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -608,24 +518,11 @@

    offerLast

    long timeout, java.util.concurrent.TimeUnit unit) throws java.lang.InterruptedException -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Inserts the specified element at the end of this deque, - waiting up to the specified wait time if necessary for space to - become available.
    Specified by:
    offerLast in interface java.util.concurrent.BlockingDeque<E>
    -
    Parameters:
    -
    e - the element to add
    -
    timeout - how long to wait before giving up, in units of - unit
    -
    unit - a TimeUnit determining how to interpret the - timeout parameter
    -
    Returns:
    -
    true if successful, or false if - the specified waiting time elapses before space is available
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -637,16 +534,11 @@

    offerLast

    takeFirst

    public E takeFirst()
             throws java.lang.InterruptedException
    -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Retrieves and removes the first element of this deque, waiting - if necessary until an element becomes available.
    Specified by:
    takeFirst in interface java.util.concurrent.BlockingDeque<E>
    -
    Returns:
    -
    the head of this deque
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -658,16 +550,11 @@

    takeFirst

    takeLast

    public E takeLast()
            throws java.lang.InterruptedException
    -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Retrieves and removes the last element of this deque, waiting - if necessary until an element becomes available.
    Specified by:
    takeLast in interface java.util.concurrent.BlockingDeque<E>
    -
    Returns:
    -
    the tail of this deque
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -681,23 +568,11 @@

    pollFirst

    public E pollFirst​(long timeout, java.util.concurrent.TimeUnit unit) throws java.lang.InterruptedException -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Retrieves and removes the first element of this deque, waiting - up to the specified wait time if necessary for an element to - become available.
    Specified by:
    pollFirst in interface java.util.concurrent.BlockingDeque<E>
    -
    Parameters:
    -
    timeout - how long to wait before giving up, in units of - unit
    -
    unit - a TimeUnit determining how to interpret the - timeout parameter
    -
    Returns:
    -
    the head of this deque, or null if the specified - waiting time elapses before an element is available
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -711,23 +586,11 @@

    pollLast

    public E pollLast​(long timeout, java.util.concurrent.TimeUnit unit) throws java.lang.InterruptedException -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Retrieves and removes the last element of this deque, waiting - up to the specified wait time if necessary for an element to - become available.
    Specified by:
    pollLast in interface java.util.concurrent.BlockingDeque<E>
    -
    Parameters:
    -
    timeout - how long to wait before giving up, in units of - unit
    -
    unit - a TimeUnit determining how to interpret the - timeout parameter
    -
    Returns:
    -
    the tail of this deque, or null if the specified - waiting time elapses before an element is available
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -741,21 +604,13 @@

    pollLast

    put

    public void put​(E e)
          throws java.lang.InterruptedException
    -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Inserts the specified element into the queue represented by this deque - (in other words, at the tail of this deque), waiting if necessary for - space to become available. - -

    This method is equivalent to putLast.

    Specified by:
    put in interface java.util.concurrent.BlockingDeque<E>
    Specified by:
    put in interface java.util.concurrent.BlockingQueue<E>
    -
    Parameters:
    -
    e - the element to add
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -771,29 +626,13 @@

    offer

    long timeout, java.util.concurrent.TimeUnit unit) throws java.lang.InterruptedException -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Inserts the specified element into the queue represented by this deque - (in other words, at the tail of this deque), waiting up to the - specified wait time if necessary for space to become available. - -

    This method is equivalent to - offerLast.

    Specified by:
    offer in interface java.util.concurrent.BlockingDeque<E>
    Specified by:
    offer in interface java.util.concurrent.BlockingQueue<E>
    -
    Parameters:
    -
    e - the element to add
    -
    timeout - how long to wait before giving up, in units of - unit
    -
    unit - a TimeUnit determining how to interpret the - timeout parameter
    -
    Returns:
    -
    true if the element was added to this deque, else - false
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -805,21 +644,13 @@

    offer

    take

    public E take()
        throws java.lang.InterruptedException
    -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Retrieves and removes the head of the queue represented by this deque - (in other words, the first element of this deque), waiting if - necessary until an element becomes available. - -

    This method is equivalent to takeFirst.

    Specified by:
    take in interface java.util.concurrent.BlockingDeque<E>
    Specified by:
    take in interface java.util.concurrent.BlockingQueue<E>
    -
    Returns:
    -
    the head of this deque
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -833,28 +664,13 @@

    poll

    public E poll​(long timeout, java.util.concurrent.TimeUnit unit) throws java.lang.InterruptedException -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Retrieves and removes the head of the queue represented by this deque - (in other words, the first element of this deque), waiting up to the - specified wait time if necessary for an element to become available. - -

    This method is equivalent to - pollFirst.

    Specified by:
    poll in interface java.util.concurrent.BlockingDeque<E>
    Specified by:
    poll in interface java.util.concurrent.BlockingQueue<E>
    -
    Parameters:
    -
    timeout - how long to wait before giving up, in units of - unit
    -
    unit - a TimeUnit determining how to interpret the - timeout parameter
    -
    Returns:
    -
    the head of this deque, or null if the - specified waiting time elapses before an element is available
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -865,24 +681,9 @@

    poll

  • drainTo

    public int drainTo​(java.util.Collection<? super E> c)
    -
    Description copied from interface: java.util.concurrent.BlockingQueue
    -
    Removes all available elements from this queue and adds them - to the given collection. This operation may be more - efficient than repeatedly polling this queue. A failure - encountered while attempting to add elements to - collection c may result in elements being in neither, - either or both collections when the associated exception is - thrown. Attempts to drain a queue to itself result in - IllegalArgumentException. Further, the behavior of - this operation is undefined if the specified collection is - modified while the operation is in progress.
    Specified by:
    drainTo in interface java.util.concurrent.BlockingQueue<E>
    -
    Parameters:
    -
    c - the collection to transfer elements into
    -
    Returns:
    -
    the number of elements transferred
    • @@ -894,24 +695,9 @@

    drainTo

    drainTo

    public int drainTo​(java.util.Collection<? super E> c,
                    int maxElements)
    -
    Description copied from interface: java.util.concurrent.BlockingQueue
    -
    Removes at most the given number of available elements from - this queue and adds them to the given collection. A failure - encountered while attempting to add elements to - collection c may result in elements being in neither, - either or both collections when the associated exception is - thrown. Attempts to drain a queue to itself result in - IllegalArgumentException. Further, the behavior of - this operation is undefined if the specified collection is - modified while the operation is in progress.
    Specified by:
    drainTo in interface java.util.concurrent.BlockingQueue<E>
    -
    Parameters:
    -
    c - the collection to transfer elements into
    -
    maxElements - the maximum number of elements to transfer
    -
    Returns:
    -
    the number of elements transferred
    diff --git a/releases/snapshot-android/api/docs/com/google/common/util/concurrent/ForwardingBlockingQueue.html b/releases/snapshot-android/api/docs/com/google/common/util/concurrent/ForwardingBlockingQueue.html index 7470df157e90..e469383e5450 100644 --- a/releases/snapshot-android/api/docs/com/google/common/util/concurrent/ForwardingBlockingQueue.html +++ b/releases/snapshot-android/api/docs/com/google/common/util/concurrent/ForwardingBlockingQueue.html @@ -228,64 +228,41 @@

    Method Summary

    int drainTo​(java.util.Collection<? super E> c) - -
    Removes all available elements from this queue and adds them - to the given collection.
    - +  int drainTo​(java.util.Collection<? super E> c, int maxElements) - -
    Removes at most the given number of available elements from - this queue and adds them to the given collection.
    - +  boolean offer​(E e, long timeout, java.util.concurrent.TimeUnit unit) - -
    Inserts the specified element into this queue, waiting up to the - specified wait time if necessary for space to become available.
    - +  E poll​(long timeout, java.util.concurrent.TimeUnit unit) - -
    Retrieves and removes the head of this queue, waiting up to the - specified wait time if necessary for an element to become available.
    - +  void put​(E e) - -
    Inserts the specified element into this queue, waiting if necessary - for space to become available.
    - +  int remainingCapacity() - -
    Returns the number of additional elements that this queue can ideally - (in the absence of memory or resource constraints) accept without - blocking, or Integer.MAX_VALUE if there is no intrinsic - limit.
    - +  E take() - -
    Retrieves and removes the head of this queue, waiting if necessary - until an element becomes available.
    - + 
      @@ -407,24 +384,9 @@

      drainTo

      @CanIgnoreReturnValue
 public int drainTo​(java.util.Collection<? super E> c,
                    int maxElements)
      -
      Description copied from interface: java.util.concurrent.BlockingQueue
      -
      Removes at most the given number of available elements from - this queue and adds them to the given collection. A failure - encountered while attempting to add elements to - collection c may result in elements being in neither, - either or both collections when the associated exception is - thrown. Attempts to drain a queue to itself result in - IllegalArgumentException. Further, the behavior of - this operation is undefined if the specified collection is - modified while the operation is in progress.
      Specified by:
      drainTo in interface java.util.concurrent.BlockingQueue<E>
      -
      Parameters:
      -
      c - the collection to transfer elements into
      -
      maxElements - the maximum number of elements to transfer
      -
      Returns:
      -
      the number of elements transferred
    @@ -436,24 +398,9 @@

    drainTo

    drainTo

    @CanIgnoreReturnValue
 public int drainTo​(java.util.Collection<? super E> c)
    -
    Description copied from interface: java.util.concurrent.BlockingQueue
    -
    Removes all available elements from this queue and adds them - to the given collection. This operation may be more - efficient than repeatedly polling this queue. A failure - encountered while attempting to add elements to - collection c may result in elements being in neither, - either or both collections when the associated exception is - thrown. Attempts to drain a queue to itself result in - IllegalArgumentException. Further, the behavior of - this operation is undefined if the specified collection is - modified while the operation is in progress.
    Specified by:
    drainTo in interface java.util.concurrent.BlockingQueue<E>
    -
    Parameters:
    -
    c - the collection to transfer elements into
    -
    Returns:
    -
    the number of elements transferred
    @@ -470,23 +417,11 @@

    offer

    long timeout, java.util.concurrent.TimeUnit unit) throws java.lang.InterruptedException -
    Description copied from interface: java.util.concurrent.BlockingQueue
    -
    Inserts the specified element into this queue, waiting up to the - specified wait time if necessary for space to become available.
    Specified by:
    offer in interface java.util.concurrent.BlockingQueue<E>
    -
    Parameters:
    -
    e - the element to add
    -
    timeout - how long to wait before giving up, in units of - unit
    -
    unit - a TimeUnit determining how to interpret the - timeout parameter
    -
    Returns:
    -
    true if successful, or false if - the specified waiting time elapses before space is available
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -501,22 +436,11 @@

    poll

    public E poll​(long timeout, java.util.concurrent.TimeUnit unit) throws java.lang.InterruptedException -
    Description copied from interface: java.util.concurrent.BlockingQueue
    -
    Retrieves and removes the head of this queue, waiting up to the - specified wait time if necessary for an element to become available.
    Specified by:
    poll in interface java.util.concurrent.BlockingQueue<E>
    -
    Parameters:
    -
    timeout - how long to wait before giving up, in units of - unit
    -
    unit - a TimeUnit determining how to interpret the - timeout parameter
    -
    Returns:
    -
    the head of this queue, or null if the - specified waiting time elapses before an element is available
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -530,16 +454,11 @@

    poll

    put

    public void put​(E e)
          throws java.lang.InterruptedException
    -
    Description copied from interface: java.util.concurrent.BlockingQueue
    -
    Inserts the specified element into this queue, waiting if necessary - for space to become available.
    Specified by:
    put in interface java.util.concurrent.BlockingQueue<E>
    -
    Parameters:
    -
    e - the element to add
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -550,21 +469,9 @@

    put

  • remainingCapacity

    public int remainingCapacity()
    -
    Description copied from interface: java.util.concurrent.BlockingQueue
    -
    Returns the number of additional elements that this queue can ideally - (in the absence of memory or resource constraints) accept without - blocking, or Integer.MAX_VALUE if there is no intrinsic - limit. - -

    Note that you cannot always tell if an attempt to insert - an element will succeed by inspecting remainingCapacity - because it may be the case that another thread is about to - insert or remove an element.

    Specified by:
    remainingCapacity in interface java.util.concurrent.BlockingQueue<E>
    -
    Returns:
    -
    the remaining capacity
    • @@ -577,16 +484,11 @@

    take

    @CanIgnoreReturnValue
 public E take()
        throws java.lang.InterruptedException
    -
    Description copied from interface: java.util.concurrent.BlockingQueue
    -
    Retrieves and removes the head of this queue, waiting if necessary - until an element becomes available.
    Specified by:
    take in interface java.util.concurrent.BlockingQueue<E>
    -
    Returns:
    -
    the head of this queue
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    diff --git a/releases/snapshot-android/api/docs/com/google/common/util/concurrent/ForwardingExecutorService.html b/releases/snapshot-android/api/docs/com/google/common/util/concurrent/ForwardingExecutorService.html index 920dc8454948..221375c674f0 100644 --- a/releases/snapshot-android/api/docs/com/google/common/util/concurrent/ForwardingExecutorService.html +++ b/releases/snapshot-android/api/docs/com/google/common/util/concurrent/ForwardingExecutorService.html @@ -207,11 +207,7 @@

    Method Summary

    boolean awaitTermination​(long timeout, java.util.concurrent.TimeUnit unit) - -
    Blocks until all tasks have completed execution after a shutdown - request, or the timeout occurs, or the current thread is - interrupted, whichever happens first.
    - +  protected abstract java.util.concurrent.ExecutorService @@ -223,104 +219,67 @@

    Method Summary

    void execute​(java.lang.Runnable command) - -
    Executes the given command at some time in the future.
    - +  <T extends @Nullable java.lang.Object>
    java.util.List<java.util.concurrent.Future<T>>     invokeAll​(java.util.Collection<? extends java.util.concurrent.Callable<T>> tasks) - -
    Executes the given tasks, returning a list of Futures holding - their status and results when all complete.
    - +  <T extends @Nullable java.lang.Object>
    java.util.List<java.util.concurrent.Future<T>>     invokeAll​(java.util.Collection<? extends java.util.concurrent.Callable<T>> tasks, long timeout, java.util.concurrent.TimeUnit unit) - -
    Executes the given tasks, returning a list of Futures holding - their status and results - when all complete or the timeout expires, whichever happens first.
    - +  <T extends @Nullable java.lang.Object>
    T     invokeAny​(java.util.Collection<? extends java.util.concurrent.Callable<T>> tasks) - -
    Executes the given tasks, returning the result - of one that has completed successfully (i.e., without throwing - an exception), if any do.
    - +  <T extends @Nullable java.lang.Object>
    T     invokeAny​(java.util.Collection<? extends java.util.concurrent.Callable<T>> tasks, long timeout, java.util.concurrent.TimeUnit unit) - -
    Executes the given tasks, returning the result - of one that has completed successfully (i.e., without throwing - an exception), if any do before the given timeout elapses.
    - +  boolean isShutdown() - -
    Returns true if this executor has been shut down.
    - +  boolean isTerminated() - -
    Returns true if all tasks have completed following shut down.
    - +  void shutdown() - -
    Initiates an orderly shutdown in which previously submitted - tasks are executed, but no new tasks will be accepted.
    - +  java.util.List<java.lang.Runnable> shutdownNow() - -
    Attempts to stop all actively executing tasks, halts the - processing of waiting tasks, and returns a list of the tasks - that were awaiting execution.
    - +  java.util.concurrent.Future<?> submit​(java.lang.Runnable task) - -
    Submits a Runnable task for execution and returns a Future - representing that task.
    - +  <T extends @Nullable java.lang.Object>
    java.util.concurrent.Future<T>     submit​(java.lang.Runnable task, T result) - -
    Submits a Runnable task for execution and returns a Future - representing that task.
    - +  <T extends @Nullable java.lang.Object>
    java.util.concurrent.Future<T>     submit​(java.util.concurrent.Callable<T> task) - -
    Submits a value-returning task for execution and returns a - Future representing the pending results of the task.
    - + 
      @@ -401,21 +360,11 @@

      awaitTermination

      public boolean awaitTermination​(long timeout, java.util.concurrent.TimeUnit unit) throws java.lang.InterruptedException -
      Description copied from interface: java.util.concurrent.ExecutorService
      -
      Blocks until all tasks have completed execution after a shutdown - request, or the timeout occurs, or the current thread is - interrupted, whichever happens first.
      Specified by:
      awaitTermination in interface java.util.concurrent.ExecutorService
      -
      Parameters:
      -
      timeout - the maximum time to wait
      -
      unit - the time unit of the timeout argument
      -
      Returns:
      -
      true if this executor terminated and - false if the timeout elapsed before termination
      Throws:
      -
      java.lang.InterruptedException - if interrupted while waiting
      +
      java.lang.InterruptedException
    @@ -427,29 +376,11 @@

    awaitTermination

    invokeAll

    public <T extends @Nullable java.lang.Object> java.util.List<java.util.concurrent.Future<T>> invokeAll​(java.util.Collection<? extends java.util.concurrent.Callable<T>> tasks)
                                                                                                 throws java.lang.InterruptedException
    -
    Description copied from interface: java.util.concurrent.ExecutorService
    -
    Executes the given tasks, returning a list of Futures holding - their status and results when all complete. - Future.isDone() is true for each - element of the returned list. - Note that a completed task could have - terminated either normally or by throwing an exception. - The results of this method are undefined if the given - collection is modified while this operation is in progress.
    Specified by:
    invokeAll in interface java.util.concurrent.ExecutorService
    -
    Type Parameters:
    -
    T - the type of the values returned from the tasks
    -
    Parameters:
    -
    tasks - the collection of tasks
    -
    Returns:
    -
    a list of Futures representing the tasks, in the same - sequential order as produced by the iterator for the - given task list, each of which has completed
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting, in - which case unfinished tasks are cancelled
    +
    java.lang.InterruptedException
    @@ -463,35 +394,11 @@

    invokeAll

    long timeout, java.util.concurrent.TimeUnit unit) throws java.lang.InterruptedException -
    Description copied from interface: java.util.concurrent.ExecutorService
    -
    Executes the given tasks, returning a list of Futures holding - their status and results - when all complete or the timeout expires, whichever happens first. - Future.isDone() is true for each - element of the returned list. - Upon return, tasks that have not completed are cancelled. - Note that a completed task could have - terminated either normally or by throwing an exception. - The results of this method are undefined if the given - collection is modified while this operation is in progress.
    Specified by:
    invokeAll in interface java.util.concurrent.ExecutorService
    -
    Type Parameters:
    -
    T - the type of the values returned from the tasks
    -
    Parameters:
    -
    tasks - the collection of tasks
    -
    timeout - the maximum time to wait
    -
    unit - the time unit of the timeout argument
    -
    Returns:
    -
    a list of Futures representing the tasks, in the same - sequential order as produced by the iterator for the - given task list. If the operation did not time out, - each task will have completed. If it did time out, some - of these tasks will not have completed.
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting, in - which case unfinished tasks are cancelled
    +
    java.lang.InterruptedException
    @@ -504,25 +411,12 @@

    invokeAny

    public <T extends @Nullable java.lang.Object> T invokeAny​(java.util.Collection<? extends java.util.concurrent.Callable<T>> tasks)
                                                    throws java.lang.InterruptedException,
                                                           java.util.concurrent.ExecutionException
    -
    Description copied from interface: java.util.concurrent.ExecutorService
    -
    Executes the given tasks, returning the result - of one that has completed successfully (i.e., without throwing - an exception), if any do. Upon normal or exceptional return, - tasks that have not completed are cancelled. - The results of this method are undefined if the given - collection is modified while this operation is in progress.
    Specified by:
    invokeAny in interface java.util.concurrent.ExecutorService
    -
    Type Parameters:
    -
    T - the type of the values returned from the tasks
    -
    Parameters:
    -
    tasks - the collection of tasks
    -
    Returns:
    -
    the result returned by one of the tasks
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    -
    java.util.concurrent.ExecutionException - if no task successfully completes
    +
    java.lang.InterruptedException
    +
    java.util.concurrent.ExecutionException
    @@ -538,30 +432,13 @@

    invokeAny

    throws java.lang.InterruptedException, java.util.concurrent.ExecutionException, java.util.concurrent.TimeoutException -
    Description copied from interface: java.util.concurrent.ExecutorService
    -
    Executes the given tasks, returning the result - of one that has completed successfully (i.e., without throwing - an exception), if any do before the given timeout elapses. - Upon normal or exceptional return, tasks that have not - completed are cancelled. - The results of this method are undefined if the given - collection is modified while this operation is in progress.
    Specified by:
    invokeAny in interface java.util.concurrent.ExecutorService
    -
    Type Parameters:
    -
    T - the type of the values returned from the tasks
    -
    Parameters:
    -
    tasks - the collection of tasks
    -
    timeout - the maximum time to wait
    -
    unit - the time unit of the timeout argument
    -
    Returns:
    -
    the result returned by one of the tasks
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    -
    java.util.concurrent.ExecutionException - if no task successfully completes
    -
    java.util.concurrent.TimeoutException - if the given timeout elapses before - any task successfully completes
    +
    java.lang.InterruptedException
    +
    java.util.concurrent.ExecutionException
    +
    java.util.concurrent.TimeoutException
    @@ -572,13 +449,9 @@

    invokeAny

  • isShutdown

    public boolean isShutdown()
    -
    Description copied from interface: java.util.concurrent.ExecutorService
    -
    Returns true if this executor has been shut down.
    Specified by:
    isShutdown in interface java.util.concurrent.ExecutorService
    -
    Returns:
    -
    true if this executor has been shut down
    • @@ -589,15 +462,9 @@

    isShutdown

  • isTerminated

    public boolean isTerminated()
    -
    Description copied from interface: java.util.concurrent.ExecutorService
    -
    Returns true if all tasks have completed following shut down. - Note that isTerminated is never true unless - either shutdown or shutdownNow was called first.
    Specified by:
    isTerminated in interface java.util.concurrent.ExecutorService
    -
    Returns:
    -
    true if all tasks have completed following shut down
    • @@ -608,14 +475,6 @@

    isTerminated

  • shutdown

    public void shutdown()
    -
    Description copied from interface: java.util.concurrent.ExecutorService
    -
    Initiates an orderly shutdown in which previously submitted - tasks are executed, but no new tasks will be accepted. - Invocation has no additional effect if already shut down. - -

    This method does not wait for previously submitted tasks to - complete execution. Use awaitTermination - to do that.

    Specified by:
    shutdown in interface java.util.concurrent.ExecutorService
    @@ -630,24 +489,9 @@

    shutdown

    shutdownNow

    @CanIgnoreReturnValue
 public java.util.List<java.lang.Runnable> shutdownNow()
    -
    Description copied from interface: java.util.concurrent.ExecutorService
    -
    Attempts to stop all actively executing tasks, halts the - processing of waiting tasks, and returns a list of the tasks - that were awaiting execution. - -

    This method does not wait for actively executing tasks to - terminate. Use awaitTermination to - do that. - -

    There are no guarantees beyond best-effort attempts to stop - processing actively executing tasks. For example, typical - implementations will cancel via Thread.interrupt(), so any - task that fails to respond to interrupts may never terminate.

    Specified by:
    shutdownNow in interface java.util.concurrent.ExecutorService
    -
    Returns:
    -
    list of tasks that never commenced execution
    • @@ -658,15 +502,9 @@

    shutdownNow

  • execute

    public void execute​(java.lang.Runnable command)
    -
    Description copied from interface: java.util.concurrent.Executor
    -
    Executes the given command at some time in the future. The command - may execute in a new thread, in a pooled thread, or in the calling - thread, at the discretion of the Executor implementation.
    Specified by:
    execute in interface java.util.concurrent.Executor
    -
    Parameters:
    -
    command - the runnable task
    • @@ -677,30 +515,9 @@

    execute

  • submit

    public <T extends @Nullable java.lang.Object> java.util.concurrent.Future<T> submit​(java.util.concurrent.Callable<T> task)
    -
    Description copied from interface: java.util.concurrent.ExecutorService
    -
    Submits a value-returning task for execution and returns a - Future representing the pending results of the task. The - Future's get method will return the task's result upon - successful completion. - -

    - If you would like to immediately block waiting - for a task, you can use constructions of the form - result = exec.submit(aCallable).get(); - -

    Note: The Executors class includes a set of methods - that can convert some other common closure-like objects, - for example, PrivilegedAction to - Callable form so they can be submitted.

    Specified by:
    submit in interface java.util.concurrent.ExecutorService
    -
    Type Parameters:
    -
    T - the type of the task's result
    -
    Parameters:
    -
    task - the task to submit
    -
    Returns:
    -
    a Future representing pending completion of the task
    • @@ -711,17 +528,9 @@

    submit

  • submit

    public java.util.concurrent.Future<?> submit​(java.lang.Runnable task)
    -
    Description copied from interface: java.util.concurrent.ExecutorService
    -
    Submits a Runnable task for execution and returns a Future - representing that task. The Future's get method will - return null upon successful completion.
    Specified by:
    submit in interface java.util.concurrent.ExecutorService
    -
    Parameters:
    -
    task - the task to submit
    -
    Returns:
    -
    a Future representing pending completion of the task
    • @@ -735,20 +544,9 @@

    submit

    submit

    public <T extends @Nullable java.lang.Object> java.util.concurrent.Future<T> submit​(java.lang.Runnable task,
                                                                                     T result)
    -
    Description copied from interface: java.util.concurrent.ExecutorService
    -
    Submits a Runnable task for execution and returns a Future - representing that task. The Future's get method will - return the given result upon successful completion.
    Specified by:
    submit in interface java.util.concurrent.ExecutorService
    -
    Type Parameters:
    -
    T - the type of the result
    -
    Parameters:
    -
    task - the task to submit
    -
    result - the result to return
    -
    Returns:
    -
    a Future representing pending completion of the task
    diff --git a/releases/snapshot-android/api/docs/com/google/common/util/concurrent/ForwardingFuture.html b/releases/snapshot-android/api/docs/com/google/common/util/concurrent/ForwardingFuture.html index c8f1f8c651e4..608bc624fb9d 100644 --- a/releases/snapshot-android/api/docs/com/google/common/util/concurrent/ForwardingFuture.html +++ b/releases/snapshot-android/api/docs/com/google/common/util/concurrent/ForwardingFuture.html @@ -233,9 +233,7 @@

    Method Summary

    boolean cancel​(boolean mayInterruptIfRunning) - -
    Attempts to cancel execution of this task.
    - +  protected abstract java.util.concurrent.Future<? extends V> @@ -247,34 +245,23 @@

    Method Summary

    V get() - -
    Waits if necessary for the computation to complete, and then - retrieves its result.
    - +  V get​(long timeout, java.util.concurrent.TimeUnit unit) - -
    Waits if necessary for at most the given time for the computation - to complete, and then retrieves its result, if available.
    - +  boolean isCancelled() - -
    Returns true if this task was cancelled before it completed - normally.
    - +  boolean isDone() - -
    Returns true if this task completed.
    - + 
      @@ -353,30 +340,9 @@

      delegate

      cancel

      @CanIgnoreReturnValue
 public boolean cancel​(boolean mayInterruptIfRunning)
      -
      Description copied from interface: java.util.concurrent.Future
      -
      Attempts to cancel execution of this task. This attempt will - fail if the task has already completed, has already been cancelled, - or could not be cancelled for some other reason. If successful, - and this task has not started when cancel is called, - this task should never run. If the task has already started, - then the mayInterruptIfRunning parameter determines - whether the thread executing this task should be interrupted in - an attempt to stop the task. - -

      After this method returns, subsequent calls to Future.isDone() will - always return true. Subsequent calls to Future.isCancelled() - will always return true if this method returned true.

      Specified by:
      cancel in interface java.util.concurrent.Future<V extends @Nullable java.lang.Object>
      -
      Parameters:
      -
      mayInterruptIfRunning - true if the thread executing this - task should be interrupted; otherwise, in-progress tasks are allowed - to complete
      -
      Returns:
      -
      false if the task could not be cancelled, - typically because it has already completed normally; - true otherwise
    @@ -387,14 +353,9 @@

    cancel

  • isCancelled

    public boolean isCancelled()
    -
    Description copied from interface: java.util.concurrent.Future
    -
    Returns true if this task was cancelled before it completed - normally.
    Specified by:
    isCancelled in interface java.util.concurrent.Future<V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    true if this task was cancelled before it completed
    • @@ -405,17 +366,9 @@

    isCancelled

  • isDone

    public boolean isDone()
    -
    Description copied from interface: java.util.concurrent.Future
    -
    Returns true if this task completed. - - Completion may be due to normal termination, an exception, or - cancellation -- in all of these cases, this method will return - true.
    Specified by:
    isDone in interface java.util.concurrent.Future<V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    true if this task completed
    • @@ -429,19 +382,12 @@

    get

    public V get() throws java.lang.InterruptedException, java.util.concurrent.ExecutionException -
    Description copied from interface: java.util.concurrent.Future
    -
    Waits if necessary for the computation to complete, and then - retrieves its result.
    Specified by:
    get in interface java.util.concurrent.Future<V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the computed result
    Throws:
    -
    java.lang.InterruptedException - if the current thread was interrupted - while waiting
    -
    java.util.concurrent.ExecutionException - if the computation threw an - exception
    +
    java.lang.InterruptedException
    +
    java.util.concurrent.ExecutionException
    @@ -457,23 +403,13 @@

    get

    throws java.lang.InterruptedException, java.util.concurrent.ExecutionException, java.util.concurrent.TimeoutException -
    Description copied from interface: java.util.concurrent.Future
    -
    Waits if necessary for at most the given time for the computation - to complete, and then retrieves its result, if available.
    Specified by:
    get in interface java.util.concurrent.Future<V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    timeout - the maximum time to wait
    -
    unit - the time unit of the timeout argument
    -
    Returns:
    -
    the computed result
    Throws:
    -
    java.lang.InterruptedException - if the current thread was interrupted - while waiting
    -
    java.util.concurrent.ExecutionException - if the computation threw an - exception
    -
    java.util.concurrent.TimeoutException - if the wait timed out
    +
    java.lang.InterruptedException
    +
    java.util.concurrent.ExecutionException
    +
    java.util.concurrent.TimeoutException
    diff --git a/releases/snapshot-android/api/docs/com/google/common/util/concurrent/ForwardingListeningExecutorService.html b/releases/snapshot-android/api/docs/com/google/common/util/concurrent/ForwardingListeningExecutorService.html index f7fa36cc49f5..9f1107ac752c 100644 --- a/releases/snapshot-android/api/docs/com/google/common/util/concurrent/ForwardingListeningExecutorService.html +++ b/releases/snapshot-android/api/docs/com/google/common/util/concurrent/ForwardingListeningExecutorService.html @@ -214,27 +214,18 @@

    Method Summary

    ListenableFuture<?> submit​(java.lang.Runnable task) - -
    Submits a Runnable task for execution and returns a Future - representing that task.
    - +  <T extends @Nullable java.lang.Object>
    ListenableFuture<T>     submit​(java.lang.Runnable task, T result) - -
    Submits a Runnable task for execution and returns a Future - representing that task.
    - +  <T extends @Nullable java.lang.Object>
    ListenableFuture<T>     submit​(java.util.concurrent.Callable<T> task) - -
    Submits a value-returning task for execution and returns a - Future representing the pending results of the task.
    - + 
      @@ -340,21 +331,6 @@

      delegate

    • submit

      public <T extends @Nullable java.lang.Object> ListenableFuture<T> submit​(java.util.concurrent.Callable<T> task)
      -
      Description copied from interface: java.util.concurrent.ExecutorService
      -
      Submits a value-returning task for execution and returns a - Future representing the pending results of the task. The - Future's get method will return the task's result upon - successful completion. - -

      - If you would like to immediately block waiting - for a task, you can use constructions of the form - result = exec.submit(aCallable).get(); - -

      Note: The Executors class includes a set of methods - that can convert some other common closure-like objects, - for example, PrivilegedAction to - Callable form so they can be submitted.

      Specified by:
      submit in interface java.util.concurrent.ExecutorService
      @@ -362,12 +338,8 @@

      submit

      submit in interface ListeningExecutorService
      Overrides:
      submit in class ForwardingExecutorService
      -
      Type Parameters:
      -
      T - the type of the task's result
      -
      Parameters:
      -
      task - the task to submit
      Returns:
      -
      a Future representing pending completion of the task
      +
      a ListenableFuture representing pending completion of the task
    @@ -378,10 +350,6 @@

    submit

  • submit

    public ListenableFuture<?> submit​(java.lang.Runnable task)
    -
    Description copied from interface: java.util.concurrent.ExecutorService
    -
    Submits a Runnable task for execution and returns a Future - representing that task. The Future's get method will - return null upon successful completion.
    Specified by:
    submit in interface java.util.concurrent.ExecutorService
    @@ -389,10 +357,8 @@

    submit

    submit in interface ListeningExecutorService
    Overrides:
    submit in class ForwardingExecutorService
    -
    Parameters:
    -
    task - the task to submit
    Returns:
    -
    a Future representing pending completion of the task
    +
    a ListenableFuture representing pending completion of the task
    • @@ -406,10 +372,6 @@

    submit

    submit

    public <T extends @Nullable java.lang.Object> ListenableFuture<T> submit​(java.lang.Runnable task,
                                                                          T result)
    -
    Description copied from interface: java.util.concurrent.ExecutorService
    -
    Submits a Runnable task for execution and returns a Future - representing that task. The Future's get method will - return the given result upon successful completion.
    Specified by:
    submit in interface java.util.concurrent.ExecutorService
    @@ -417,13 +379,8 @@

    submit

    submit in interface ListeningExecutorService
    Overrides:
    submit in class ForwardingExecutorService
    -
    Type Parameters:
    -
    T - the type of the result
    -
    Parameters:
    -
    task - the task to submit
    -
    result - the result to return
    Returns:
    -
    a Future representing pending completion of the task
    +
    a ListenableFuture representing pending completion of the task
    diff --git a/releases/snapshot-android/api/docs/com/google/common/util/concurrent/ListenableFutureTask.html b/releases/snapshot-android/api/docs/com/google/common/util/concurrent/ListenableFutureTask.html index 107ddcce83c0..e0daefc33711 100644 --- a/releases/snapshot-android/api/docs/com/google/common/util/concurrent/ListenableFutureTask.html +++ b/releases/snapshot-android/api/docs/com/google/common/util/concurrent/ListenableFutureTask.html @@ -212,10 +212,7 @@

    Method Summary

    V get​(long timeout, java.util.concurrent.TimeUnit unit) - -
    Waits if necessary for at most the given time for the computation - to complete, and then retrieves its result, if available.
    - + 
      @@ -348,25 +345,15 @@

      get

      throws java.util.concurrent.TimeoutException, java.lang.InterruptedException, java.util.concurrent.ExecutionException -
      Description copied from interface: java.util.concurrent.Future
      -
      Waits if necessary for at most the given time for the computation - to complete, and then retrieves its result, if available.
      Specified by:
      get in interface java.util.concurrent.Future<V extends @Nullable java.lang.Object>
      Overrides:
      get in class java.util.concurrent.FutureTask<V extends @Nullable java.lang.Object>
      -
      Parameters:
      -
      timeout - the maximum time to wait
      -
      unit - the time unit of the timeout argument
      -
      Returns:
      -
      the computed result
      Throws:
      -
      java.util.concurrent.TimeoutException - if the wait timed out
      -
      java.lang.InterruptedException - if the current thread was interrupted - while waiting
      -
      java.util.concurrent.ExecutionException - if the computation threw an - exception
      +
      java.util.concurrent.TimeoutException
      +
      java.lang.InterruptedException
      +
      java.util.concurrent.ExecutionException
    diff --git a/releases/snapshot-android/api/docs/com/google/common/util/concurrent/ListeningExecutorService.html b/releases/snapshot-android/api/docs/com/google/common/util/concurrent/ListeningExecutorService.html index 502352107a23..c4b059b529b6 100644 --- a/releases/snapshot-android/api/docs/com/google/common/util/concurrent/ListeningExecutorService.html +++ b/releases/snapshot-android/api/docs/com/google/common/util/concurrent/ListeningExecutorService.html @@ -171,46 +171,28 @@

    Method Summary

    <T extends @Nullable java.lang.Object>
    java.util.List<java.util.concurrent.Future<T>>     invokeAll​(java.util.Collection<? extends java.util.concurrent.Callable<T>> tasks) - -
    Executes the given tasks, returning a list of Futures holding - their status and results when all complete.
    - <T extends @Nullable java.lang.Object>
    java.util.List<java.util.concurrent.Future<T>>     invokeAll​(java.util.Collection<? extends java.util.concurrent.Callable<T>> tasks, long timeout, java.util.concurrent.TimeUnit unit) - -
    Executes the given tasks, returning a list of Futures holding - their status and results - when all complete or the timeout expires, whichever happens first.
    - ListenableFuture<?> submit​(java.lang.Runnable task) - -
    Submits a Runnable task for execution and returns a Future - representing that task.
    - +  <T extends @Nullable java.lang.Object>
    ListenableFuture<T>     submit​(java.lang.Runnable task, T result) - -
    Submits a Runnable task for execution and returns a Future - representing that task.
    - +  <T extends @Nullable java.lang.Object>
    ListenableFuture<T>     submit​(java.util.concurrent.Callable<T> task) - -
    Submits a value-returning task for execution and returns a - Future representing the pending results of the task.
    - + 
      @@ -250,33 +232,13 @@

      Method Detail

    • submit

      <T extends @Nullable java.lang.Object> ListenableFuture<T> submit​(java.util.concurrent.Callable<T> task)
      -
      Description copied from interface: java.util.concurrent.ExecutorService
      -
      Submits a value-returning task for execution and returns a - Future representing the pending results of the task. The - Future's get method will return the task's result upon - successful completion. - -

      - If you would like to immediately block waiting - for a task, you can use constructions of the form - result = exec.submit(aCallable).get(); - -

      Note: The Executors class includes a set of methods - that can convert some other common closure-like objects, - for example, PrivilegedAction to - Callable form so they can be submitted.

      Specified by:
      submit in interface java.util.concurrent.ExecutorService
      -
      Type Parameters:
      -
      T - the type of the task's result
      -
      Parameters:
      -
      task - the task to submit
      Returns:
      a ListenableFuture representing pending completion of the task
      Throws:
      -
      java.util.concurrent.RejectedExecutionException - if the task cannot be - scheduled for execution
      +
      java.util.concurrent.RejectedExecutionException
    @@ -287,20 +249,13 @@

    submit

  • submit

    ListenableFuture<?> submit​(java.lang.Runnable task)
    -
    Description copied from interface: java.util.concurrent.ExecutorService
    -
    Submits a Runnable task for execution and returns a Future - representing that task. The Future's get method will - return null upon successful completion.
    Specified by:
    submit in interface java.util.concurrent.ExecutorService
    -
    Parameters:
    -
    task - the task to submit
    Returns:
    a ListenableFuture representing pending completion of the task
    Throws:
    -
    java.util.concurrent.RejectedExecutionException - if the task cannot be - scheduled for execution
    +
    java.util.concurrent.RejectedExecutionException
    • @@ -314,23 +269,13 @@

    submit

    submit

    <T extends @Nullable java.lang.Object> ListenableFuture<T> submit​(java.lang.Runnable task,
                                                                   T result)
    -
    Description copied from interface: java.util.concurrent.ExecutorService
    -
    Submits a Runnable task for execution and returns a Future - representing that task. The Future's get method will - return the given result upon successful completion.
    Specified by:
    submit in interface java.util.concurrent.ExecutorService
    -
    Type Parameters:
    -
    T - the type of the result
    -
    Parameters:
    -
    task - the task to submit
    -
    result - the result to return
    Returns:
    a ListenableFuture representing pending completion of the task
    Throws:
    -
    java.util.concurrent.RejectedExecutionException - if the task cannot be - scheduled for execution
    +
    java.util.concurrent.RejectedExecutionException
    @@ -342,14 +287,7 @@

    submit

    invokeAll

    <T extends @Nullable java.lang.Object> java.util.List<java.util.concurrent.Future<T>> invokeAll​(java.util.Collection<? extends java.util.concurrent.Callable<T>> tasks)
                                                                                          throws java.lang.InterruptedException
    -
    Executes the given tasks, returning a list of Futures holding - their status and results when all complete. - Future.isDone() is true for each - element of the returned list. - Note that a completed task could have - terminated either normally or by throwing an exception. - The results of this method are undefined if the given - collection is modified while this operation is in progress. +

    All elements in the returned list must be ListenableFuture instances. The easiest way to obtain a List<ListenableFuture<T>> from this method is an unchecked (but safe) @@ -362,20 +300,14 @@

    invokeAll

    Specified by:
    invokeAll in interface java.util.concurrent.ExecutorService
    -
    Type Parameters:
    -
    T - the type of the values returned from the tasks
    -
    Parameters:
    -
    tasks - the collection of tasks
    Returns:
    A list of ListenableFuture instances representing the tasks, in the same sequential order as produced by the iterator for the given task list, each of which has completed.
    Throws:
    -
    java.util.concurrent.RejectedExecutionException - if any task cannot be - scheduled for execution
    +
    java.util.concurrent.RejectedExecutionException
    java.lang.NullPointerException - if any task is null
    -
    java.lang.InterruptedException - if interrupted while waiting, in - which case unfinished tasks are cancelled
    +
    java.lang.InterruptedException
    @@ -389,16 +321,7 @@

    invokeAll

    long timeout, java.util.concurrent.TimeUnit unit) throws java.lang.InterruptedException -
    Executes the given tasks, returning a list of Futures holding - their status and results - when all complete or the timeout expires, whichever happens first. - Future.isDone() is true for each - element of the returned list. - Upon return, tasks that have not completed are cancelled. - Note that a completed task could have - terminated either normally or by throwing an exception. - The results of this method are undefined if the given - collection is modified while this operation is in progress. +

    All elements in the returned list must be ListenableFuture instances. The easiest way to obtain a List<ListenableFuture<T>> from this method is an unchecked (but safe) @@ -411,23 +334,15 @@

    invokeAll

    Specified by:
    invokeAll in interface java.util.concurrent.ExecutorService
    -
    Type Parameters:
    -
    T - the type of the values returned from the tasks
    -
    Parameters:
    -
    tasks - the collection of tasks
    -
    timeout - the maximum time to wait
    -
    unit - the time unit of the timeout argument
    Returns:
    a list of ListenableFuture instances representing the tasks, in the same sequential order as produced by the iterator for the given task list. If the operation did not time out, each task will have completed. If it did time out, some of these tasks will not have completed.
    Throws:
    -
    java.util.concurrent.RejectedExecutionException - if any task cannot be scheduled - for execution
    +
    java.util.concurrent.RejectedExecutionException
    java.lang.NullPointerException - if any task is null
    -
    java.lang.InterruptedException - if interrupted while waiting, in - which case unfinished tasks are cancelled
    +
    java.lang.InterruptedException
    diff --git a/releases/snapshot-android/api/docs/com/google/common/util/concurrent/ListeningScheduledExecutorService.html b/releases/snapshot-android/api/docs/com/google/common/util/concurrent/ListeningScheduledExecutorService.html index ea291d940afc..26f7ca2efa07 100644 --- a/releases/snapshot-android/api/docs/com/google/common/util/concurrent/ListeningScheduledExecutorService.html +++ b/releases/snapshot-android/api/docs/com/google/common/util/concurrent/ListeningScheduledExecutorService.html @@ -164,19 +164,14 @@

    Method Summary

    schedule​(java.lang.Runnable command, long delay, java.util.concurrent.TimeUnit unit) - -
    Submits a one-shot task that becomes enabled after the given delay.
    - +  <V extends @Nullable java.lang.Object>
    ListenableScheduledFuture<V>     schedule​(java.util.concurrent.Callable<V> callable, long delay, java.util.concurrent.TimeUnit unit) - -
    Submits a value-returning one-shot task that becomes enabled - after the given delay.
    - +  ListenableScheduledFuture<?> @@ -184,13 +179,7 @@

    Method Summary

    long initialDelay, long period, java.util.concurrent.TimeUnit unit) - -
    Submits a periodic action that becomes enabled first after the - given initial delay, and subsequently with the given period; - that is, executions will commence after - initialDelay, then initialDelay + period, then - initialDelay + 2 * period, and so on.
    - +  ListenableScheduledFuture<?> @@ -198,12 +187,7 @@

    Method Summary

    long initialDelay, long delay, java.util.concurrent.TimeUnit unit) - -
    Submits a periodic action that becomes enabled first after the - given initial delay, and subsequently with the given delay - between the termination of one execution and the commencement of - the next.
    - + 
      @@ -252,19 +236,9 @@

      schedule

      ListenableScheduledFuture<?> schedule​(java.lang.Runnable command,
                                       long delay,
                                       java.util.concurrent.TimeUnit unit)
      -
      Description copied from interface: java.util.concurrent.ScheduledExecutorService
      -
      Submits a one-shot task that becomes enabled after the given delay.
      Specified by:
      schedule in interface java.util.concurrent.ScheduledExecutorService
      -
      Parameters:
      -
      command - the task to execute
      -
      delay - the time from now to delay execution
      -
      unit - the time unit of the delay parameter
      -
      Returns:
      -
      a ScheduledFuture representing pending completion of - the task and whose get() method will return - null upon completion
      Since:
      15.0 (previously returned ScheduledFuture)
      @@ -279,20 +253,9 @@

      schedule

      <V extends @Nullable java.lang.Object> ListenableScheduledFuture<V> schedule​(java.util.concurrent.Callable<V> callable,
                                                                              long delay,
                                                                              java.util.concurrent.TimeUnit unit)
      -
      Description copied from interface: java.util.concurrent.ScheduledExecutorService
      -
      Submits a value-returning one-shot task that becomes enabled - after the given delay.
      Specified by:
      schedule in interface java.util.concurrent.ScheduledExecutorService
      -
      Type Parameters:
      -
      V - the type of the callable's result
      -
      Parameters:
      -
      callable - the function to execute
      -
      delay - the time from now to delay execution
      -
      unit - the time unit of the delay parameter
      -
      Returns:
      -
      a ScheduledFuture that can be used to extract result or cancel
      Since:
      15.0 (previously returned ScheduledFuture)
      @@ -308,43 +271,9 @@

      scheduleAtFixedRate

      long initialDelay, long period, java.util.concurrent.TimeUnit unit) -
      Description copied from interface: java.util.concurrent.ScheduledExecutorService
      -
      Submits a periodic action that becomes enabled first after the - given initial delay, and subsequently with the given period; - that is, executions will commence after - initialDelay, then initialDelay + period, then - initialDelay + 2 * period, and so on. - -

      The sequence of task executions continues indefinitely until - one of the following exceptional completions occur: -

        -
      • The task is explicitly cancelled - via the returned future. -
      • The executor terminates, also resulting in task cancellation. -
      • An execution of the task throws an exception. In this case - calling get on the returned future will throw - ExecutionException, holding the exception as its cause. -
      - Subsequent executions are suppressed. Subsequent calls to - isDone() on the returned future will - return true. - -

      If any execution of this task takes longer than its period, then - subsequent executions may start late, but will not concurrently - execute.

      Specified by:
      scheduleAtFixedRate in interface java.util.concurrent.ScheduledExecutorService
      -
      Parameters:
      -
      command - the task to execute
      -
      initialDelay - the time to delay first execution
      -
      period - the period between successive executions
      -
      unit - the time unit of the initialDelay and period parameters
      -
      Returns:
      -
      a ScheduledFuture representing pending completion of - the series of repeated tasks. The future's get() method will never return normally, - and will throw an exception upon task cancellation or - abnormal termination of a task execution.
      Since:
      15.0 (previously returned ScheduledFuture)
      @@ -360,39 +289,9 @@

      scheduleWithFixedDelay

      long initialDelay, long delay, java.util.concurrent.TimeUnit unit) -
      Description copied from interface: java.util.concurrent.ScheduledExecutorService
      -
      Submits a periodic action that becomes enabled first after the - given initial delay, and subsequently with the given delay - between the termination of one execution and the commencement of - the next. - -

      The sequence of task executions continues indefinitely until - one of the following exceptional completions occur: -

        -
      • The task is explicitly cancelled - via the returned future. -
      • The executor terminates, also resulting in task cancellation. -
      • An execution of the task throws an exception. In this case - calling get on the returned future will throw - ExecutionException, holding the exception as its cause. -
      - Subsequent executions are suppressed. Subsequent calls to - isDone() on the returned future will - return true.
      Specified by:
      scheduleWithFixedDelay in interface java.util.concurrent.ScheduledExecutorService
      -
      Parameters:
      -
      command - the task to execute
      -
      initialDelay - the time to delay first execution
      -
      delay - the delay between the termination of one - execution and the commencement of the next
      -
      unit - the time unit of the initialDelay and delay parameters
      -
      Returns:
      -
      a ScheduledFuture representing pending completion of - the series of repeated tasks. The future's get() method will never return normally, - and will throw an exception upon task cancellation or - abnormal termination of a task execution.
      Since:
      15.0 (previously returned ScheduledFuture)
      diff --git a/releases/snapshot-android/api/docs/com/google/common/util/concurrent/RateLimiter.html b/releases/snapshot-android/api/docs/com/google/common/util/concurrent/RateLimiter.html index 86e0386a81d4..87dce949473b 100644 --- a/releases/snapshot-android/api/docs/com/google/common/util/concurrent/RateLimiter.html +++ b/releases/snapshot-android/api/docs/com/google/common/util/concurrent/RateLimiter.html @@ -269,9 +269,7 @@

      Method Summary

      java.lang.String toString() - -
      Returns a string representation of the object.
      - +  boolean @@ -573,29 +571,9 @@

      tryAcquire

    • toString

      public java.lang.String toString()
      -
      Description copied from class: java.lang.Object
      -
      Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

      - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

      - 
      - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
      Overrides:
      toString in class java.lang.Object
      -
      Returns:
      -
      a string representation of the object.
    diff --git a/releases/snapshot-android/api/docs/com/google/common/util/concurrent/ServiceManager.html b/releases/snapshot-android/api/docs/com/google/common/util/concurrent/ServiceManager.html index 4bd154f3fec3..1eeb4036404d 100644 --- a/releases/snapshot-android/api/docs/com/google/common/util/concurrent/ServiceManager.html +++ b/releases/snapshot-android/api/docs/com/google/common/util/concurrent/ServiceManager.html @@ -337,9 +337,7 @@

    Method Summary

    java.lang.String toString() - -
    Returns a string representation of the object.
    - + 
      @@ -583,29 +581,9 @@

      startupTimes

    • toString

      public java.lang.String toString()
      -
      Description copied from class: java.lang.Object
      -
      Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

      - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

      - 
      - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
      Overrides:
      toString in class java.lang.Object
      -
      Returns:
      -
      a string representation of the object.
    diff --git a/releases/snapshot-android/api/docs/com/google/common/util/concurrent/SettableFuture.html b/releases/snapshot-android/api/docs/com/google/common/util/concurrent/SettableFuture.html index 069090aae31e..a5df878cf0fe 100644 --- a/releases/snapshot-android/api/docs/com/google/common/util/concurrent/SettableFuture.html +++ b/releases/snapshot-android/api/docs/com/google/common/util/concurrent/SettableFuture.html @@ -193,9 +193,6 @@

    Method Summary

    boolean cancel​(boolean mayInterruptIfRunning) - -
    Attempts to cancel execution of this task.
    - static <V extends @Nullable java.lang.Object>
    SettableFuture<V>     @@ -207,34 +204,21 @@

    Method Summary

    V get() - -
    Waits if necessary for the computation to complete, and then - retrieves its result.
    - V get​(long timeout, java.util.concurrent.TimeUnit unit) - -
    Waits if necessary for at most the given time for the computation - to complete, and then retrieves its result, if available.
    - boolean isCancelled() - -
    Returns true if this task was cancelled before it completed - normally.
    - +  boolean isDone() - -
    Returns true if this task completed.
    - +  boolean @@ -415,8 +399,7 @@

    get

    throws java.lang.InterruptedException, java.util.concurrent.ExecutionException
    Description copied from class: AbstractFuture
    -
    Waits if necessary for the computation to complete, and then - retrieves its result. +

    The default AbstractFuture implementation throws InterruptedException if the current thread is interrupted during the call, even if the value is already available.

    @@ -425,13 +408,9 @@

    get

    get in interface java.util.concurrent.Future<V extends @Nullable java.lang.Object>
    Overrides:
    get in class AbstractFuture<V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the computed result
    Throws:
    -
    java.lang.InterruptedException - if the current thread was interrupted - while waiting
    -
    java.util.concurrent.ExecutionException - if the computation threw an - exception
    +
    java.lang.InterruptedException
    +
    java.util.concurrent.ExecutionException
    @@ -448,8 +427,7 @@

    get

    java.util.concurrent.ExecutionException, java.util.concurrent.TimeoutException
    Description copied from class: AbstractFuture
    -
    Waits if necessary for at most the given time for the computation - to complete, and then retrieves its result, if available. +

    The default AbstractFuture implementation throws InterruptedException if the current thread is interrupted during the call, even if the value is already available.

    @@ -458,17 +436,10 @@

    get

    get in interface java.util.concurrent.Future<V extends @Nullable java.lang.Object>
    Overrides:
    get in class AbstractFuture<V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    timeout - the maximum time to wait
    -
    unit - the time unit of the timeout argument
    -
    Returns:
    -
    the computed result
    Throws:
    -
    java.lang.InterruptedException - if the current thread was interrupted - while waiting
    -
    java.util.concurrent.ExecutionException - if the computation threw an - exception
    -
    java.util.concurrent.TimeoutException - if the wait timed out
    +
    java.lang.InterruptedException
    +
    java.util.concurrent.ExecutionException
    +
    java.util.concurrent.TimeoutException
    @@ -479,19 +450,11 @@

    get

  • isDone

    public final boolean isDone()
    -
    Description copied from interface: java.util.concurrent.Future
    -
    Returns true if this task completed. - - Completion may be due to normal termination, an exception, or - cancellation -- in all of these cases, this method will return - true.
    Specified by:
    isDone in interface java.util.concurrent.Future<V extends @Nullable java.lang.Object>
    Overrides:
    isDone in class AbstractFuture<V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    true if this task completed
    • @@ -502,16 +465,11 @@

    isDone

  • isCancelled

    public final boolean isCancelled()
    -
    Description copied from interface: java.util.concurrent.Future
    -
    Returns true if this task was cancelled before it completed - normally.
    Specified by:
    isCancelled in interface java.util.concurrent.Future<V extends @Nullable java.lang.Object>
    Overrides:
    isCancelled in class AbstractFuture<V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    true if this task was cancelled before it completed
    • @@ -567,18 +525,7 @@

    cancel

    @CanIgnoreReturnValue
 public final boolean cancel​(boolean mayInterruptIfRunning)
    Description copied from class: AbstractFuture
    -
    Attempts to cancel execution of this task. This attempt will - fail if the task has already completed, has already been cancelled, - or could not be cancelled for some other reason. If successful, - and this task has not started when cancel is called, - this task should never run. If the task has already started, - then the mayInterruptIfRunning parameter determines - whether the thread executing this task should be interrupted in - an attempt to stop the task. - -

    After this method returns, subsequent calls to Future.isDone() will - always return true. Subsequent calls to Future.isCancelled() - will always return true if this method returned true. +

    If a cancellation attempt succeeds on a Future that had previously been set asynchronously, then the cancellation will also be propagated to the delegate Future that was supplied in the setFuture call. @@ -595,14 +542,6 @@

    cancel

    cancel in interface java.util.concurrent.Future<V extends @Nullable java.lang.Object>
    Overrides:
    cancel in class AbstractFuture<V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    mayInterruptIfRunning - true if the thread executing this - task should be interrupted; otherwise, in-progress tasks are allowed - to complete
    -
    Returns:
    -
    false if the task could not be cancelled, - typically because it has already completed normally; - true otherwise
    diff --git a/releases/snapshot-android/api/docs/index-all.html b/releases/snapshot-android/api/docs/index-all.html index bd42199650e7..19800243d987 100644 --- a/releases/snapshot-android/api/docs/index-all.html +++ b/releases/snapshot-android/api/docs/index-all.html @@ -2551,9 +2551,6 @@

    C

    is to be disregarded.
    cancel(boolean) - Method in class com.google.common.util.concurrent.AbstractFuture
    -
    -
    Attempts to cancel execution of this task.
    -
    cancel(boolean) - Method in class com.google.common.util.concurrent.ClosingFuture
    Attempts to cancel execution of this step.
    @@ -6181,9 +6178,6 @@

    E

    Compares the specified object with this multimap for equality.
    equals(Object) - Method in interface com.google.common.collect.Multiset.Entry
    -
    -
    Indicates whether some other object is "equal to" this one.
    -
    equals(Object) - Method in interface com.google.common.collect.Multiset
    Compares the specified object with this multiset for equality.
    @@ -6252,13 +6246,7 @@

    E

    representation to this hash code.
    equals(Object) - Method in class com.google.common.math.PairedStats
    -
    -
    Indicates whether some other object is "equal to" this one.
    -
    equals(Object) - Method in class com.google.common.math.Stats
    -
    -
    Indicates whether some other object is "equal to" this one.
    -
    equals(Object) - Method in class com.google.common.net.HostAndPort
     
    equals(Object) - Method in class com.google.common.net.HostSpecifier
    @@ -7777,10 +7765,6 @@

    G

    Retrieves an instance of the appropriate type.
    get() - Method in class com.google.common.util.concurrent.AbstractFuture
    -
    -
    Waits if necessary for the computation to complete, and then - retrieves its result.
    -
    get() - Method in class com.google.common.util.concurrent.AtomicDouble
    Gets the current value.
    @@ -7815,10 +7799,6 @@

    G

    Gets the current value at position i.
    get(long, TimeUnit) - Method in class com.google.common.util.concurrent.AbstractFuture
    -
    -
    Waits if necessary for at most the given time for the computation - to complete, and then retrieves its result, if available.
    -
    get(long, TimeUnit) - Method in class com.google.common.util.concurrent.ForwardingFuture
     
    get(long, TimeUnit) - Method in class com.google.common.util.concurrent.ListenableFutureTask
    @@ -8265,10 +8245,6 @@

    G

    Returns the single element contained in iterator.
    getOrDefault(Object, V) - Method in class com.google.common.collect.ImmutableMap
    -
    -
    Returns the value to which the specified key is mapped, or - defaultValue if this map contains no mapping for the key.
    -
    getOwnerType() - Method in class com.google.common.reflect.Invokable
    Returns the type of T.
    @@ -8662,9 +8638,6 @@

    H

    Returns the hash code for this multimap.
    hashCode() - Method in interface com.google.common.collect.Multiset.Entry
    -
    -
    Returns a hash code value for the object.
    -
    hashCode() - Method in interface com.google.common.collect.Multiset
    Returns the hash code for this multiset.
    @@ -8732,13 +8705,7 @@

    H

    hashCode() - Method in class com.google.common.math.PairedStats
    -
    -
    Returns a hash code value for the object.
    -
    hashCode() - Method in class com.google.common.math.Stats
    -
    -
    Returns a hash code value for the object.
    -
    hashCode() - Method in class com.google.common.net.HostAndPort
     
    hashCode() - Method in class com.google.common.net.HostSpecifier
    @@ -8987,10 +8954,6 @@

    H

    headSet(E) - Method in class com.google.common.collect.ForwardingSortedSet
     
    headSet(E) - Method in class com.google.common.collect.ImmutableSortedSet
    -
    -
    Returns a view of the portion of this set whose elements are - strictly less than toElement.
    -
    headSet(E, boolean) - Method in class com.google.common.collect.ForwardingNavigableSet
     
    headSet(E, boolean) - Method in class com.google.common.collect.ImmutableSortedSet
    @@ -9874,8 +9837,17 @@

    I

    invoke(Object, Method, Object[]) - Method in class com.google.common.reflect.AbstractInvocationHandler
    -
    Processes a method invocation on a proxy instance and returns - the result.
    +
    + + + proxy.hashCode() delegates to AbstractInvocationHandler.hashCode() + proxy.toString() delegates to AbstractInvocationHandler.toString() + proxy.equals(argument) returns true if: + + proxy and argument are of the same type + and AbstractInvocationHandler.equals(java.lang.Object) returns true for the InvocationHandler of argument + + other method calls are dispatched to AbstractInvocationHandler.handleInvocation(java.lang.Object, java.lang.reflect.Method, java.lang.Object[]).
    invoke(T, Object...) - Method in class com.google.common.reflect.Invokable
    @@ -9886,18 +9858,9 @@

    I

    invokeAll(Collection<? extends Callable<T>>) - Method in class com.google.common.util.concurrent.ForwardingExecutorService
     
    invokeAll(Collection<? extends Callable<T>>) - Method in interface com.google.common.util.concurrent.ListeningExecutorService
    -
    -
    Executes the given tasks, returning a list of Futures holding - their status and results when all complete.
    -
    invokeAll(Collection<? extends Callable<T>>, long, TimeUnit) - Method in class com.google.common.util.concurrent.ForwardingExecutorService
     
    invokeAll(Collection<? extends Callable<T>>, long, TimeUnit) - Method in interface com.google.common.util.concurrent.ListeningExecutorService
    -
    -
    Executes the given tasks, returning a list of Futures holding - their status and results - when all complete or the timeout expires, whichever happens first.
    -
    invokeAny(Collection<? extends Callable<T>>) - Method in class com.google.common.util.concurrent.ForwardingExecutorService
     
    invokeAny(Collection<? extends Callable<T>>, long, TimeUnit) - Method in class com.google.common.util.concurrent.ForwardingExecutorService
    @@ -10367,17 +10330,11 @@

    I

    order.
    iterator() - Method in interface com.google.common.collect.Multiset
    -
    -
    Returns an iterator over the elements in this collection.
    -
    iterator() - Method in class com.google.common.collect.Sets.SetView
    Scope the return type to UnmodifiableIterator to ensure this is an unmodifiable view.
    iterator() - Method in interface com.google.common.collect.SortedMultiset
    -
    -
    Returns an iterator over the elements in this collection.
    -
    iterator() - Method in class com.google.common.collect.TreeMultiset
     
    iterator() - Method in class com.google.common.graph.EndpointPair
    @@ -12468,9 +12425,6 @@

    N

    next() - Method in class com.google.common.collect.ForwardingIterator
     
    next() - Method in interface com.google.common.collect.PeekingIterator
    -
    -
    Returns the next element in the iteration.
    -
    next(C) - Method in class com.google.common.collect.DiscreteDomain
    Returns the unique least value of type C that is greater than value, or @@ -14196,10 +14150,6 @@

    P

    put(K, V) - Method in class com.google.common.cache.ForwardingCache
     
    put(K, V) - Method in interface com.google.common.collect.BiMap
    -
    -
    Associates the specified value with the specified key in this map - (optional operation).
    -
    put(K, V) - Method in class com.google.common.collect.EnumHashBiMap
     
    put(K, V) - Method in class com.google.common.collect.ForwardingMap
    @@ -14392,10 +14342,6 @@

    P

    putAll(Map<? extends K, ? extends V>) - Method in class com.google.common.cache.ForwardingCache
     
    putAll(Map<? extends K, ? extends V>) - Method in interface com.google.common.collect.BiMap
    -
    -
    Copies all of the mappings from the specified map to this map - (optional operation).
    -
    putAll(Map<? extends K, ? extends V>) - Method in class com.google.common.collect.ForwardingMap
     
    putAll(Map<? extends K, ? extends V>) - Method in class com.google.common.collect.ImmutableBiMap.Builder
    @@ -15066,10 +15012,6 @@

    R

    remove() - Method in class com.google.common.collect.ForwardingQueue
     
    remove() - Method in interface com.google.common.collect.PeekingIterator
    -
    -
    Removes from the underlying collection the last element returned - by this iterator (optional operation).
    -
    remove() - Method in class com.google.common.collect.UnmodifiableIterator
    Deprecated. @@ -15273,10 +15215,6 @@

    R

    removeAll(Collection<?>) - Method in interface com.google.common.collect.Multiset
    -
    -
    Removes all of this collection's elements that are also contained in the - specified collection (optional operation).
    -
    removeAll(Collection<?>) - Method in class com.google.common.collect.Sets.SetView
    Deprecated. @@ -15501,10 +15439,6 @@

    R

    retainAll(Collection<?>) - Method in interface com.google.common.collect.Multiset
    -
    -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation).
    -
    retainAll(Collection<?>) - Method in class com.google.common.collect.Sets.SetView
    Deprecated. @@ -16533,7 +16467,7 @@

    S

     
    size() - Method in class com.google.common.collect.ConcurrentHashMultiset
    -
    Returns the number of elements in this collection.
    +
    Returns the total number of all occurrences of all elements in this multiset.
    size() - Method in class com.google.common.collect.EnumMultiset
     
    @@ -17691,11 +17625,6 @@

    S

    subSet(E, E) - Method in class com.google.common.collect.ForwardingSortedSet
     
    subSet(E, E) - Method in class com.google.common.collect.ImmutableSortedSet
    -
    -
    Returns a view of the portion of this set whose elements range - from fromElement, inclusive, to toElement, - exclusive.
    -
    subSet(NavigableSet<K>, Range<K>) - Static method in class com.google.common.collect.Sets
    Returns a view of the portion of set whose elements are contained by range.
    @@ -17893,10 +17822,6 @@

    T

    tailSet(E) - Method in class com.google.common.collect.ForwardingSortedSet
     
    tailSet(E) - Method in class com.google.common.collect.ImmutableSortedSet
    -
    -
    Returns a view of the portion of this set whose elements are - greater than or equal to fromElement.
    -
    tailSet(E, boolean) - Method in class com.google.common.collect.ForwardingNavigableSet
     
    tailSet(E, boolean) - Method in class com.google.common.collect.ImmutableSortedSet
    @@ -18313,9 +18238,6 @@

    T

    Returns the canonical string representation of this entry, defined as follows.
    toString() - Method in interface com.google.common.collect.Multiset
    -
    -
    Returns a string representation of the object.
    -
    toString() - Method in class com.google.common.collect.Range
    Returns a string representation of this range, such as "[3..5)" (other examples are @@ -19448,9 +19370,6 @@

    V

    Returns an unmodifiable collection of all values, which may contain duplicates.
    values() - Method in interface com.google.common.collect.BiMap
    -
    -
    Returns a Collection view of the values contained in this map.
    -
    values() - Static method in enum com.google.common.collect.BoundType
    Returns an array containing the constants of this enum type, in diff --git a/releases/snapshot-android/api/docs/member-search-index.zip b/releases/snapshot-android/api/docs/member-search-index.zip index b6f97ffa49685080c03422c8e0ff551555bb665b..d10de4abddeb6b70cf8da50cab31f2c87c1b4a77 100644 GIT binary patch delta 32 ncmezTp6T;@Cf)#VW)=|!4h{|mzVw2PywkQb1L?`jw)+AAvH%LX delta 32 ncmezTp6T;@Cf)#VW)=|!4h{|mp6&S?d8ch>2GWz4ZTAHLxB?4P diff --git a/releases/snapshot-android/api/docs/package-search-index.zip b/releases/snapshot-android/api/docs/package-search-index.zip index 26ff1263233bd3ea23c7591c19fa81897dec61e8..07e14e7f1cc2e8b738b9a8e82fa9cc20af7b9558 100644 GIT binary patch delta 28 hcmX@abcl&Jz?+#xgn@&DgMlx-U?T4mW)Sto4**+(2ZjIu delta 28 hcmX@abcl&Jz?+#xgn@&DgMnvz{zTp<%pmHE9{^yU2p|9e diff --git a/releases/snapshot-android/api/docs/type-search-index.zip b/releases/snapshot-android/api/docs/type-search-index.zip index e042bd320bb3802f94c844b4003f7e2026517761..0be1ea1ab29b3e2debad45dd20b6b97a231ab17a 100644 GIT binary patch delta 30 kcmca0c|nplz?+#xgn@&DgMlx-U?XoS4>ORS+{)t(0Bj%!DF6Tf delta 30 kcmca0c|nplz?+#xgn@&DgMnvz{zl$X9%djtxs}Ho0CFM+!vFvP diff --git a/releases/snapshot-jre/api/docs/com/google/common/base/CharMatcher.html b/releases/snapshot-jre/api/docs/com/google/common/base/CharMatcher.html index e2e59bd359f5..8917c24ef28f 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/base/CharMatcher.html +++ b/releases/snapshot-jre/api/docs/com/google/common/base/CharMatcher.html @@ -975,9 +975,6 @@

    negate

    Specified by:
    negate in interface java.util.function.Predicate<java.lang.Character>
    -
    Returns:
    -
    a predicate that represents the logical negation of this - predicate
    @@ -1392,8 +1389,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/base/Converter.html b/releases/snapshot-jre/api/docs/com/google/common/base/Converter.html index 36af79ee5280..ab7457453b9d 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/base/Converter.html +++ b/releases/snapshot-jre/api/docs/com/google/common/base/Converter.html @@ -516,17 +516,11 @@

    apply

    Deprecated.
    Provided to satisfy the Function interface; use convert(A) instead.
    -
    Description copied from interface: java.util.function.Function
    -
    Applies this function to the given argument.
    Specified by:
    apply in interface Function<A,​B>
    Specified by:
    apply in interface java.util.function.Function<A,​B>
    -
    Parameters:
    -
    a - the function argument
    -
    Returns:
    -
    the function result
    @@ -552,14 +546,6 @@

    equals

    equals in interface Function<A,​B>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -595,12 +581,6 @@

    from

    identity

    public static <T> Converter<T,​T> identity()
    Returns a serializable converter that always converts or reverses an object to itself.
    -
    -
    Type Parameters:
    -
    T - the type of the input and output objects to the function
    -
    Returns:
    -
    a function that always returns its input argument
    -
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/base/Equivalence.Wrapper.html b/releases/snapshot-jre/api/docs/com/google/common/base/Equivalence.Wrapper.html index c92f8d25f524..f931e0abeea7 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/base/Equivalence.Wrapper.html +++ b/releases/snapshot-jre/api/docs/com/google/common/base/Equivalence.Wrapper.html @@ -262,14 +262,6 @@

    equals

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -284,11 +276,6 @@

    hashCode

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    @@ -304,8 +291,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/base/Equivalence.html b/releases/snapshot-jre/api/docs/com/google/common/base/Equivalence.html index a214ca243f7e..ac06652b2bf1 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/base/Equivalence.html +++ b/releases/snapshot-jre/api/docs/com/google/common/base/Equivalence.html @@ -405,17 +405,9 @@

    test

    Provided only to satisfy the BiPredicate interface; use equivalent(T, T) instead.
    -
    Description copied from interface: java.util.function.BiPredicate
    -
    Evaluates this predicate on the given arguments.
    Specified by:
    test in interface java.util.function.BiPredicate<@Nullable T,​@Nullable T>
    -
    Parameters:
    -
    t - the first input argument
    -
    u - the second input argument
    -
    Returns:
    -
    true if the input arguments match the predicate, - otherwise false
    Since:
    21.0
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/base/FinalizableReferenceQueue.html b/releases/snapshot-jre/api/docs/com/google/common/base/FinalizableReferenceQueue.html index c948c83b83a6..c296eb1b8c0f 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/base/FinalizableReferenceQueue.html +++ b/releases/snapshot-jre/api/docs/com/google/common/base/FinalizableReferenceQueue.html @@ -246,10 +246,7 @@

    Method Summary

    void close() - -
    Closes this stream and releases any system resources associated - with it.
    - + 
      @@ -302,16 +299,6 @@

      Method Detail

    • close

      public void close()
      -
      Description copied from interface: java.io.Closeable
      -
      Closes this stream and releases any system resources associated - with it. If the stream is already closed then invoking this - method has no effect. - -

      As noted in AutoCloseable.close(), cases where the - close may fail require careful attention. It is strongly advised - to relinquish the underlying resources and to internally - mark the Closeable as closed, prior to throwing - the IOException.

      Specified by:
      close in interface java.lang.AutoCloseable
      diff --git a/releases/snapshot-jre/api/docs/com/google/common/base/Function.html b/releases/snapshot-jre/api/docs/com/google/common/base/Function.html index 2f142de04b4d..af163964d892 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/base/Function.html +++ b/releases/snapshot-jre/api/docs/com/google/common/base/Function.html @@ -188,9 +188,7 @@

      Method Summary

      T apply​(F input) - -
      Applies this function to the given argument.
      - +  boolean @@ -233,15 +231,9 @@

      Method Detail

    • apply

      T apply​(F input)
      -
      Description copied from interface: java.util.function.Function
      -
      Applies this function to the given argument.
      Specified by:
      apply in interface java.util.function.Function<F extends @Nullable java.lang.Object,​T extends @Nullable java.lang.Object>
      -
      Parameters:
      -
      input - the function argument
      -
      Returns:
      -
      the function result
    @@ -265,14 +257,6 @@

    equals

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/base/MoreObjects.ToStringHelper.html b/releases/snapshot-jre/api/docs/com/google/common/base/MoreObjects.ToStringHelper.html index f769df8c895d..f77dce040ea7 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/base/MoreObjects.ToStringHelper.html +++ b/releases/snapshot-jre/api/docs/com/google/common/base/MoreObjects.ToStringHelper.html @@ -576,8 +576,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/base/Optional.html b/releases/snapshot-jre/api/docs/com/google/common/base/Optional.html index 43697f021c97..2e0be486e8f0 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/base/Optional.html +++ b/releases/snapshot-jre/api/docs/com/google/common/base/Optional.html @@ -678,14 +678,6 @@

    equals

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -703,11 +695,6 @@

    hashCode

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    @@ -725,8 +712,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/base/Predicate.html b/releases/snapshot-jre/api/docs/com/google/common/base/Predicate.html index c2d7ee1ee6e2..3d3c44393024 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/base/Predicate.html +++ b/releases/snapshot-jre/api/docs/com/google/common/base/Predicate.html @@ -200,9 +200,7 @@

    Method Summary

    default boolean test​(T input) - -
    Evaluates this predicate on the given argument.
    - + 
      @@ -272,14 +270,6 @@

      equals

      Overrides:
      equals in class java.lang.Object
      -
      Parameters:
      -
      object - the reference object with which to compare.
      -
      Returns:
      -
      true if this object is the same as the obj - argument; false otherwise.
      -
      See Also:
      -
      Object.hashCode(), -HashMap
    @@ -292,16 +282,9 @@

    equals

  • test

    default boolean test​(T input)
    -
    Description copied from interface: java.util.function.Predicate
    -
    Evaluates this predicate on the given argument.
    Specified by:
    test in interface java.util.function.Predicate<T extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    input - the input argument
    -
    Returns:
    -
    true if the input argument matches the predicate, - otherwise false
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/base/StandardSystemProperty.html b/releases/snapshot-jre/api/docs/com/google/common/base/StandardSystemProperty.html index c685e0789f92..b123c49d37c9 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/base/StandardSystemProperty.html +++ b/releases/snapshot-jre/api/docs/com/google/common/base/StandardSystemProperty.html @@ -815,8 +815,6 @@

    toString

    Overrides:
    toString in class java.lang.Enum<StandardSystemProperty>
    -
    Returns:
    -
    the name of this enum constant
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/base/Stopwatch.html b/releases/snapshot-jre/api/docs/com/google/common/base/Stopwatch.html index a55bea21ca86..61b9c53948b3 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/base/Stopwatch.html +++ b/releases/snapshot-jre/api/docs/com/google/common/base/Stopwatch.html @@ -485,8 +485,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/cache/AbstractLoadingCache.html b/releases/snapshot-jre/api/docs/com/google/common/cache/AbstractLoadingCache.html index bb2730764baa..852372eac6fc 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/cache/AbstractLoadingCache.html +++ b/releases/snapshot-jre/api/docs/com/google/common/cache/AbstractLoadingCache.html @@ -224,9 +224,7 @@

    Method Summary

    V apply​(K key) - -
    Applies this function to the given argument.
    - +  ImmutableMap<K,​V> @@ -405,8 +403,6 @@

    getAll

  • apply

    public final V apply​(K key)
    -
    Description copied from interface: java.util.function.Function
    -
    Applies this function to the given argument.
    Specified by:
    apply in interface Function<K,​V>
    @@ -414,10 +410,6 @@

    apply

    apply in interface java.util.function.Function<K,​V>
    Specified by:
    apply in interface LoadingCache<K,​V>
    -
    Parameters:
    -
    key - the function argument
    -
    Returns:
    -
    the function result
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/cache/CacheBuilder.html b/releases/snapshot-jre/api/docs/com/google/common/cache/CacheBuilder.html index 7bf42d0b1bf1..db0232ad9a8d 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/cache/CacheBuilder.html +++ b/releases/snapshot-jre/api/docs/com/google/common/cache/CacheBuilder.html @@ -1149,8 +1149,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/cache/CacheBuilderSpec.html b/releases/snapshot-jre/api/docs/com/google/common/cache/CacheBuilderSpec.html index 5cfe147c6d06..31f1808dcafc 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/cache/CacheBuilderSpec.html +++ b/releases/snapshot-jre/api/docs/com/google/common/cache/CacheBuilderSpec.html @@ -212,16 +212,12 @@

    Method Summary

    boolean equals​(java.lang.Object obj) - -
    Indicates whether some other object is "equal to" this one.
    - +  int hashCode() - -
    Returns a hash code value for the object.
    - +  static CacheBuilderSpec @@ -316,8 +312,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    @@ -328,43 +322,9 @@

    toString

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -376,56 +336,9 @@

    hashCode

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object obj)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/cache/CacheStats.html b/releases/snapshot-jre/api/docs/com/google/common/cache/CacheStats.html index a8b0bad40392..e9a059395511 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/cache/CacheStats.html +++ b/releases/snapshot-jre/api/docs/com/google/common/cache/CacheStats.html @@ -225,9 +225,7 @@

    Method Summary

    boolean equals​(java.lang.Object object) - -
    Indicates whether some other object is "equal to" this one.
    - +  long @@ -239,9 +237,7 @@

    Method Summary

    int hashCode() - -
    Returns a hash code value for the object.
    - +  long @@ -329,9 +325,7 @@

    Method Summary

    java.lang.String toString() - -
    Returns a string representation of the object.
    - +  long @@ -597,43 +591,9 @@

    plus

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -645,56 +605,9 @@

    hashCode

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object object)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -705,29 +618,9 @@

    equals

  • toString

    public java.lang.String toString()
    -
    Description copied from class: java.lang.Object
    -
    Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

    - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

    - 
    - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/cache/ForwardingLoadingCache.html b/releases/snapshot-jre/api/docs/com/google/common/cache/ForwardingLoadingCache.html index 69a2fa558144..69680ca65c0d 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/cache/ForwardingLoadingCache.html +++ b/releases/snapshot-jre/api/docs/com/google/common/cache/ForwardingLoadingCache.html @@ -246,9 +246,7 @@

    Method Summary

    V apply​(K key) - -
    Applies this function to the given argument.
    - +  protected abstract LoadingCache<K,​V> @@ -505,8 +503,6 @@

    getAll

  • apply

    public V apply​(K key)
    -
    Description copied from interface: java.util.function.Function
    -
    Applies this function to the given argument.
    Specified by:
    apply in interface Function<K,​V>
    @@ -514,10 +510,6 @@

    apply

    apply in interface java.util.function.Function<K,​V>
    Specified by:
    apply in interface LoadingCache<K,​V>
    -
    Parameters:
    -
    key - the function argument
    -
    Returns:
    -
    the function result
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/cache/LoadingCache.html b/releases/snapshot-jre/api/docs/com/google/common/cache/LoadingCache.html index 311658a8c878..8758587ed257 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/cache/LoadingCache.html +++ b/releases/snapshot-jre/api/docs/com/google/common/cache/LoadingCache.html @@ -379,17 +379,11 @@

    apply

    Deprecated.
    Provided to satisfy the Function interface; use get(K) or getUnchecked(K) instead.
    -
    Description copied from interface: java.util.function.Function
    -
    Applies this function to the given argument.
    Specified by:
    apply in interface Function<K,​V>
    Specified by:
    apply in interface java.util.function.Function<K,​V>
    -
    Parameters:
    -
    key - the function argument
    -
    Returns:
    -
    the function result
    Throws:
    UncheckedExecutionException - if an exception was thrown while loading the value. (As described in the documentation for getUnchecked(K), LoadingCache should be diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/AbstractIterator.html b/releases/snapshot-jre/api/docs/com/google/common/collect/AbstractIterator.html index f4e3a16e754d..dea6a2882594 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/AbstractIterator.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/AbstractIterator.html @@ -243,16 +243,12 @@

    Method Summary

    boolean hasNext() - -
    Returns true if the iteration has more elements.
    - +  T next() - -
    Returns the next element in the iteration.
    - +  T @@ -379,14 +375,6 @@

    endOfData

  • hasNext

    public final boolean hasNext()
    -
    Description copied from interface: java.util.Iterator
    -
    Returns true if the iteration has more elements. - (In other words, returns true if Iterator.next() would - return an element rather than throwing an exception.)
    -
    -
    Returns:
    -
    true if the iteration has more elements
    -
    • @@ -397,12 +385,6 @@

    hasNext

    next

    @CanIgnoreReturnValue
 public final T next()
    -
    Description copied from interface: java.util.Iterator
    -
    Returns the next element in the iteration.
    -
    -
    Returns:
    -
    the next element in the iteration
    -
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/AbstractSequentialIterator.html b/releases/snapshot-jre/api/docs/com/google/common/collect/AbstractSequentialIterator.html index 71aa6890e2e1..7dd78e42bb03 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/AbstractSequentialIterator.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/AbstractSequentialIterator.html @@ -221,16 +221,12 @@

    Method Summary

    boolean     hasNext() - -
    Returns true if the iteration has more elements.
    - +  T next() - -
    Returns the next element in the iteration.
    - + 
      @@ -316,14 +312,6 @@

      computeNext

    • hasNext

      public final boolean hasNext()
      -
      Description copied from interface: java.util.Iterator
      -
      Returns true if the iteration has more elements. - (In other words, returns true if Iterator.next() would - return an element rather than throwing an exception.)
      -
      -
      Returns:
      -
      true if the iteration has more elements
      -
    @@ -333,12 +321,6 @@

    hasNext

  • next

    public final T next()
    -
    Description copied from interface: java.util.Iterator
    -
    Returns the next element in the iteration.
    -
    -
    Returns:
    -
    the next element in the iteration
    -
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ArrayListMultimap.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ArrayListMultimap.html index fd912f275b7a..f443a9b17db1 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ArrayListMultimap.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ArrayListMultimap.html @@ -643,14 +643,6 @@

    equals

    equals in interface ListMultimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Specified by:
    equals in interface Multimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -949,8 +941,6 @@

    hashCode

    hashCode in interface Multimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    See Also:
    Map.hashCode()
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ArrayTable.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ArrayTable.html index 5392073007ce..e13098bdf39f 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ArrayTable.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ArrayTable.html @@ -334,7 +334,7 @@

    Method Summary

    boolean equals​(java.lang.Object obj) -
    Indicates whether some other object is "equal to" this one.
    +
    Compares the specified object with this table for equality.
    @@ -365,7 +365,7 @@

    Method Summary

    int hashCode() -
    Returns a hash code value for the object.
    +
    Returns the hash code for this table.
    @@ -1086,58 +1086,14 @@

    values

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object obj)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    +
    Description copied from interface: Table
    +
    Compares the specified object with this table for equality. Two tables are equal when their + cell views, as returned by Table.cellSet(), are equal.
    Specified by:
    equals in interface Table<R extends @Nullable java.lang.Object,​C extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -1148,45 +1104,14 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    +
    Description copied from interface: Table
    +
    Returns the hash code for this table. The hash code of a table is defined as the hash code of + its cell view, as returned by Table.cellSet().
    Specified by:
    hashCode in interface Table<R extends @Nullable java.lang.Object,​C extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -1201,8 +1126,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/BiMap.html b/releases/snapshot-jre/api/docs/com/google/common/collect/BiMap.html index b9aa30d21547..169009eec38f 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/BiMap.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/BiMap.html @@ -164,7 +164,7 @@

    Nested Class Summary

    Nested classes/interfaces inherited from interface java.util.Map

    -java.util.Map.Entry<K,​V> +java.util.Map.Entry<K extends java.lang.Object,​V extends java.lang.Object> @@ -204,25 +204,14 @@

    Method Summary

    V put​(K key, V value) - -
    Associates the specified value with the specified key in this map - (optional operation).
    - void putAll​(java.util.Map<? extends K,​? extends V> map) - -
    Copies all of the mappings from the specified map to this map - (optional operation).
    - java.util.Set<V> values() - -
    Returns a Collection view of the values contained in this map.
    -
      @@ -260,24 +249,9 @@

      put

      @CheckForNull V put​(K key, V value) -
      Associates the specified value with the specified key in this map - (optional operation). If the map previously contained a mapping for - the key, the old value is replaced by the specified value. (A map - m is said to contain a mapping for a key k if and only - if m.containsKey(k) would return - true.)
      Specified by:
      put in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
      -
      Parameters:
      -
      key - key with which the specified value is to be associated
      -
      value - value to be associated with the specified key
      -
      Returns:
      -
      the previous value associated with key, or - null if there was no mapping for key. - (A null return can also indicate that the map - previously associated null with key, - if the implementation supports null values.)
      Throws:
      java.lang.IllegalArgumentException - if the given value is already bound to a different key in this bimap. The bimap will remain unmodified in this event. To avoid this exception, call forcePut(K, V) instead.
      @@ -324,20 +298,13 @@

      forcePut

    • putAll

      void putAll​(java.util.Map<? extends K,​? extends V> map)
      -
      Copies all of the mappings from the specified map to this map - (optional operation). The effect of this call is equivalent to that - of calling put(k, v) on this map once - for each mapping from key k to value v in the - specified map. The behavior of this operation is undefined if the - specified map is modified while the operation is in progress. +

      Warning: the results of calling this method may vary depending on the iteration order of map.

      Specified by:
      putAll in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
      -
      Parameters:
      -
      map - mappings to be stored in this map
      Throws:
      java.lang.IllegalArgumentException - if an attempt to put any entry fails. Note that some map entries may have been added to the bimap before the exception was thrown.
      @@ -351,24 +318,12 @@

      putAll

    • values

      java.util.Set<V> values()
      -
      Returns a Collection view of the values contained in this map. - The collection is backed by the map, so changes to the map are - reflected in the collection, and vice-versa. If the map is - modified while an iteration over the collection is in progress - (except through the iterator's own remove operation), - the results of the iteration are undefined. The collection - supports element removal, which removes the corresponding - mapping from the map, via the Iterator.remove, - Collection.remove, removeAll, - retainAll and clear operations. It does not - support the add or addAll operations. +

      Because a bimap has unique values, this method returns a Set, instead of the Collection specified in the Map interface.

      Specified by:
      values in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
      -
      Returns:
      -
      a collection view of the values contained in this map
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ClassToInstanceMap.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ClassToInstanceMap.html index 58d4da9481a2..01548f2a9259 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ClassToInstanceMap.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ClassToInstanceMap.html @@ -186,7 +186,7 @@

    Nested Class Summary

    Nested classes/interfaces inherited from interface java.util.Map

    -java.util.Map.Entry<K,​V> +java.util.Map.Entry<K extends java.lang.Object,​V extends java.lang.Object> diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ConcurrentHashMultiset.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ConcurrentHashMultiset.html index 690bb5d54bd8..c8db1df5288b 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ConcurrentHashMultiset.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ConcurrentHashMultiset.html @@ -198,8 +198,7 @@

    Method Summary

    boolean add​(E element) -
    Ensures that this collection contains the specified element (optional - operation).
    +
    Adds a single occurrence of the specified element to this multiset.
    @@ -213,23 +212,17 @@

    Method Summary

    boolean addAll​(java.util.Collection<? extends E> elementsToAdd) - -
    Adds all of the elements in the specified collection to this collection - (optional operation).
    - void clear() - -
    Removes all of the elements from this collection (optional operation).
    - +  boolean contains​(java.lang.Object element) -
    Returns true if this collection contains the specified element.
    +
    Determines whether this multiset contains the specified element.
    @@ -291,36 +284,30 @@

    Method Summary

    boolean equals​(java.lang.Object object) -
    Indicates whether some other object is "equal to" this one.
    +
    Compares the specified object with this multiset for equality.
    int hashCode() -
    Returns a hash code value for the object.
    +
    Returns the hash code for this multiset.
    boolean isEmpty() - -
    Returns true if this collection contains no elements.
    - +  java.util.Iterator<E> iterator() - -
    Returns an iterator over the elements contained in this collection.
    - boolean remove​(java.lang.Object element) -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation).
    +
    Removes a single occurrence of the specified element from this multiset, if present.
    @@ -334,10 +321,6 @@

    Method Summary

    boolean removeAll​(java.util.Collection<?> elementsToRemove) - -
    Removes all of this collection's elements that are also contained in the - specified collection (optional operation).
    - boolean @@ -351,10 +334,6 @@

    Method Summary

    boolean retainAll​(java.util.Collection<?> elementsToRetain) - -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation).
    - int @@ -379,30 +358,22 @@

    Method Summary

    int size() -
    Returns the number of elements in this collection.
    +
    Returns the total number of all occurrences of all elements in this multiset.
    java.lang.Object[] toArray() - -
    Returns an array containing all of the elements in this collection.
    - +  <T extends @Nullable java.lang.Object>
    T[]     toArray​(T[] array) - -
    Returns an array containing all of the elements in this collection; - the runtime type of the returned array is that of the specified array.
    - +  java.lang.String toString() - -
    Returns a string representation of this collection.
    -
      @@ -529,9 +500,10 @@

      count

    • size

      public int size()
      -
      Returns the number of elements in this collection. If this collection - contains more than Integer.MAX_VALUE elements, returns - Integer.MAX_VALUE. +
      Returns the total number of all occurrences of all elements in this multiset. + +

      Note: this method does not return the number of distinct elements in the + multiset, which is given by entrySet().size().

      If the data in the multiset is modified by any other threads during this method, it is undefined which (if any) of these modifications will be reflected in the result.

      @@ -542,8 +514,6 @@

      size

      size in interface Multiset<E>
      Specified by:
      size in class java.util.AbstractCollection<E>
      -
      Returns:
      -
      the number of elements in this collection
    @@ -554,24 +524,11 @@

    size

  • toArray

    public java.lang.Object[] toArray()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns an array containing all of the elements in this collection. - If this collection makes any guarantees as to what order its elements - are returned by its iterator, this method must return the elements in - the same order. The returned array's runtime component type is Object. - -

    The returned array will be "safe" in that no references to it are - maintained by this collection. (In other words, this method must - allocate a new array even if this collection is backed by an array). - The caller is thus free to modify the returned array.

    Specified by:
    toArray in interface java.util.Collection<E>
    Overrides:
    toArray in class java.util.AbstractCollection<E>
    -
    Returns:
    -
    an array, whose runtime component - type is Object, containing all of the elements in this collection
    • @@ -584,36 +541,11 @@

    toArray

  • toArray

    public <T extends @Nullable java.lang.Object> T[] toArray​(T[] array)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns an array containing all of the elements in this collection; - the runtime type of the returned array is that of the specified array. - If the collection fits in the specified array, it is returned therein. - Otherwise, a new array is allocated with the runtime type of the - specified array and the size of this collection. - -

    If this collection fits in the specified array with room to spare - (i.e., the array has more elements than this collection), the element - in the array immediately following the end of the collection is set to - null. (This is useful in determining the length of this - collection only if the caller knows that this collection does - not contain any null elements.) - -

    If this collection makes any guarantees as to what order its elements - are returned by its iterator, this method must return the elements in - the same order.

    Specified by:
    toArray in interface java.util.Collection<E>
    Overrides:
    toArray in class java.util.AbstractCollection<E>
    -
    Type Parameters:
    -
    T - the component type of the array to contain the collection
    -
    Parameters:
    -
    array - the array into which the elements of this collection are to be - stored, if it is big enough; otherwise, a new array of the same - runtime type is allocated for this purpose.
    -
    Returns:
    -
    an array containing all of the elements in this collection
    • @@ -773,13 +705,9 @@

    createEntrySet

  • isEmpty

    public boolean isEmpty()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains no elements.
    Specified by:
    isEmpty in interface java.util.Collection<E>
    -
    Returns:
    -
    true if this collection contains no elements
    • @@ -790,8 +718,11 @@

    isEmpty

  • iterator

    public java.util.Iterator<E> iterator()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns an iterator over the elements contained in this collection.
    +
    Description copied from interface: Multiset
    +
    + +

    Elements that occur multiple times in the multiset will appear multiple times in this + iterator, though not necessarily sequentially.

    Specified by:
    iterator in interface java.util.Collection<E>
    @@ -801,8 +732,6 @@

    iterator

    iterator in interface Multiset<E>
    Specified by:
    iterator in class java.util.AbstractCollection<E>
    -
    Returns:
    -
    an iterator over the elements contained in this collection
    • @@ -813,9 +742,6 @@

    iterator

  • clear

    public void clear()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes all of the elements from this collection (optional operation). - The collection will be empty after this method returns.
    Specified by:
    clear in interface java.util.Collection<E>
    @@ -830,11 +756,11 @@

    clear

    contains

    public boolean contains​(@CheckForNull
                         java.lang.Object element)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains the specified element. - More formally, returns true if and only if this collection - contains at least one element e such that - Objects.equals(o, e).
    +
    Description copied from interface: Multiset
    +
    Determines whether this multiset contains the specified element. + +

    This method refines Collection.contains(java.lang.Object) to further specify that it may not + throw an exception in response to element being null or of the wrong type.

    Specified by:
    contains in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -843,10 +769,9 @@

    contains

    Overrides:
    contains in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    Parameters:
    -
    element - element whose presence in this collection is to be tested
    +
    element - the element to check for
    Returns:
    -
    true if this collection contains the specified - element
    +
    true if this multiset contains at least one occurrence of the element
    • @@ -860,24 +785,14 @@

    contains

    add

    @CanIgnoreReturnValue
 public final boolean add​(E element)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Ensures that this collection contains the specified element (optional - operation). Returns true if this collection changed as a - result of the call. (Returns false if this collection does - not permit duplicates and already contains the specified element.)

    +

    Description copied from interface: Multiset
    +
    Adds a single occurrence of the specified element to this multiset. - Collections that support this operation may place limitations on what - elements may be added to this collection. In particular, some - collections will refuse to add null elements, and others will - impose restrictions on the type of elements that may be added. - Collection classes should clearly specify in their documentation any - restrictions on what elements may be added.

    +

    This method refines Collection.add(E), which only ensures the presence of the + element, to further specify that a successful call must always increment the count of the + element, and the overall size of the collection, by one. - If a collection refuses to add a particular element for any reason - other than that it already contains the element, it must throw - an exception (rather than returning false). This preserves - the invariant that a collection always contains the specified element - after this call returns.

    +

    To both add the element and obtain the previous count of that element, use add(element, 1) instead.

    Specified by:
    add in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -886,10 +801,11 @@

    add

    Overrides:
    add in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    Parameters:
    -
    element - element whose presence in this collection is to be ensured
    +
    element - the element to add one occurrence of; may be null only if explicitly allowed by + the implementation
    Returns:
    -
    true if this collection changed as a result of the - call
    +
    true always, since this call is required to modify the multiset, unlike other + Collection types
    @@ -902,14 +818,13 @@

    remove

    @CanIgnoreReturnValue
 public final boolean remove​(@CheckForNull
                             java.lang.Object element)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation). More formally, - removes an element e such that - Objects.equals(o, e), if - this collection contains one or more such elements. Returns - true if this collection contained the specified element (or - equivalently, if this collection changed as a result of the call).
    +
    Description copied from interface: Multiset
    +
    Removes a single occurrence of the specified element from this multiset, if present. + +

    This method refines Collection.remove(java.lang.Object) to further specify that it may not + throw an exception in response to element being null or of the wrong type. + +

    To both remove the element and obtain the previous count of that element, use remove(element, 1) instead.

    Specified by:
    remove in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -918,9 +833,9 @@

    remove

    Overrides:
    remove in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    Parameters:
    -
    element - element to be removed from this collection, if present
    +
    element - the element to remove one occurrence of
    Returns:
    -
    true if an element was removed as a result of this call
    +
    true if an occurrence was found and removed
    @@ -932,12 +847,7 @@

    remove

    addAll

    @CanIgnoreReturnValue
 public final boolean addAll​(java.util.Collection<? extends E> elementsToAdd)
    -
    Adds all of the elements in the specified collection to this collection - (optional operation). The behavior of this operation is undefined if - the specified collection is modified while the operation is in progress. - (This implies that the behavior of this call is undefined if the - specified collection is this collection, and this collection is - nonempty.) +

    This implementation is highly efficient when elementsToAdd is itself a Multiset.

    @@ -945,12 +855,6 @@

    addAll

    addAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    Overrides:
    addAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    elementsToAdd - collection containing elements to be added to this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    -
    See Also:
    -
    AbstractCollection.add(Object)
    @@ -962,11 +866,16 @@

    addAll

    removeAll

    @CanIgnoreReturnValue
 public final boolean removeAll​(java.util.Collection<?> elementsToRemove)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes all of this collection's elements that are also contained in the - specified collection (optional operation). After this call returns, - this collection will contain no elements in common with the specified - collection.
    +
    Description copied from interface: Multiset
    +
    + +

    Note: This method ignores how often any element might appear in c, and only + cares whether or not an element appears at all. If you wish to remove one occurrence in this + multiset for every occurrence in c, see Multisets.removeOccurrences(Multiset, + Multiset). + +

    This method refines Collection.removeAll(java.util.Collection<?>) to further specify that it may not + throw an exception in response to any of elements being null or of the wrong type.

    Specified by:
    removeAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -974,14 +883,6 @@

    removeAll

    removeAll in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    removeAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    elementsToRemove - collection containing elements to be removed from this collection
    -
    Returns:
    -
    true if this collection changed as a result of the - call
    -
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    @@ -993,11 +894,16 @@

    removeAll

    retainAll

    @CanIgnoreReturnValue
 public final boolean retainAll​(java.util.Collection<?> elementsToRetain)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation). In other words, removes from - this collection all of its elements that are not contained in the - specified collection.
    +
    Description copied from interface: Multiset
    +
    + +

    Note: This method ignores how often any element might appear in c, and only + cares whether or not an element appears at all. If you wish to remove one occurrence in this + multiset for every occurrence in c, see Multisets.retainOccurrences(Multiset, + Multiset). + +

    This method refines Collection.retainAll(java.util.Collection<?>) to further specify that it may not + throw an exception in response to any of elements being null or of the wrong type.

    Specified by:
    retainAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -1005,13 +911,8 @@

    retainAll

    retainAll in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    retainAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    elementsToRetain - collection containing elements to be retained in this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    +
    Multisets.retainOccurrences(Multiset, Multiset)
    @@ -1077,44 +978,9 @@

    entrySet

    equals

    public final boolean equals​(@CheckForNull
                             java.lang.Object object)
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes. +

    Compares the specified object with this multiset for equality. Returns true if the + given object is also a multiset and contains equal elements with equal counts, regardless of + order.

    This implementation returns true if object is a multiset of the same size and if, for each element, the two multisets have the same count.

    @@ -1125,14 +991,6 @@

    equals

    equals in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -1143,34 +1001,14 @@

    equals

  • hashCode

    public final int hashCode()
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.) +

    Returns the hash code for this multiset. This is defined as the sum of + + 
    
+ ((element == null) ? 0 : element.hashCode()) ^ count(element)
+
    + +

    over all distinct elements in the multiset. It follows that a multiset and its entry set + always have the same hash code.

    This implementation returns the hash code of Multiset.entrySet().

    @@ -1180,11 +1018,6 @@

    hashCode

    hashCode in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -1195,12 +1028,11 @@

    hashCode

  • toString

    public final java.lang.String toString()
    -
    Returns a string representation of this collection. The string - representation consists of a list of the collection's elements in the - order they are returned by its iterator, enclosed in square brackets - ("[]"). Adjacent elements are separated by the characters - ", " (comma and space). Elements are converted to strings as - by String.valueOf(Object). +
    + +

    It is recommended, though not mandatory, that this method return the result of invoking + Multiset.toString() on the Multiset.entrySet(), yielding a result such as [a x 3, c, d x 2, + e].

    This implementation returns the result of invoking toString on Multiset.entrySet().

    @@ -1208,8 +1040,6 @@

    toString

    toString in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    toString in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a string representation of this collection
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ContiguousSet.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ContiguousSet.html index 3fbb702b7307..8386004621c4 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ContiguousSet.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ContiguousSet.html @@ -302,19 +302,12 @@

    Method Summary

    ContiguousSet<C> headSet​(C toElement) - -
    Returns a view of the portion of this set whose elements are - strictly less than toElement.
    - ContiguousSet<C> headSet​(C toElement, boolean inclusive) - -
    Returns a view of the portion of this set whose elements are less than - (or equal to, if inclusive is true) toElement.
    - +  abstract ContiguousSet<C> @@ -417,37 +410,22 @@

    Method Summary

    boolean fromInclusive, C toElement, boolean toInclusive)     - -
    Returns a view of the portion of this set whose elements range from - fromElement to toElement.
    - +  ContiguousSet<C> subSet​(C fromElement, C toElement) - -
    Returns a view of the portion of this set whose elements range - from fromElement, inclusive, to toElement, - exclusive.
    - ContiguousSet<C> tailSet​(C fromElement) - -
    Returns a view of the portion of this set whose elements are - greater than or equal to fromElement.
    - ContiguousSet<C> tailSet​(C fromElement, boolean inclusive) - -
    Returns a view of the portion of this set whose elements are greater - than (or equal to, if inclusive is true) fromElement.
    - +  static <E> java.util.stream.Collector<E,​?,​ImmutableSet<E>> @@ -646,16 +624,7 @@

    closedOpen

    headSet

    public ContiguousSet<C> headSet​(C toElement)
    Description copied from class: ImmutableSortedSet
    -
    Returns a view of the portion of this set whose elements are - strictly less than toElement. The returned set is - backed by this set, so changes in the returned set are - reflected in this set, and vice-versa. The returned set - supports all optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range. - -

    Equivalent to headSet(toElement, false). +

    This method returns a serializable ImmutableSortedSet. @@ -670,11 +639,6 @@

    headSet

    headSet in interface java.util.SortedSet<C extends java.lang.Comparable>
    Overrides:
    headSet in class ImmutableSortedSet<C extends java.lang.Comparable>
    -
    Parameters:
    -
    toElement - high endpoint (exclusive) of the returned set
    -
    Returns:
    -
    a view of the portion of this set whose elements are strictly - less than toElement
    @@ -689,27 +653,11 @@

    headSet

    @GwtIncompatible
 public ContiguousSet<C> headSet​(C toElement,
                                 boolean inclusive)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns a view of the portion of this set whose elements are less than - (or equal to, if inclusive is true) toElement. The - returned set is backed by this set, so changes in the returned set are - reflected in this set, and vice-versa. The returned set supports all - optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    headSet in interface java.util.NavigableSet<C extends java.lang.Comparable>
    Overrides:
    headSet in class ImmutableSortedSet<C extends java.lang.Comparable>
    -
    Parameters:
    -
    toElement - high endpoint of the returned set
    -
    inclusive - true if the high endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this set whose elements are less than - (or equal to, if inclusive is true) toElement
    Since:
    12.0
    @@ -726,18 +674,7 @@

    subSet

    public ContiguousSet<C> subSet​(C fromElement,
                                C toElement)
    Description copied from class: ImmutableSortedSet
    -
    Returns a view of the portion of this set whose elements range - from fromElement, inclusive, to toElement, - exclusive. (If fromElement and toElement are - equal, the returned set is empty.) The returned set is backed - by this set, so changes in the returned set are reflected in - this set, and vice-versa. The returned set supports all - optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range. - -

    Equivalent to subSet(fromElement, true, toElement, false). +

    This method returns a serializable ImmutableSortedSet. @@ -753,12 +690,6 @@

    subSet

    subSet in interface java.util.SortedSet<C extends java.lang.Comparable>
    Overrides:
    subSet in class ImmutableSortedSet<C extends java.lang.Comparable>
    -
    Parameters:
    -
    fromElement - low endpoint (inclusive) of the returned set
    -
    toElement - high endpoint (exclusive) of the returned set
    -
    Returns:
    -
    a view of the portion of this set whose elements range from - fromElement, inclusive, to toElement, exclusive
    @@ -775,32 +706,11 @@

    subSet

    boolean fromInclusive, C toElement, boolean toInclusive) -
    Description copied from interface: java.util.NavigableSet
    -
    Returns a view of the portion of this set whose elements range from - fromElement to toElement. If fromElement and - toElement are equal, the returned set is empty unless - fromInclusive and toInclusive are both true. The returned set - is backed by this set, so changes in the returned set are reflected in - this set, and vice-versa. The returned set supports all optional set - operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    subSet in interface java.util.NavigableSet<C extends java.lang.Comparable>
    Overrides:
    subSet in class ImmutableSortedSet<C extends java.lang.Comparable>
    -
    Parameters:
    -
    fromElement - low endpoint of the returned set
    -
    fromInclusive - true if the low endpoint - is to be included in the returned view
    -
    toElement - high endpoint of the returned set
    -
    toInclusive - true if the high endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this set whose elements range from - fromElement, inclusive, to toElement, exclusive
    Since:
    12.0
    @@ -816,16 +726,7 @@

    subSet

    tailSet

    public ContiguousSet<C> tailSet​(C fromElement)
    Description copied from class: ImmutableSortedSet
    -
    Returns a view of the portion of this set whose elements are - greater than or equal to fromElement. The returned - set is backed by this set, so changes in the returned set are - reflected in this set, and vice-versa. The returned set - supports all optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range. - -

    Equivalent to tailSet(fromElement, true). +

    This method returns a serializable ImmutableSortedSet. @@ -840,11 +741,6 @@

    tailSet

    tailSet in interface java.util.SortedSet<C extends java.lang.Comparable>
    Overrides:
    tailSet in class ImmutableSortedSet<C extends java.lang.Comparable>
    -
    Parameters:
    -
    fromElement - low endpoint (inclusive) of the returned set
    -
    Returns:
    -
    a view of the portion of this set whose elements are greater - than or equal to fromElement
    @@ -859,27 +755,11 @@

    tailSet

    @GwtIncompatible
 public ContiguousSet<C> tailSet​(C fromElement,
                                 boolean inclusive)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns a view of the portion of this set whose elements are greater - than (or equal to, if inclusive is true) fromElement. - The returned set is backed by this set, so changes in the returned set - are reflected in this set, and vice-versa. The returned set supports - all optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    tailSet in interface java.util.NavigableSet<C extends java.lang.Comparable>
    Overrides:
    tailSet in class ImmutableSortedSet<C extends java.lang.Comparable>
    -
    Parameters:
    -
    fromElement - low endpoint of the returned set
    -
    inclusive - true if the low endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this set whose elements are greater - than or equal to fromElement
    Since:
    12.0
    @@ -944,8 +824,6 @@

    toString

    Overrides:
    toString in class java.util.AbstractCollection<C extends java.lang.Comparable>
    -
    Returns:
    -
    a string representation of this collection
    @@ -1026,12 +904,6 @@

    of

    element. Proper calls will resolve to the version in ImmutableSortedSet, not this dummy version.
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    element - the single element
    -
    Returns:
    -
    a Set containing the specified element
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -1055,13 +927,6 @@

    of

    element. Proper calls will resolve to the version in ImmutableSortedSet, not this dummy version.
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    Returns:
    -
    a Set containing the specified elements
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -1086,14 +951,6 @@

    of

    element. Proper calls will resolve to the version in ImmutableSortedSet, not this dummy version.
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    Returns:
    -
    a Set containing the specified elements
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -1119,15 +976,6 @@

    of

    element. Proper calls will resolve to the version in ImmutableSortedSet, not this dummy version.
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    e4 - the fourth element
    -
    Returns:
    -
    a Set containing the specified elements
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -1154,16 +1002,6 @@

    of

    element. Proper calls will resolve to the version in ImmutableSortedSet, not this dummy version.
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    e4 - the fourth element
    -
    e5 - the fifth element
    -
    Returns:
    -
    a Set containing the specified elements
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -1193,18 +1031,6 @@

    of

    element. Proper calls will resolve to the version in ImmutableSortedSet, not this dummy version.
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    e4 - the fourth element
    -
    e5 - the fifth element
    -
    e6 - the sixth element
    -
    remaining - the seventh element
    -
    Returns:
    -
    a Set containing the specified elements
    Throws:
    java.lang.UnsupportedOperationException - always
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/EnumBiMap.html b/releases/snapshot-jre/api/docs/com/google/common/collect/EnumBiMap.html index d35a3cb012f2..63be86c0b0ef 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/EnumBiMap.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/EnumBiMap.html @@ -186,7 +186,7 @@

    Nested classes/interfaces inherited from class com.google.common.collec

    Nested classes/interfaces inherited from interface java.util.Map

    -java.util.Map.Entry<K,​V> +java.util.Map.Entry<K extends java.lang.Object,​V extends java.lang.Object> @@ -208,17 +208,12 @@

    Method Summary

    void clear() - -
    Removes all of the mappings from this map (optional operation).
    - +  boolean containsValue​(java.lang.Object value) - -
    Returns true if this map maps one or more keys to the - specified value.
    - +  static <K extends java.lang.Enum<K>,​V extends java.lang.Enum<V>>
    EnumBiMap<K,​V>     @@ -245,9 +240,7 @@

    Method Summary

    java.util.Set<java.util.Map.Entry<K,​V>> entrySet() - -
    Returns a Set view of the mappings contained in this map.
    - +  V @@ -269,9 +262,7 @@

    Method Summary

    java.util.Set<K> keySet() - -
    Returns a Set view of the keys contained in this map.
    - +  java.lang.Class<K> @@ -284,42 +275,24 @@

    Method Summary

    V put​(K key, V value) - -
    Associates the specified value with the specified key in this map - (optional operation).
    - void putAll​(java.util.Map<? extends K,​? extends V> map) - -
    Copies all of the mappings from the specified map to this map - (optional operation).
    - V remove​(java.lang.Object key) - -
    Removes the mapping for a key from this map if it is present - (optional operation).
    - +  void replaceAll​(java.util.function.BiFunction<? super K,​? super V,​? extends V> function) - -
    Replaces each entry's value with the result of invoking the given - function on that entry until all entries have been processed or the - function throws an exception.
    - +  java.util.Set<V> values() - -
    Returns a Collection view of the values contained in this map.
    - java.lang.Class<V> @@ -454,23 +427,11 @@

    delegate

    containsValue

    public boolean containsValue​(@CheckForNull
                              java.lang.Object value)
    -
    Description copied from interface: java.util.Map
    -
    Returns true if this map maps one or more keys to the - specified value. More formally, returns true if and only if - this map contains at least one mapping to a value v such that - Objects.equals(value, v). This operation - will probably require time linear in the map size for most - implementations of the Map interface.
    Specified by:
    containsValue in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    containsValue in class ForwardingMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    value - value whose presence in this map is to be tested
    -
    Returns:
    -
    true if this map maps one or more keys to the - specified value
    @@ -486,13 +447,7 @@

    put

    @CheckForNull public V put​(K key, V value) -
    Description copied from interface: java.util.Map
    -
    Associates the specified value with the specified key in this map - (optional operation). If the map previously contained a mapping for - the key, the old value is replaced by the specified value. (A map - m is said to contain a mapping for a key k if and only - if m.containsKey(k) would return - true.)
    +
    Description copied from interface: BiMap
    Specified by:
    put in interface BiMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    @@ -500,15 +455,6 @@

    put

    put in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    put in class ForwardingMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - key with which the specified value is to be associated
    -
    value - value to be associated with the specified key
    -
    Returns:
    -
    the previous value associated with key, or - null if there was no mapping for key. - (A null return can also indicate that the map - previously associated null with key, - if the implementation supports null values.)
    @@ -558,33 +504,11 @@

    remove

    @CheckForNull public V remove​(@CheckForNull java.lang.Object key) -
    Description copied from interface: java.util.Map
    -
    Removes the mapping for a key from this map if it is present - (optional operation). More formally, if this map contains a mapping - from key k to value v such that - Objects.equals(key, k), that mapping - is removed. (The map can contain at most one such mapping.) - -

    Returns the value to which this map previously associated the key, - or null if the map contained no mapping for the key. - -

    If this map permits null values, then a return value of - null does not necessarily indicate that the map - contained no mapping for the key; it's also possible that the map - explicitly mapped the key to null. - -

    The map will not contain a mapping for the specified key once the - call returns.

    Specified by:
    remove in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    remove in class ForwardingMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - key whose mapping is to be removed from the map
    -
    Returns:
    -
    the previous value associated with key, or - null if there was no mapping for key.
    @@ -595,13 +519,11 @@

    remove

  • putAll

    public void putAll​(java.util.Map<? extends K,​? extends V> map)
    -
    Description copied from interface: java.util.Map
    -
    Copies all of the mappings from the specified map to this map - (optional operation). The effect of this call is equivalent to that - of calling put(k, v) on this map once - for each mapping from key k to value v in the - specified map. The behavior of this operation is undefined if the - specified map is modified while the operation is in progress.
    +
    Description copied from interface: BiMap
    +
    + +

    Warning: the results of calling this method may vary depending on the iteration order + of map.

    Specified by:
    putAll in interface BiMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    @@ -609,8 +531,6 @@

    putAll

    putAll in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    putAll in class ForwardingMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    map - mappings to be stored in this map
    • @@ -621,16 +541,9 @@

    putAll

  • replaceAll

    public void replaceAll​(java.util.function.BiFunction<? super K,​? super V,​? extends V> function)
    -
    Description copied from interface: java.util.Map
    -
    Replaces each entry's value with the result of invoking the given - function on that entry until all entries have been processed or the - function throws an exception. Exceptions thrown by the function are - relayed to the caller.
    Specified by:
    replaceAll in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    function - the function to apply to each entry
    • @@ -641,9 +554,6 @@

    replaceAll

  • clear

    public void clear()
    -
    Description copied from interface: java.util.Map
    -
    Removes all of the mappings from this map (optional operation). - The map will be empty after this call returns.
    Specified by:
    clear in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    @@ -681,25 +591,11 @@

    inverse

  • keySet

    public java.util.Set<K> keySet()
    -
    Description copied from interface: java.util.Map
    -
    Returns a Set view of the keys contained in this map. - The set is backed by the map, so changes to the map are - reflected in the set, and vice-versa. If the map is modified - while an iteration over the set is in progress (except through - the iterator's own remove operation), the results of - the iteration are undefined. The set supports element removal, - which removes the corresponding mapping from the map, via the - Iterator.remove, Set.remove, - removeAll, retainAll, and clear - operations. It does not support the add or addAll - operations.
    Specified by:
    keySet in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    keySet in class ForwardingMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a set view of the keys contained in this map
    • @@ -710,18 +606,10 @@

    keySet

  • values

    public java.util.Set<V> values()
    -
    Description copied from interface: java.util.Map
    -
    Returns a Collection view of the values contained in this map. - The collection is backed by the map, so changes to the map are - reflected in the collection, and vice-versa. If the map is - modified while an iteration over the collection is in progress - (except through the iterator's own remove operation), - the results of the iteration are undefined. The collection - supports element removal, which removes the corresponding - mapping from the map, via the Iterator.remove, - Collection.remove, removeAll, - retainAll and clear operations. It does not - support the add or addAll operations.
    +
    Description copied from interface: BiMap
    +
    + +

    Because a bimap has unique values, this method returns a Set, instead of the Collection specified in the Map interface.

    Specified by:
    values in interface BiMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    @@ -729,8 +617,6 @@

    values

    values in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    values in class ForwardingMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a collection view of the values contained in this map
    • @@ -741,26 +627,11 @@

    values

  • entrySet

    public java.util.Set<java.util.Map.Entry<K,​V>> entrySet()
    -
    Description copied from interface: java.util.Map
    -
    Returns a Set view of the mappings contained in this map. - The set is backed by the map, so changes to the map are - reflected in the set, and vice-versa. If the map is modified - while an iteration over the set is in progress (except through - the iterator's own remove operation, or through the - setValue operation on a map entry returned by the - iterator) the results of the iteration are undefined. The set - supports element removal, which removes the corresponding - mapping from the map, via the Iterator.remove, - Set.remove, removeAll, retainAll and - clear operations. It does not support the - add or addAll operations.
    Specified by:
    entrySet in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    entrySet in class ForwardingMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a set view of the mappings contained in this map
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/EnumHashBiMap.html b/releases/snapshot-jre/api/docs/com/google/common/collect/EnumHashBiMap.html index 83e4931b7017..46e5cb103c0b 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/EnumHashBiMap.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/EnumHashBiMap.html @@ -187,7 +187,7 @@

    Nested classes/interfaces inherited from class com.google.common.collec

    Nested classes/interfaces inherited from interface java.util.Map

    -java.util.Map.Entry<K,​V>
    • +java.util.Map.Entry<K extends java.lang.Object,​V extends java.lang.Object> @@ -209,17 +209,12 @@

    Method Summary

    void clear() - -
    Removes all of the mappings from this map (optional operation).
    - +  boolean containsValue​(java.lang.Object value) - -
    Returns true if this map maps one or more keys to the - specified value.
    - +  static <K extends java.lang.Enum<K>,​V extends @Nullable java.lang.Object>
    EnumHashBiMap<K,​V>     @@ -245,9 +240,7 @@

    Method Summary

    java.util.Set<java.util.Map.Entry<K,​V>> entrySet() - -
    Returns a Set view of the mappings contained in this map.
    - +  V @@ -269,9 +262,7 @@

    Method Summary

    java.util.Set<K> keySet() - -
    Returns a Set view of the keys contained in this map.
    - +  java.lang.Class<K> @@ -284,42 +275,24 @@

    Method Summary

    V put​(K key, V value) - -
    Associates the specified value with the specified key in this map - (optional operation).
    - void putAll​(java.util.Map<? extends K,​? extends V> map) - -
    Copies all of the mappings from the specified map to this map - (optional operation).
    - V remove​(java.lang.Object key) - -
    Removes the mapping for a key from this map if it is present - (optional operation).
    - +  void replaceAll​(java.util.function.BiFunction<? super K,​? super V,​? extends V> function) - -
    Replaces each entry's value with the result of invoking the given - function on that entry until all entries have been processed or the - function throws an exception.
    - +  java.util.Set<V> values() - -
    Returns a Collection view of the values contained in this map.
    -
      @@ -412,27 +385,12 @@

      put

      @CheckForNull public V put​(K key, V value) -
      Description copied from interface: java.util.Map
      -
      Associates the specified value with the specified key in this map - (optional operation). If the map previously contained a mapping for - the key, the old value is replaced by the specified value. (A map - m is said to contain a mapping for a key k if and only - if m.containsKey(k) would return - true.)
      +
      Description copied from interface: BiMap
      Specified by:
      put in interface BiMap<K extends java.lang.Enum<K>,​V extends @Nullable java.lang.Object>
      Specified by:
      put in interface java.util.Map<K extends java.lang.Enum<K>,​V extends @Nullable java.lang.Object>
      -
      Parameters:
      -
      key - key with which the specified value is to be associated
      -
      value - value to be associated with the specified key
      -
      Returns:
      -
      the previous value associated with key, or - null if there was no mapping for key. - (A null return can also indicate that the map - previously associated null with key, - if the implementation supports null values.)
    @@ -508,23 +466,11 @@

    delegate

    containsValue

    public boolean containsValue​(@CheckForNull
                              java.lang.Object value)
    -
    Description copied from interface: java.util.Map
    -
    Returns true if this map maps one or more keys to the - specified value. More formally, returns true if and only if - this map contains at least one mapping to a value v such that - Objects.equals(value, v). This operation - will probably require time linear in the map size for most - implementations of the Map interface.
    Specified by:
    containsValue in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    containsValue in class ForwardingMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    value - value whose presence in this map is to be tested
    -
    Returns:
    -
    true if this map maps one or more keys to the - specified value
    @@ -538,33 +484,11 @@

    remove

    @CheckForNull public V remove​(@CheckForNull java.lang.Object key) -
    Description copied from interface: java.util.Map
    -
    Removes the mapping for a key from this map if it is present - (optional operation). More formally, if this map contains a mapping - from key k to value v such that - Objects.equals(key, k), that mapping - is removed. (The map can contain at most one such mapping.) - -

    Returns the value to which this map previously associated the key, - or null if the map contained no mapping for the key. - -

    If this map permits null values, then a return value of - null does not necessarily indicate that the map - contained no mapping for the key; it's also possible that the map - explicitly mapped the key to null. - -

    The map will not contain a mapping for the specified key once the - call returns.

    Specified by:
    remove in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    remove in class ForwardingMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - key whose mapping is to be removed from the map
    -
    Returns:
    -
    the previous value associated with key, or - null if there was no mapping for key.
    @@ -575,13 +499,11 @@

    remove

  • putAll

    public void putAll​(java.util.Map<? extends K,​? extends V> map)
    -
    Description copied from interface: java.util.Map
    -
    Copies all of the mappings from the specified map to this map - (optional operation). The effect of this call is equivalent to that - of calling put(k, v) on this map once - for each mapping from key k to value v in the - specified map. The behavior of this operation is undefined if the - specified map is modified while the operation is in progress.
    +
    Description copied from interface: BiMap
    +
    + +

    Warning: the results of calling this method may vary depending on the iteration order + of map.

    Specified by:
    putAll in interface BiMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    @@ -589,8 +511,6 @@

    putAll

    putAll in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    putAll in class ForwardingMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    map - mappings to be stored in this map
    • @@ -601,16 +521,9 @@

    putAll

  • replaceAll

    public void replaceAll​(java.util.function.BiFunction<? super K,​? super V,​? extends V> function)
    -
    Description copied from interface: java.util.Map
    -
    Replaces each entry's value with the result of invoking the given - function on that entry until all entries have been processed or the - function throws an exception. Exceptions thrown by the function are - relayed to the caller.
    Specified by:
    replaceAll in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    function - the function to apply to each entry
    • @@ -621,9 +534,6 @@

    replaceAll

  • clear

    public void clear()
    -
    Description copied from interface: java.util.Map
    -
    Removes all of the mappings from this map (optional operation). - The map will be empty after this call returns.
    Specified by:
    clear in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    @@ -661,25 +571,11 @@

    inverse

  • keySet

    public java.util.Set<K> keySet()
    -
    Description copied from interface: java.util.Map
    -
    Returns a Set view of the keys contained in this map. - The set is backed by the map, so changes to the map are - reflected in the set, and vice-versa. If the map is modified - while an iteration over the set is in progress (except through - the iterator's own remove operation), the results of - the iteration are undefined. The set supports element removal, - which removes the corresponding mapping from the map, via the - Iterator.remove, Set.remove, - removeAll, retainAll, and clear - operations. It does not support the add or addAll - operations.
    Specified by:
    keySet in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    keySet in class ForwardingMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a set view of the keys contained in this map
    • @@ -690,18 +586,10 @@

    keySet

  • values

    public java.util.Set<V> values()
    -
    Description copied from interface: java.util.Map
    -
    Returns a Collection view of the values contained in this map. - The collection is backed by the map, so changes to the map are - reflected in the collection, and vice-versa. If the map is - modified while an iteration over the collection is in progress - (except through the iterator's own remove operation), - the results of the iteration are undefined. The collection - supports element removal, which removes the corresponding - mapping from the map, via the Iterator.remove, - Collection.remove, removeAll, - retainAll and clear operations. It does not - support the add or addAll operations.
    +
    Description copied from interface: BiMap
    +
    + +

    Because a bimap has unique values, this method returns a Set, instead of the Collection specified in the Map interface.

    Specified by:
    values in interface BiMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    @@ -709,8 +597,6 @@

    values

    values in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    values in class ForwardingMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a collection view of the values contained in this map
    • @@ -721,26 +607,11 @@

    values

  • entrySet

    public java.util.Set<java.util.Map.Entry<K,​V>> entrySet()
    -
    Description copied from interface: java.util.Map
    -
    Returns a Set view of the mappings contained in this map. - The set is backed by the map, so changes to the map are - reflected in the set, and vice-versa. If the map is modified - while an iteration over the set is in progress (except through - the iterator's own remove operation, or through the - setValue operation on a map entry returned by the - iterator) the results of the iteration are undefined. The set - supports element removal, which removes the corresponding - mapping from the map, via the Iterator.remove, - Set.remove, removeAll, retainAll and - clear operations. It does not support the - add or addAll operations.
    Specified by:
    entrySet in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    entrySet in class ForwardingMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a set view of the mappings contained in this map
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/EnumMultiset.html b/releases/snapshot-jre/api/docs/com/google/common/collect/EnumMultiset.html index 46a26ec21242..505ec0dda079 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/EnumMultiset.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/EnumMultiset.html @@ -198,8 +198,7 @@

    Method Summary

    boolean add​(E element) -
    Ensures that this collection contains the specified element (optional - operation).
    +
    Adds a single occurrence of the specified element to this multiset.
    @@ -213,23 +212,17 @@

    Method Summary

    boolean addAll​(java.util.Collection<? extends E> elementsToAdd) - -
    Adds all of the elements in the specified collection to this collection - (optional operation).
    - void clear() - -
    Removes all of the elements from this collection (optional operation).
    - +  boolean contains​(java.lang.Object element) -
    Returns true if this collection contains the specified element.
    +
    Determines whether this multiset contains the specified element.
    @@ -281,7 +274,7 @@

    Method Summary

    boolean equals​(java.lang.Object object) -
    Indicates whether some other object is "equal to" this one.
    +
    Compares the specified object with this multiset for equality.
    @@ -296,29 +289,23 @@

    Method Summary

    int hashCode() -
    Returns a hash code value for the object.
    +
    Returns the hash code for this multiset.
    boolean isEmpty() - -
    Returns true if this collection contains no elements.
    - +  java.util.Iterator<E> iterator() - -
    Returns an iterator over the elements contained in this collection.
    - boolean remove​(java.lang.Object element) -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation).
    +
    Removes a single occurrence of the specified element from this multiset, if present.
    @@ -332,18 +319,10 @@

    Method Summary

    boolean removeAll​(java.util.Collection<?> elementsToRemove) - -
    Removes all of this collection's elements that are also contained in the - specified collection (optional operation).
    - boolean retainAll​(java.util.Collection<?> elementsToRetain) - -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation).
    - int @@ -367,15 +346,12 @@

    Method Summary

    int size() -
    Returns the number of elements in this collection.
    +
    Returns the total number of all occurrences of all elements in this multiset.
    java.lang.String toString() - -
    Returns a string representation of this collection.
    -
      @@ -472,10 +448,11 @@

      create

    • size

      public int size()
      -
      Description copied from interface: java.util.Collection
      -
      Returns the number of elements in this collection. If this collection - contains more than Integer.MAX_VALUE elements, returns - Integer.MAX_VALUE.
      +
      Description copied from interface: Multiset
      +
      Returns the total number of all occurrences of all elements in this multiset. + +

      Note: this method does not return the number of distinct elements in the + multiset, which is given by entrySet().size().

      Specified by:
      size in interface java.util.Collection<E extends java.lang.Enum<E>>
      @@ -483,8 +460,6 @@

      size

      size in interface Multiset<E extends java.lang.Enum<E>>
      Specified by:
      size in class java.util.AbstractCollection<E extends java.lang.Enum<E>>
      -
      Returns:
      -
      the number of elements in this collection
    @@ -605,9 +580,6 @@

    setCount

  • clear

    public void clear()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes all of the elements from this collection (optional operation). - The collection will be empty after this method returns.
    Specified by:
    clear in interface java.util.Collection<E extends java.lang.Enum<E>>
    @@ -639,8 +611,11 @@

    forEachEntry

  • iterator

    public java.util.Iterator<E> iterator()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns an iterator over the elements contained in this collection.
    +
    Description copied from interface: Multiset
    +
    + +

    Elements that occur multiple times in the multiset will appear multiple times in this + iterator, though not necessarily sequentially.

    Specified by:
    iterator in interface java.util.Collection<E extends java.lang.Enum<E>>
    @@ -650,8 +625,6 @@

    iterator

    iterator in interface Multiset<E extends java.lang.Enum<E>>
    Specified by:
    iterator in class java.util.AbstractCollection<E extends java.lang.Enum<E>>
    -
    Returns:
    -
    an iterator over the elements contained in this collection
    • @@ -662,15 +635,11 @@

    iterator

  • isEmpty

    public boolean isEmpty()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains no elements.
    Specified by:
    isEmpty in interface java.util.Collection<E extends @Nullable java.lang.Object>
    Overrides:
    isEmpty in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    true if this collection contains no elements
    • @@ -682,11 +651,11 @@

    isEmpty

    contains

    public boolean contains​(@CheckForNull
                         java.lang.Object element)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains the specified element. - More formally, returns true if and only if this collection - contains at least one element e such that - Objects.equals(o, e).
    +
    Description copied from interface: Multiset
    +
    Determines whether this multiset contains the specified element. + +

    This method refines Collection.contains(java.lang.Object) to further specify that it may not + throw an exception in response to element being null or of the wrong type.

    Specified by:
    contains in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -695,10 +664,9 @@

    contains

    Overrides:
    contains in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    Parameters:
    -
    element - element whose presence in this collection is to be tested
    +
    element - the element to check for
    Returns:
    -
    true if this collection contains the specified - element
    +
    true if this multiset contains at least one occurrence of the element
    • @@ -712,24 +680,14 @@

    contains

    add

    @CanIgnoreReturnValue
 public final boolean add​(E element)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Ensures that this collection contains the specified element (optional - operation). Returns true if this collection changed as a - result of the call. (Returns false if this collection does - not permit duplicates and already contains the specified element.)

    +

    Description copied from interface: Multiset
    +
    Adds a single occurrence of the specified element to this multiset. - Collections that support this operation may place limitations on what - elements may be added to this collection. In particular, some - collections will refuse to add null elements, and others will - impose restrictions on the type of elements that may be added. - Collection classes should clearly specify in their documentation any - restrictions on what elements may be added.

    +

    This method refines Collection.add(E), which only ensures the presence of the + element, to further specify that a successful call must always increment the count of the + element, and the overall size of the collection, by one. - If a collection refuses to add a particular element for any reason - other than that it already contains the element, it must throw - an exception (rather than returning false). This preserves - the invariant that a collection always contains the specified element - after this call returns.

    +

    To both add the element and obtain the previous count of that element, use add(element, 1) instead.

    Specified by:
    add in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -738,10 +696,11 @@

    add

    Overrides:
    add in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    Parameters:
    -
    element - element whose presence in this collection is to be ensured
    +
    element - the element to add one occurrence of; may be null only if explicitly allowed by + the implementation
    Returns:
    -
    true if this collection changed as a result of the - call
    +
    true always, since this call is required to modify the multiset, unlike other + Collection types
    • @@ -754,14 +713,13 @@

    remove

    @CanIgnoreReturnValue
 public final boolean remove​(@CheckForNull
                             java.lang.Object element)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation). More formally, - removes an element e such that - Objects.equals(o, e), if - this collection contains one or more such elements. Returns - true if this collection contained the specified element (or - equivalently, if this collection changed as a result of the call).
    +
    Description copied from interface: Multiset
    +
    Removes a single occurrence of the specified element from this multiset, if present. + +

    This method refines Collection.remove(java.lang.Object) to further specify that it may not + throw an exception in response to element being null or of the wrong type. + +

    To both remove the element and obtain the previous count of that element, use remove(element, 1) instead.

    Specified by:
    remove in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -770,9 +728,9 @@

    remove

    Overrides:
    remove in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    Parameters:
    -
    element - element to be removed from this collection, if present
    +
    element - the element to remove one occurrence of
    Returns:
    -
    true if an element was removed as a result of this call
    +
    true if an occurrence was found and removed
    @@ -813,12 +771,7 @@

    setCount

    addAll

    @CanIgnoreReturnValue
 public final boolean addAll​(java.util.Collection<? extends E> elementsToAdd)
    -
    Adds all of the elements in the specified collection to this collection - (optional operation). The behavior of this operation is undefined if - the specified collection is modified while the operation is in progress. - (This implies that the behavior of this call is undefined if the - specified collection is this collection, and this collection is - nonempty.) +

    This implementation is highly efficient when elementsToAdd is itself a Multiset.

    @@ -826,12 +779,6 @@

    addAll

    addAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    Overrides:
    addAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    elementsToAdd - collection containing elements to be added to this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    -
    See Also:
    -
    AbstractCollection.add(Object)
    @@ -843,11 +790,16 @@

    addAll

    removeAll

    @CanIgnoreReturnValue
 public final boolean removeAll​(java.util.Collection<?> elementsToRemove)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes all of this collection's elements that are also contained in the - specified collection (optional operation). After this call returns, - this collection will contain no elements in common with the specified - collection.
    +
    Description copied from interface: Multiset
    +
    + +

    Note: This method ignores how often any element might appear in c, and only + cares whether or not an element appears at all. If you wish to remove one occurrence in this + multiset for every occurrence in c, see Multisets.removeOccurrences(Multiset, + Multiset). + +

    This method refines Collection.removeAll(java.util.Collection<?>) to further specify that it may not + throw an exception in response to any of elements being null or of the wrong type.

    Specified by:
    removeAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -855,14 +807,6 @@

    removeAll

    removeAll in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    removeAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    elementsToRemove - collection containing elements to be removed from this collection
    -
    Returns:
    -
    true if this collection changed as a result of the - call
    -
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    @@ -874,11 +818,16 @@

    removeAll

    retainAll

    @CanIgnoreReturnValue
 public final boolean retainAll​(java.util.Collection<?> elementsToRetain)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation). In other words, removes from - this collection all of its elements that are not contained in the - specified collection.
    +
    Description copied from interface: Multiset
    +
    + +

    Note: This method ignores how often any element might appear in c, and only + cares whether or not an element appears at all. If you wish to remove one occurrence in this + multiset for every occurrence in c, see Multisets.retainOccurrences(Multiset, + Multiset). + +

    This method refines Collection.retainAll(java.util.Collection<?>) to further specify that it may not + throw an exception in response to any of elements being null or of the wrong type.

    Specified by:
    retainAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -886,13 +835,8 @@

    retainAll

    retainAll in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    retainAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    elementsToRetain - collection containing elements to be retained in this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    +
    Multisets.retainOccurrences(Multiset, Multiset)
    @@ -958,44 +902,9 @@

    entrySet

    equals

    public final boolean equals​(@CheckForNull
                             java.lang.Object object)
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes. +

    Compares the specified object with this multiset for equality. Returns true if the + given object is also a multiset and contains equal elements with equal counts, regardless of + order.

    This implementation returns true if object is a multiset of the same size and if, for each element, the two multisets have the same count.

    @@ -1006,14 +915,6 @@

    equals

    equals in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -1024,34 +925,14 @@

    equals

  • hashCode

    public final int hashCode()
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.) +

    Returns the hash code for this multiset. This is defined as the sum of + + 
    
+ ((element == null) ? 0 : element.hashCode()) ^ count(element)
+
    + +

    over all distinct elements in the multiset. It follows that a multiset and its entry set + always have the same hash code.

    This implementation returns the hash code of Multiset.entrySet().

    @@ -1061,11 +942,6 @@

    hashCode

    hashCode in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -1076,12 +952,11 @@

    hashCode

  • toString

    public final java.lang.String toString()
    -
    Returns a string representation of this collection. The string - representation consists of a list of the collection's elements in the - order they are returned by its iterator, enclosed in square brackets - ("[]"). Adjacent elements are separated by the characters - ", " (comma and space). Elements are converted to strings as - by String.valueOf(Object). +
    + +

    It is recommended, though not mandatory, that this method return the result of invoking + Multiset.toString() on the Multiset.entrySet(), yielding a result such as [a x 3, c, d x 2, + e].

    This implementation returns the result of invoking toString on Multiset.entrySet().

    @@ -1089,8 +964,6 @@

    toString

    toString in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    toString in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a string representation of this collection
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/EvictingQueue.html b/releases/snapshot-jre/api/docs/com/google/common/collect/EvictingQueue.html index f30412c5c559..a84d0cf480a0 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/EvictingQueue.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/EvictingQueue.html @@ -204,10 +204,7 @@

    Method Summary

    boolean addAll​(java.util.Collection<? extends E> collection) - -
    Adds all of the elements in the specified collection to this collection - (optional operation).
    - +  static <E> EvictingQueue<E> @@ -241,9 +238,7 @@

    Method Summary

    java.lang.Object[] toArray() - -
    Returns an array containing all of the elements in this collection.
    - + 
      @@ -367,8 +362,6 @@

      offer

      offer in interface java.util.Queue<E>
      Overrides:
      offer in class ForwardingQueue<E>
      -
      Parameters:
      -
      e - the element to add
      Returns:
      true always
      @@ -393,8 +386,6 @@

      add

      add in interface java.util.Queue<E>
      Overrides:
      add in class ForwardingCollection<E>
      -
      Parameters:
      -
      e - element whose presence in this collection is to be ensured
      Returns:
      true always
      @@ -408,24 +399,11 @@

      add

      addAll

      @CanIgnoreReturnValue
 public boolean addAll​(java.util.Collection<? extends E> collection)
      -
      Description copied from interface: java.util.Collection
      -
      Adds all of the elements in the specified collection to this collection - (optional operation). The behavior of this operation is undefined if - the specified collection is modified while the operation is in progress. - (This implies that the behavior of this call is undefined if the - specified collection is this collection, and this collection is - nonempty.)
      Specified by:
      addAll in interface java.util.Collection<E>
      Overrides:
      addAll in class ForwardingCollection<E>
      -
      Parameters:
      -
      collection - collection containing elements to be added to this collection
      -
      Returns:
      -
      true if this collection changed as a result of the call
      -
      See Also:
      -
      Collection.add(Object)
    @@ -436,24 +414,11 @@

    addAll

  • toArray

    public java.lang.Object[] toArray()
    -
    Description copied from interface: java.util.Collection
    -
    Returns an array containing all of the elements in this collection. - If this collection makes any guarantees as to what order its elements - are returned by its iterator, this method must return the elements in - the same order. The returned array's runtime component type is Object. - -

    The returned array will be "safe" in that no references to it are - maintained by this collection. (In other words, this method must - allocate a new array even if this collection is backed by an array). - The caller is thus free to modify the returned array.

    Specified by:
    toArray in interface java.util.Collection<E>
    Overrides:
    toArray in class ForwardingCollection<E>
    -
    Returns:
    -
    an array, whose runtime component - type is Object, containing all of the elements in this collection
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/FluentIterable.html b/releases/snapshot-jre/api/docs/com/google/common/collect/FluentIterable.html index 38d4db80adea..f42c22a9bc87 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/FluentIterable.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/FluentIterable.html @@ -853,8 +853,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingBlockingDeque.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingBlockingDeque.html index 5ff032b60f7a..e930d73e6a46 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingBlockingDeque.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingBlockingDeque.html @@ -245,9 +245,7 @@

    Method Summary

    drainTo​(java.util.Collection<? super E> c)
    Deprecated.
    -
    Removes all available elements from this queue and adds them - to the given collection.
    - +  int @@ -255,9 +253,7 @@

    Method Summary

    int maxElements)
    Deprecated.
    -
    Removes at most the given number of available elements from - this queue and adds them to the given collection.
    - +  boolean @@ -266,10 +262,7 @@

    Method Summary

    java.util.concurrent.TimeUnit unit)
    Deprecated.
    -
    Inserts the specified element into the queue represented by this deque - (in other words, at the tail of this deque), waiting up to the - specified wait time if necessary for space to become available.
    - +  boolean @@ -278,10 +271,7 @@

    Method Summary

    java.util.concurrent.TimeUnit unit)
    Deprecated.
    -
    Inserts the specified element at the front of this deque, - waiting up to the specified wait time if necessary for space to - become available.
    - +  boolean @@ -290,10 +280,7 @@

    Method Summary

    java.util.concurrent.TimeUnit unit)
    Deprecated.
    -
    Inserts the specified element at the end of this deque, - waiting up to the specified wait time if necessary for space to - become available.
    - +  E @@ -301,10 +288,7 @@

    Method Summary

    java.util.concurrent.TimeUnit unit)
    Deprecated.
    -
    Retrieves and removes the head of the queue represented by this deque - (in other words, the first element of this deque), waiting up to the - specified wait time if necessary for an element to become available.
    - +  E @@ -312,10 +296,7 @@

    Method Summary

    java.util.concurrent.TimeUnit unit)
    Deprecated.
    -
    Retrieves and removes the first element of this deque, waiting - up to the specified wait time if necessary for an element to - become available.
    - +  E @@ -323,77 +304,56 @@

    Method Summary

    java.util.concurrent.TimeUnit unit)
    Deprecated.
    -
    Retrieves and removes the last element of this deque, waiting - up to the specified wait time if necessary for an element to - become available.
    - +  void put​(E e)
    Deprecated.
    -
    Inserts the specified element into the queue represented by this deque - (in other words, at the tail of this deque), waiting if necessary for - space to become available.
    - +  void putFirst​(E e)
    Deprecated.
    -
    Inserts the specified element at the front of this deque, - waiting if necessary for space to become available.
    - +  void putLast​(E e)
    Deprecated.
    -
    Inserts the specified element at the end of this deque, - waiting if necessary for space to become available.
    - +  int remainingCapacity()
    Deprecated.
    -
    Returns the number of additional elements that this queue can ideally - (in the absence of memory or resource constraints) accept without - blocking, or Integer.MAX_VALUE if there is no intrinsic - limit.
    - +  E take()
    Deprecated.
    -
    Retrieves and removes the head of the queue represented by this deque - (in other words, the first element of this deque), waiting if - necessary until an element becomes available.
    - +  E takeFirst()
    Deprecated.
    -
    Retrieves and removes the first element of this deque, waiting - if necessary until an element becomes available.
    - +  E takeLast()
    Deprecated.
    -
    Retrieves and removes the last element of this deque, waiting - if necessary until an element becomes available.
    - + 
      @@ -523,21 +483,9 @@

      delegate

      remainingCapacity

      public int remainingCapacity()
      Deprecated.
      -
      Description copied from interface: java.util.concurrent.BlockingQueue
      -
      Returns the number of additional elements that this queue can ideally - (in the absence of memory or resource constraints) accept without - blocking, or Integer.MAX_VALUE if there is no intrinsic - limit. - -

      Note that you cannot always tell if an attempt to insert - an element will succeed by inspecting remainingCapacity - because it may be the case that another thread is about to - insert or remove an element.

      Specified by:
      remainingCapacity in interface java.util.concurrent.BlockingQueue<E>
      -
      Returns:
      -
      the remaining capacity
    @@ -552,16 +500,11 @@

    putFirst

    public void putFirst​(E e)
               throws java.lang.InterruptedException
    Deprecated.
    -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Inserts the specified element at the front of this deque, - waiting if necessary for space to become available.
    Specified by:
    putFirst in interface java.util.concurrent.BlockingDeque<E>
    -
    Parameters:
    -
    e - the element to add
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -576,16 +519,11 @@

    putLast

    public void putLast​(E e)
              throws java.lang.InterruptedException
    Deprecated.
    -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Inserts the specified element at the end of this deque, - waiting if necessary for space to become available.
    Specified by:
    putLast in interface java.util.concurrent.BlockingDeque<E>
    -
    Parameters:
    -
    e - the element to add
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -602,24 +540,11 @@

    offerFirst

    java.util.concurrent.TimeUnit unit) throws java.lang.InterruptedException
    Deprecated.
    -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Inserts the specified element at the front of this deque, - waiting up to the specified wait time if necessary for space to - become available.
    Specified by:
    offerFirst in interface java.util.concurrent.BlockingDeque<E>
    -
    Parameters:
    -
    e - the element to add
    -
    timeout - how long to wait before giving up, in units of - unit
    -
    unit - a TimeUnit determining how to interpret the - timeout parameter
    -
    Returns:
    -
    true if successful, or false if - the specified waiting time elapses before space is available
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -636,24 +561,11 @@

    offerLast

    java.util.concurrent.TimeUnit unit) throws java.lang.InterruptedException
    Deprecated.
    -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Inserts the specified element at the end of this deque, - waiting up to the specified wait time if necessary for space to - become available.
    Specified by:
    offerLast in interface java.util.concurrent.BlockingDeque<E>
    -
    Parameters:
    -
    e - the element to add
    -
    timeout - how long to wait before giving up, in units of - unit
    -
    unit - a TimeUnit determining how to interpret the - timeout parameter
    -
    Returns:
    -
    true if successful, or false if - the specified waiting time elapses before space is available
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -666,16 +578,11 @@

    takeFirst

    public E takeFirst()
             throws java.lang.InterruptedException
    Deprecated.
    -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Retrieves and removes the first element of this deque, waiting - if necessary until an element becomes available.
    Specified by:
    takeFirst in interface java.util.concurrent.BlockingDeque<E>
    -
    Returns:
    -
    the head of this deque
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -688,16 +595,11 @@

    takeLast

    public E takeLast()
            throws java.lang.InterruptedException
    Deprecated.
    -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Retrieves and removes the last element of this deque, waiting - if necessary until an element becomes available.
    Specified by:
    takeLast in interface java.util.concurrent.BlockingDeque<E>
    -
    Returns:
    -
    the tail of this deque
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -712,23 +614,11 @@

    pollFirst

    java.util.concurrent.TimeUnit unit) throws java.lang.InterruptedException
    Deprecated.
    -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Retrieves and removes the first element of this deque, waiting - up to the specified wait time if necessary for an element to - become available.
    Specified by:
    pollFirst in interface java.util.concurrent.BlockingDeque<E>
    -
    Parameters:
    -
    timeout - how long to wait before giving up, in units of - unit
    -
    unit - a TimeUnit determining how to interpret the - timeout parameter
    -
    Returns:
    -
    the head of this deque, or null if the specified - waiting time elapses before an element is available
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -743,23 +633,11 @@

    pollLast

    java.util.concurrent.TimeUnit unit) throws java.lang.InterruptedException
    Deprecated.
    -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Retrieves and removes the last element of this deque, waiting - up to the specified wait time if necessary for an element to - become available.
    Specified by:
    pollLast in interface java.util.concurrent.BlockingDeque<E>
    -
    Parameters:
    -
    timeout - how long to wait before giving up, in units of - unit
    -
    unit - a TimeUnit determining how to interpret the - timeout parameter
    -
    Returns:
    -
    the tail of this deque, or null if the specified - waiting time elapses before an element is available
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -774,21 +652,13 @@

    put

    public void put​(E e)
          throws java.lang.InterruptedException
    Deprecated.
    -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Inserts the specified element into the queue represented by this deque - (in other words, at the tail of this deque), waiting if necessary for - space to become available. - -

    This method is equivalent to putLast.

    Specified by:
    put in interface java.util.concurrent.BlockingDeque<E>
    Specified by:
    put in interface java.util.concurrent.BlockingQueue<E>
    -
    Parameters:
    -
    e - the element to add
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -805,29 +675,13 @@

    offer

    java.util.concurrent.TimeUnit unit) throws java.lang.InterruptedException
    Deprecated.
    -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Inserts the specified element into the queue represented by this deque - (in other words, at the tail of this deque), waiting up to the - specified wait time if necessary for space to become available. - -

    This method is equivalent to - offerLast.

    Specified by:
    offer in interface java.util.concurrent.BlockingDeque<E>
    Specified by:
    offer in interface java.util.concurrent.BlockingQueue<E>
    -
    Parameters:
    -
    e - the element to add
    -
    timeout - how long to wait before giving up, in units of - unit
    -
    unit - a TimeUnit determining how to interpret the - timeout parameter
    -
    Returns:
    -
    true if the element was added to this deque, else - false
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -840,21 +694,13 @@

    take

    public E take()
        throws java.lang.InterruptedException
    Deprecated.
    -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Retrieves and removes the head of the queue represented by this deque - (in other words, the first element of this deque), waiting if - necessary until an element becomes available. - -

    This method is equivalent to takeFirst.

    Specified by:
    take in interface java.util.concurrent.BlockingDeque<E>
    Specified by:
    take in interface java.util.concurrent.BlockingQueue<E>
    -
    Returns:
    -
    the head of this deque
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -869,28 +715,13 @@

    poll

    java.util.concurrent.TimeUnit unit) throws java.lang.InterruptedException
    Deprecated.
    -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Retrieves and removes the head of the queue represented by this deque - (in other words, the first element of this deque), waiting up to the - specified wait time if necessary for an element to become available. - -

    This method is equivalent to - pollFirst.

    Specified by:
    poll in interface java.util.concurrent.BlockingDeque<E>
    Specified by:
    poll in interface java.util.concurrent.BlockingQueue<E>
    -
    Parameters:
    -
    timeout - how long to wait before giving up, in units of - unit
    -
    unit - a TimeUnit determining how to interpret the - timeout parameter
    -
    Returns:
    -
    the head of this deque, or null if the - specified waiting time elapses before an element is available
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -902,24 +733,9 @@

    poll

    drainTo

    public int drainTo​(java.util.Collection<? super E> c)
    Deprecated.
    -
    Description copied from interface: java.util.concurrent.BlockingQueue
    -
    Removes all available elements from this queue and adds them - to the given collection. This operation may be more - efficient than repeatedly polling this queue. A failure - encountered while attempting to add elements to - collection c may result in elements being in neither, - either or both collections when the associated exception is - thrown. Attempts to drain a queue to itself result in - IllegalArgumentException. Further, the behavior of - this operation is undefined if the specified collection is - modified while the operation is in progress.
    Specified by:
    drainTo in interface java.util.concurrent.BlockingQueue<E>
    -
    Parameters:
    -
    c - the collection to transfer elements into
    -
    Returns:
    -
    the number of elements transferred
    @@ -932,24 +748,9 @@

    drainTo

    public int drainTo​(java.util.Collection<? super E> c,
                    int maxElements)
    Deprecated.
    -
    Description copied from interface: java.util.concurrent.BlockingQueue
    -
    Removes at most the given number of available elements from - this queue and adds them to the given collection. A failure - encountered while attempting to add elements to - collection c may result in elements being in neither, - either or both collections when the associated exception is - thrown. Attempts to drain a queue to itself result in - IllegalArgumentException. Further, the behavior of - this operation is undefined if the specified collection is - modified while the operation is in progress.
    Specified by:
    drainTo in interface java.util.concurrent.BlockingQueue<E>
    -
    Parameters:
    -
    c - the collection to transfer elements into
    -
    maxElements - the maximum number of elements to transfer
    -
    Returns:
    -
    the number of elements transferred
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingCollection.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingCollection.html index 7c04c73ca35a..9c4cf19c034f 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingCollection.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingCollection.html @@ -219,40 +219,27 @@

    Method Summary

    boolean add​(E element) - -
    Ensures that this collection contains the specified element (optional - operation).
    - +  boolean addAll​(java.util.Collection<? extends E> collection) - -
    Adds all of the elements in the specified collection to this collection - (optional operation).
    - +  void clear() - -
    Removes all of the elements from this collection (optional operation).
    - +  boolean contains​(java.lang.Object object) - -
    Returns true if this collection contains the specified element.
    - +  boolean containsAll​(java.util.Collection<?> collection) - -
    Returns true if this collection contains all of the elements - in the specified collection.
    - +  protected abstract java.util.Collection<E> @@ -264,47 +251,32 @@

    Method Summary

    boolean isEmpty() - -
    Returns true if this collection contains no elements.
    - +  java.util.Iterator<E> iterator() - -
    Returns an iterator over the elements in this collection.
    - +  boolean remove​(java.lang.Object object) - -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation).
    - +  boolean removeAll​(java.util.Collection<?> collection) - -
    Removes all of this collection's elements that are also contained in the - specified collection (optional operation).
    - +  boolean retainAll​(java.util.Collection<?> collection) - -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation).
    - +  int size() - -
    Returns the number of elements in this collection.
    - +  protected boolean @@ -390,17 +362,12 @@

    Method Summary

    @Nullable java.lang.Object[] toArray() - -
    Returns an array containing all of the elements in this collection.
    - +  <T extends @Nullable java.lang.Object>
    T[]     toArray​(T[] array) - -
    Returns an array containing all of the elements in this collection; - the runtime type of the returned array is that of the specified array.
    - + 
      @@ -492,18 +459,11 @@

      delegate

    • iterator

      public java.util.Iterator<E> iterator()
      -
      Description copied from interface: java.util.Collection
      -
      Returns an iterator over the elements in this collection. There are no - guarantees concerning the order in which the elements are returned - (unless this collection is an instance of some class that provides a - guarantee).
      Specified by:
      iterator in interface java.util.Collection<E extends @Nullable java.lang.Object>
      Specified by:
      iterator in interface java.lang.Iterable<E extends @Nullable java.lang.Object>
      -
      Returns:
      -
      an Iterator over the elements in this collection
    @@ -514,15 +474,9 @@

    iterator

  • size

    public int size()
    -
    Description copied from interface: java.util.Collection
    -
    Returns the number of elements in this collection. If this collection - contains more than Integer.MAX_VALUE elements, returns - Integer.MAX_VALUE.
    Specified by:
    size in interface java.util.Collection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the number of elements in this collection
    • @@ -534,22 +488,9 @@

    size

    removeAll

    @CanIgnoreReturnValue
 public boolean removeAll​(java.util.Collection<?> collection)
    -
    Description copied from interface: java.util.Collection
    -
    Removes all of this collection's elements that are also contained in the - specified collection (optional operation). After this call returns, - this collection will contain no elements in common with the specified - collection.
    Specified by:
    removeAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    collection - collection containing elements to be removed from this collection
    -
    Returns:
    -
    true if this collection changed as a result of the - call
    -
    See Also:
    -
    Collection.remove(Object), -Collection.contains(Object)
    @@ -560,13 +501,9 @@

    removeAll

  • isEmpty

    public boolean isEmpty()
    -
    Description copied from interface: java.util.Collection
    -
    Returns true if this collection contains no elements.
    Specified by:
    isEmpty in interface java.util.Collection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    true if this collection contains no elements
    • @@ -578,19 +515,9 @@

    isEmpty

    contains

    public boolean contains​(@CheckForNull
                         java.lang.Object object)
    -
    Description copied from interface: java.util.Collection
    -
    Returns true if this collection contains the specified element. - More formally, returns true if and only if this collection - contains at least one element e such that - Objects.equals(o, e).
    Specified by:
    contains in interface java.util.Collection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    object - element whose presence in this collection is to be tested
    -
    Returns:
    -
    true if this collection contains the specified - element
    @@ -604,32 +531,9 @@

    contains

    add

    @CanIgnoreReturnValue
 public boolean add​(E element)
    -
    Description copied from interface: java.util.Collection
    -
    Ensures that this collection contains the specified element (optional - operation). Returns true if this collection changed as a - result of the call. (Returns false if this collection does - not permit duplicates and already contains the specified element.)

    - - Collections that support this operation may place limitations on what - elements may be added to this collection. In particular, some - collections will refuse to add null elements, and others will - impose restrictions on the type of elements that may be added. - Collection classes should clearly specify in their documentation any - restrictions on what elements may be added.

    - - If a collection refuses to add a particular element for any reason - other than that it already contains the element, it must throw - an exception (rather than returning false). This preserves - the invariant that a collection always contains the specified element - after this call returns.

    Specified by:
    add in interface java.util.Collection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    element - element whose presence in this collection is to be ensured
    -
    Returns:
    -
    true if this collection changed as a result of the - call
    @@ -642,21 +546,9 @@

    remove

    @CanIgnoreReturnValue
 public boolean remove​(@CheckForNull
                       java.lang.Object object)
    -
    Description copied from interface: java.util.Collection
    -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation). More formally, - removes an element e such that - Objects.equals(o, e), if - this collection contains one or more such elements. Returns - true if this collection contained the specified element (or - equivalently, if this collection changed as a result of the call).
    Specified by:
    remove in interface java.util.Collection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    object - element to be removed from this collection, if present
    -
    Returns:
    -
    true if an element was removed as a result of this call
    @@ -667,19 +559,9 @@

    remove

  • containsAll

    public boolean containsAll​(java.util.Collection<?> collection)
    -
    Description copied from interface: java.util.Collection
    -
    Returns true if this collection contains all of the elements - in the specified collection.
    Specified by:
    containsAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    collection - collection to be checked for containment in this collection
    -
    Returns:
    -
    true if this collection contains all of the elements - in the specified collection
    -
    See Also:
    -
    Collection.contains(Object)
    • @@ -691,22 +573,9 @@

    containsAll

    addAll

    @CanIgnoreReturnValue
 public boolean addAll​(java.util.Collection<? extends E> collection)
    -
    Description copied from interface: java.util.Collection
    -
    Adds all of the elements in the specified collection to this collection - (optional operation). The behavior of this operation is undefined if - the specified collection is modified while the operation is in progress. - (This implies that the behavior of this call is undefined if the - specified collection is this collection, and this collection is - nonempty.)
    Specified by:
    addAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    collection - collection containing elements to be added to this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    -
    See Also:
    -
    Collection.add(Object)
    @@ -718,21 +587,9 @@

    addAll

    retainAll

    @CanIgnoreReturnValue
 public boolean retainAll​(java.util.Collection<?> collection)
    -
    Description copied from interface: java.util.Collection
    -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation). In other words, removes from - this collection all of its elements that are not contained in the - specified collection.
    Specified by:
    retainAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    collection - collection containing elements to be retained in this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    -
    See Also:
    -
    Collection.remove(Object), -Collection.contains(Object)
    @@ -743,9 +600,6 @@

    retainAll

  • clear

    public void clear()
    -
    Description copied from interface: java.util.Collection
    -
    Removes all of the elements from this collection (optional operation). - The collection will be empty after this method returns.
    Specified by:
    clear in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -759,22 +613,9 @@

    clear

  • toArray

    public @Nullable java.lang.Object[] toArray()
    -
    Description copied from interface: java.util.Collection
    -
    Returns an array containing all of the elements in this collection. - If this collection makes any guarantees as to what order its elements - are returned by its iterator, this method must return the elements in - the same order. The returned array's runtime component type is Object. - -

    The returned array will be "safe" in that no references to it are - maintained by this collection. (In other words, this method must - allocate a new array even if this collection is backed by an array). - The caller is thus free to modify the returned array.

    Specified by:
    toArray in interface java.util.Collection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    an array, whose runtime component - type is Object, containing all of the elements in this collection
    • @@ -788,34 +629,9 @@

    toArray

    toArray

    @CanIgnoreReturnValue
 public <T extends @Nullable java.lang.Object> T[] toArray​(T[] array)
    -
    Description copied from interface: java.util.Collection
    -
    Returns an array containing all of the elements in this collection; - the runtime type of the returned array is that of the specified array. - If the collection fits in the specified array, it is returned therein. - Otherwise, a new array is allocated with the runtime type of the - specified array and the size of this collection. - -

    If this collection fits in the specified array with room to spare - (i.e., the array has more elements than this collection), the element - in the array immediately following the end of the collection is set to - null. (This is useful in determining the length of this - collection only if the caller knows that this collection does - not contain any null elements.) - -

    If this collection makes any guarantees as to what order its elements - are returned by its iterator, this method must return the elements in - the same order.

    Specified by:
    toArray in interface java.util.Collection<E extends @Nullable java.lang.Object>
    -
    Type Parameters:
    -
    T - the component type of the array to contain the collection
    -
    Parameters:
    -
    array - the array into which the elements of this collection are to be - stored, if it is big enough; otherwise, a new array of the same - runtime type is allocated for this purpose.
    -
    Returns:
    -
    an array containing all of the elements in this collection
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingConcurrentMap.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingConcurrentMap.html index ca519fcfa33c..c9cd983bb5bc 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingConcurrentMap.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingConcurrentMap.html @@ -189,7 +189,7 @@

    Nested classes/interfaces inherited from class com.google.common.collec

    Nested classes/interfaces inherited from interface java.util.Map

    -java.util.Map.Entry<K,​V> +java.util.Map.Entry<K extends java.lang.Object,​V extends java.lang.Object> @@ -244,35 +244,26 @@

    Method Summary

    V putIfAbsent​(K key, V value) - -
    If the specified key is not already associated - with a value, associates it with the given value.
    - +  boolean remove​(java.lang.Object key, java.lang.Object value) - -
    Removes the entry for a key only if currently mapped to a given value.
    - +  V replace​(K key, V value) - -
    Replaces the entry for a key only if currently mapped to some value.
    - +  boolean replace​(K key, V oldValue, V newValue) - -
    Replaces the entry for a key only if currently mapped to a given value.
    - + 
      @@ -376,31 +367,11 @@

      putIfAbsent

      @CheckForNull public V putIfAbsent​(K key, V value) -
      Description copied from interface: java.util.concurrent.ConcurrentMap
      -
      If the specified key is not already associated - with a value, associates it with the given value. - This is equivalent to, for this map: - 
       
- if (!map.containsKey(key))
-   return map.put(key, value);
- else
-   return map.get(key);
      - - except that the action is performed atomically.
      Specified by:
      putIfAbsent in interface java.util.concurrent.ConcurrentMap<K,​V>
      Specified by:
      putIfAbsent in interface java.util.Map<K,​V>
      -
      Parameters:
      -
      key - key with which the specified value is to be associated
      -
      value - value to be associated with the specified key
      -
      Returns:
      -
      the previous value associated with the specified key, or - null if there was no mapping for the key. - (A null return can also indicate that the map - previously associated null with the key, - if the implementation supports null values.)
    @@ -415,29 +386,11 @@

    remove

    java.lang.Object key, @CheckForNull java.lang.Object value) -
    Description copied from interface: java.util.concurrent.ConcurrentMap
    -
    Removes the entry for a key only if currently mapped to a given value. - This is equivalent to, for this map: - 
     
- if (map.containsKey(key)
-     && Objects.equals(map.get(key), value)) {
-   map.remove(key);
-   return true;
- } else {
-   return false;
- }
    - - except that the action is performed atomically.
    Specified by:
    remove in interface java.util.concurrent.ConcurrentMap<K,​V>
    Specified by:
    remove in interface java.util.Map<K,​V>
    -
    Parameters:
    -
    key - key with which the specified value is associated
    -
    value - value expected to be associated with the specified key
    -
    Returns:
    -
    true if the value was removed
    @@ -453,30 +406,11 @@

    replace

    @CheckForNull public V replace​(K key, V value) -
    Description copied from interface: java.util.concurrent.ConcurrentMap
    -
    Replaces the entry for a key only if currently mapped to some value. - This is equivalent to, for this map: - 
     
- if (map.containsKey(key))
-   return map.put(key, value);
- else
-   return null;
    - - except that the action is performed atomically.
    Specified by:
    replace in interface java.util.concurrent.ConcurrentMap<K,​V>
    Specified by:
    replace in interface java.util.Map<K,​V>
    -
    Parameters:
    -
    key - key with which the specified value is associated
    -
    value - value to be associated with the specified key
    -
    Returns:
    -
    the previous value associated with the specified key, or - null if there was no mapping for the key. - (A null return can also indicate that the map - previously associated null with the key, - if the implementation supports null values.)
    @@ -492,30 +426,11 @@

    replace

    public boolean replace​(K key, V oldValue, V newValue) -
    Description copied from interface: java.util.concurrent.ConcurrentMap
    -
    Replaces the entry for a key only if currently mapped to a given value. - This is equivalent to, for this map: - 
     
- if (map.containsKey(key)
-     && Objects.equals(map.get(key), oldValue)) {
-   map.put(key, newValue);
-   return true;
- } else {
-   return false;
- }
    - - except that the action is performed atomically.
    Specified by:
    replace in interface java.util.concurrent.ConcurrentMap<K,​V>
    Specified by:
    replace in interface java.util.Map<K,​V>
    -
    Parameters:
    -
    key - key with which the specified value is associated
    -
    oldValue - value expected to be associated with the specified key
    -
    newValue - value to be associated with the specified key
    -
    Returns:
    -
    true if the value was replaced
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingDeque.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingDeque.html index 17d0ae12ef2f..02fa87b830b5 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingDeque.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingDeque.html @@ -224,22 +224,12 @@

    Method Summary

    void addFirst​(E e) - -
    Inserts the specified element at the front of this deque if it is - possible to do so immediately without violating capacity restrictions, - throwing an IllegalStateException if no space is currently - available.
    - +  void addLast​(E e) - -
    Inserts the specified element at the end of this deque if it is - possible to do so immediately without violating capacity restrictions, - throwing an IllegalStateException if no space is currently - available.
    - +  protected abstract java.util.Deque<E> @@ -251,117 +241,77 @@

    Method Summary

    java.util.Iterator<E> descendingIterator() - -
    Returns an iterator over the elements in this deque in reverse - sequential order.
    - +  E getFirst() - -
    Retrieves, but does not remove, the first element of this deque.
    - +  E getLast() - -
    Retrieves, but does not remove, the last element of this deque.
    - +  boolean offerFirst​(E e) - -
    Inserts the specified element at the front of this deque unless it would - violate capacity restrictions.
    - +  boolean offerLast​(E e) - -
    Inserts the specified element at the end of this deque unless it would - violate capacity restrictions.
    - +  E peekFirst() - -
    Retrieves, but does not remove, the first element of this deque, - or returns null if this deque is empty.
    - +  E peekLast() - -
    Retrieves, but does not remove, the last element of this deque, - or returns null if this deque is empty.
    - +  E pollFirst() - -
    Retrieves and removes the first element of this deque, - or returns null if this deque is empty.
    - +  E pollLast() - -
    Retrieves and removes the last element of this deque, - or returns null if this deque is empty.
    - +  E pop() - -
    Pops an element from the stack represented by this deque.
    - +  void push​(E e) - -
    Pushes an element onto the stack represented by this deque (in other - words, at the head of this deque) if it is possible to do so - immediately without violating capacity restrictions, throwing an - IllegalStateException if no space is currently available.
    - +  E removeFirst() - -
    Retrieves and removes the first element of this deque.
    - +  boolean removeFirstOccurrence​(java.lang.Object o) - -
    Removes the first occurrence of the specified element from this deque.
    - +  E removeLast() - -
    Retrieves and removes the last element of this deque.
    - +  boolean removeLastOccurrence​(java.lang.Object o) - -
    Removes the last occurrence of the specified element from this deque.
    - + 
      @@ -476,17 +426,9 @@

      delegate

    • addFirst

      public void addFirst​(E e)
      -
      Description copied from interface: java.util.Deque
      -
      Inserts the specified element at the front of this deque if it is - possible to do so immediately without violating capacity restrictions, - throwing an IllegalStateException if no space is currently - available. When using a capacity-restricted deque, it is generally - preferable to use method Deque.offerFirst(E).
      Specified by:
      addFirst in interface java.util.Deque<E extends @Nullable java.lang.Object>
      -
      Parameters:
      -
      e - the element to add
    @@ -499,19 +441,9 @@

    addFirst

  • addLast

    public void addLast​(E e)
    -
    Description copied from interface: java.util.Deque
    -
    Inserts the specified element at the end of this deque if it is - possible to do so immediately without violating capacity restrictions, - throwing an IllegalStateException if no space is currently - available. When using a capacity-restricted deque, it is generally - preferable to use method Deque.offerLast(E). - -

    This method is equivalent to Deque.add(E).

    Specified by:
    addLast in interface java.util.Deque<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    e - the element to add
    • @@ -522,16 +454,9 @@

    addLast

  • descendingIterator

    public java.util.Iterator<E> descendingIterator()
    -
    Description copied from interface: java.util.Deque
    -
    Returns an iterator over the elements in this deque in reverse - sequential order. The elements will be returned in order from - last (tail) to first (head).
    Specified by:
    descendingIterator in interface java.util.Deque<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    an iterator over the elements in this deque in reverse - sequence
    • @@ -542,16 +467,9 @@

    descendingIterator

  • getFirst

    public E getFirst()
    -
    Description copied from interface: java.util.Deque
    -
    Retrieves, but does not remove, the first element of this deque. - - This method differs from peekFirst only in that it - throws an exception if this deque is empty.
    Specified by:
    getFirst in interface java.util.Deque<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the head of this deque
    • @@ -562,15 +480,9 @@

    getFirst

  • getLast

    public E getLast()
    -
    Description copied from interface: java.util.Deque
    -
    Retrieves, but does not remove, the last element of this deque. - This method differs from peekLast only in that it - throws an exception if this deque is empty.
    Specified by:
    getLast in interface java.util.Deque<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the tail of this deque
    • @@ -584,19 +496,9 @@

    getLast

    offerFirst

    @CanIgnoreReturnValue
 public boolean offerFirst​(E e)
    -
    Description copied from interface: java.util.Deque
    -
    Inserts the specified element at the front of this deque unless it would - violate capacity restrictions. When using a capacity-restricted deque, - this method is generally preferable to the Deque.addFirst(E) method, - which can fail to insert an element only by throwing an exception.
    Specified by:
    offerFirst in interface java.util.Deque<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    e - the element to add
    -
    Returns:
    -
    true if the element was added to this deque, else - false
    @@ -610,19 +512,9 @@

    offerFirst

    offerLast

    @CanIgnoreReturnValue
 public boolean offerLast​(E e)
    -
    Description copied from interface: java.util.Deque
    -
    Inserts the specified element at the end of this deque unless it would - violate capacity restrictions. When using a capacity-restricted deque, - this method is generally preferable to the Deque.addLast(E) method, - which can fail to insert an element only by throwing an exception.
    Specified by:
    offerLast in interface java.util.Deque<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    e - the element to add
    -
    Returns:
    -
    true if the element was added to this deque, else - false
    @@ -634,14 +526,9 @@

    offerLast

    peekFirst

    @CheckForNull
 public E peekFirst()
    -
    Description copied from interface: java.util.Deque
    -
    Retrieves, but does not remove, the first element of this deque, - or returns null if this deque is empty.
    Specified by:
    peekFirst in interface java.util.Deque<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the head of this deque, or null if this deque is empty
    @@ -653,14 +540,9 @@

    peekFirst

    peekLast

    @CheckForNull
 public E peekLast()
    -
    Description copied from interface: java.util.Deque
    -
    Retrieves, but does not remove, the last element of this deque, - or returns null if this deque is empty.
    Specified by:
    peekLast in interface java.util.Deque<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the tail of this deque, or null if this deque is empty
    @@ -673,14 +555,9 @@

    pollFirst

    @CanIgnoreReturnValue
 @CheckForNull
 public E pollFirst()
    -
    Description copied from interface: java.util.Deque
    -
    Retrieves and removes the first element of this deque, - or returns null if this deque is empty.
    Specified by:
    pollFirst in interface java.util.Deque<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the head of this deque, or null if this deque is empty
    @@ -693,14 +570,9 @@

    pollLast

    @CanIgnoreReturnValue
 @CheckForNull
 public E pollLast()
    -
    Description copied from interface: java.util.Deque
    -
    Retrieves and removes the last element of this deque, - or returns null if this deque is empty.
    Specified by:
    pollLast in interface java.util.Deque<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the tail of this deque, or null if this deque is empty
    @@ -712,17 +584,9 @@

    pollLast

    pop

    @CanIgnoreReturnValue
 public E pop()
    -
    Description copied from interface: java.util.Deque
    -
    Pops an element from the stack represented by this deque. In other - words, removes and returns the first element of this deque. - -

    This method is equivalent to Deque.removeFirst().

    Specified by:
    pop in interface java.util.Deque<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the element at the front of this deque (which is the top - of the stack represented by this deque)
    @@ -735,18 +599,9 @@

    pop

  • push

    public void push​(E e)
    -
    Description copied from interface: java.util.Deque
    -
    Pushes an element onto the stack represented by this deque (in other - words, at the head of this deque) if it is possible to do so - immediately without violating capacity restrictions, throwing an - IllegalStateException if no space is currently available. - -

    This method is equivalent to Deque.addFirst(E).

    Specified by:
    push in interface java.util.Deque<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    e - the element to push
    • @@ -758,15 +613,9 @@

    push

    removeFirst

    @CanIgnoreReturnValue
 public E removeFirst()
    -
    Description copied from interface: java.util.Deque
    -
    Retrieves and removes the first element of this deque. This method - differs from pollFirst only in that it throws an - exception if this deque is empty.
    Specified by:
    removeFirst in interface java.util.Deque<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the head of this deque
    @@ -778,15 +627,9 @@

    removeFirst

    removeLast

    @CanIgnoreReturnValue
 public E removeLast()
    -
    Description copied from interface: java.util.Deque
    -
    Retrieves and removes the last element of this deque. This method - differs from pollLast only in that it throws an - exception if this deque is empty.
    Specified by:
    removeLast in interface java.util.Deque<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the tail of this deque
    @@ -799,20 +642,9 @@

    removeFirstOccurrence

    @CanIgnoreReturnValue
 public boolean removeFirstOccurrence​(@CheckForNull
                                      java.lang.Object o)
    -
    Description copied from interface: java.util.Deque
    -
    Removes the first occurrence of the specified element from this deque. - If the deque does not contain the element, it is unchanged. - More formally, removes the first element e such that - Objects.equals(o, e) (if such an element exists). - Returns true if this deque contained the specified element - (or equivalently, if this deque changed as a result of the call).
    Specified by:
    removeFirstOccurrence in interface java.util.Deque<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    o - element to be removed from this deque, if present
    -
    Returns:
    -
    true if an element was removed as a result of this call
    @@ -825,20 +657,9 @@

    removeLastOccurrence

    @CanIgnoreReturnValue
 public boolean removeLastOccurrence​(@CheckForNull
                                     java.lang.Object o)
    -
    Description copied from interface: java.util.Deque
    -
    Removes the last occurrence of the specified element from this deque. - If the deque does not contain the element, it is unchanged. - More formally, removes the last element e such that - Objects.equals(o, e) (if such an element exists). - Returns true if this deque contained the specified element - (or equivalently, if this deque changed as a result of the call).
    Specified by:
    removeLastOccurrence in interface java.util.Deque<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    o - element to be removed from this deque, if present
    -
    Returns:
    -
    true if an element was removed as a result of this call
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingIterator.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingIterator.html index 040f3bd11119..797c65c3b3b0 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingIterator.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingIterator.html @@ -218,24 +218,17 @@

    Method Summary

    boolean hasNext() - -
    Returns true if the iteration has more elements.
    - +  T next() - -
    Returns the next element in the iteration.
    - +  void remove() - -
    Removes from the underlying collection the last element returned - by this iterator (optional operation).
    - + 
      @@ -320,15 +313,9 @@

      delegate

    • hasNext

      public boolean hasNext()
      -
      Description copied from interface: java.util.Iterator
      -
      Returns true if the iteration has more elements. - (In other words, returns true if Iterator.next() would - return an element rather than throwing an exception.)
      Specified by:
      hasNext in interface java.util.Iterator<T extends @Nullable java.lang.Object>
      -
      Returns:
      -
      true if the iteration has more elements
    @@ -340,13 +327,9 @@

    hasNext

    next

    @CanIgnoreReturnValue
 public T next()
    -
    Description copied from interface: java.util.Iterator
    -
    Returns the next element in the iteration.
    Specified by:
    next in interface java.util.Iterator<T extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the next element in the iteration
    @@ -357,18 +340,6 @@

    next

  • remove

    public void remove()
    -
    Description copied from interface: java.util.Iterator
    -
    Removes from the underlying collection the last element returned - by this iterator (optional operation). This method can be called - only once per call to Iterator.next(). -

    - The behavior of an iterator is unspecified if the underlying collection - is modified while the iteration is in progress in any way other than by - calling this method, unless an overriding class has specified a - concurrent modification policy. -

    - The behavior of an iterator is unspecified if this method is called - after a call to the forEachRemaining method.

    Specified by:
    remove in interface java.util.Iterator<T extends @Nullable java.lang.Object>
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingList.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingList.html index 978daf7e8da9..e3fc6841cf17 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingList.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingList.html @@ -223,19 +223,13 @@

    Method Summary

    void add​(int index, E element) - -
    Inserts the specified element at the specified position in this list - (optional operation).
    - +  boolean addAll​(int index, java.util.Collection<? extends E> elements) - -
    Inserts all of the elements in the specified collection into this - list at the specified position (optional operation).
    - +  protected abstract java.util.List<E> @@ -247,72 +241,48 @@

    Method Summary

    boolean equals​(java.lang.Object object) - -
    Indicates whether some other object is "equal to" this one.
    - +  E get​(int index) - -
    Returns the element at the specified position in this list.
    - +  int hashCode() - -
    Returns a hash code value for the object.
    - +  int indexOf​(java.lang.Object element) - -
    Returns the index of the first occurrence of the specified element - in this list, or -1 if this list does not contain the element.
    - +  int lastIndexOf​(java.lang.Object element) - -
    Returns the index of the last occurrence of the specified element - in this list, or -1 if this list does not contain the element.
    - +  java.util.ListIterator<E> listIterator() - -
    Returns a list iterator over the elements in this list (in proper - sequence).
    - +  java.util.ListIterator<E> listIterator​(int index) - -
    Returns a list iterator over the elements in this list (in proper - sequence), starting at the specified position in the list.
    - +  E remove​(int index) - -
    Removes the element at the specified position in this list (optional - operation).
    - +  E set​(int index, E element) - -
    Replaces the element at the specified position in this list with the - specified element (optional operation).
    - +  protected boolean @@ -393,10 +363,7 @@

    Method Summary

    java.util.List<E> subList​(int fromIndex, int toIndex) - -
    Returns a view of the portion of this list between the specified - fromIndex, inclusive, and toIndex, exclusive.
    - + 
      @@ -505,17 +472,9 @@

      delegate

      add

      public void add​(int index,
                 E element)
      -
      Description copied from interface: java.util.List
      -
      Inserts the specified element at the specified position in this list - (optional operation). Shifts the element currently at that position - (if any) and any subsequent elements to the right (adds one to their - indices).
      Specified by:
      add in interface java.util.List<E extends @Nullable java.lang.Object>
      -
      Parameters:
      -
      index - index at which the specified element is to be inserted
      -
      element - element to be inserted
    @@ -528,25 +487,9 @@

    addAll

    @CanIgnoreReturnValue
 public boolean addAll​(int index,
                       java.util.Collection<? extends E> elements)
    -
    Description copied from interface: java.util.List
    -
    Inserts all of the elements in the specified collection into this - list at the specified position (optional operation). Shifts the - element currently at that position (if any) and any subsequent - elements to the right (increases their indices). The new elements - will appear in this list in the order that they are returned by the - specified collection's iterator. The behavior of this operation is - undefined if the specified collection is modified while the - operation is in progress. (Note that this will occur if the specified - collection is this list, and it's nonempty.)
    Specified by:
    addAll in interface java.util.List<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    index - index at which to insert the first element from the - specified collection
    -
    elements - collection containing elements to be added to this list
    -
    Returns:
    -
    true if this list changed as a result of the call
    • @@ -557,15 +500,9 @@

    addAll

  • get

    public E get​(int index)
    -
    Description copied from interface: java.util.List
    -
    Returns the element at the specified position in this list.
    Specified by:
    get in interface java.util.List<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    index - index of the element to return
    -
    Returns:
    -
    the element at the specified position in this list
    • @@ -577,20 +514,9 @@

    get

    indexOf

    public int indexOf​(@CheckForNull
                    java.lang.Object element)
    -
    Description copied from interface: java.util.List
    -
    Returns the index of the first occurrence of the specified element - in this list, or -1 if this list does not contain the element. - More formally, returns the lowest index i such that - Objects.equals(o, get(i)), - or -1 if there is no such index.
    Specified by:
    indexOf in interface java.util.List<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    element - element to search for
    -
    Returns:
    -
    the index of the first occurrence of the specified element in - this list, or -1 if this list does not contain the element
    @@ -602,20 +528,9 @@

    indexOf

    lastIndexOf

    public int lastIndexOf​(@CheckForNull
                        java.lang.Object element)
    -
    Description copied from interface: java.util.List
    -
    Returns the index of the last occurrence of the specified element - in this list, or -1 if this list does not contain the element. - More formally, returns the highest index i such that - Objects.equals(o, get(i)), - or -1 if there is no such index.
    Specified by:
    lastIndexOf in interface java.util.List<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    element - element to search for
    -
    Returns:
    -
    the index of the last occurrence of the specified element in - this list, or -1 if this list does not contain the element
    @@ -626,15 +541,9 @@

    lastIndexOf

  • listIterator

    public java.util.ListIterator<E> listIterator()
    -
    Description copied from interface: java.util.List
    -
    Returns a list iterator over the elements in this list (in proper - sequence).
    Specified by:
    listIterator in interface java.util.List<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a list iterator over the elements in this list (in proper - sequence)
    • @@ -645,22 +554,9 @@

    listIterator

  • listIterator

    public java.util.ListIterator<E> listIterator​(int index)
    -
    Description copied from interface: java.util.List
    -
    Returns a list iterator over the elements in this list (in proper - sequence), starting at the specified position in the list. - The specified index indicates the first element that would be - returned by an initial call to next. - An initial call to previous would - return the element with the specified index minus one.
    Specified by:
    listIterator in interface java.util.List<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    index - index of the first element to be returned from the - list iterator (by a call to next)
    -
    Returns:
    -
    a list iterator over the elements in this list (in proper - sequence), starting at the specified position in the list
    • @@ -672,18 +568,9 @@

    listIterator

    remove

    @CanIgnoreReturnValue
 public E remove​(int index)
    -
    Description copied from interface: java.util.List
    -
    Removes the element at the specified position in this list (optional - operation). Shifts any subsequent elements to the left (subtracts one - from their indices). Returns the element that was removed from the - list.
    Specified by:
    remove in interface java.util.List<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    index - the index of the element to be removed
    -
    Returns:
    -
    the element previously at the specified position
    @@ -698,17 +585,9 @@

    set

    @CanIgnoreReturnValue
 public E set​(int index,
              E element)
    -
    Description copied from interface: java.util.List
    -
    Replaces the element at the specified position in this list with the - specified element (optional operation).
    Specified by:
    set in interface java.util.List<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    index - index of the element to replace
    -
    element - element to be stored at the specified position
    -
    Returns:
    -
    the element previously at the specified position
    @@ -720,40 +599,9 @@

    set

    subList

    public java.util.List<E> subList​(int fromIndex,
                                  int toIndex)
    -
    Description copied from interface: java.util.List
    -
    Returns a view of the portion of this list between the specified - fromIndex, inclusive, and toIndex, exclusive. (If - fromIndex and toIndex are equal, the returned list is - empty.) The returned list is backed by this list, so non-structural - changes in the returned list are reflected in this list, and vice-versa. - The returned list supports all of the optional list operations supported - by this list.

    - - This method eliminates the need for explicit range operations (of - the sort that commonly exist for arrays). Any operation that expects - a list can be used as a range operation by passing a subList view - instead of a whole list. For example, the following idiom - removes a range of elements from a list: - 

    
-      list.subList(from, to).clear();
-
    - Similar idioms may be constructed for indexOf and - lastIndexOf, and all of the algorithms in the - Collections class can be applied to a subList.

    - - The semantics of the list returned by this method become undefined if - the backing list (i.e., this list) is structurally modified in - any way other than via the returned list. (Structural modifications are - those that change the size of this list, or otherwise perturb it in such - a fashion that iterations in progress may yield incorrect results.)

    Specified by:
    subList in interface java.util.List<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromIndex - low endpoint (inclusive) of the subList
    -
    toIndex - high endpoint (exclusive) of the subList
    -
    Returns:
    -
    a view of the specified range within this list
    @@ -765,45 +613,6 @@

    subList

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object object)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    Specified by:
    equals in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -811,14 +620,6 @@

    equals

    equals in interface java.util.List<E extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -829,35 +630,6 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    Specified by:
    hashCode in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -865,11 +637,6 @@

    hashCode

    hashCode in interface java.util.List<E extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingListIterator.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingListIterator.html index 4a35fc53fb74..ad0deb0a9571 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingListIterator.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingListIterator.html @@ -212,9 +212,7 @@

    Method Summary

    void add​(E element) - -
    Inserts the specified element into the list (optional operation).
    - +  protected abstract java.util.ListIterator<E> @@ -226,42 +224,27 @@

    Method Summary

    boolean hasPrevious() - -
    Returns true if this list iterator has more elements when - traversing the list in the reverse direction.
    - +  int nextIndex() - -
    Returns the index of the element that would be returned by a - subsequent call to ListIterator.next().
    - +  E previous() - -
    Returns the previous element in the list and moves the cursor - position backwards.
    - +  int previousIndex() - -
    Returns the index of the element that would be returned by a - subsequent call to ListIterator.previous().
    - +  void set​(E element) - -
    Replaces the last element returned by ListIterator.next() or - ListIterator.previous() with the specified element (optional operation).
    - + 
      @@ -362,22 +345,9 @@

      delegate

    • add

      public void add​(E element)
      -
      Description copied from interface: java.util.ListIterator
      -
      Inserts the specified element into the list (optional operation). - The element is inserted immediately before the element that - would be returned by ListIterator.next(), if any, and after the element - that would be returned by ListIterator.previous(), if any. (If the - list contains no elements, the new element becomes the sole element - on the list.) The new element is inserted before the implicit - cursor: a subsequent call to next would be unaffected, and a - subsequent call to previous would return the new element. - (This call increases by one the value that would be returned by a - call to nextIndex or previousIndex.)
      Specified by:
      add in interface java.util.ListIterator<E extends @Nullable java.lang.Object>
      -
      Parameters:
      -
      element - the element to insert
    @@ -388,17 +358,9 @@

    add

  • hasPrevious

    public boolean hasPrevious()
    -
    Description copied from interface: java.util.ListIterator
    -
    Returns true if this list iterator has more elements when - traversing the list in the reverse direction. (In other words, - returns true if ListIterator.previous() would return an element - rather than throwing an exception.)
    Specified by:
    hasPrevious in interface java.util.ListIterator<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    true if the list iterator has more elements when - traversing the list in the reverse direction
    • @@ -409,17 +371,9 @@

    hasPrevious

  • nextIndex

    public int nextIndex()
    -
    Description copied from interface: java.util.ListIterator
    -
    Returns the index of the element that would be returned by a - subsequent call to ListIterator.next(). (Returns list size if the list - iterator is at the end of the list.)
    Specified by:
    nextIndex in interface java.util.ListIterator<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the index of the element that would be returned by a - subsequent call to next, or list size if the list - iterator is at the end of the list
    • @@ -431,18 +385,9 @@

    nextIndex

    previous

    @CanIgnoreReturnValue
 public E previous()
    -
    Description copied from interface: java.util.ListIterator
    -
    Returns the previous element in the list and moves the cursor - position backwards. This method may be called repeatedly to - iterate through the list backwards, or intermixed with calls to - ListIterator.next() to go back and forth. (Note that alternating calls - to next and previous will return the same - element repeatedly.)
    Specified by:
    previous in interface java.util.ListIterator<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the previous element in the list
    @@ -453,17 +398,9 @@

    previous

  • previousIndex

    public int previousIndex()
    -
    Description copied from interface: java.util.ListIterator
    -
    Returns the index of the element that would be returned by a - subsequent call to ListIterator.previous(). (Returns -1 if the list - iterator is at the beginning of the list.)
    Specified by:
    previousIndex in interface java.util.ListIterator<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the index of the element that would be returned by a - subsequent call to previous, or -1 if the list - iterator is at the beginning of the list
    • @@ -476,17 +413,9 @@

    previousIndex

  • set

    public void set​(E element)
    -
    Description copied from interface: java.util.ListIterator
    -
    Replaces the last element returned by ListIterator.next() or - ListIterator.previous() with the specified element (optional operation). - This call can be made only if neither ListIterator.remove() nor ListIterator.add(E) have been called after the last call to next or - previous.
    Specified by:
    set in interface java.util.ListIterator<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    element - the element with which to replace the last element returned by - next or previous
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingMap.StandardEntrySet.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingMap.StandardEntrySet.html index 197d11c81618..189ee11fb36b 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingMap.StandardEntrySet.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingMap.StandardEntrySet.html @@ -208,54 +208,37 @@

    Method Summary

    void clear() - -
    Removes all of the elements from this collection (optional operation).
    - +  boolean contains​(java.lang.Object o) - -
    Returns true if this collection contains the specified element.
    - +  boolean isEmpty() - -
    Returns true if this collection contains no elements.
    - +  boolean remove​(java.lang.Object o) - -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation).
    - +  boolean removeAll​(java.util.Collection<?> c) - -
    Removes from this set all of its elements that are contained in the - specified collection (optional operation).
    - +  boolean retainAll​(java.util.Collection<?> c) - -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation).
    - +  int size() - -
    Returns the number of elements in this collection.
    - + 
      @@ -343,10 +326,6 @@

      Method Detail

    • size

      public int size()
      -
      Description copied from interface: java.util.Collection
      -
      Returns the number of elements in this collection. If this collection - contains more than Integer.MAX_VALUE elements, returns - Integer.MAX_VALUE.
      Specified by:
      size in interface java.util.Collection<K extends @Nullable java.lang.Object>
      @@ -354,8 +333,6 @@

      size

      size in interface java.util.Set<K extends @Nullable java.lang.Object>
      Specified by:
      size in class java.util.AbstractCollection<java.util.Map.Entry<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>>
      -
      Returns:
      -
      the number of elements in this collection
    @@ -366,9 +343,6 @@

    size

  • clear

    public void clear()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes all of the elements from this collection (optional operation). - The collection will be empty after this method returns.
    Specified by:
    clear in interface java.util.Collection<K extends @Nullable java.lang.Object>
    @@ -387,11 +361,6 @@

    clear

    contains

    public boolean contains​(@CheckForNull
                         java.lang.Object o)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains the specified element. - More formally, returns true if and only if this collection - contains at least one element e such that - Objects.equals(o, e).
    Specified by:
    contains in interface java.util.Collection<K extends @Nullable java.lang.Object>
    @@ -399,11 +368,6 @@

    contains

    contains in interface java.util.Set<K extends @Nullable java.lang.Object>
    Overrides:
    contains in class java.util.AbstractCollection<java.util.Map.Entry<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>>
    -
    Parameters:
    -
    o - element whose presence in this collection is to be tested
    -
    Returns:
    -
    true if this collection contains the specified - element
    • @@ -414,8 +378,6 @@

    contains

  • isEmpty

    public boolean isEmpty()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains no elements.
    Specified by:
    isEmpty in interface java.util.Collection<K extends @Nullable java.lang.Object>
    @@ -423,8 +385,6 @@

    isEmpty

    isEmpty in interface java.util.Set<K extends @Nullable java.lang.Object>
    Overrides:
    isEmpty in class java.util.AbstractCollection<java.util.Map.Entry<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>>
    -
    Returns:
    -
    true if this collection contains no elements
    • @@ -436,14 +396,6 @@

    isEmpty

    remove

    public boolean remove​(@CheckForNull
                       java.lang.Object o)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation). More formally, - removes an element e such that - Objects.equals(o, e), if - this collection contains one or more such elements. Returns - true if this collection contained the specified element (or - equivalently, if this collection changed as a result of the call).
    Specified by:
    remove in interface java.util.Collection<K extends @Nullable java.lang.Object>
    @@ -451,10 +403,6 @@

    remove

    remove in interface java.util.Set<K extends @Nullable java.lang.Object>
    Overrides:
    remove in class java.util.AbstractCollection<java.util.Map.Entry<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>>
    -
    Parameters:
    -
    o - element to be removed from this collection, if present
    -
    Returns:
    -
    true if an element was removed as a result of this call
    @@ -465,40 +413,11 @@

    remove

  • removeAll

    public boolean removeAll​(java.util.Collection<?> c)
    -
    Description copied from class: java.util.AbstractSet
    -
    Removes from this set all of its elements that are contained in the - specified collection (optional operation). If the specified - collection is also a set, this operation effectively modifies this - set so that its value is the asymmetric set difference of - the two sets. - -

    This implementation determines which is the smaller of this set - and the specified collection, by invoking the size - method on each. If this set has fewer elements, then the - implementation iterates over this set, checking each element - returned by the iterator in turn to see if it is contained in - the specified collection. If it is so contained, it is removed - from this set with the iterator's remove method. If - the specified collection has fewer elements, then the - implementation iterates over the specified collection, removing - from this set each element returned by the iterator, using this - set's remove method. - -

    Note that this implementation will throw an - UnsupportedOperationException if the iterator returned by the - iterator method does not implement the remove method.

    Specified by:
    removeAll in interface java.util.Collection<K extends @Nullable java.lang.Object>
    Specified by:
    removeAll in interface java.util.Set<K extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    c - collection containing elements to be removed from this set
    -
    Returns:
    -
    true if this set changed as a result of the call
    -
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    • @@ -509,23 +428,11 @@

    removeAll

  • retainAll

    public boolean retainAll​(java.util.Collection<?> c)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation). In other words, removes from - this collection all of its elements that are not contained in the - specified collection.
    Specified by:
    retainAll in interface java.util.Collection<K extends @Nullable java.lang.Object>
    Specified by:
    retainAll in interface java.util.Set<K extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    c - collection containing elements to be retained in this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    -
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingMap.StandardKeySet.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingMap.StandardKeySet.html index f549c401c8d5..f14fbdcd940f 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingMap.StandardKeySet.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingMap.StandardKeySet.html @@ -205,70 +205,47 @@

    Method Summary

    void clear() - -
    Removes all of the elements from this collection (optional operation).
    - +  boolean contains​(java.lang.Object o) - -
    Returns true if this collection contains the specified element.
    - +  void forEach​(java.util.function.Consumer<? super K> action) - -
    Performs the given action for each element of the Iterable - until all elements have been processed or the action throws an - exception.
    - +  boolean isEmpty() - -
    Returns true if this collection contains no elements.
    - +  java.util.Iterator<K> iterator() - -
    Returns an iterator over the elements contained in this collection.
    - +  boolean remove​(java.lang.Object o) - -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation).
    - +  boolean removeAll​(java.util.Collection<?> c) - -
    Removes from this set all of its elements that are contained in the - specified collection (optional operation).
    - +  boolean retainAll​(java.util.Collection<?> c) - -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation).
    - +  int size() - -
    Returns the number of elements in this collection.
    - + 
      @@ -349,8 +326,6 @@

      Method Detail

    • iterator

      public java.util.Iterator<K> iterator()
      -
      Description copied from class: java.util.AbstractCollection
      -
      Returns an iterator over the elements contained in this collection.
      Specified by:
      iterator in interface java.util.Collection<K extends @Nullable java.lang.Object>
      @@ -360,8 +335,6 @@

      iterator

      iterator in interface java.util.Set<K extends @Nullable java.lang.Object>
      Specified by:
      iterator in class java.util.AbstractCollection<K extends @Nullable java.lang.Object>
      -
      Returns:
      -
      an iterator over the elements contained in this collection
    @@ -372,20 +345,6 @@

    iterator

  • forEach

    public void forEach​(java.util.function.Consumer<? super K> action)
    -
    Description copied from interface: java.lang.Iterable
    -
    Performs the given action for each element of the Iterable - until all elements have been processed or the action throws an - exception. Actions are performed in the order of iteration, if that - order is specified. Exceptions thrown by the action are relayed to the - caller. -

    - The behavior of this method is unspecified if the action performs - side-effects that modify the underlying source of elements, unless an - overriding class has specified a concurrent modification policy.

    -
    -
    Parameters:
    -
    action - The action to be performed for each element
    -
    • @@ -395,10 +354,6 @@

    forEach

  • size

    public int size()
    -
    Description copied from interface: java.util.Collection
    -
    Returns the number of elements in this collection. If this collection - contains more than Integer.MAX_VALUE elements, returns - Integer.MAX_VALUE.
    Specified by:
    size in interface java.util.Collection<K extends @Nullable java.lang.Object>
    @@ -406,8 +361,6 @@

    size

    size in interface java.util.Set<K extends @Nullable java.lang.Object>
    Specified by:
    size in class java.util.AbstractCollection<K extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the number of elements in this collection
    • @@ -418,8 +371,6 @@

    size

  • isEmpty

    public boolean isEmpty()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains no elements.
    Specified by:
    isEmpty in interface java.util.Collection<K extends @Nullable java.lang.Object>
    @@ -427,8 +378,6 @@

    isEmpty

    isEmpty in interface java.util.Set<K extends @Nullable java.lang.Object>
    Overrides:
    isEmpty in class java.util.AbstractCollection<K extends @Nullable java.lang.Object>
    -
    Returns:
    -
    true if this collection contains no elements
    • @@ -440,11 +389,6 @@

    isEmpty

    contains

    public boolean contains​(@CheckForNull
                         java.lang.Object o)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains the specified element. - More formally, returns true if and only if this collection - contains at least one element e such that - Objects.equals(o, e).
    Specified by:
    contains in interface java.util.Collection<K extends @Nullable java.lang.Object>
    @@ -452,11 +396,6 @@

    contains

    contains in interface java.util.Set<K extends @Nullable java.lang.Object>
    Overrides:
    contains in class java.util.AbstractCollection<K extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    o - element whose presence in this collection is to be tested
    -
    Returns:
    -
    true if this collection contains the specified - element
    @@ -468,14 +407,6 @@

    contains

    remove

    public boolean remove​(@CheckForNull
                       java.lang.Object o)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation). More formally, - removes an element e such that - Objects.equals(o, e), if - this collection contains one or more such elements. Returns - true if this collection contained the specified element (or - equivalently, if this collection changed as a result of the call).
    Specified by:
    remove in interface java.util.Collection<K extends @Nullable java.lang.Object>
    @@ -483,10 +414,6 @@

    remove

    remove in interface java.util.Set<K extends @Nullable java.lang.Object>
    Overrides:
    remove in class java.util.AbstractCollection<K extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    o - element to be removed from this collection, if present
    -
    Returns:
    -
    true if an element was removed as a result of this call
    @@ -497,9 +424,6 @@

    remove

  • clear

    public void clear()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes all of the elements from this collection (optional operation). - The collection will be empty after this method returns.
    Specified by:
    clear in interface java.util.Collection<K extends @Nullable java.lang.Object>
    @@ -517,28 +441,6 @@

    clear

  • removeAll

    public boolean removeAll​(java.util.Collection<?> c)
    -
    Description copied from class: java.util.AbstractSet
    -
    Removes from this set all of its elements that are contained in the - specified collection (optional operation). If the specified - collection is also a set, this operation effectively modifies this - set so that its value is the asymmetric set difference of - the two sets. - -

    This implementation determines which is the smaller of this set - and the specified collection, by invoking the size - method on each. If this set has fewer elements, then the - implementation iterates over this set, checking each element - returned by the iterator in turn to see if it is contained in - the specified collection. If it is so contained, it is removed - from this set with the iterator's remove method. If - the specified collection has fewer elements, then the - implementation iterates over the specified collection, removing - from this set each element returned by the iterator, using this - set's remove method. - -

    Note that this implementation will throw an - UnsupportedOperationException if the iterator returned by the - iterator method does not implement the remove method.

    Specified by:
    removeAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -546,13 +448,6 @@

    removeAll

    removeAll in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    removeAll in class java.util.AbstractSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    c - collection containing elements to be removed from this set
    -
    Returns:
    -
    true if this set changed as a result of the call
    -
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    • @@ -563,11 +458,6 @@

    removeAll

  • retainAll

    public boolean retainAll​(java.util.Collection<?> c)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation). In other words, removes from - this collection all of its elements that are not contained in the - specified collection.
    Specified by:
    retainAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -575,13 +465,6 @@

    retainAll

    retainAll in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    retainAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    c - collection containing elements to be retained in this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    -
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingMap.StandardValues.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingMap.StandardValues.html index 4a2da2e896dc..65b33198c2a0 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingMap.StandardValues.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingMap.StandardValues.html @@ -201,70 +201,47 @@

    Method Summary

    void clear() - -
    Removes all of the elements from this collection (optional operation).
    - +  boolean contains​(java.lang.Object o) - -
    Returns true if this collection contains the specified element.
    - +  void forEach​(java.util.function.Consumer<? super V> action) - -
    Performs the given action for each element of the Iterable - until all elements have been processed or the action throws an - exception.
    - +  boolean isEmpty() - -
    Returns true if this collection contains no elements.
    - +  java.util.Iterator<V> iterator() - -
    Returns an iterator over the elements contained in this collection.
    - +  boolean remove​(java.lang.Object o) - -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation).
    - +  boolean removeAll​(java.util.Collection<?> c) - -
    Removes all of this collection's elements that are also contained in the - specified collection (optional operation).
    - +  boolean retainAll​(java.util.Collection<?> c) - -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation).
    - +  int size() - -
    Returns the number of elements in this collection.
    - + 
      @@ -331,8 +308,6 @@

      Method Detail

    • iterator

      public java.util.Iterator<V> iterator()
      -
      Description copied from class: java.util.AbstractCollection
      -
      Returns an iterator over the elements contained in this collection.
      Specified by:
      iterator in interface java.util.Collection<K extends @Nullable java.lang.Object>
      @@ -340,8 +315,6 @@

      iterator

      iterator in interface java.lang.Iterable<K extends @Nullable java.lang.Object>
      Specified by:
      iterator in class java.util.AbstractCollection<V extends @Nullable java.lang.Object>
      -
      Returns:
      -
      an iterator over the elements contained in this collection
    @@ -352,20 +325,6 @@

    iterator

  • forEach

    public void forEach​(java.util.function.Consumer<? super V> action)
    -
    Description copied from interface: java.lang.Iterable
    -
    Performs the given action for each element of the Iterable - until all elements have been processed or the action throws an - exception. Actions are performed in the order of iteration, if that - order is specified. Exceptions thrown by the action are relayed to the - caller. -

    - The behavior of this method is unspecified if the action performs - side-effects that modify the underlying source of elements, unless an - overriding class has specified a concurrent modification policy.

    -
    -
    Parameters:
    -
    action - The action to be performed for each element
    -
    • @@ -376,23 +335,11 @@

    forEach

    remove

    public boolean remove​(@CheckForNull
                       java.lang.Object o)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation). More formally, - removes an element e such that - Objects.equals(o, e), if - this collection contains one or more such elements. Returns - true if this collection contained the specified element (or - equivalently, if this collection changed as a result of the call).
    Specified by:
    remove in interface java.util.Collection<K extends @Nullable java.lang.Object>
    Overrides:
    remove in class java.util.AbstractCollection<V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    o - element to be removed from this collection, if present
    -
    Returns:
    -
    true if an element was removed as a result of this call
    • @@ -403,24 +350,11 @@

    remove

  • removeAll

    public boolean removeAll​(java.util.Collection<?> c)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes all of this collection's elements that are also contained in the - specified collection (optional operation). After this call returns, - this collection will contain no elements in common with the specified - collection.
    Specified by:
    removeAll in interface java.util.Collection<K extends @Nullable java.lang.Object>
    Overrides:
    removeAll in class java.util.AbstractCollection<V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    c - collection containing elements to be removed from this collection
    -
    Returns:
    -
    true if this collection changed as a result of the - call
    -
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    • @@ -431,23 +365,11 @@

    removeAll

  • retainAll

    public boolean retainAll​(java.util.Collection<?> c)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation). In other words, removes from - this collection all of its elements that are not contained in the - specified collection.
    Specified by:
    retainAll in interface java.util.Collection<K extends @Nullable java.lang.Object>
    Overrides:
    retainAll in class java.util.AbstractCollection<V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    c - collection containing elements to be retained in this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    -
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    • @@ -458,17 +380,11 @@

    retainAll

  • size

    public int size()
    -
    Description copied from interface: java.util.Collection
    -
    Returns the number of elements in this collection. If this collection - contains more than Integer.MAX_VALUE elements, returns - Integer.MAX_VALUE.
    Specified by:
    size in interface java.util.Collection<K extends @Nullable java.lang.Object>
    Specified by:
    size in class java.util.AbstractCollection<V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the number of elements in this collection
    • @@ -479,15 +395,11 @@

    size

  • isEmpty

    public boolean isEmpty()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains no elements.
    Specified by:
    isEmpty in interface java.util.Collection<K extends @Nullable java.lang.Object>
    Overrides:
    isEmpty in class java.util.AbstractCollection<V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    true if this collection contains no elements
    • @@ -499,21 +411,11 @@

    isEmpty

    contains

    public boolean contains​(@CheckForNull
                         java.lang.Object o)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains the specified element. - More formally, returns true if and only if this collection - contains at least one element e such that - Objects.equals(o, e).
    Specified by:
    contains in interface java.util.Collection<K extends @Nullable java.lang.Object>
    Overrides:
    contains in class java.util.AbstractCollection<V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    o - element whose presence in this collection is to be tested
    -
    Returns:
    -
    true if this collection contains the specified - element
    @@ -524,9 +426,6 @@

    contains

  • clear

    public void clear()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes all of the elements from this collection (optional operation). - The collection will be empty after this method returns.
    Specified by:
    clear in interface java.util.Collection<K extends @Nullable java.lang.Object>
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingMap.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingMap.html index 443af6db56c8..a3d5114d9f27 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingMap.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingMap.html @@ -224,7 +224,7 @@

    Nested Class Summary

    Nested classes/interfaces inherited from interface java.util.Map

    -java.util.Map.Entry<K,​V>
    • +java.util.Map.Entry<K extends java.lang.Object,​V extends java.lang.Object> @@ -271,25 +271,17 @@

    Method Summary

    void clear() - -
    Removes all of the mappings from this map (optional operation).
    - +  boolean containsKey​(java.lang.Object key) - -
    Returns true if this map contains a mapping for the specified - key.
    - +  boolean containsValue​(java.lang.Object value) - -
    Returns true if this map maps one or more keys to the - specified value.
    - +  protected abstract java.util.Map<K,​V> @@ -301,77 +293,53 @@

    Method Summary

    java.util.Set<java.util.Map.Entry<K,​V>> entrySet() - -
    Returns a Set view of the mappings contained in this map.
    - +  boolean equals​(java.lang.Object object) - -
    Indicates whether some other object is "equal to" this one.
    - +  V get​(java.lang.Object key) - -
    Returns the value to which the specified key is mapped, - or null if this map contains no mapping for the key.
    - +  int hashCode() - -
    Returns a hash code value for the object.
    - +  boolean isEmpty() - -
    Returns true if this map contains no key-value mappings.
    - +  java.util.Set<K> keySet() - -
    Returns a Set view of the keys contained in this map.
    - +  V put​(K key, V value) - -
    Associates the specified value with the specified key in this map - (optional operation).
    - +  void putAll​(java.util.Map<? extends K,​? extends V> map) - -
    Copies all of the mappings from the specified map to this map - (optional operation).
    - +  V remove​(java.lang.Object key) - -
    Removes the mapping for a key from this map if it is present - (optional operation).
    - +  int size() - -
    Returns the number of key-value mappings in this map.
    - +  protected void @@ -442,9 +410,7 @@

    Method Summary

    java.util.Collection<V> values() - -
    Returns a Collection view of the values contained in this map.
    - + 
      @@ -529,15 +495,9 @@

      delegate

    • size

      public int size()
      -
      Description copied from interface: java.util.Map
      -
      Returns the number of key-value mappings in this map. If the - map contains more than Integer.MAX_VALUE elements, returns - Integer.MAX_VALUE.
      Specified by:
      size in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
      -
      Returns:
      -
      the number of key-value mappings in this map
    @@ -548,13 +508,9 @@

    size

  • isEmpty

    public boolean isEmpty()
    -
    Description copied from interface: java.util.Map
    -
    Returns true if this map contains no key-value mappings.
    Specified by:
    isEmpty in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    true if this map contains no key-value mappings
    • @@ -568,31 +524,9 @@

    remove

    @CheckForNull public V remove​(@CheckForNull java.lang.Object key) -
    Description copied from interface: java.util.Map
    -
    Removes the mapping for a key from this map if it is present - (optional operation). More formally, if this map contains a mapping - from key k to value v such that - Objects.equals(key, k), that mapping - is removed. (The map can contain at most one such mapping.) - -

    Returns the value to which this map previously associated the key, - or null if the map contained no mapping for the key. - -

    If this map permits null values, then a return value of - null does not necessarily indicate that the map - contained no mapping for the key; it's also possible that the map - explicitly mapped the key to null. - -

    The map will not contain a mapping for the specified key once the - call returns.

    Specified by:
    remove in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - key whose mapping is to be removed from the map
    -
    Returns:
    -
    the previous value associated with key, or - null if there was no mapping for key.
    @@ -603,9 +537,6 @@

    remove

  • clear

    public void clear()
    -
    Description copied from interface: java.util.Map
    -
    Removes all of the mappings from this map (optional operation). - The map will be empty after this call returns.
    Specified by:
    clear in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    @@ -620,20 +551,9 @@

    clear

    containsKey

    public boolean containsKey​(@CheckForNull
                            java.lang.Object key)
    -
    Description copied from interface: java.util.Map
    -
    Returns true if this map contains a mapping for the specified - key. More formally, returns true if and only if - this map contains a mapping for a key k such that - Objects.equals(key, k). (There can be - at most one such mapping.)
    Specified by:
    containsKey in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - key whose presence in this map is to be tested
    -
    Returns:
    -
    true if this map contains a mapping for the specified - key
    • @@ -645,21 +565,9 @@

    containsKey

    containsValue

    public boolean containsValue​(@CheckForNull
                              java.lang.Object value)
    -
    Description copied from interface: java.util.Map
    -
    Returns true if this map maps one or more keys to the - specified value. More formally, returns true if and only if - this map contains at least one mapping to a value v such that - Objects.equals(value, v). This operation - will probably require time linear in the map size for most - implementations of the Map interface.
    Specified by:
    containsValue in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    value - value whose presence in this map is to be tested
    -
    Returns:
    -
    true if this map maps one or more keys to the - specified value
    @@ -672,28 +580,9 @@

    get

    @CheckForNull
 public V get​(@CheckForNull
              java.lang.Object key)
    -
    Description copied from interface: java.util.Map
    -
    Returns the value to which the specified key is mapped, - or null if this map contains no mapping for the key. - -

    More formally, if this map contains a mapping from a key - k to a value v such that - Objects.equals(key, k), - then this method returns v; otherwise - it returns null. (There can be at most one such mapping.) - -

    If this map permits null values, then a return value of - null does not necessarily indicate that the map - contains no mapping for the key; it's also possible that the map - explicitly maps the key to null. The containsKey operation may be used to distinguish these two cases.

    Specified by:
    get in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - the key whose associated value is to be returned
    -
    Returns:
    -
    the value to which the specified key is mapped, or - null if this map contains no mapping for the key
    @@ -709,25 +598,9 @@

    put

    @CheckForNull public V put​(K key, V value) -
    Description copied from interface: java.util.Map
    -
    Associates the specified value with the specified key in this map - (optional operation). If the map previously contained a mapping for - the key, the old value is replaced by the specified value. (A map - m is said to contain a mapping for a key k if and only - if m.containsKey(k) would return - true.)
    Specified by:
    put in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - key with which the specified value is to be associated
    -
    value - value to be associated with the specified key
    -
    Returns:
    -
    the previous value associated with key, or - null if there was no mapping for key. - (A null return can also indicate that the map - previously associated null with key, - if the implementation supports null values.)
    @@ -738,18 +611,9 @@

    put

  • putAll

    public void putAll​(java.util.Map<? extends K,​? extends V> map)
    -
    Description copied from interface: java.util.Map
    -
    Copies all of the mappings from the specified map to this map - (optional operation). The effect of this call is equivalent to that - of calling put(k, v) on this map once - for each mapping from key k to value v in the - specified map. The behavior of this operation is undefined if the - specified map is modified while the operation is in progress.
    Specified by:
    putAll in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    map - mappings to be stored in this map
    • @@ -760,23 +624,9 @@

    putAll

  • keySet

    public java.util.Set<K> keySet()
    -
    Description copied from interface: java.util.Map
    -
    Returns a Set view of the keys contained in this map. - The set is backed by the map, so changes to the map are - reflected in the set, and vice-versa. If the map is modified - while an iteration over the set is in progress (except through - the iterator's own remove operation), the results of - the iteration are undefined. The set supports element removal, - which removes the corresponding mapping from the map, via the - Iterator.remove, Set.remove, - removeAll, retainAll, and clear - operations. It does not support the add or addAll - operations.
    Specified by:
    keySet in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a set view of the keys contained in this map
    • @@ -787,23 +637,9 @@

    keySet

  • values

    public java.util.Collection<V> values()
    -
    Description copied from interface: java.util.Map
    -
    Returns a Collection view of the values contained in this map. - The collection is backed by the map, so changes to the map are - reflected in the collection, and vice-versa. If the map is - modified while an iteration over the collection is in progress - (except through the iterator's own remove operation), - the results of the iteration are undefined. The collection - supports element removal, which removes the corresponding - mapping from the map, via the Iterator.remove, - Collection.remove, removeAll, - retainAll and clear operations. It does not - support the add or addAll operations.
    Specified by:
    values in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a collection view of the values contained in this map
    • @@ -814,24 +650,9 @@

    values

  • entrySet

    public java.util.Set<java.util.Map.Entry<K,​V>> entrySet()
    -
    Description copied from interface: java.util.Map
    -
    Returns a Set view of the mappings contained in this map. - The set is backed by the map, so changes to the map are - reflected in the set, and vice-versa. If the map is modified - while an iteration over the set is in progress (except through - the iterator's own remove operation, or through the - setValue operation on a map entry returned by the - iterator) the results of the iteration are undefined. The set - supports element removal, which removes the corresponding - mapping from the map, via the Iterator.remove, - Set.remove, removeAll, retainAll and - clear operations. It does not support the - add or addAll operations.
    Specified by:
    entrySet in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a set view of the mappings contained in this map
    • @@ -843,58 +664,11 @@

    entrySet

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object object)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    Specified by:
    equals in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -905,45 +679,11 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    Specified by:
    hashCode in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingMapEntry.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingMapEntry.html index ec2283ccc4a7..3c1bfef36d80 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingMapEntry.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingMapEntry.html @@ -222,38 +222,27 @@

    Method Summary

    boolean equals​(java.lang.Object object) - -
    Indicates whether some other object is "equal to" this one.
    - +  K getKey() - -
    Returns the key corresponding to this entry.
    - +  V getValue() - -
    Returns the value corresponding to this entry.
    - +  int hashCode() - -
    Returns a hash code value for the object.
    - +  V setValue​(V value) - -
    Replaces the value corresponding to this entry with the specified - value (optional operation).
    - +  protected boolean @@ -352,13 +341,9 @@

    delegate

  • getKey

    public K getKey()
    -
    Description copied from interface: java.util.Map.Entry
    -
    Returns the key corresponding to this entry.
    Specified by:
    getKey in interface java.util.Map.Entry<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the key corresponding to this entry
    • @@ -369,15 +354,9 @@

    getKey

  • getValue

    public V getValue()
    -
    Description copied from interface: java.util.Map.Entry
    -
    Returns the value corresponding to this entry. If the mapping - has been removed from the backing map (by the iterator's - remove operation), the results of this call are undefined.
    Specified by:
    getValue in interface java.util.Map.Entry<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the value corresponding to this entry
    • @@ -390,18 +369,9 @@

    getValue

  • setValue

    public V setValue​(V value)
    -
    Description copied from interface: java.util.Map.Entry
    -
    Replaces the value corresponding to this entry with the specified - value (optional operation). (Writes through to the map.) The - behavior of this call is undefined if the mapping has already been - removed from the map (by the iterator's remove operation).
    Specified by:
    setValue in interface java.util.Map.Entry<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    value - new value to be stored in this entry
    -
    Returns:
    -
    old value corresponding to the entry
    • @@ -413,58 +383,11 @@

    setValue

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object object)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    Specified by:
    equals in interface java.util.Map.Entry<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -475,45 +398,11 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    Specified by:
    hashCode in interface java.util.Map.Entry<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingMultimap.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingMultimap.html index f5a8a106d1a8..7209189367b7 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingMultimap.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingMultimap.html @@ -265,7 +265,7 @@

    Method Summary

    boolean equals​(java.lang.Object object) -
    Indicates whether some other object is "equal to" this one.
    +
    Compares the specified object with this multimap for equality.
    @@ -279,7 +279,7 @@

    Method Summary

    int hashCode() -
    Returns a hash code value for the object.
    +
    Returns the hash code for this multimap.
    @@ -821,58 +821,23 @@

    values

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object object)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    +
    Description copied from interface: Multimap
    +
    Compares the specified object with this multimap for equality. Two multimaps are equal when + their map views, as returned by Multimap.asMap(), are also equal. + +

    In general, two multimaps with identical key-value mappings may or may not be equal, + depending on the implementation. For example, two SetMultimap instances with the same + key-value mappings are equal, but equality of two ListMultimap instances depends on the + ordering of the values for each key. + +

    A non-empty SetMultimap cannot be equal to a non-empty ListMultimap, since + their Multimap.asMap() views contain unequal collections as values. However, any two empty + multimaps are equal, because they both have empty Multimap.asMap() views.

    Specified by:
    equals in interface Multimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -883,45 +848,21 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    +
    Description copied from interface: Multimap
    +
    Returns the hash code for this multimap. + +

    The hash code of a multimap is defined as the hash code of the map view, as returned by + Multimap.asMap(). + +

    In general, two multimaps with identical key-value mappings may or may not have the same + hash codes, depending on the implementation. For example, two SetMultimap instances + with the same key-value mappings will have the same hashCode, but the hashCode + of ListMultimap instances depends on the ordering of the values for each key.

    Specified by:
    hashCode in interface Multimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingMultiset.StandardElementSet.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingMultiset.StandardElementSet.html index fd334737ff16..64e2c852648b 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingMultiset.StandardElementSet.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingMultiset.StandardElementSet.html @@ -207,69 +207,47 @@

    Method Summary

    void clear() - -
    Removes all of the elements from this collection (optional operation).
    - +  boolean contains​(java.lang.Object o) - -
    Returns true if this collection contains the specified element.
    - +  boolean containsAll​(java.util.Collection<?> c) - -
    Returns true if this collection contains all of the elements - in the specified collection.
    - +  boolean isEmpty() - -
    Returns true if this collection contains no elements.
    - +  java.util.Iterator<E> iterator() - -
    Returns an iterator over the elements contained in this collection.
    - +  boolean remove​(java.lang.Object o) - -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation).
    - +  boolean removeAll​(java.util.Collection<?> c) - -
    Removes from this set all of its elements that are contained in the - specified collection (optional operation).
    - +  boolean retainAll​(java.util.Collection<?> c) - -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation).
    - +  int size() - -
    Returns the number of elements in this collection.
    - + 
      @@ -357,8 +335,6 @@

      Method Detail

    • iterator

      public java.util.Iterator<E> iterator()
      -
      Description copied from class: java.util.AbstractCollection
      -
      Returns an iterator over the elements contained in this collection.
      Specified by:
      iterator in interface java.util.Collection<E extends @Nullable java.lang.Object>
      @@ -366,8 +342,6 @@

      iterator

      iterator in interface java.lang.Iterable<E extends @Nullable java.lang.Object>
      Specified by:
      iterator in interface java.util.Set<E extends @Nullable java.lang.Object>
      -
      Returns:
      -
      an iterator over the elements contained in this collection
    @@ -378,9 +352,6 @@

    iterator

  • clear

    public void clear()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes all of the elements from this collection (optional operation). - The collection will be empty after this method returns.
    Specified by:
    clear in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -399,11 +370,6 @@

    clear

    contains

    public boolean contains​(@CheckForNull
                         java.lang.Object o)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains the specified element. - More formally, returns true if and only if this collection - contains at least one element e such that - Objects.equals(o, e).
    Specified by:
    contains in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -411,11 +377,6 @@

    contains

    contains in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    contains in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    o - element whose presence in this collection is to be tested
    -
    Returns:
    -
    true if this collection contains the specified - element
    • @@ -426,9 +387,6 @@

    contains

  • containsAll

    public boolean containsAll​(java.util.Collection<?> c)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains all of the elements - in the specified collection.
    Specified by:
    containsAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -436,13 +394,6 @@

    containsAll

    containsAll in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    containsAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    c - collection to be checked for containment in this collection
    -
    Returns:
    -
    true if this collection contains all of the elements - in the specified collection
    -
    See Also:
    -
    AbstractCollection.contains(Object)
    • @@ -453,8 +404,6 @@

    containsAll

  • isEmpty

    public boolean isEmpty()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains no elements.
    Specified by:
    isEmpty in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -462,8 +411,6 @@

    isEmpty

    isEmpty in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    isEmpty in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    true if this collection contains no elements
    • @@ -475,14 +422,6 @@

    isEmpty

    remove

    public boolean remove​(@CheckForNull
                       java.lang.Object o)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation). More formally, - removes an element e such that - Objects.equals(o, e), if - this collection contains one or more such elements. Returns - true if this collection contained the specified element (or - equivalently, if this collection changed as a result of the call).
    Specified by:
    remove in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -490,10 +429,6 @@

    remove

    remove in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    remove in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    o - element to be removed from this collection, if present
    -
    Returns:
    -
    true if an element was removed as a result of this call
    @@ -504,10 +439,6 @@

    remove

  • size

    public int size()
    -
    Description copied from interface: java.util.Collection
    -
    Returns the number of elements in this collection. If this collection - contains more than Integer.MAX_VALUE elements, returns - Integer.MAX_VALUE.
    Specified by:
    size in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -515,8 +446,6 @@

    size

    size in interface java.util.Set<E extends @Nullable java.lang.Object>
    Specified by:
    size in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the number of elements in this collection
    • @@ -527,28 +456,6 @@

    size

  • removeAll

    public boolean removeAll​(java.util.Collection<?> c)
    -
    Description copied from class: java.util.AbstractSet
    -
    Removes from this set all of its elements that are contained in the - specified collection (optional operation). If the specified - collection is also a set, this operation effectively modifies this - set so that its value is the asymmetric set difference of - the two sets. - -

    This implementation determines which is the smaller of this set - and the specified collection, by invoking the size - method on each. If this set has fewer elements, then the - implementation iterates over this set, checking each element - returned by the iterator in turn to see if it is contained in - the specified collection. If it is so contained, it is removed - from this set with the iterator's remove method. If - the specified collection has fewer elements, then the - implementation iterates over the specified collection, removing - from this set each element returned by the iterator, using this - set's remove method. - -

    Note that this implementation will throw an - UnsupportedOperationException if the iterator returned by the - iterator method does not implement the remove method.

    Specified by:
    removeAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -556,13 +463,6 @@

    removeAll

    removeAll in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    removeAll in class java.util.AbstractSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    c - collection containing elements to be removed from this set
    -
    Returns:
    -
    true if this set changed as a result of the call
    -
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    • @@ -573,11 +473,6 @@

    removeAll

  • retainAll

    public boolean retainAll​(java.util.Collection<?> c)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation). In other words, removes from - this collection all of its elements that are not contained in the - specified collection.
    Specified by:
    retainAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -585,13 +480,6 @@

    retainAll

    retainAll in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    retainAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    c - collection containing elements to be retained in this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    -
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingMultiset.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingMultiset.html index 13b1b8b6ea73..8d1504853938 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingMultiset.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingMultiset.html @@ -295,14 +295,14 @@

    Method Summary

    boolean equals​(java.lang.Object object) -
    Indicates whether some other object is "equal to" this one.
    +
    Compares the specified object with this multiset for equality.
    int hashCode() -
    Returns a hash code value for the object.
    +
    Returns the hash code for this multiset.
    @@ -679,45 +679,10 @@

    entrySet

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object object)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    +
    Description copied from interface: Multiset
    +
    Compares the specified object with this multiset for equality. Returns true if the + given object is also a multiset and contains equal elements with equal counts, regardless of + order.
    Specified by:
    equals in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -725,14 +690,6 @@

    equals

    equals in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -743,35 +700,15 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    +
    Description copied from interface: Multiset
    +
    Returns the hash code for this multiset. This is defined as the sum of + + 
    
+ ((element == null) ? 0 : element.hashCode()) ^ count(element)
+
    + +

    over all distinct elements in the multiset. It follows that a multiset and its entry set + always have the same hash code.

    Specified by:
    hashCode in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -779,11 +716,6 @@

    hashCode

    hashCode in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingNavigableMap.StandardDescendingMap.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingNavigableMap.StandardDescendingMap.html index fbaf5eee8a85..afb3f6afaa29 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingNavigableMap.StandardDescendingMap.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingNavigableMap.StandardDescendingMap.html @@ -187,7 +187,7 @@

    Nested classes/interfaces inherited from class com.google.common.collec

    Nested classes/interfaces inherited from interface java.util.Map

    -java.util.Map.Entry<K,​V> +java.util.Map.Entry<K extends java.lang.Object,​V extends java.lang.Object> @@ -232,27 +232,17 @@

    Method Summary

    java.util.Map.Entry<K,​V> ceilingEntry​(K key) - -
    Returns a key-value mapping associated with the least key - greater than or equal to the given key, or null if - there is no such key.
    - +  K ceilingKey​(K key) - -
    Returns the least key greater than or equal to the given key, - or null if there is no such key.
    - +  java.util.Comparator<? super K> comparator() - -
    Returns the comparator used to order the keys in this map, or - null if this map uses the natural ordering of its keys.
    - +  protected java.util.Map<K,​V> @@ -264,16 +254,12 @@

    Method Summary

    java.util.NavigableSet<K> descendingKeySet() - -
    Returns a reverse order NavigableSet view of the keys contained in this map.
    - +  java.util.NavigableMap<K,​V> descendingMap() - -
    Returns a reverse order view of the mappings contained in this map.
    - +  protected java.util.Iterator<java.util.Map.Entry<K,​V>> @@ -283,146 +269,93 @@

    Method Summary

    java.util.Set<java.util.Map.Entry<K,​V>> entrySet() - -
    Returns a Set view of the mappings contained in this map.
    - +  java.util.Map.Entry<K,​V> firstEntry() - -
    Returns a key-value mapping associated with the least - key in this map, or null if the map is empty.
    - +  K firstKey() - -
    Returns the first (lowest) key currently in this map.
    - +  java.util.Map.Entry<K,​V> floorEntry​(K key) - -
    Returns a key-value mapping associated with the greatest key - less than or equal to the given key, or null if there - is no such key.
    - +  K floorKey​(K key) - -
    Returns the greatest key less than or equal to the given key, - or null if there is no such key.
    - +  java.util.SortedMap<K,​V> headMap​(K toKey) - -
    Returns a view of the portion of this map whose keys are - strictly less than toKey.
    - +  java.util.NavigableMap<K,​V> headMap​(K toKey, boolean inclusive) - -
    Returns a view of the portion of this map whose keys are less than (or - equal to, if inclusive is true) toKey.
    - +  java.util.Map.Entry<K,​V> higherEntry​(K key) - -
    Returns a key-value mapping associated with the least key - strictly greater than the given key, or null if there - is no such key.
    - +  K higherKey​(K key) - -
    Returns the least key strictly greater than the given key, or - null if there is no such key.
    - +  java.util.Set<K> keySet() - -
    Returns a Set view of the keys contained in this map.
    - +  java.util.Map.Entry<K,​V> lastEntry() - -
    Returns a key-value mapping associated with the greatest - key in this map, or null if the map is empty.
    - +  K lastKey() - -
    Returns the last (highest) key currently in this map.
    - +  java.util.Map.Entry<K,​V> lowerEntry​(K key) - -
    Returns a key-value mapping associated with the greatest key - strictly less than the given key, or null if there is - no such key.
    - +  K lowerKey​(K key) - -
    Returns the greatest key strictly less than the given key, or - null if there is no such key.
    - +  java.util.NavigableSet<K> navigableKeySet() - -
    Returns a NavigableSet view of the keys contained in this map.
    - +  java.util.Map.Entry<K,​V> pollFirstEntry() - -
    Removes and returns a key-value mapping associated with - the least key in this map, or null if the map is empty.
    - +  java.util.Map.Entry<K,​V> pollLastEntry() - -
    Removes and returns a key-value mapping associated with - the greatest key in this map, or null if the map is empty.
    - +  void replaceAll​(java.util.function.BiFunction<? super K,​? super V,​? extends V> function) - -
    Replaces each entry's value with the result of invoking the given - function on that entry until all entries have been processed or the - function throws an exception.
    - +  java.util.NavigableMap<K,​V> @@ -430,36 +363,24 @@

    Method Summary

    boolean fromInclusive, K toKey, boolean toInclusive) - -
    Returns a view of the portion of this map whose keys range from - fromKey to toKey.
    - +  java.util.SortedMap<K,​V> subMap​(K fromKey, K toKey) - -
    Returns a view of the portion of this map whose keys range from - fromKey, inclusive, to toKey, exclusive.
    - +  java.util.SortedMap<K,​V> tailMap​(K fromKey) - -
    Returns a view of the portion of this map whose keys are - greater than or equal to fromKey.
    - +  java.util.NavigableMap<K,​V> tailMap​(K fromKey, boolean inclusive) - -
    Returns a view of the portion of this map whose keys are greater than (or - equal to, if inclusive is true) fromKey.
    - +  java.lang.String @@ -471,9 +392,7 @@

    Method Summary

    java.util.Collection<V> values() - -
    Returns a Collection view of the values contained in this map.
    - + 
      @@ -540,15 +459,6 @@

      Method Detail

    • replaceAll

      public void replaceAll​(java.util.function.BiFunction<? super K,​? super V,​? extends V> function)
      -
      Description copied from interface: java.util.Map
      -
      Replaces each entry's value with the result of invoking the given - function on that entry until all entries have been processed or the - function throws an exception. Exceptions thrown by the function are - relayed to the caller.
      -
      -
      Parameters:
      -
      function - the function to apply to each entry
      -
    @@ -585,16 +495,9 @@

    delegate

  • comparator

    public java.util.Comparator<? super K> comparator()
    -
    Description copied from interface: java.util.SortedMap
    -
    Returns the comparator used to order the keys in this map, or - null if this map uses the natural ordering of its keys.
    Specified by:
    comparator in interface java.util.SortedMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the comparator used to order the keys in this map, - or null if this map uses the natural ordering - of its keys
    • @@ -605,13 +508,9 @@

    comparator

  • firstKey

    public K firstKey()
    -
    Description copied from interface: java.util.SortedMap
    -
    Returns the first (lowest) key currently in this map.
    Specified by:
    firstKey in interface java.util.SortedMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the first (lowest) key currently in this map
    • @@ -622,13 +521,9 @@

    firstKey

  • lastKey

    public K lastKey()
    -
    Description copied from interface: java.util.SortedMap
    -
    Returns the last (highest) key currently in this map.
    Specified by:
    lastKey in interface java.util.SortedMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the last (highest) key currently in this map
    • @@ -642,18 +537,9 @@

    lastKey

    lowerEntry

    @CheckForNull
 public java.util.Map.Entry<K,​V> lowerEntry​(K key)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a key-value mapping associated with the greatest key - strictly less than the given key, or null if there is - no such key.
    Specified by:
    lowerEntry in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - the key
    -
    Returns:
    -
    an entry with the greatest key less than key, - or null if there is no such key
    @@ -667,17 +553,9 @@

    lowerEntry

    lowerKey

    @CheckForNull
 public K lowerKey​(K key)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns the greatest key strictly less than the given key, or - null if there is no such key.
    Specified by:
    lowerKey in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - the key
    -
    Returns:
    -
    the greatest key less than key, - or null if there is no such key
    @@ -691,18 +569,9 @@

    lowerKey

    floorEntry

    @CheckForNull
 public java.util.Map.Entry<K,​V> floorEntry​(K key)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a key-value mapping associated with the greatest key - less than or equal to the given key, or null if there - is no such key.
    Specified by:
    floorEntry in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - the key
    -
    Returns:
    -
    an entry with the greatest key less than or equal to - key, or null if there is no such key
    @@ -716,17 +585,9 @@

    floorEntry

    floorKey

    @CheckForNull
 public K floorKey​(K key)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns the greatest key less than or equal to the given key, - or null if there is no such key.
    Specified by:
    floorKey in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - the key
    -
    Returns:
    -
    the greatest key less than or equal to key, - or null if there is no such key
    @@ -740,18 +601,9 @@

    floorKey

    ceilingEntry

    @CheckForNull
 public java.util.Map.Entry<K,​V> ceilingEntry​(K key)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a key-value mapping associated with the least key - greater than or equal to the given key, or null if - there is no such key.
    Specified by:
    ceilingEntry in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - the key
    -
    Returns:
    -
    an entry with the least key greater than or equal to - key, or null if there is no such key
    @@ -765,17 +617,9 @@

    ceilingEntry

    ceilingKey

    @CheckForNull
 public K ceilingKey​(K key)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns the least key greater than or equal to the given key, - or null if there is no such key.
    Specified by:
    ceilingKey in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - the key
    -
    Returns:
    -
    the least key greater than or equal to key, - or null if there is no such key
    @@ -789,18 +633,9 @@

    ceilingKey

    higherEntry

    @CheckForNull
 public java.util.Map.Entry<K,​V> higherEntry​(K key)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a key-value mapping associated with the least key - strictly greater than the given key, or null if there - is no such key.
    Specified by:
    higherEntry in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - the key
    -
    Returns:
    -
    an entry with the least key greater than key, - or null if there is no such key
    @@ -814,17 +649,9 @@

    higherEntry

    higherKey

    @CheckForNull
 public K higherKey​(K key)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns the least key strictly greater than the given key, or - null if there is no such key.
    Specified by:
    higherKey in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - the key
    -
    Returns:
    -
    the least key greater than key, - or null if there is no such key
    @@ -836,15 +663,9 @@

    higherKey

    firstEntry

    @CheckForNull
 public java.util.Map.Entry<K,​V> firstEntry()
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a key-value mapping associated with the least - key in this map, or null if the map is empty.
    Specified by:
    firstEntry in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    an entry with the least key, - or null if this map is empty
    @@ -856,15 +677,9 @@

    firstEntry

    lastEntry

    @CheckForNull
 public java.util.Map.Entry<K,​V> lastEntry()
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a key-value mapping associated with the greatest - key in this map, or null if the map is empty.
    Specified by:
    lastEntry in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    an entry with the greatest key, - or null if this map is empty
    @@ -876,15 +691,9 @@

    lastEntry

    pollFirstEntry

    @CheckForNull
 public java.util.Map.Entry<K,​V> pollFirstEntry()
    -
    Description copied from interface: java.util.NavigableMap
    -
    Removes and returns a key-value mapping associated with - the least key in this map, or null if the map is empty.
    Specified by:
    pollFirstEntry in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the removed first entry of this map, - or null if this map is empty
    @@ -896,15 +705,9 @@

    pollFirstEntry

    pollLastEntry

    @CheckForNull
 public java.util.Map.Entry<K,​V> pollLastEntry()
    -
    Description copied from interface: java.util.NavigableMap
    -
    Removes and returns a key-value mapping associated with - the greatest key in this map, or null if the map is empty.
    Specified by:
    pollLastEntry in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the removed last entry of this map, - or null if this map is empty
    @@ -915,23 +718,9 @@

    pollLastEntry

  • descendingMap

    public java.util.NavigableMap<K,​V> descendingMap()
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a reverse order view of the mappings contained in this map. - The descending map is backed by this map, so changes to the map are - reflected in the descending map, and vice-versa. If either map is - modified while an iteration over a collection view of either map - is in progress (except through the iterator's own remove - operation), the results of the iteration are undefined. - -

    The returned map has an ordering equivalent to - Collections.reverseOrder(comparator()). - The expression m.descendingMap().descendingMap() returns a - view of m essentially equivalent to m.

    Specified by:
    descendingMap in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a reverse order view of this map
    • @@ -942,19 +731,6 @@

    descendingMap

  • entrySet

    public java.util.Set<java.util.Map.Entry<K,​V>> entrySet()
    -
    Description copied from interface: java.util.Map
    -
    Returns a Set view of the mappings contained in this map. - The set is backed by the map, so changes to the map are - reflected in the set, and vice-versa. If the map is modified - while an iteration over the set is in progress (except through - the iterator's own remove operation, or through the - setValue operation on a map entry returned by the - iterator) the results of the iteration are undefined. The set - supports element removal, which removes the corresponding - mapping from the map, via the Iterator.remove, - Set.remove, removeAll, retainAll and - clear operations. It does not support the - add or addAll operations.
    Specified by:
    entrySet in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    @@ -962,8 +738,6 @@

    entrySet

    entrySet in interface java.util.SortedMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    entrySet in class ForwardingMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a set view of the mappings contained in this map
    • @@ -974,18 +748,6 @@

    entrySet

  • keySet

    public java.util.Set<K> keySet()
    -
    Description copied from interface: java.util.Map
    -
    Returns a Set view of the keys contained in this map. - The set is backed by the map, so changes to the map are - reflected in the set, and vice-versa. If the map is modified - while an iteration over the set is in progress (except through - the iterator's own remove operation), the results of - the iteration are undefined. The set supports element removal, - which removes the corresponding mapping from the map, via the - Iterator.remove, Set.remove, - removeAll, retainAll, and clear - operations. It does not support the add or addAll - operations.
    Specified by:
    keySet in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    @@ -993,8 +755,6 @@

    keySet

    keySet in interface java.util.SortedMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    keySet in class ForwardingMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a set view of the keys contained in this map
    • @@ -1005,22 +765,9 @@

    keySet

  • navigableKeySet

    public java.util.NavigableSet<K> navigableKeySet()
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a NavigableSet view of the keys contained in this map. - The set's iterator returns the keys in ascending order. - The set is backed by the map, so changes to the map are reflected in - the set, and vice-versa. If the map is modified while an iteration - over the set is in progress (except through the iterator's own - remove operation), the results of the iteration are undefined. The - set supports element removal, which removes the corresponding mapping - from the map, via the Iterator.remove, Set.remove, - removeAll, retainAll, and clear operations. - It does not support the add or addAll operations.
    Specified by:
    navigableKeySet in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a navigable set view of the keys in this map
    • @@ -1031,22 +778,9 @@

    navigableKeySet

  • descendingKeySet

    public java.util.NavigableSet<K> descendingKeySet()
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a reverse order NavigableSet view of the keys contained in this map. - The set's iterator returns the keys in descending order. - The set is backed by the map, so changes to the map are reflected in - the set, and vice-versa. If the map is modified while an iteration - over the set is in progress (except through the iterator's own - remove operation), the results of the iteration are undefined. The - set supports element removal, which removes the corresponding mapping - from the map, via the Iterator.remove, Set.remove, - removeAll, retainAll, and clear operations. - It does not support the add or addAll operations.
    Specified by:
    descendingKeySet in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a reverse order navigable set view of the keys in this map
    • @@ -1062,31 +796,9 @@

    subMap

    boolean fromInclusive, K toKey, boolean toInclusive) -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a view of the portion of this map whose keys range from - fromKey to toKey. If fromKey and - toKey are equal, the returned map is empty unless - fromInclusive and toInclusive are both true. The - returned map is backed by this map, so changes in the returned map are - reflected in this map, and vice-versa. The returned map supports all - optional map operations that this map supports. - -

    The returned map will throw an IllegalArgumentException - on an attempt to insert a key outside of its range, or to construct a - submap either of whose endpoints lie outside its range.

    Specified by:
    subMap in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromKey - low endpoint of the keys in the returned map
    -
    fromInclusive - true if the low endpoint - is to be included in the returned view
    -
    toKey - high endpoint of the keys in the returned map
    -
    toInclusive - true if the high endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this map whose keys range from - fromKey to toKey
    @@ -1100,30 +812,11 @@

    subMap

    subMap

    public java.util.SortedMap<K,​V> subMap​(K fromKey,
                                              K toKey)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a view of the portion of this map whose keys range from - fromKey, inclusive, to toKey, exclusive. (If - fromKey and toKey are equal, the returned map - is empty.) The returned map is backed by this map, so changes - in the returned map are reflected in this map, and vice-versa. - The returned map supports all optional map operations that this - map supports. - -

    The returned map will throw an IllegalArgumentException - on an attempt to insert a key outside its range. - -

    Equivalent to subMap(fromKey, true, toKey, false).

    Specified by:
    subMap in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Specified by:
    subMap in interface java.util.SortedMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromKey - low endpoint (inclusive) of the keys in the returned map
    -
    toKey - high endpoint (exclusive) of the keys in the returned map
    -
    Returns:
    -
    a view of the portion of this map whose keys range from - fromKey, inclusive, to toKey, exclusive
    @@ -1137,25 +830,9 @@

    subMap

    headMap

    public java.util.NavigableMap<K,​V> headMap​(K toKey,
                                                  boolean inclusive)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a view of the portion of this map whose keys are less than (or - equal to, if inclusive is true) toKey. The returned - map is backed by this map, so changes in the returned map are reflected - in this map, and vice-versa. The returned map supports all optional - map operations that this map supports. - -

    The returned map will throw an IllegalArgumentException - on an attempt to insert a key outside its range.

    Specified by:
    headMap in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    toKey - high endpoint of the keys in the returned map
    -
    inclusive - true if the high endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this map whose keys are less than - (or equal to, if inclusive is true) toKey
    @@ -1168,27 +845,11 @@

    headMap

  • headMap

    public java.util.SortedMap<K,​V> headMap​(K toKey)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a view of the portion of this map whose keys are - strictly less than toKey. The returned map is backed - by this map, so changes in the returned map are reflected in - this map, and vice-versa. The returned map supports all - optional map operations that this map supports. - -

    The returned map will throw an IllegalArgumentException - on an attempt to insert a key outside its range. - -

    Equivalent to headMap(toKey, false).

    Specified by:
    headMap in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Specified by:
    headMap in interface java.util.SortedMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    toKey - high endpoint (exclusive) of the keys in the returned map
    -
    Returns:
    -
    a view of the portion of this map whose keys are strictly - less than toKey
    • @@ -1202,25 +863,9 @@

    headMap

    tailMap

    public java.util.NavigableMap<K,​V> tailMap​(K fromKey,
                                                  boolean inclusive)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a view of the portion of this map whose keys are greater than (or - equal to, if inclusive is true) fromKey. The returned - map is backed by this map, so changes in the returned map are reflected - in this map, and vice-versa. The returned map supports all optional - map operations that this map supports. - -

    The returned map will throw an IllegalArgumentException - on an attempt to insert a key outside its range.

    Specified by:
    tailMap in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromKey - low endpoint of the keys in the returned map
    -
    inclusive - true if the low endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this map whose keys are greater than - (or equal to, if inclusive is true) fromKey
    @@ -1233,27 +878,11 @@

    tailMap

  • tailMap

    public java.util.SortedMap<K,​V> tailMap​(K fromKey)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a view of the portion of this map whose keys are - greater than or equal to fromKey. The returned map is - backed by this map, so changes in the returned map are - reflected in this map, and vice-versa. The returned map - supports all optional map operations that this map supports. - -

    The returned map will throw an IllegalArgumentException - on an attempt to insert a key outside its range. - -

    Equivalent to tailMap(fromKey, true).

    Specified by:
    tailMap in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Specified by:
    tailMap in interface java.util.SortedMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromKey - low endpoint (inclusive) of the keys in the returned map
    -
    Returns:
    -
    a view of the portion of this map whose keys are greater - than or equal to fromKey
    • @@ -1264,18 +893,6 @@

    tailMap

  • values

    public java.util.Collection<V> values()
    -
    Description copied from interface: java.util.Map
    -
    Returns a Collection view of the values contained in this map. - The collection is backed by the map, so changes to the map are - reflected in the collection, and vice-versa. If the map is - modified while an iteration over the collection is in progress - (except through the iterator's own remove operation), - the results of the iteration are undefined. The collection - supports element removal, which removes the corresponding - mapping from the map, via the Iterator.remove, - Collection.remove, removeAll, - retainAll and clear operations. It does not - support the add or addAll operations.
    Specified by:
    values in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    @@ -1283,8 +900,6 @@

    values

    values in interface java.util.SortedMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    values in class ForwardingMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a collection view of the values contained in this map
    • @@ -1300,8 +915,6 @@

    toString

    Overrides:
    toString in class ForwardingObject
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingNavigableMap.StandardNavigableKeySet.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingNavigableMap.StandardNavigableKeySet.html index e3442f54f8c7..207c4034e3ee 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingNavigableMap.StandardNavigableKeySet.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingNavigableMap.StandardNavigableKeySet.html @@ -206,171 +206,113 @@

    Method Summary

    K ceiling​(K e) - -
    Returns the least element in this set greater than or equal to - the given element, or null if there is no such element.
    - +  void clear() - -
    Removes all of the elements from this collection (optional operation).
    - +  java.util.Comparator<? super K> comparator() - -
    Returns the comparator used to order the elements in this set, - or null if this set uses the natural ordering of its elements.
    - +  boolean contains​(java.lang.Object o) - -
    Returns true if this collection contains the specified element.
    - +  java.util.Iterator<K> descendingIterator() - -
    Returns an iterator over the elements in this set, in descending order.
    - +  java.util.NavigableSet<K> descendingSet() - -
    Returns a reverse order view of the elements contained in this set.
    - +  K first() - -
    Returns the first (lowest) element currently in this set.
    - +  K floor​(K e) - -
    Returns the greatest element in this set less than or equal to - the given element, or null if there is no such element.
    - +  void forEach​(java.util.function.Consumer<? super K> action) - -
    Performs the given action for each element of the Iterable - until all elements have been processed or the action throws an - exception.
    - +  java.util.SortedSet<K> headSet​(K toElement) - -
    Returns a view of the portion of this set whose elements are - strictly less than toElement.
    - +  java.util.NavigableSet<K> headSet​(K toElement, boolean inclusive) - -
    Returns a view of the portion of this set whose elements are less than - (or equal to, if inclusive is true) toElement.
    - +  K higher​(K e) - -
    Returns the least element in this set strictly greater than the - given element, or null if there is no such element.
    - +  boolean isEmpty() - -
    Returns true if this collection contains no elements.
    - +  java.util.Iterator<K> iterator() - -
    Returns an iterator over the elements contained in this collection.
    - +  K last() - -
    Returns the last (highest) element currently in this set.
    - +  K lower​(K e) - -
    Returns the greatest element in this set strictly less than the - given element, or null if there is no such element.
    - +  K pollFirst() - -
    Retrieves and removes the first (lowest) element, - or returns null if this set is empty.
    - +  K pollLast() - -
    Retrieves and removes the last (highest) element, - or returns null if this set is empty.
    - +  boolean remove​(java.lang.Object o) - -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation).
    - +  boolean removeAll​(java.util.Collection<?> c) - -
    Removes from this set all of its elements that are contained in the - specified collection (optional operation).
    - +  boolean retainAll​(java.util.Collection<?> c) - -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation).
    - +  int size() - -
    Returns the number of elements in this collection.
    - +  java.util.NavigableSet<K> @@ -378,37 +320,24 @@

    Method Summary

    boolean fromInclusive, K toElement, boolean toInclusive) - -
    Returns a view of the portion of this set whose elements range from - fromElement to toElement.
    - +  java.util.SortedSet<K> subSet​(K fromElement, K toElement) - -
    Returns a view of the portion of this set whose elements range - from fromElement, inclusive, to toElement, - exclusive.
    - +  java.util.SortedSet<K> tailSet​(K fromElement) - -
    Returns a view of the portion of this set whose elements are - greater than or equal to fromElement.
    - +  java.util.NavigableSet<K> tailSet​(K fromElement, boolean inclusive) - -
    Returns a view of the portion of this set whose elements are greater - than (or equal to, if inclusive is true) fromElement.
    - + 
      @@ -513,17 +442,9 @@

      Method Detail

      lower

      @CheckForNull
 public K lower​(K e)
      -
      Description copied from interface: java.util.NavigableSet
      -
      Returns the greatest element in this set strictly less than the - given element, or null if there is no such element.
      Specified by:
      lower in interface java.util.NavigableSet<K extends @Nullable java.lang.Object>
      -
      Parameters:
      -
      e - the value to match
      -
      Returns:
      -
      the greatest element less than e, - or null if there is no such element
    @@ -537,17 +458,9 @@

    lower

    floor

    @CheckForNull
 public K floor​(K e)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns the greatest element in this set less than or equal to - the given element, or null if there is no such element.
    Specified by:
    floor in interface java.util.NavigableSet<K extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    e - the value to match
    -
    Returns:
    -
    the greatest element less than or equal to e, - or null if there is no such element
    @@ -561,17 +474,9 @@

    floor

    ceiling

    @CheckForNull
 public K ceiling​(K e)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns the least element in this set greater than or equal to - the given element, or null if there is no such element.
    Specified by:
    ceiling in interface java.util.NavigableSet<K extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    e - the value to match
    -
    Returns:
    -
    the least element greater than or equal to e, - or null if there is no such element
    @@ -585,17 +490,9 @@

    ceiling

    higher

    @CheckForNull
 public K higher​(K e)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns the least element in this set strictly greater than the - given element, or null if there is no such element.
    Specified by:
    higher in interface java.util.NavigableSet<K extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    e - the value to match
    -
    Returns:
    -
    the least element greater than e, - or null if there is no such element
    @@ -607,14 +504,9 @@

    higher

    pollFirst

    @CheckForNull
 public K pollFirst()
    -
    Description copied from interface: java.util.NavigableSet
    -
    Retrieves and removes the first (lowest) element, - or returns null if this set is empty.
    Specified by:
    pollFirst in interface java.util.NavigableSet<K extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the first element, or null if this set is empty
    @@ -626,14 +518,9 @@

    pollFirst

    pollLast

    @CheckForNull
 public K pollLast()
    -
    Description copied from interface: java.util.NavigableSet
    -
    Retrieves and removes the last (highest) element, - or returns null if this set is empty.
    Specified by:
    pollLast in interface java.util.NavigableSet<K extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the last element, or null if this set is empty
    @@ -644,23 +531,9 @@

    pollLast

  • descendingSet

    public java.util.NavigableSet<K> descendingSet()
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns a reverse order view of the elements contained in this set. - The descending set is backed by this set, so changes to the set are - reflected in the descending set, and vice-versa. If either set is - modified while an iteration over either set is in progress (except - through the iterator's own remove operation), the results of - the iteration are undefined. - -

    The returned set has an ordering equivalent to - Collections.reverseOrder(comparator()). - The expression s.descendingSet().descendingSet() returns a - view of s essentially equivalent to s.

    Specified by:
    descendingSet in interface java.util.NavigableSet<K extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a reverse order view of this set
    • @@ -671,14 +544,9 @@

    descendingSet

  • descendingIterator

    public java.util.Iterator<K> descendingIterator()
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns an iterator over the elements in this set, in descending order. - Equivalent in effect to descendingSet().iterator().
    Specified by:
    descendingIterator in interface java.util.NavigableSet<K extends @Nullable java.lang.Object>
    -
    Returns:
    -
    an iterator over the elements in this set, in descending order
    • @@ -694,30 +562,9 @@

    subSet

    boolean fromInclusive, K toElement, boolean toInclusive) -
    Description copied from interface: java.util.NavigableSet
    -
    Returns a view of the portion of this set whose elements range from - fromElement to toElement. If fromElement and - toElement are equal, the returned set is empty unless - fromInclusive and toInclusive are both true. The returned set - is backed by this set, so changes in the returned set are reflected in - this set, and vice-versa. The returned set supports all optional set - operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    subSet in interface java.util.NavigableSet<K extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromElement - low endpoint of the returned set
    -
    fromInclusive - true if the low endpoint - is to be included in the returned view
    -
    toElement - high endpoint of the returned set
    -
    toInclusive - true if the high endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this set whose elements range from - fromElement, inclusive, to toElement, exclusive
    @@ -731,28 +578,11 @@

    subSet

    subSet

    public java.util.SortedSet<K> subSet​(K fromElement,
                                      K toElement)
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns a view of the portion of this set whose elements range - from fromElement, inclusive, to toElement, - exclusive. (If fromElement and toElement are - equal, the returned set is empty.) The returned set is backed - by this set, so changes in the returned set are reflected in - this set, and vice-versa. The returned set supports all - optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    subSet in interface java.util.NavigableSet<K extends @Nullable java.lang.Object>
    Specified by:
    subSet in interface java.util.SortedSet<K extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromElement - low endpoint (inclusive) of the returned set
    -
    toElement - high endpoint (exclusive) of the returned set
    -
    Returns:
    -
    a view of the portion of this set whose elements range from - fromElement, inclusive, to toElement, exclusive
    @@ -766,25 +596,9 @@

    subSet

    headSet

    public java.util.NavigableSet<K> headSet​(K toElement,
                                          boolean inclusive)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns a view of the portion of this set whose elements are less than - (or equal to, if inclusive is true) toElement. The - returned set is backed by this set, so changes in the returned set are - reflected in this set, and vice-versa. The returned set supports all - optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    headSet in interface java.util.NavigableSet<K extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    toElement - high endpoint of the returned set
    -
    inclusive - true if the high endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this set whose elements are less than - (or equal to, if inclusive is true) toElement
    @@ -797,25 +611,11 @@

    headSet

  • headSet

    public java.util.SortedSet<K> headSet​(K toElement)
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns a view of the portion of this set whose elements are - strictly less than toElement. The returned set is - backed by this set, so changes in the returned set are - reflected in this set, and vice-versa. The returned set - supports all optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    headSet in interface java.util.NavigableSet<K extends @Nullable java.lang.Object>
    Specified by:
    headSet in interface java.util.SortedSet<K extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    toElement - high endpoint (exclusive) of the returned set
    -
    Returns:
    -
    a view of the portion of this set whose elements are strictly - less than toElement
    • @@ -829,25 +629,9 @@

    headSet

    tailSet

    public java.util.NavigableSet<K> tailSet​(K fromElement,
                                          boolean inclusive)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns a view of the portion of this set whose elements are greater - than (or equal to, if inclusive is true) fromElement. - The returned set is backed by this set, so changes in the returned set - are reflected in this set, and vice-versa. The returned set supports - all optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    tailSet in interface java.util.NavigableSet<K extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromElement - low endpoint of the returned set
    -
    inclusive - true if the low endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this set whose elements are greater - than or equal to fromElement
    @@ -860,25 +644,11 @@

    tailSet

  • tailSet

    public java.util.SortedSet<K> tailSet​(K fromElement)
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns a view of the portion of this set whose elements are - greater than or equal to fromElement. The returned - set is backed by this set, so changes in the returned set are - reflected in this set, and vice-versa. The returned set - supports all optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    tailSet in interface java.util.NavigableSet<K extends @Nullable java.lang.Object>
    Specified by:
    tailSet in interface java.util.SortedSet<K extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromElement - low endpoint (inclusive) of the returned set
    -
    Returns:
    -
    a view of the portion of this set whose elements are greater - than or equal to fromElement
    • @@ -890,16 +660,9 @@

    tailSet

    comparator

    @CheckForNull
 public java.util.Comparator<? super K> comparator()
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns the comparator used to order the elements in this set, - or null if this set uses the natural ordering of its elements.
    Specified by:
    comparator in interface java.util.SortedSet<K extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the comparator used to order the elements in this set, - or null if this set uses the natural ordering - of its elements
    @@ -910,13 +673,9 @@

    comparator

  • first

    public K first()
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns the first (lowest) element currently in this set.
    Specified by:
    first in interface java.util.SortedSet<K extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the first (lowest) element currently in this set
    • @@ -927,13 +686,9 @@

    first

  • last

    public K last()
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns the last (highest) element currently in this set.
    Specified by:
    last in interface java.util.SortedSet<K extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the last (highest) element currently in this set
    • @@ -944,8 +699,6 @@

    last

  • iterator

    public java.util.Iterator<K> iterator()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns an iterator over the elements contained in this collection.
    Specified by:
    iterator in interface java.util.Collection<K extends @Nullable java.lang.Object>
    @@ -955,8 +708,6 @@

    iterator

    iterator in interface java.util.Set<K extends @Nullable java.lang.Object>
    Specified by:
    iterator in class java.util.AbstractCollection<K extends @Nullable java.lang.Object>
    -
    Returns:
    -
    an iterator over the elements contained in this collection
    • @@ -967,20 +718,6 @@

    iterator

  • forEach

    public void forEach​(java.util.function.Consumer<? super K> action)
    -
    Description copied from interface: java.lang.Iterable
    -
    Performs the given action for each element of the Iterable - until all elements have been processed or the action throws an - exception. Actions are performed in the order of iteration, if that - order is specified. Exceptions thrown by the action are relayed to the - caller. -

    - The behavior of this method is unspecified if the action performs - side-effects that modify the underlying source of elements, unless an - overriding class has specified a concurrent modification policy.

    -
    -
    Parameters:
    -
    action - The action to be performed for each element
    -
    • @@ -990,10 +727,6 @@

    forEach

  • size

    public int size()
    -
    Description copied from interface: java.util.Collection
    -
    Returns the number of elements in this collection. If this collection - contains more than Integer.MAX_VALUE elements, returns - Integer.MAX_VALUE.
    Specified by:
    size in interface java.util.Collection<K extends @Nullable java.lang.Object>
    @@ -1001,8 +734,6 @@

    size

    size in interface java.util.Set<K extends @Nullable java.lang.Object>
    Specified by:
    size in class java.util.AbstractCollection<K extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the number of elements in this collection
    • @@ -1013,8 +744,6 @@

    size

  • isEmpty

    public boolean isEmpty()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains no elements.
    Specified by:
    isEmpty in interface java.util.Collection<K extends @Nullable java.lang.Object>
    @@ -1022,8 +751,6 @@

    isEmpty

    isEmpty in interface java.util.Set<K extends @Nullable java.lang.Object>
    Overrides:
    isEmpty in class java.util.AbstractCollection<K extends @Nullable java.lang.Object>
    -
    Returns:
    -
    true if this collection contains no elements
    • @@ -1035,11 +762,6 @@

    isEmpty

    contains

    public boolean contains​(@CheckForNull
                         java.lang.Object o)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains the specified element. - More formally, returns true if and only if this collection - contains at least one element e such that - Objects.equals(o, e).
    Specified by:
    contains in interface java.util.Collection<K extends @Nullable java.lang.Object>
    @@ -1047,11 +769,6 @@

    contains

    contains in interface java.util.Set<K extends @Nullable java.lang.Object>
    Overrides:
    contains in class java.util.AbstractCollection<K extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    o - element whose presence in this collection is to be tested
    -
    Returns:
    -
    true if this collection contains the specified - element
    @@ -1063,14 +780,6 @@

    contains

    remove

    public boolean remove​(@CheckForNull
                       java.lang.Object o)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation). More formally, - removes an element e such that - Objects.equals(o, e), if - this collection contains one or more such elements. Returns - true if this collection contained the specified element (or - equivalently, if this collection changed as a result of the call).
    Specified by:
    remove in interface java.util.Collection<K extends @Nullable java.lang.Object>
    @@ -1078,10 +787,6 @@

    remove

    remove in interface java.util.Set<K extends @Nullable java.lang.Object>
    Overrides:
    remove in class java.util.AbstractCollection<K extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    o - element to be removed from this collection, if present
    -
    Returns:
    -
    true if an element was removed as a result of this call
    @@ -1092,9 +797,6 @@

    remove

  • clear

    public void clear()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes all of the elements from this collection (optional operation). - The collection will be empty after this method returns.
    Specified by:
    clear in interface java.util.Collection<K extends @Nullable java.lang.Object>
    @@ -1112,28 +814,6 @@

    clear

  • removeAll

    public boolean removeAll​(java.util.Collection<?> c)
    -
    Description copied from class: java.util.AbstractSet
    -
    Removes from this set all of its elements that are contained in the - specified collection (optional operation). If the specified - collection is also a set, this operation effectively modifies this - set so that its value is the asymmetric set difference of - the two sets. - -

    This implementation determines which is the smaller of this set - and the specified collection, by invoking the size - method on each. If this set has fewer elements, then the - implementation iterates over this set, checking each element - returned by the iterator in turn to see if it is contained in - the specified collection. If it is so contained, it is removed - from this set with the iterator's remove method. If - the specified collection has fewer elements, then the - implementation iterates over the specified collection, removing - from this set each element returned by the iterator, using this - set's remove method. - -

    Note that this implementation will throw an - UnsupportedOperationException if the iterator returned by the - iterator method does not implement the remove method.

    Specified by:
    removeAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -1141,13 +821,6 @@

    removeAll

    removeAll in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    removeAll in class java.util.AbstractSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    c - collection containing elements to be removed from this set
    -
    Returns:
    -
    true if this set changed as a result of the call
    -
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    • @@ -1158,11 +831,6 @@

    removeAll

  • retainAll

    public boolean retainAll​(java.util.Collection<?> c)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation). In other words, removes from - this collection all of its elements that are not contained in the - specified collection.
    Specified by:
    retainAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -1170,13 +838,6 @@

    retainAll

    retainAll in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    retainAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    c - collection containing elements to be retained in this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    -
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingNavigableMap.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingNavigableMap.html index e320f29e88e1..752ade299788 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingNavigableMap.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingNavigableMap.html @@ -237,7 +237,7 @@

    Nested classes/interfaces inherited from class com.google.common.collec

    Nested classes/interfaces inherited from interface java.util.Map

    -java.util.Map.Entry<K,​V>
    • +java.util.Map.Entry<K extends java.lang.Object,​V extends java.lang.Object> @@ -284,19 +284,12 @@

    Method Summary

    java.util.Map.Entry<K,​V> ceilingEntry​(K key) - -
    Returns a key-value mapping associated with the least key - greater than or equal to the given key, or null if - there is no such key.
    - +  K ceilingKey​(K key) - -
    Returns the least key greater than or equal to the given key, - or null if there is no such key.
    - +  protected abstract java.util.NavigableMap<K,​V> @@ -308,115 +301,73 @@

    Method Summary

    java.util.NavigableSet<K> descendingKeySet() - -
    Returns a reverse order NavigableSet view of the keys contained in this map.
    - +  java.util.NavigableMap<K,​V> descendingMap() - -
    Returns a reverse order view of the mappings contained in this map.
    - +  java.util.Map.Entry<K,​V> firstEntry() - -
    Returns a key-value mapping associated with the least - key in this map, or null if the map is empty.
    - +  java.util.Map.Entry<K,​V> floorEntry​(K key) - -
    Returns a key-value mapping associated with the greatest key - less than or equal to the given key, or null if there - is no such key.
    - +  K floorKey​(K key) - -
    Returns the greatest key less than or equal to the given key, - or null if there is no such key.
    - +  java.util.NavigableMap<K,​V> headMap​(K toKey, boolean inclusive) - -
    Returns a view of the portion of this map whose keys are less than (or - equal to, if inclusive is true) toKey.
    - +  java.util.Map.Entry<K,​V> higherEntry​(K key) - -
    Returns a key-value mapping associated with the least key - strictly greater than the given key, or null if there - is no such key.
    - +  K higherKey​(K key) - -
    Returns the least key strictly greater than the given key, or - null if there is no such key.
    - +  java.util.Map.Entry<K,​V> lastEntry() - -
    Returns a key-value mapping associated with the greatest - key in this map, or null if the map is empty.
    - +  java.util.Map.Entry<K,​V> lowerEntry​(K key) - -
    Returns a key-value mapping associated with the greatest key - strictly less than the given key, or null if there is - no such key.
    - +  K lowerKey​(K key) - -
    Returns the greatest key strictly less than the given key, or - null if there is no such key.
    - +  java.util.NavigableSet<K> navigableKeySet() - -
    Returns a NavigableSet view of the keys contained in this map.
    - +  java.util.Map.Entry<K,​V> pollFirstEntry() - -
    Removes and returns a key-value mapping associated with - the least key in this map, or null if the map is empty.
    - +  java.util.Map.Entry<K,​V> pollLastEntry() - -
    Removes and returns a key-value mapping associated with - the greatest key in this map, or null if the map is empty.
    - +  protected java.util.Map.Entry<K,​V> @@ -556,19 +507,13 @@

    Method Summary

    boolean fromInclusive, K toKey, boolean toInclusive) - -
    Returns a view of the portion of this map whose keys range from - fromKey to toKey.
    - +  java.util.NavigableMap<K,​V> tailMap​(K fromKey, boolean inclusive) - -
    Returns a view of the portion of this map whose keys are greater than (or - equal to, if inclusive is true) fromKey.
    - + 
      @@ -684,18 +629,9 @@

      delegate

      lowerEntry

      @CheckForNull
 public java.util.Map.Entry<K,​V> lowerEntry​(K key)
      -
      Description copied from interface: java.util.NavigableMap
      -
      Returns a key-value mapping associated with the greatest key - strictly less than the given key, or null if there is - no such key.
      Specified by:
      lowerEntry in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
      -
      Parameters:
      -
      key - the key
      -
      Returns:
      -
      an entry with the greatest key less than key, - or null if there is no such key
    @@ -723,17 +659,9 @@

    standardLowerEntry

    lowerKey

    @CheckForNull
 public K lowerKey​(K key)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns the greatest key strictly less than the given key, or - null if there is no such key.
    Specified by:
    lowerKey in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - the key
    -
    Returns:
    -
    the greatest key less than key, - or null if there is no such key
    @@ -762,18 +690,9 @@

    standardLowerKey

    floorEntry

    @CheckForNull
 public java.util.Map.Entry<K,​V> floorEntry​(K key)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a key-value mapping associated with the greatest key - less than or equal to the given key, or null if there - is no such key.
    Specified by:
    floorEntry in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - the key
    -
    Returns:
    -
    an entry with the greatest key less than or equal to - key, or null if there is no such key
    @@ -801,17 +720,9 @@

    standardFloorEntry

    floorKey

    @CheckForNull
 public K floorKey​(K key)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns the greatest key less than or equal to the given key, - or null if there is no such key.
    Specified by:
    floorKey in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - the key
    -
    Returns:
    -
    the greatest key less than or equal to key, - or null if there is no such key
    @@ -840,18 +751,9 @@

    standardFloorKey

    ceilingEntry

    @CheckForNull
 public java.util.Map.Entry<K,​V> ceilingEntry​(K key)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a key-value mapping associated with the least key - greater than or equal to the given key, or null if - there is no such key.
    Specified by:
    ceilingEntry in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - the key
    -
    Returns:
    -
    an entry with the least key greater than or equal to - key, or null if there is no such key
    @@ -879,17 +781,9 @@

    standardCeilingEntry

    ceilingKey

    @CheckForNull
 public K ceilingKey​(K key)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns the least key greater than or equal to the given key, - or null if there is no such key.
    Specified by:
    ceilingKey in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - the key
    -
    Returns:
    -
    the least key greater than or equal to key, - or null if there is no such key
    @@ -918,18 +812,9 @@

    standardCeilingKey

    higherEntry

    @CheckForNull
 public java.util.Map.Entry<K,​V> higherEntry​(K key)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a key-value mapping associated with the least key - strictly greater than the given key, or null if there - is no such key.
    Specified by:
    higherEntry in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - the key
    -
    Returns:
    -
    an entry with the least key greater than key, - or null if there is no such key
    @@ -957,17 +842,9 @@

    standardHigherEntry

    higherKey

    @CheckForNull
 public K higherKey​(K key)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns the least key strictly greater than the given key, or - null if there is no such key.
    Specified by:
    higherKey in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - the key
    -
    Returns:
    -
    the least key greater than key, - or null if there is no such key
    @@ -994,15 +871,9 @@

    standardHigherKey

    firstEntry

    @CheckForNull
 public java.util.Map.Entry<K,​V> firstEntry()
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a key-value mapping associated with the least - key in this map, or null if the map is empty.
    Specified by:
    firstEntry in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    an entry with the least key, - or null if this map is empty
    @@ -1038,15 +909,9 @@

    standardFirstKey

    lastEntry

    @CheckForNull
 public java.util.Map.Entry<K,​V> lastEntry()
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a key-value mapping associated with the greatest - key in this map, or null if the map is empty.
    Specified by:
    lastEntry in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    an entry with the greatest key, - or null if this map is empty
    @@ -1081,15 +946,9 @@

    standardLastKey

    pollFirstEntry

    @CheckForNull
 public java.util.Map.Entry<K,​V> pollFirstEntry()
    -
    Description copied from interface: java.util.NavigableMap
    -
    Removes and returns a key-value mapping associated with - the least key in this map, or null if the map is empty.
    Specified by:
    pollFirstEntry in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the removed first entry of this map, - or null if this map is empty
    @@ -1114,15 +973,9 @@

    standardPollFirstEntry

    pollLastEntry

    @CheckForNull
 public java.util.Map.Entry<K,​V> pollLastEntry()
    -
    Description copied from interface: java.util.NavigableMap
    -
    Removes and returns a key-value mapping associated with - the greatest key in this map, or null if the map is empty.
    Specified by:
    pollLastEntry in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the removed last entry of this map, - or null if this map is empty
    @@ -1146,23 +999,9 @@

    standardPollLastEntry

  • descendingMap

    public java.util.NavigableMap<K,​V> descendingMap()
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a reverse order view of the mappings contained in this map. - The descending map is backed by this map, so changes to the map are - reflected in the descending map, and vice-versa. If either map is - modified while an iteration over a collection view of either map - is in progress (except through the iterator's own remove - operation), the results of the iteration are undefined. - -

    The returned map has an ordering equivalent to - Collections.reverseOrder(comparator()). - The expression m.descendingMap().descendingMap() returns a - view of m essentially equivalent to m.

    Specified by:
    descendingMap in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a reverse order view of this map
    • @@ -1173,22 +1012,9 @@

    descendingMap

  • navigableKeySet

    public java.util.NavigableSet<K> navigableKeySet()
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a NavigableSet view of the keys contained in this map. - The set's iterator returns the keys in ascending order. - The set is backed by the map, so changes to the map are reflected in - the set, and vice-versa. If the map is modified while an iteration - over the set is in progress (except through the iterator's own - remove operation), the results of the iteration are undefined. The - set supports element removal, which removes the corresponding mapping - from the map, via the Iterator.remove, Set.remove, - removeAll, retainAll, and clear operations. - It does not support the add or addAll operations.
    Specified by:
    navigableKeySet in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a navigable set view of the keys in this map
    • @@ -1199,22 +1025,9 @@

    navigableKeySet

  • descendingKeySet

    public java.util.NavigableSet<K> descendingKeySet()
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a reverse order NavigableSet view of the keys contained in this map. - The set's iterator returns the keys in descending order. - The set is backed by the map, so changes to the map are reflected in - the set, and vice-versa. If the map is modified while an iteration - over the set is in progress (except through the iterator's own - remove operation), the results of the iteration are undefined. The - set supports element removal, which removes the corresponding mapping - from the map, via the Iterator.remove, Set.remove, - removeAll, retainAll, and clear operations. - It does not support the add or addAll operations.
    Specified by:
    descendingKeySet in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a reverse order navigable set view of the keys in this map
    • @@ -1263,31 +1076,9 @@

    subMap

    boolean fromInclusive, K toKey, boolean toInclusive) -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a view of the portion of this map whose keys range from - fromKey to toKey. If fromKey and - toKey are equal, the returned map is empty unless - fromInclusive and toInclusive are both true. The - returned map is backed by this map, so changes in the returned map are - reflected in this map, and vice-versa. The returned map supports all - optional map operations that this map supports. - -

    The returned map will throw an IllegalArgumentException - on an attempt to insert a key outside of its range, or to construct a - submap either of whose endpoints lie outside its range.

    Specified by:
    subMap in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromKey - low endpoint of the keys in the returned map
    -
    fromInclusive - true if the low endpoint - is to be included in the returned view
    -
    toKey - high endpoint of the keys in the returned map
    -
    toInclusive - true if the high endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this map whose keys range from - fromKey to toKey
    @@ -1301,25 +1092,9 @@

    subMap

    headMap

    public java.util.NavigableMap<K,​V> headMap​(K toKey,
                                                  boolean inclusive)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a view of the portion of this map whose keys are less than (or - equal to, if inclusive is true) toKey. The returned - map is backed by this map, so changes in the returned map are reflected - in this map, and vice-versa. The returned map supports all optional - map operations that this map supports. - -

    The returned map will throw an IllegalArgumentException - on an attempt to insert a key outside its range.

    Specified by:
    headMap in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    toKey - high endpoint of the keys in the returned map
    -
    inclusive - true if the high endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this map whose keys are less than - (or equal to, if inclusive is true) toKey
    @@ -1333,25 +1108,9 @@

    headMap

    tailMap

    public java.util.NavigableMap<K,​V> tailMap​(K fromKey,
                                                  boolean inclusive)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a view of the portion of this map whose keys are greater than (or - equal to, if inclusive is true) fromKey. The returned - map is backed by this map, so changes in the returned map are reflected - in this map, and vice-versa. The returned map supports all optional - map operations that this map supports. - -

    The returned map will throw an IllegalArgumentException - on an attempt to insert a key outside its range.

    Specified by:
    tailMap in interface java.util.NavigableMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromKey - low endpoint of the keys in the returned map
    -
    inclusive - true if the low endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this map whose keys are greater than - (or equal to, if inclusive is true) fromKey
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingNavigableSet.StandardDescendingSet.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingNavigableSet.StandardDescendingSet.html index 86cc50a0aef8..8ed93d331929 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingNavigableSet.StandardDescendingSet.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingNavigableSet.StandardDescendingSet.html @@ -240,18 +240,12 @@

    Method Summary

    E ceiling​(E e) - -
    Returns the least element in this set greater than or equal to - the given element, or null if there is no such element.
    - +  java.util.Comparator<? super E> comparator() - -
    Returns the comparator used to order the elements in this set, - or null if this set uses the natural ordering of its elements.
    - +  protected java.util.NavigableSet<E> @@ -263,94 +257,63 @@

    Method Summary

    java.util.Iterator<E> descendingIterator() - -
    Returns an iterator over the elements in this set, in descending order.
    - +  java.util.NavigableSet<E> descendingSet() - -
    Returns a reverse order view of the elements contained in this set.
    - +  E first() - -
    Returns the first (lowest) element currently in this set.
    - +  E floor​(E e) - -
    Returns the greatest element in this set less than or equal to - the given element, or null if there is no such element.
    - +  java.util.SortedSet<E> headSet​(E toElement) - -
    Returns a view of the portion of this set whose elements are - strictly less than toElement.
    - +  java.util.NavigableSet<E> headSet​(E toElement, boolean inclusive) - -
    Returns a view of the portion of this set whose elements are less than - (or equal to, if inclusive is true) toElement.
    - +  E higher​(E e) - -
    Returns the least element in this set strictly greater than the - given element, or null if there is no such element.
    - +  java.util.Iterator<E> iterator() - -
    Returns an iterator over the elements in this collection.
    - +  E last() - -
    Returns the last (highest) element currently in this set.
    - +  E lower​(E e) - -
    Returns the greatest element in this set strictly less than the - given element, or null if there is no such element.
    - +  E pollFirst() - -
    Retrieves and removes the first (lowest) element, - or returns null if this set is empty.
    - +  E pollLast() - -
    Retrieves and removes the last (highest) element, - or returns null if this set is empty.
    - +  java.util.NavigableSet<E> @@ -358,52 +321,34 @@

    Method Summary

    boolean fromInclusive, E toElement, boolean toInclusive) - -
    Returns a view of the portion of this set whose elements range from - fromElement to toElement.
    - +  java.util.SortedSet<E> subSet​(E fromElement, E toElement) - -
    Returns a view of the portion of this set whose elements range - from fromElement, inclusive, to toElement, - exclusive.
    - +  java.util.SortedSet<E> tailSet​(E fromElement) - -
    Returns a view of the portion of this set whose elements are - greater than or equal to fromElement.
    - +  java.util.NavigableSet<E> tailSet​(E fromElement, boolean inclusive) - -
    Returns a view of the portion of this set whose elements are greater - than (or equal to, if inclusive is true) fromElement.
    - +  @Nullable java.lang.Object[] toArray() - -
    Returns an array containing all of the elements in this collection.
    - +  <T extends @Nullable java.lang.Object>
    T[]     toArray​(T[] array) - -
    Returns an array containing all of the elements in this collection; - the runtime type of the returned array is that of the specified array.
    - +  java.lang.String @@ -540,19 +485,11 @@

    delegate

    lower

    @CheckForNull
 public E lower​(E e)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns the greatest element in this set strictly less than the - given element, or null if there is no such element.
    Specified by:
    lower in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    Overrides:
    lower in class ForwardingNavigableSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    e - the value to match
    -
    Returns:
    -
    the greatest element less than e, - or null if there is no such element
    @@ -566,19 +503,11 @@

    lower

    floor

    @CheckForNull
 public E floor​(E e)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns the greatest element in this set less than or equal to - the given element, or null if there is no such element.
    Specified by:
    floor in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    Overrides:
    floor in class ForwardingNavigableSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    e - the value to match
    -
    Returns:
    -
    the greatest element less than or equal to e, - or null if there is no such element
    @@ -592,19 +521,11 @@

    floor

    ceiling

    @CheckForNull
 public E ceiling​(E e)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns the least element in this set greater than or equal to - the given element, or null if there is no such element.
    Specified by:
    ceiling in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    Overrides:
    ceiling in class ForwardingNavigableSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    e - the value to match
    -
    Returns:
    -
    the least element greater than or equal to e, - or null if there is no such element
    @@ -618,19 +539,11 @@

    ceiling

    higher

    @CheckForNull
 public E higher​(E e)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns the least element in this set strictly greater than the - given element, or null if there is no such element.
    Specified by:
    higher in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    Overrides:
    higher in class ForwardingNavigableSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    e - the value to match
    -
    Returns:
    -
    the least element greater than e, - or null if there is no such element
    @@ -642,16 +555,11 @@

    higher

    pollFirst

    @CheckForNull
 public E pollFirst()
    -
    Description copied from interface: java.util.NavigableSet
    -
    Retrieves and removes the first (lowest) element, - or returns null if this set is empty.
    Specified by:
    pollFirst in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    Overrides:
    pollFirst in class ForwardingNavigableSet<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the first element, or null if this set is empty
    @@ -663,16 +571,11 @@

    pollFirst

    pollLast

    @CheckForNull
 public E pollLast()
    -
    Description copied from interface: java.util.NavigableSet
    -
    Retrieves and removes the last (highest) element, - or returns null if this set is empty.
    Specified by:
    pollLast in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    Overrides:
    pollLast in class ForwardingNavigableSet<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the last element, or null if this set is empty
    @@ -683,25 +586,11 @@

    pollLast

  • descendingSet

    public java.util.NavigableSet<E> descendingSet()
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns a reverse order view of the elements contained in this set. - The descending set is backed by this set, so changes to the set are - reflected in the descending set, and vice-versa. If either set is - modified while an iteration over either set is in progress (except - through the iterator's own remove operation), the results of - the iteration are undefined. - -

    The returned set has an ordering equivalent to - Collections.reverseOrder(comparator()). - The expression s.descendingSet().descendingSet() returns a - view of s essentially equivalent to s.

    Specified by:
    descendingSet in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    Overrides:
    descendingSet in class ForwardingNavigableSet<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a reverse order view of this set
    • @@ -712,16 +601,11 @@

    descendingSet

  • descendingIterator

    public java.util.Iterator<E> descendingIterator()
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns an iterator over the elements in this set, in descending order. - Equivalent in effect to descendingSet().iterator().
    Specified by:
    descendingIterator in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    Overrides:
    descendingIterator in class ForwardingNavigableSet<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    an iterator over the elements in this set, in descending order
    • @@ -737,32 +621,11 @@

    subSet

    boolean fromInclusive, E toElement, boolean toInclusive) -
    Description copied from interface: java.util.NavigableSet
    -
    Returns a view of the portion of this set whose elements range from - fromElement to toElement. If fromElement and - toElement are equal, the returned set is empty unless - fromInclusive and toInclusive are both true. The returned set - is backed by this set, so changes in the returned set are reflected in - this set, and vice-versa. The returned set supports all optional set - operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    subSet in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    Overrides:
    subSet in class ForwardingNavigableSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromElement - low endpoint of the returned set
    -
    fromInclusive - true if the low endpoint - is to be included in the returned view
    -
    toElement - high endpoint of the returned set
    -
    toInclusive - true if the high endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this set whose elements range from - fromElement, inclusive, to toElement, exclusive
    @@ -776,17 +639,6 @@

    subSet

    subSet

    public java.util.SortedSet<E> subSet​(E fromElement,
                                      E toElement)
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns a view of the portion of this set whose elements range - from fromElement, inclusive, to toElement, - exclusive. (If fromElement and toElement are - equal, the returned set is empty.) The returned set is backed - by this set, so changes in the returned set are reflected in - this set, and vice-versa. The returned set supports all - optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    subSet in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    @@ -794,12 +646,6 @@

    subSet

    subSet in interface java.util.SortedSet<E extends @Nullable java.lang.Object>
    Overrides:
    subSet in class ForwardingSortedSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromElement - low endpoint (inclusive) of the returned set
    -
    toElement - high endpoint (exclusive) of the returned set
    -
    Returns:
    -
    a view of the portion of this set whose elements range from - fromElement, inclusive, to toElement, exclusive
    @@ -813,27 +659,11 @@

    subSet

    headSet

    public java.util.NavigableSet<E> headSet​(E toElement,
                                          boolean inclusive)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns a view of the portion of this set whose elements are less than - (or equal to, if inclusive is true) toElement. The - returned set is backed by this set, so changes in the returned set are - reflected in this set, and vice-versa. The returned set supports all - optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    headSet in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    Overrides:
    headSet in class ForwardingNavigableSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    toElement - high endpoint of the returned set
    -
    inclusive - true if the high endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this set whose elements are less than - (or equal to, if inclusive is true) toElement
    @@ -846,15 +676,6 @@

    headSet

  • headSet

    public java.util.SortedSet<E> headSet​(E toElement)
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns a view of the portion of this set whose elements are - strictly less than toElement. The returned set is - backed by this set, so changes in the returned set are - reflected in this set, and vice-versa. The returned set - supports all optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    headSet in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    @@ -862,11 +683,6 @@

    headSet

    headSet in interface java.util.SortedSet<E extends @Nullable java.lang.Object>
    Overrides:
    headSet in class ForwardingSortedSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    toElement - high endpoint (exclusive) of the returned set
    -
    Returns:
    -
    a view of the portion of this set whose elements are strictly - less than toElement
    • @@ -880,27 +696,11 @@

    headSet

    tailSet

    public java.util.NavigableSet<E> tailSet​(E fromElement,
                                          boolean inclusive)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns a view of the portion of this set whose elements are greater - than (or equal to, if inclusive is true) fromElement. - The returned set is backed by this set, so changes in the returned set - are reflected in this set, and vice-versa. The returned set supports - all optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    tailSet in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    Overrides:
    tailSet in class ForwardingNavigableSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromElement - low endpoint of the returned set
    -
    inclusive - true if the low endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this set whose elements are greater - than or equal to fromElement
    @@ -913,15 +713,6 @@

    tailSet

  • tailSet

    public java.util.SortedSet<E> tailSet​(E fromElement)
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns a view of the portion of this set whose elements are - greater than or equal to fromElement. The returned - set is backed by this set, so changes in the returned set are - reflected in this set, and vice-versa. The returned set - supports all optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    tailSet in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    @@ -929,11 +720,6 @@

    tailSet

    tailSet in interface java.util.SortedSet<E extends @Nullable java.lang.Object>
    Overrides:
    tailSet in class ForwardingSortedSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromElement - low endpoint (inclusive) of the returned set
    -
    Returns:
    -
    a view of the portion of this set whose elements are greater - than or equal to fromElement
    • @@ -944,18 +730,11 @@

    tailSet

  • comparator

    public java.util.Comparator<? super E> comparator()
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns the comparator used to order the elements in this set, - or null if this set uses the natural ordering of its elements.
    Specified by:
    comparator in interface java.util.SortedSet<E extends @Nullable java.lang.Object>
    Overrides:
    comparator in class ForwardingSortedSet<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the comparator used to order the elements in this set, - or null if this set uses the natural ordering - of its elements
    • @@ -966,15 +745,11 @@

    comparator

  • first

    public E first()
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns the first (lowest) element currently in this set.
    Specified by:
    first in interface java.util.SortedSet<E extends @Nullable java.lang.Object>
    Overrides:
    first in class ForwardingSortedSet<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the first (lowest) element currently in this set
    • @@ -985,15 +760,11 @@

    first

  • last

    public E last()
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns the last (highest) element currently in this set.
    Specified by:
    last in interface java.util.SortedSet<E extends @Nullable java.lang.Object>
    Overrides:
    last in class ForwardingSortedSet<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the last (highest) element currently in this set
    • @@ -1004,11 +775,6 @@

    last

  • iterator

    public java.util.Iterator<E> iterator()
    -
    Description copied from interface: java.util.Collection
    -
    Returns an iterator over the elements in this collection. There are no - guarantees concerning the order in which the elements are returned - (unless this collection is an instance of some class that provides a - guarantee).
    Specified by:
    iterator in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -1020,8 +786,6 @@

    iterator

    iterator in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    iterator in class ForwardingCollection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    an Iterator over the elements in this collection
    • @@ -1032,16 +796,6 @@

    iterator

  • toArray

    public @Nullable java.lang.Object[] toArray()
    -
    Description copied from interface: java.util.Collection
    -
    Returns an array containing all of the elements in this collection. - If this collection makes any guarantees as to what order its elements - are returned by its iterator, this method must return the elements in - the same order. The returned array's runtime component type is Object. - -

    The returned array will be "safe" in that no references to it are - maintained by this collection. (In other words, this method must - allocate a new array even if this collection is backed by an array). - The caller is thus free to modify the returned array.

    Specified by:
    toArray in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -1049,9 +803,6 @@

    toArray

    toArray in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    toArray in class ForwardingCollection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    an array, whose runtime component - type is Object, containing all of the elements in this collection
    • @@ -1064,23 +815,6 @@

    toArray

  • toArray

    public <T extends @Nullable java.lang.Object> T[] toArray​(T[] array)
    -
    Description copied from interface: java.util.Collection
    -
    Returns an array containing all of the elements in this collection; - the runtime type of the returned array is that of the specified array. - If the collection fits in the specified array, it is returned therein. - Otherwise, a new array is allocated with the runtime type of the - specified array and the size of this collection. - -

    If this collection fits in the specified array with room to spare - (i.e., the array has more elements than this collection), the element - in the array immediately following the end of the collection is set to - null. (This is useful in determining the length of this - collection only if the caller knows that this collection does - not contain any null elements.) - -

    If this collection makes any guarantees as to what order its elements - are returned by its iterator, this method must return the elements in - the same order.

    Specified by:
    toArray in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -1088,14 +822,6 @@

    toArray

    toArray in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    toArray in class ForwardingCollection<E extends @Nullable java.lang.Object>
    -
    Type Parameters:
    -
    T - the component type of the array to contain the collection
    -
    Parameters:
    -
    array - the array into which the elements of this collection are to be - stored, if it is big enough; otherwise, a new array of the same - runtime type is allocated for this purpose.
    -
    Returns:
    -
    an array containing all of the elements in this collection
    • @@ -1111,8 +837,6 @@

    toString

    Overrides:
    toString in class ForwardingObject
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingNavigableSet.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingNavigableSet.html index dcdff413a63d..c5601c64bb32 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingNavigableSet.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingNavigableSet.html @@ -264,10 +264,7 @@

    Method Summary

    E ceiling​(E e) - -
    Returns the least element in this set greater than or equal to - the given element, or null if there is no such element.
    - +  protected abstract java.util.NavigableSet<E> @@ -279,65 +276,43 @@

    Method Summary

    java.util.Iterator<E> descendingIterator() - -
    Returns an iterator over the elements in this set, in descending order.
    - +  java.util.NavigableSet<E> descendingSet() - -
    Returns a reverse order view of the elements contained in this set.
    - +  E floor​(E e) - -
    Returns the greatest element in this set less than or equal to - the given element, or null if there is no such element.
    - +  java.util.NavigableSet<E> headSet​(E toElement, boolean inclusive) - -
    Returns a view of the portion of this set whose elements are less than - (or equal to, if inclusive is true) toElement.
    - +  E higher​(E e) - -
    Returns the least element in this set strictly greater than the - given element, or null if there is no such element.
    - +  E lower​(E e) - -
    Returns the greatest element in this set strictly less than the - given element, or null if there is no such element.
    - +  E pollFirst() - -
    Retrieves and removes the first (lowest) element, - or returns null if this set is empty.
    - +  E pollLast() - -
    Retrieves and removes the last (highest) element, - or returns null if this set is empty.
    - +  protected E @@ -435,19 +410,13 @@

    Method Summary

    boolean fromInclusive, E toElement, boolean toInclusive) - -
    Returns a view of the portion of this set whose elements range from - fromElement to toElement.
    - +  java.util.NavigableSet<E> tailSet​(E fromElement, boolean inclusive) - -
    Returns a view of the portion of this set whose elements are greater - than (or equal to, if inclusive is true) fromElement.
    - + 
      @@ -584,17 +553,9 @@

      delegate

      lower

      @CheckForNull
 public E lower​(E e)
      -
      Description copied from interface: java.util.NavigableSet
      -
      Returns the greatest element in this set strictly less than the - given element, or null if there is no such element.
      Specified by:
      lower in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
      -
      Parameters:
      -
      e - the value to match
      -
      Returns:
      -
      the greatest element less than e, - or null if there is no such element
    @@ -623,17 +584,9 @@

    standardLower

    floor

    @CheckForNull
 public E floor​(E e)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns the greatest element in this set less than or equal to - the given element, or null if there is no such element.
    Specified by:
    floor in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    e - the value to match
    -
    Returns:
    -
    the greatest element less than or equal to e, - or null if there is no such element
    @@ -662,17 +615,9 @@

    standardFloor

    ceiling

    @CheckForNull
 public E ceiling​(E e)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns the least element in this set greater than or equal to - the given element, or null if there is no such element.
    Specified by:
    ceiling in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    e - the value to match
    -
    Returns:
    -
    the least element greater than or equal to e, - or null if there is no such element
    @@ -700,17 +645,9 @@

    standardCeiling

    higher

    @CheckForNull
 public E higher​(E e)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns the least element in this set strictly greater than the - given element, or null if there is no such element.
    Specified by:
    higher in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    e - the value to match
    -
    Returns:
    -
    the least element greater than e, - or null if there is no such element
    @@ -736,14 +673,9 @@

    standardHigher

    pollFirst

    @CheckForNull
 public E pollFirst()
    -
    Description copied from interface: java.util.NavigableSet
    -
    Retrieves and removes the first (lowest) element, - or returns null if this set is empty.
    Specified by:
    pollFirst in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the first element, or null if this set is empty
    @@ -768,14 +700,9 @@

    standardPollFirst

    pollLast

    @CheckForNull
 public E pollLast()
    -
    Description copied from interface: java.util.NavigableSet
    -
    Retrieves and removes the last (highest) element, - or returns null if this set is empty.
    Specified by:
    pollLast in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the last element, or null if this set is empty
    @@ -817,23 +744,9 @@

    standardLast

  • descendingSet

    public java.util.NavigableSet<E> descendingSet()
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns a reverse order view of the elements contained in this set. - The descending set is backed by this set, so changes to the set are - reflected in the descending set, and vice-versa. If either set is - modified while an iteration over either set is in progress (except - through the iterator's own remove operation), the results of - the iteration are undefined. - -

    The returned set has an ordering equivalent to - Collections.reverseOrder(comparator()). - The expression s.descendingSet().descendingSet() returns a - view of s essentially equivalent to s.

    Specified by:
    descendingSet in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a reverse order view of this set
    • @@ -844,14 +757,9 @@

    descendingSet

  • descendingIterator

    public java.util.Iterator<E> descendingIterator()
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns an iterator over the elements in this set, in descending order. - Equivalent in effect to descendingSet().iterator().
    Specified by:
    descendingIterator in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    an iterator over the elements in this set, in descending order
    • @@ -867,30 +775,9 @@

    subSet

    boolean fromInclusive, E toElement, boolean toInclusive) -
    Description copied from interface: java.util.NavigableSet
    -
    Returns a view of the portion of this set whose elements range from - fromElement to toElement. If fromElement and - toElement are equal, the returned set is empty unless - fromInclusive and toInclusive are both true. The returned set - is backed by this set, so changes in the returned set are reflected in - this set, and vice-versa. The returned set supports all optional set - operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    subSet in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromElement - low endpoint of the returned set
    -
    fromInclusive - true if the low endpoint - is to be included in the returned view
    -
    toElement - high endpoint of the returned set
    -
    toInclusive - true if the high endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this set whose elements range from - fromElement, inclusive, to toElement, exclusive
    @@ -941,25 +828,9 @@

    standardSubSet

    headSet

    public java.util.NavigableSet<E> headSet​(E toElement,
                                          boolean inclusive)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns a view of the portion of this set whose elements are less than - (or equal to, if inclusive is true) toElement. The - returned set is backed by this set, so changes in the returned set are - reflected in this set, and vice-versa. The returned set supports all - optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    headSet in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    toElement - high endpoint of the returned set
    -
    inclusive - true if the high endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this set whose elements are less than - (or equal to, if inclusive is true) toElement
    @@ -987,25 +858,9 @@

    standardHeadSet

    tailSet

    public java.util.NavigableSet<E> tailSet​(E fromElement,
                                          boolean inclusive)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns a view of the portion of this set whose elements are greater - than (or equal to, if inclusive is true) fromElement. - The returned set is backed by this set, so changes in the returned set - are reflected in this set, and vice-versa. The returned set supports - all optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    tailSet in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromElement - low endpoint of the returned set
    -
    inclusive - true if the low endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this set whose elements are greater - than or equal to fromElement
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingObject.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingObject.html index 88a2e8ad47b2..947d4504f498 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingObject.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingObject.html @@ -289,8 +289,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingQueue.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingQueue.html index 9ca4ce6cb799..2027c524ebe2 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingQueue.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingQueue.html @@ -230,40 +230,27 @@

    Method Summary

    E element() - -
    Retrieves, but does not remove, the head of this queue.
    - +  boolean offer​(E o) - -
    Inserts the specified element into this queue if it is possible to do - so immediately without violating capacity restrictions.
    - +  E peek() - -
    Retrieves, but does not remove, the head of this queue, - or returns null if this queue is empty.
    - +  E poll() - -
    Retrieves and removes the head of this queue, - or returns null if this queue is empty.
    - +  E remove() - -
    Retrieves and removes the head of this queue.
    - +  protected boolean @@ -393,20 +380,9 @@

    delegate

    offer

    @CanIgnoreReturnValue
 public boolean offer​(E o)
    -
    Description copied from interface: java.util.Queue
    -
    Inserts the specified element into this queue if it is possible to do - so immediately without violating capacity restrictions. - When using a capacity-restricted queue, this method is generally - preferable to Queue.add(E), which can fail to insert an element only - by throwing an exception.
    Specified by:
    offer in interface java.util.Queue<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    o - the element to add
    -
    Returns:
    -
    true if the element was added to this queue, else - false
    @@ -419,14 +395,9 @@

    poll

    @CanIgnoreReturnValue
 @CheckForNull
 public E poll()
    -
    Description copied from interface: java.util.Queue
    -
    Retrieves and removes the head of this queue, - or returns null if this queue is empty.
    Specified by:
    poll in interface java.util.Queue<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the head of this queue, or null if this queue is empty
    @@ -438,15 +409,9 @@

    poll

    remove

    @CanIgnoreReturnValue
 public E remove()
    -
    Description copied from interface: java.util.Queue
    -
    Retrieves and removes the head of this queue. This method differs - from poll() only in that it throws an exception if - this queue is empty.
    Specified by:
    remove in interface java.util.Queue<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the head of this queue
    @@ -458,14 +423,9 @@

    remove

    peek

    @CheckForNull
 public E peek()
    -
    Description copied from interface: java.util.Queue
    -
    Retrieves, but does not remove, the head of this queue, - or returns null if this queue is empty.
    Specified by:
    peek in interface java.util.Queue<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the head of this queue, or null if this queue is empty
    @@ -476,15 +436,9 @@

    peek

  • element

    public E element()
    -
    Description copied from interface: java.util.Queue
    -
    Retrieves, but does not remove, the head of this queue. This method - differs from peek only in that it throws an exception - if this queue is empty.
    Specified by:
    element in interface java.util.Queue<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the head of this queue
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingSet.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingSet.html index 0b7fe8e422bc..f73a2a314d49 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingSet.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingSet.html @@ -230,16 +230,12 @@

    Method Summary

    boolean equals​(java.lang.Object object) - -
    Indicates whether some other object is "equal to" this one.
    - +  int hashCode() - -
    Returns a hash code value for the object.
    - +  protected boolean @@ -367,45 +363,6 @@

    delegate

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object object)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    Specified by:
    equals in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -413,14 +370,6 @@

    equals

    equals in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -431,35 +380,6 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    Specified by:
    hashCode in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -467,11 +387,6 @@

    hashCode

    hashCode in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingSortedMap.StandardKeySet.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingSortedMap.StandardKeySet.html index 5115b77e3f1d..39da83c3ff84 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingSortedMap.StandardKeySet.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingSortedMap.StandardKeySet.html @@ -205,118 +205,78 @@

    Method Summary

    void clear() - -
    Removes all of the elements from this collection (optional operation).
    - +  java.util.Comparator<? super K> comparator() - -
    Returns the comparator used to order the elements in this set, - or null if this set uses the natural ordering of its elements.
    - +  boolean contains​(java.lang.Object o) - -
    Returns true if this collection contains the specified element.
    - +  K first() - -
    Returns the first (lowest) element currently in this set.
    - +  void forEach​(java.util.function.Consumer<? super K> action) - -
    Performs the given action for each element of the Iterable - until all elements have been processed or the action throws an - exception.
    - +  java.util.SortedSet<K> headSet​(K toElement) - -
    Returns a view of the portion of this set whose elements are - strictly less than toElement.
    - +  boolean isEmpty() - -
    Returns true if this collection contains no elements.
    - +  java.util.Iterator<K> iterator() - -
    Returns an iterator over the elements contained in this collection.
    - +  K last() - -
    Returns the last (highest) element currently in this set.
    - +  boolean remove​(java.lang.Object o) - -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation).
    - +  boolean removeAll​(java.util.Collection<?> c) - -
    Removes from this set all of its elements that are contained in the - specified collection (optional operation).
    - +  boolean retainAll​(java.util.Collection<?> c) - -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation).
    - +  int size() - -
    Returns the number of elements in this collection.
    - +  java.util.SortedSet<K> subSet​(K fromElement, K toElement) - -
    Returns a view of the portion of this set whose elements range - from fromElement, inclusive, to toElement, - exclusive.
    - +  java.util.SortedSet<K> tailSet​(K fromElement) - -
    Returns a view of the portion of this set whose elements are - greater than or equal to fromElement.
    - + 
      @@ -412,16 +372,9 @@

      Method Detail

      comparator

      @CheckForNull
 public java.util.Comparator<? super K> comparator()
      -
      Description copied from interface: java.util.SortedSet
      -
      Returns the comparator used to order the elements in this set, - or null if this set uses the natural ordering of its elements.
      Specified by:
      comparator in interface java.util.SortedSet<K extends @Nullable java.lang.Object>
      -
      Returns:
      -
      the comparator used to order the elements in this set, - or null if this set uses the natural ordering - of its elements
    @@ -435,26 +388,9 @@

    comparator

    subSet

    public java.util.SortedSet<K> subSet​(K fromElement,
                                      K toElement)
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns a view of the portion of this set whose elements range - from fromElement, inclusive, to toElement, - exclusive. (If fromElement and toElement are - equal, the returned set is empty.) The returned set is backed - by this set, so changes in the returned set are reflected in - this set, and vice-versa. The returned set supports all - optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    subSet in interface java.util.SortedSet<K extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromElement - low endpoint (inclusive) of the returned set
    -
    toElement - high endpoint (exclusive) of the returned set
    -
    Returns:
    -
    a view of the portion of this set whose elements range from - fromElement, inclusive, to toElement, exclusive
    @@ -467,23 +403,9 @@

    subSet

  • headSet

    public java.util.SortedSet<K> headSet​(K toElement)
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns a view of the portion of this set whose elements are - strictly less than toElement. The returned set is - backed by this set, so changes in the returned set are - reflected in this set, and vice-versa. The returned set - supports all optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    headSet in interface java.util.SortedSet<K extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    toElement - high endpoint (exclusive) of the returned set
    -
    Returns:
    -
    a view of the portion of this set whose elements are strictly - less than toElement
    • @@ -496,23 +418,9 @@

    headSet

  • tailSet

    public java.util.SortedSet<K> tailSet​(K fromElement)
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns a view of the portion of this set whose elements are - greater than or equal to fromElement. The returned - set is backed by this set, so changes in the returned set are - reflected in this set, and vice-versa. The returned set - supports all optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    tailSet in interface java.util.SortedSet<K extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromElement - low endpoint (inclusive) of the returned set
    -
    Returns:
    -
    a view of the portion of this set whose elements are greater - than or equal to fromElement
    • @@ -523,13 +431,9 @@

    tailSet

  • first

    public K first()
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns the first (lowest) element currently in this set.
    Specified by:
    first in interface java.util.SortedSet<K extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the first (lowest) element currently in this set
    • @@ -540,13 +444,9 @@

    first

  • last

    public K last()
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns the last (highest) element currently in this set.
    Specified by:
    last in interface java.util.SortedSet<K extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the last (highest) element currently in this set
    • @@ -557,8 +457,6 @@

    last

  • iterator

    public java.util.Iterator<K> iterator()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns an iterator over the elements contained in this collection.
    Specified by:
    iterator in interface java.util.Collection<K extends @Nullable java.lang.Object>
    @@ -568,8 +466,6 @@

    iterator

    iterator in interface java.util.Set<K extends @Nullable java.lang.Object>
    Specified by:
    iterator in class java.util.AbstractCollection<K extends @Nullable java.lang.Object>
    -
    Returns:
    -
    an iterator over the elements contained in this collection
    • @@ -580,20 +476,6 @@

    iterator

  • forEach

    public void forEach​(java.util.function.Consumer<? super K> action)
    -
    Description copied from interface: java.lang.Iterable
    -
    Performs the given action for each element of the Iterable - until all elements have been processed or the action throws an - exception. Actions are performed in the order of iteration, if that - order is specified. Exceptions thrown by the action are relayed to the - caller. -

    - The behavior of this method is unspecified if the action performs - side-effects that modify the underlying source of elements, unless an - overriding class has specified a concurrent modification policy.

    -
    -
    Parameters:
    -
    action - The action to be performed for each element
    -
    • @@ -603,10 +485,6 @@

    forEach

  • size

    public int size()
    -
    Description copied from interface: java.util.Collection
    -
    Returns the number of elements in this collection. If this collection - contains more than Integer.MAX_VALUE elements, returns - Integer.MAX_VALUE.
    Specified by:
    size in interface java.util.Collection<K extends @Nullable java.lang.Object>
    @@ -614,8 +492,6 @@

    size

    size in interface java.util.Set<K extends @Nullable java.lang.Object>
    Specified by:
    size in class java.util.AbstractCollection<K extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the number of elements in this collection
    • @@ -626,8 +502,6 @@

    size

  • isEmpty

    public boolean isEmpty()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains no elements.
    Specified by:
    isEmpty in interface java.util.Collection<K extends @Nullable java.lang.Object>
    @@ -635,8 +509,6 @@

    isEmpty

    isEmpty in interface java.util.Set<K extends @Nullable java.lang.Object>
    Overrides:
    isEmpty in class java.util.AbstractCollection<K extends @Nullable java.lang.Object>
    -
    Returns:
    -
    true if this collection contains no elements
    • @@ -648,11 +520,6 @@

    isEmpty

    contains

    public boolean contains​(@CheckForNull
                         java.lang.Object o)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains the specified element. - More formally, returns true if and only if this collection - contains at least one element e such that - Objects.equals(o, e).
    Specified by:
    contains in interface java.util.Collection<K extends @Nullable java.lang.Object>
    @@ -660,11 +527,6 @@

    contains

    contains in interface java.util.Set<K extends @Nullable java.lang.Object>
    Overrides:
    contains in class java.util.AbstractCollection<K extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    o - element whose presence in this collection is to be tested
    -
    Returns:
    -
    true if this collection contains the specified - element
    @@ -676,14 +538,6 @@

    contains

    remove

    public boolean remove​(@CheckForNull
                       java.lang.Object o)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation). More formally, - removes an element e such that - Objects.equals(o, e), if - this collection contains one or more such elements. Returns - true if this collection contained the specified element (or - equivalently, if this collection changed as a result of the call).
    Specified by:
    remove in interface java.util.Collection<K extends @Nullable java.lang.Object>
    @@ -691,10 +545,6 @@

    remove

    remove in interface java.util.Set<K extends @Nullable java.lang.Object>
    Overrides:
    remove in class java.util.AbstractCollection<K extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    o - element to be removed from this collection, if present
    -
    Returns:
    -
    true if an element was removed as a result of this call
    @@ -705,9 +555,6 @@

    remove

  • clear

    public void clear()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes all of the elements from this collection (optional operation). - The collection will be empty after this method returns.
    Specified by:
    clear in interface java.util.Collection<K extends @Nullable java.lang.Object>
    @@ -725,28 +572,6 @@

    clear

  • removeAll

    public boolean removeAll​(java.util.Collection<?> c)
    -
    Description copied from class: java.util.AbstractSet
    -
    Removes from this set all of its elements that are contained in the - specified collection (optional operation). If the specified - collection is also a set, this operation effectively modifies this - set so that its value is the asymmetric set difference of - the two sets. - -

    This implementation determines which is the smaller of this set - and the specified collection, by invoking the size - method on each. If this set has fewer elements, then the - implementation iterates over this set, checking each element - returned by the iterator in turn to see if it is contained in - the specified collection. If it is so contained, it is removed - from this set with the iterator's remove method. If - the specified collection has fewer elements, then the - implementation iterates over the specified collection, removing - from this set each element returned by the iterator, using this - set's remove method. - -

    Note that this implementation will throw an - UnsupportedOperationException if the iterator returned by the - iterator method does not implement the remove method.

    Specified by:
    removeAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -754,13 +579,6 @@

    removeAll

    removeAll in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    removeAll in class java.util.AbstractSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    c - collection containing elements to be removed from this set
    -
    Returns:
    -
    true if this set changed as a result of the call
    -
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    • @@ -771,11 +589,6 @@

    removeAll

  • retainAll

    public boolean retainAll​(java.util.Collection<?> c)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation). In other words, removes from - this collection all of its elements that are not contained in the - specified collection.
    Specified by:
    retainAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -783,13 +596,6 @@

    retainAll

    retainAll in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    retainAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    c - collection containing elements to be retained in this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    -
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingSortedMap.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingSortedMap.html index d01e9f78ed7a..36da132378f4 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingSortedMap.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingSortedMap.html @@ -220,7 +220,7 @@

    Nested classes/interfaces inherited from class com.google.common.collec

    Nested classes/interfaces inherited from interface java.util.Map

    -java.util.Map.Entry<K,​V>
    • +java.util.Map.Entry<K extends java.lang.Object,​V extends java.lang.Object> @@ -267,10 +267,7 @@

    Method Summary

    java.util.Comparator<? super K> comparator() - -
    Returns the comparator used to order the keys in this map, or - null if this map uses the natural ordering of its keys.
    - +  protected abstract java.util.SortedMap<K,​V> @@ -282,24 +279,17 @@

    Method Summary

    K firstKey() - -
    Returns the first (lowest) key currently in this map.
    - +  java.util.SortedMap<K,​V> headMap​(K toKey) - -
    Returns a view of the portion of this map whose keys are - strictly less than toKey.
    - +  K lastKey() - -
    Returns the last (highest) key currently in this map.
    - +  protected boolean @@ -321,18 +311,12 @@

    Method Summary

    java.util.SortedMap<K,​V> subMap​(K fromKey, K toKey) - -
    Returns a view of the portion of this map whose keys range from - fromKey, inclusive, to toKey, exclusive.
    - +  java.util.SortedMap<K,​V> tailMap​(K fromKey) - -
    Returns a view of the portion of this map whose keys are - greater than or equal to fromKey.
    - + 
      @@ -432,16 +416,9 @@

      delegate

      comparator

      @CheckForNull
 public java.util.Comparator<? super K> comparator()
      -
      Description copied from interface: java.util.SortedMap
      -
      Returns the comparator used to order the keys in this map, or - null if this map uses the natural ordering of its keys.
      Specified by:
      comparator in interface java.util.SortedMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
      -
      Returns:
      -
      the comparator used to order the keys in this map, - or null if this map uses the natural ordering - of its keys
    @@ -452,13 +429,9 @@

    comparator

  • firstKey

    public K firstKey()
    -
    Description copied from interface: java.util.SortedMap
    -
    Returns the first (lowest) key currently in this map.
    Specified by:
    firstKey in interface java.util.SortedMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the first (lowest) key currently in this map
    • @@ -471,23 +444,9 @@

    firstKey

  • headMap

    public java.util.SortedMap<K,​V> headMap​(K toKey)
    -
    Description copied from interface: java.util.SortedMap
    -
    Returns a view of the portion of this map whose keys are - strictly less than toKey. The returned map is backed - by this map, so changes in the returned map are reflected in - this map, and vice-versa. The returned map supports all - optional map operations that this map supports. - -

    The returned map will throw an IllegalArgumentException - on an attempt to insert a key outside its range.

    Specified by:
    headMap in interface java.util.SortedMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    toKey - high endpoint (exclusive) of the keys in the returned map
    -
    Returns:
    -
    a view of the portion of this map whose keys are strictly - less than toKey
    • @@ -498,13 +457,9 @@

    headMap

  • lastKey

    public K lastKey()
    -
    Description copied from interface: java.util.SortedMap
    -
    Returns the last (highest) key currently in this map.
    Specified by:
    lastKey in interface java.util.SortedMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the last (highest) key currently in this map
    • @@ -518,26 +473,9 @@

    lastKey

    subMap

    public java.util.SortedMap<K,​V> subMap​(K fromKey,
                                              K toKey)
    -
    Description copied from interface: java.util.SortedMap
    -
    Returns a view of the portion of this map whose keys range from - fromKey, inclusive, to toKey, exclusive. (If - fromKey and toKey are equal, the returned map - is empty.) The returned map is backed by this map, so changes - in the returned map are reflected in this map, and vice-versa. - The returned map supports all optional map operations that this - map supports. - -

    The returned map will throw an IllegalArgumentException - on an attempt to insert a key outside its range.

    Specified by:
    subMap in interface java.util.SortedMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromKey - low endpoint (inclusive) of the keys in the returned map
    -
    toKey - high endpoint (exclusive) of the keys in the returned map
    -
    Returns:
    -
    a view of the portion of this map whose keys range from - fromKey, inclusive, to toKey, exclusive
    @@ -550,23 +488,9 @@

    subMap

  • tailMap

    public java.util.SortedMap<K,​V> tailMap​(K fromKey)
    -
    Description copied from interface: java.util.SortedMap
    -
    Returns a view of the portion of this map whose keys are - greater than or equal to fromKey. The returned map is - backed by this map, so changes in the returned map are - reflected in this map, and vice-versa. The returned map - supports all optional map operations that this map supports. - -

    The returned map will throw an IllegalArgumentException - on an attempt to insert a key outside its range.

    Specified by:
    tailMap in interface java.util.SortedMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromKey - low endpoint (inclusive) of the keys in the returned map
    -
    Returns:
    -
    a view of the portion of this map whose keys are greater - than or equal to fromKey
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingSortedMultiset.StandardDescendingMultiset.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingSortedMultiset.StandardDescendingMultiset.html index ccca37d8bf85..bbcc5e9e6b50 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingSortedMultiset.StandardDescendingMultiset.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingSortedMultiset.StandardDescendingMultiset.html @@ -292,9 +292,6 @@

    Method Summary

    java.util.Iterator<E> iterator() - -
    Returns an iterator over the elements in this collection.
    - Multiset.Entry<E> @@ -343,17 +340,12 @@

    Method Summary

    @Nullable java.lang.Object[] toArray() - -
    Returns an array containing all of the elements in this collection.
    - +  <T extends @Nullable java.lang.Object>
    T[]     toArray​(T[] array) - -
    Returns an array containing all of the elements in this collection; - the runtime type of the returned array is that of the specified array.
    - +  java.lang.String @@ -698,11 +690,14 @@

    entrySet

  • iterator

    public java.util.Iterator<E> iterator()
    -
    Description copied from interface: java.util.Collection
    -
    Returns an iterator over the elements in this collection. There are no - guarantees concerning the order in which the elements are returned - (unless this collection is an instance of some class that provides a - guarantee).
    +
    Description copied from interface: SortedMultiset
    +
    + +

    Elements that occur multiple times in the multiset will appear multiple times in this + iterator, though not necessarily sequentially. + +

    The iterator returns the elements in ascending order according to this multiset's + comparator.

    Specified by:
    iterator in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -714,8 +709,6 @@

    iterator

    iterator in interface SortedMultiset<E extends @Nullable java.lang.Object>
    Overrides:
    iterator in class ForwardingCollection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    an Iterator over the elements in this collection
    • @@ -726,24 +719,11 @@

    iterator

  • toArray

    public @Nullable java.lang.Object[] toArray()
    -
    Description copied from interface: java.util.Collection
    -
    Returns an array containing all of the elements in this collection. - If this collection makes any guarantees as to what order its elements - are returned by its iterator, this method must return the elements in - the same order. The returned array's runtime component type is Object. - -

    The returned array will be "safe" in that no references to it are - maintained by this collection. (In other words, this method must - allocate a new array even if this collection is backed by an array). - The caller is thus free to modify the returned array.

    Specified by:
    toArray in interface java.util.Collection<E extends @Nullable java.lang.Object>
    Overrides:
    toArray in class ForwardingCollection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    an array, whose runtime component - type is Object, containing all of the elements in this collection
    • @@ -756,36 +736,11 @@

    toArray

  • toArray

    public <T extends @Nullable java.lang.Object> T[] toArray​(T[] array)
    -
    Description copied from interface: java.util.Collection
    -
    Returns an array containing all of the elements in this collection; - the runtime type of the returned array is that of the specified array. - If the collection fits in the specified array, it is returned therein. - Otherwise, a new array is allocated with the runtime type of the - specified array and the size of this collection. - -

    If this collection fits in the specified array with room to spare - (i.e., the array has more elements than this collection), the element - in the array immediately following the end of the collection is set to - null. (This is useful in determining the length of this - collection only if the caller knows that this collection does - not contain any null elements.) - -

    If this collection makes any guarantees as to what order its elements - are returned by its iterator, this method must return the elements in - the same order.

    Specified by:
    toArray in interface java.util.Collection<E extends @Nullable java.lang.Object>
    Overrides:
    toArray in class ForwardingCollection<E extends @Nullable java.lang.Object>
    -
    Type Parameters:
    -
    T - the component type of the array to contain the collection
    -
    Parameters:
    -
    array - the array into which the elements of this collection are to be - stored, if it is big enough; otherwise, a new array of the same - runtime type is allocated for this purpose.
    -
    Returns:
    -
    an array containing all of the elements in this collection
    • @@ -803,8 +758,6 @@

    toString

    toString in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    toString in class ForwardingObject
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingSortedMultiset.StandardElementSet.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingSortedMultiset.StandardElementSet.html index b324b3fefdbe..66ecafa1ca2d 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingSortedMultiset.StandardElementSet.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingSortedMultiset.StandardElementSet.html @@ -209,170 +209,113 @@

    Method Summary

    E ceiling​(E e) - -
    Returns the least element in this set greater than or equal to - the given element, or null if there is no such element.
    - +  void clear() - -
    Removes all of the elements from this collection (optional operation).
    - +  java.util.Comparator<? super E> comparator() - -
    Returns the comparator used to order the elements in this set, - or null if this set uses the natural ordering of its elements.
    - +  boolean contains​(java.lang.Object o) - -
    Returns true if this collection contains the specified element.
    - +  boolean containsAll​(java.util.Collection<?> c) - -
    Returns true if this collection contains all of the elements - in the specified collection.
    - +  java.util.Iterator<E> descendingIterator() - -
    Returns an iterator over the elements in this set, in descending order.
    - +  java.util.NavigableSet<E> descendingSet() - -
    Returns a reverse order view of the elements contained in this set.
    - +  E first() - -
    Returns the first (lowest) element currently in this set.
    - +  E floor​(E e) - -
    Returns the greatest element in this set less than or equal to - the given element, or null if there is no such element.
    - +  java.util.SortedSet<E> headSet​(E toElement) - -
    Returns a view of the portion of this set whose elements are - strictly less than toElement.
    - +  java.util.NavigableSet<E> headSet​(E toElement, boolean inclusive) - -
    Returns a view of the portion of this set whose elements are less than - (or equal to, if inclusive is true) toElement.
    - +  E higher​(E e) - -
    Returns the least element in this set strictly greater than the - given element, or null if there is no such element.
    - +  boolean isEmpty() - -
    Returns true if this collection contains no elements.
    - +  java.util.Iterator<E> iterator() - -
    Returns an iterator over the elements contained in this collection.
    - +  E last() - -
    Returns the last (highest) element currently in this set.
    - +  E lower​(E e) - -
    Returns the greatest element in this set strictly less than the - given element, or null if there is no such element.
    - +  E pollFirst() - -
    Retrieves and removes the first (lowest) element, - or returns null if this set is empty.
    - +  E pollLast() - -
    Retrieves and removes the last (highest) element, - or returns null if this set is empty.
    - +  boolean remove​(java.lang.Object o) - -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation).
    - +  boolean removeAll​(java.util.Collection<?> c) - -
    Removes from this set all of its elements that are contained in the - specified collection (optional operation).
    - +  boolean retainAll​(java.util.Collection<?> c) - -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation).
    - +  int size() - -
    Returns the number of elements in this collection.
    - +  java.util.NavigableSet<E> @@ -380,37 +323,24 @@

    Method Summary

    boolean fromInclusive, E toElement, boolean toInclusive) - -
    Returns a view of the portion of this set whose elements range from - fromElement to toElement.
    - +  java.util.SortedSet<E> subSet​(E fromElement, E toElement) - -
    Returns a view of the portion of this set whose elements range - from fromElement, inclusive, to toElement, - exclusive.
    - +  java.util.SortedSet<E> tailSet​(E fromElement) - -
    Returns a view of the portion of this set whose elements are - greater than or equal to fromElement.
    - +  java.util.NavigableSet<E> tailSet​(E fromElement, boolean inclusive) - -
    Returns a view of the portion of this set whose elements are greater - than (or equal to, if inclusive is true) fromElement.
    - + 
      @@ -515,17 +445,9 @@

      Method Detail

      lower

      @CheckForNull
 public E lower​(E e)
      -
      Description copied from interface: java.util.NavigableSet
      -
      Returns the greatest element in this set strictly less than the - given element, or null if there is no such element.
      Specified by:
      lower in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
      -
      Parameters:
      -
      e - the value to match
      -
      Returns:
      -
      the greatest element less than e, - or null if there is no such element
    @@ -539,17 +461,9 @@

    lower

    floor

    @CheckForNull
 public E floor​(E e)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns the greatest element in this set less than or equal to - the given element, or null if there is no such element.
    Specified by:
    floor in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    e - the value to match
    -
    Returns:
    -
    the greatest element less than or equal to e, - or null if there is no such element
    @@ -563,17 +477,9 @@

    floor

    ceiling

    @CheckForNull
 public E ceiling​(E e)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns the least element in this set greater than or equal to - the given element, or null if there is no such element.
    Specified by:
    ceiling in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    e - the value to match
    -
    Returns:
    -
    the least element greater than or equal to e, - or null if there is no such element
    @@ -587,17 +493,9 @@

    ceiling

    higher

    @CheckForNull
 public E higher​(E e)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns the least element in this set strictly greater than the - given element, or null if there is no such element.
    Specified by:
    higher in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    e - the value to match
    -
    Returns:
    -
    the least element greater than e, - or null if there is no such element
    @@ -608,23 +506,9 @@

    higher

  • descendingSet

    public java.util.NavigableSet<E> descendingSet()
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns a reverse order view of the elements contained in this set. - The descending set is backed by this set, so changes to the set are - reflected in the descending set, and vice-versa. If either set is - modified while an iteration over either set is in progress (except - through the iterator's own remove operation), the results of - the iteration are undefined. - -

    The returned set has an ordering equivalent to - Collections.reverseOrder(comparator()). - The expression s.descendingSet().descendingSet() returns a - view of s essentially equivalent to s.

    Specified by:
    descendingSet in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a reverse order view of this set
    • @@ -635,14 +519,9 @@

    descendingSet

  • descendingIterator

    public java.util.Iterator<E> descendingIterator()
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns an iterator over the elements in this set, in descending order. - Equivalent in effect to descendingSet().iterator().
    Specified by:
    descendingIterator in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    an iterator over the elements in this set, in descending order
    • @@ -654,14 +533,9 @@

    descendingIterator

    pollFirst

    @CheckForNull
 public E pollFirst()
    -
    Description copied from interface: java.util.NavigableSet
    -
    Retrieves and removes the first (lowest) element, - or returns null if this set is empty.
    Specified by:
    pollFirst in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the first element, or null if this set is empty
    @@ -673,14 +547,9 @@

    pollFirst

    pollLast

    @CheckForNull
 public E pollLast()
    -
    Description copied from interface: java.util.NavigableSet
    -
    Retrieves and removes the last (highest) element, - or returns null if this set is empty.
    Specified by:
    pollLast in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the last element, or null if this set is empty
    @@ -696,30 +565,9 @@

    subSet

    boolean fromInclusive, E toElement, boolean toInclusive) -
    Description copied from interface: java.util.NavigableSet
    -
    Returns a view of the portion of this set whose elements range from - fromElement to toElement. If fromElement and - toElement are equal, the returned set is empty unless - fromInclusive and toInclusive are both true. The returned set - is backed by this set, so changes in the returned set are reflected in - this set, and vice-versa. The returned set supports all optional set - operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    subSet in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromElement - low endpoint of the returned set
    -
    fromInclusive - true if the low endpoint - is to be included in the returned view
    -
    toElement - high endpoint of the returned set
    -
    toInclusive - true if the high endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this set whose elements range from - fromElement, inclusive, to toElement, exclusive
    @@ -733,25 +581,9 @@

    subSet

    headSet

    public java.util.NavigableSet<E> headSet​(E toElement,
                                          boolean inclusive)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns a view of the portion of this set whose elements are less than - (or equal to, if inclusive is true) toElement. The - returned set is backed by this set, so changes in the returned set are - reflected in this set, and vice-versa. The returned set supports all - optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    headSet in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    toElement - high endpoint of the returned set
    -
    inclusive - true if the high endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this set whose elements are less than - (or equal to, if inclusive is true) toElement
    @@ -765,25 +597,9 @@

    headSet

    tailSet

    public java.util.NavigableSet<E> tailSet​(E fromElement,
                                          boolean inclusive)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns a view of the portion of this set whose elements are greater - than (or equal to, if inclusive is true) fromElement. - The returned set is backed by this set, so changes in the returned set - are reflected in this set, and vice-versa. The returned set supports - all optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    tailSet in interface java.util.NavigableSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromElement - low endpoint of the returned set
    -
    inclusive - true if the low endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this set whose elements are greater - than or equal to fromElement
    @@ -794,8 +610,6 @@

    tailSet

  • iterator

    public java.util.Iterator<E> iterator()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns an iterator over the elements contained in this collection.
    Specified by:
    iterator in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -803,8 +617,6 @@

    iterator

    iterator in interface java.lang.Iterable<E extends @Nullable java.lang.Object>
    Specified by:
    iterator in interface java.util.Set<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    an iterator over the elements contained in this collection
    • @@ -815,16 +627,9 @@

    iterator

  • comparator

    public java.util.Comparator<? super E> comparator()
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns the comparator used to order the elements in this set, - or null if this set uses the natural ordering of its elements.
    Specified by:
    comparator in interface java.util.SortedSet<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the comparator used to order the elements in this set, - or null if this set uses the natural ordering - of its elements
    • @@ -838,26 +643,9 @@

    comparator

    subSet

    public java.util.SortedSet<E> subSet​(E fromElement,
                                      E toElement)
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns a view of the portion of this set whose elements range - from fromElement, inclusive, to toElement, - exclusive. (If fromElement and toElement are - equal, the returned set is empty.) The returned set is backed - by this set, so changes in the returned set are reflected in - this set, and vice-versa. The returned set supports all - optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    subSet in interface java.util.SortedSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromElement - low endpoint (inclusive) of the returned set
    -
    toElement - high endpoint (exclusive) of the returned set
    -
    Returns:
    -
    a view of the portion of this set whose elements range from - fromElement, inclusive, to toElement, exclusive
    @@ -870,23 +658,9 @@

    subSet

  • headSet

    public java.util.SortedSet<E> headSet​(E toElement)
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns a view of the portion of this set whose elements are - strictly less than toElement. The returned set is - backed by this set, so changes in the returned set are - reflected in this set, and vice-versa. The returned set - supports all optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    headSet in interface java.util.SortedSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    toElement - high endpoint (exclusive) of the returned set
    -
    Returns:
    -
    a view of the portion of this set whose elements are strictly - less than toElement
    • @@ -899,23 +673,9 @@

    headSet

  • tailSet

    public java.util.SortedSet<E> tailSet​(E fromElement)
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns a view of the portion of this set whose elements are - greater than or equal to fromElement. The returned - set is backed by this set, so changes in the returned set are - reflected in this set, and vice-versa. The returned set - supports all optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    tailSet in interface java.util.SortedSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromElement - low endpoint (inclusive) of the returned set
    -
    Returns:
    -
    a view of the portion of this set whose elements are greater - than or equal to fromElement
    • @@ -926,13 +686,9 @@

    tailSet

  • first

    public E first()
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns the first (lowest) element currently in this set.
    Specified by:
    first in interface java.util.SortedSet<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the first (lowest) element currently in this set
    • @@ -943,13 +699,9 @@

    first

  • last

    public E last()
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns the last (highest) element currently in this set.
    Specified by:
    last in interface java.util.SortedSet<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the last (highest) element currently in this set
    • @@ -960,9 +712,6 @@

    last

  • clear

    public void clear()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes all of the elements from this collection (optional operation). - The collection will be empty after this method returns.
    Specified by:
    clear in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -981,11 +730,6 @@

    clear

    contains

    public boolean contains​(@CheckForNull
                         java.lang.Object o)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains the specified element. - More formally, returns true if and only if this collection - contains at least one element e such that - Objects.equals(o, e).
    Specified by:
    contains in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -993,11 +737,6 @@

    contains

    contains in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    contains in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    o - element whose presence in this collection is to be tested
    -
    Returns:
    -
    true if this collection contains the specified - element
    • @@ -1008,9 +747,6 @@

    contains

  • containsAll

    public boolean containsAll​(java.util.Collection<?> c)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains all of the elements - in the specified collection.
    Specified by:
    containsAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -1018,13 +754,6 @@

    containsAll

    containsAll in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    containsAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    c - collection to be checked for containment in this collection
    -
    Returns:
    -
    true if this collection contains all of the elements - in the specified collection
    -
    See Also:
    -
    AbstractCollection.contains(Object)
    • @@ -1035,8 +764,6 @@

    containsAll

  • isEmpty

    public boolean isEmpty()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains no elements.
    Specified by:
    isEmpty in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -1044,8 +771,6 @@

    isEmpty

    isEmpty in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    isEmpty in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    true if this collection contains no elements
    • @@ -1057,14 +782,6 @@

    isEmpty

    remove

    public boolean remove​(@CheckForNull
                       java.lang.Object o)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation). More formally, - removes an element e such that - Objects.equals(o, e), if - this collection contains one or more such elements. Returns - true if this collection contained the specified element (or - equivalently, if this collection changed as a result of the call).
    Specified by:
    remove in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -1072,10 +789,6 @@

    remove

    remove in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    remove in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    o - element to be removed from this collection, if present
    -
    Returns:
    -
    true if an element was removed as a result of this call
    @@ -1086,10 +799,6 @@

    remove

  • size

    public int size()
    -
    Description copied from interface: java.util.Collection
    -
    Returns the number of elements in this collection. If this collection - contains more than Integer.MAX_VALUE elements, returns - Integer.MAX_VALUE.
    Specified by:
    size in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -1097,8 +806,6 @@

    size

    size in interface java.util.Set<E extends @Nullable java.lang.Object>
    Specified by:
    size in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the number of elements in this collection
    • @@ -1109,28 +816,6 @@

    size

  • removeAll

    public boolean removeAll​(java.util.Collection<?> c)
    -
    Description copied from class: java.util.AbstractSet
    -
    Removes from this set all of its elements that are contained in the - specified collection (optional operation). If the specified - collection is also a set, this operation effectively modifies this - set so that its value is the asymmetric set difference of - the two sets. - -

    This implementation determines which is the smaller of this set - and the specified collection, by invoking the size - method on each. If this set has fewer elements, then the - implementation iterates over this set, checking each element - returned by the iterator in turn to see if it is contained in - the specified collection. If it is so contained, it is removed - from this set with the iterator's remove method. If - the specified collection has fewer elements, then the - implementation iterates over the specified collection, removing - from this set each element returned by the iterator, using this - set's remove method. - -

    Note that this implementation will throw an - UnsupportedOperationException if the iterator returned by the - iterator method does not implement the remove method.

    Specified by:
    removeAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -1138,13 +823,6 @@

    removeAll

    removeAll in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    removeAll in class java.util.AbstractSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    c - collection containing elements to be removed from this set
    -
    Returns:
    -
    true if this set changed as a result of the call
    -
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    • @@ -1155,11 +833,6 @@

    removeAll

  • retainAll

    public boolean retainAll​(java.util.Collection<?> c)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation). In other words, removes from - this collection all of its elements that are not contained in the - specified collection.
    Specified by:
    retainAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -1167,13 +840,6 @@

    retainAll

    retainAll in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    retainAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    c - collection containing elements to be retained in this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    -
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingSortedSet.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingSortedSet.html index e8b6f0dd98d0..f54a9cd0a57d 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingSortedSet.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingSortedSet.html @@ -234,10 +234,7 @@

    Method Summary

    java.util.Comparator<? super E> comparator() - -
    Returns the comparator used to order the elements in this set, - or null if this set uses the natural ordering of its elements.
    - +  protected abstract java.util.SortedSet<E> @@ -249,24 +246,17 @@

    Method Summary

    E first() - -
    Returns the first (lowest) element currently in this set.
    - +  java.util.SortedSet<E> headSet​(E toElement) - -
    Returns a view of the portion of this set whose elements are - strictly less than toElement.
    - +  E last() - -
    Returns the last (highest) element currently in this set.
    - +  protected boolean @@ -294,19 +284,12 @@

    Method Summary

    java.util.SortedSet<E> subSet​(E fromElement, E toElement) - -
    Returns a view of the portion of this set whose elements range - from fromElement, inclusive, to toElement, - exclusive.
    - +  java.util.SortedSet<E> tailSet​(E fromElement) - -
    Returns a view of the portion of this set whose elements are - greater than or equal to fromElement.
    - + 
      @@ -427,16 +410,9 @@

      delegate

      comparator

      @CheckForNull
 public java.util.Comparator<? super E> comparator()
      -
      Description copied from interface: java.util.SortedSet
      -
      Returns the comparator used to order the elements in this set, - or null if this set uses the natural ordering of its elements.
      Specified by:
      comparator in interface java.util.SortedSet<E extends @Nullable java.lang.Object>
      -
      Returns:
      -
      the comparator used to order the elements in this set, - or null if this set uses the natural ordering - of its elements
    @@ -447,13 +423,9 @@

    comparator

  • first

    public E first()
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns the first (lowest) element currently in this set.
    Specified by:
    first in interface java.util.SortedSet<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the first (lowest) element currently in this set
    • @@ -466,23 +438,9 @@

    first

  • headSet

    public java.util.SortedSet<E> headSet​(E toElement)
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns a view of the portion of this set whose elements are - strictly less than toElement. The returned set is - backed by this set, so changes in the returned set are - reflected in this set, and vice-versa. The returned set - supports all optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    headSet in interface java.util.SortedSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    toElement - high endpoint (exclusive) of the returned set
    -
    Returns:
    -
    a view of the portion of this set whose elements are strictly - less than toElement
    • @@ -493,13 +451,9 @@

    headSet

  • last

    public E last()
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns the last (highest) element currently in this set.
    Specified by:
    last in interface java.util.SortedSet<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the last (highest) element currently in this set
    • @@ -513,26 +467,9 @@

    last

    subSet

    public java.util.SortedSet<E> subSet​(E fromElement,
                                      E toElement)
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns a view of the portion of this set whose elements range - from fromElement, inclusive, to toElement, - exclusive. (If fromElement and toElement are - equal, the returned set is empty.) The returned set is backed - by this set, so changes in the returned set are reflected in - this set, and vice-versa. The returned set supports all - optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    subSet in interface java.util.SortedSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromElement - low endpoint (inclusive) of the returned set
    -
    toElement - high endpoint (exclusive) of the returned set
    -
    Returns:
    -
    a view of the portion of this set whose elements range from - fromElement, inclusive, to toElement, exclusive
    @@ -545,23 +482,9 @@

    subSet

  • tailSet

    public java.util.SortedSet<E> tailSet​(E fromElement)
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns a view of the portion of this set whose elements are - greater than or equal to fromElement. The returned - set is backed by this set, so changes in the returned set are - reflected in this set, and vice-versa. The returned set - supports all optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    tailSet in interface java.util.SortedSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    fromElement - low endpoint (inclusive) of the returned set
    -
    Returns:
    -
    a view of the portion of this set whose elements are greater - than or equal to fromElement
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingTable.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingTable.html index 7790b50d2b78..7ffe856dcff4 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingTable.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ForwardingTable.html @@ -291,7 +291,7 @@

    Method Summary

    boolean equals​(java.lang.Object obj) -
    Indicates whether some other object is "equal to" this one.
    +
    Compares the specified object with this table for equality.
    @@ -307,7 +307,7 @@

    Method Summary

    int hashCode() -
    Returns a hash code value for the object.
    +
    Returns the hash code for this table.
    @@ -838,58 +838,14 @@

    values

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object obj)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    +
    Description copied from interface: Table
    +
    Compares the specified object with this table for equality. Two tables are equal when their + cell views, as returned by Table.cellSet(), are equal.
    Specified by:
    equals in interface Table<R extends @Nullable java.lang.Object,​C extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -900,45 +856,14 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    +
    Description copied from interface: Table
    +
    Returns the hash code for this table. The hash code of a table is defined as the hash code of + its cell view, as returned by Table.cellSet().
    Specified by:
    hashCode in interface Table<R extends @Nullable java.lang.Object,​C extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/HashBasedTable.html b/releases/snapshot-jre/api/docs/com/google/common/collect/HashBasedTable.html index 8870f033c650..c5fbd161939d 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/HashBasedTable.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/HashBasedTable.html @@ -291,7 +291,7 @@

    Method Summary

    boolean equals​(java.lang.Object obj) -
    Indicates whether some other object is "equal to" this one.
    +
    Compares the specified object with this table for equality.
    @@ -307,7 +307,7 @@

    Method Summary

    int hashCode() -
    Returns a hash code value for the object.
    +
    Returns the hash code for this table.
    @@ -858,58 +858,14 @@

    putAll

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object obj)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    +
    Description copied from interface: Table
    +
    Compares the specified object with this table for equality. Two tables are equal when their + cell views, as returned by Table.cellSet(), are equal.
    Specified by:
    equals in interface Table<R extends @Nullable java.lang.Object,​C extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -920,45 +876,14 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    +
    Description copied from interface: Table
    +
    Returns the hash code for this table. The hash code of a table is defined as the hash code of + its cell view, as returned by Table.cellSet().
    Specified by:
    hashCode in interface Table<R extends @Nullable java.lang.Object,​C extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -973,8 +898,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/HashBiMap.html b/releases/snapshot-jre/api/docs/com/google/common/collect/HashBiMap.html index 6df47dacd6b0..bad15fd3a81f 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/HashBiMap.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/HashBiMap.html @@ -177,14 +177,14 @@

    Nested Class Summary

    Nested classes/interfaces inherited from class java.util.AbstractMap

    -java.util.AbstractMap.SimpleEntry<K,​V>, java.util.AbstractMap.SimpleImmutableEntry<K,​V> +java.util.AbstractMap.SimpleEntry<K extends java.lang.Object,​V extends java.lang.Object>, java.util.AbstractMap.SimpleImmutableEntry<K extends java.lang.Object,​V extends java.lang.Object>

    • Nested classes/interfaces inherited from interface java.util.Map

      -java.util.Map.Entry<K,​V>
      • +java.util.Map.Entry<K extends java.lang.Object,​V extends java.lang.Object>
    @@ -206,17 +206,12 @@

    Method Summary

    void clear() - -
    Removes all of the mappings from this map (optional operation).
    - +  boolean containsKey​(java.lang.Object key) - -
    Returns true if this map contains a mapping for the specified - key.
    - +  boolean @@ -250,9 +245,7 @@

    Method Summary

    java.util.Set<java.util.Map.Entry<K,​V>> entrySet() - -
    Returns a Set view of the mappings contained in this map.
    - +  V @@ -266,18 +259,12 @@

    Method Summary

    void forEach​(java.util.function.BiConsumer<? super K,​? super V> action) - -
    Performs the given action for each entry in this map until all entries - have been processed or the action throws an exception.
    - +  V get​(java.lang.Object key) - -
    Returns the value to which the specified key is mapped, - or null if this map contains no mapping for the key.
    - +  BiMap<V,​K> @@ -290,49 +277,31 @@

    Method Summary

    java.util.Set<K> keySet() - -
    Returns a Set view of the keys contained in this map.
    - +  V put​(K key, V value) - -
    Associates the specified value with the specified key in this map - (optional operation).
    - V remove​(java.lang.Object key) - -
    Removes the mapping for a key from this map if it is present - (optional operation).
    - +  void replaceAll​(java.util.function.BiFunction<? super K,​? super V,​? extends V> function) - -
    Replaces each entry's value with the result of invoking the given - function on that entry until all entries have been processed or the - function throws an exception.
    - +  int size() - -
    Returns the number of key-value mappings in this map.
    - +  java.util.Set<V> values() - -
    Returns a Collection view of the values contained in this map.
    -
      @@ -424,22 +393,11 @@

      create

      containsKey

      public boolean containsKey​(@CheckForNull
                            java.lang.Object key)
      -
      Description copied from class: java.util.AbstractMap
      -
      Returns true if this map contains a mapping for the specified - key. More formally, returns true if and only if - this map contains a mapping for a key k such that - Objects.equals(key, k). (There can be - at most one such mapping.)
      Specified by:
      containsKey in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
      Overrides:
      containsKey in class java.util.AbstractMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
      -
      Parameters:
      -
      key - key whose presence in this map is to be tested
      -
      Returns:
      -
      true if this map contains a mapping for the specified - key
    @@ -477,30 +435,11 @@

    get

    @CheckForNull
 public V get​(@CheckForNull
              java.lang.Object key)
    -
    Description copied from class: java.util.AbstractMap
    -
    Returns the value to which the specified key is mapped, - or null if this map contains no mapping for the key. - -

    More formally, if this map contains a mapping from a key - k to a value v such that - Objects.equals(key, k), - then this method returns v; otherwise - it returns null. (There can be at most one such mapping.) - -

    If this map permits null values, then a return value of - null does not necessarily indicate that the map - contains no mapping for the key; it's also possible that the map - explicitly maps the key to null. The containsKey operation may be used to distinguish these two cases.

    Specified by:
    get in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    get in class java.util.AbstractMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - the key whose associated value is to be returned
    -
    Returns:
    -
    the value to which the specified key is mapped, or - null if this map contains no mapping for the key
    @@ -516,13 +455,7 @@

    put

    @CheckForNull public V put​(K key, V value) -
    Description copied from class: java.util.AbstractMap
    -
    Associates the specified value with the specified key in this map - (optional operation). If the map previously contained a mapping for - the key, the old value is replaced by the specified value. (A map - m is said to contain a mapping for a key k if and only - if m.containsKey(k) would return - true.)
    +
    Description copied from interface: BiMap
    Specified by:
    put in interface BiMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    @@ -530,15 +463,6 @@

    put

    put in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    put in class java.util.AbstractMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - key with which the specified value is to be associated
    -
    value - value to be associated with the specified key
    -
    Returns:
    -
    the previous value associated with key, or - null if there was no mapping for key. - (A null return can also indicate that the map - previously associated null with key, - if the implementation supports null values.)
    @@ -588,33 +512,11 @@

    remove

    @CheckForNull public V remove​(@CheckForNull java.lang.Object key) -
    Description copied from class: java.util.AbstractMap
    -
    Removes the mapping for a key from this map if it is present - (optional operation). More formally, if this map contains a mapping - from key k to value v such that - Objects.equals(key, k), that mapping - is removed. (The map can contain at most one such mapping.) - -

    Returns the value to which this map previously associated the key, - or null if the map contained no mapping for the key. - -

    If this map permits null values, then a return value of - null does not necessarily indicate that the map - contained no mapping for the key; it's also possible that the map - explicitly mapped the key to null. - -

    The map will not contain a mapping for the specified key once the - call returns.

    Specified by:
    remove in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    remove in class java.util.AbstractMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    key - key whose mapping is to be removed from the map
    -
    Returns:
    -
    the previous value associated with key, or - null if there was no mapping for key.
    @@ -625,9 +527,6 @@

    remove

  • clear

    public void clear()
    -
    Description copied from class: java.util.AbstractMap
    -
    Removes all of the mappings from this map (optional operation). - The map will be empty after this call returns.
    Specified by:
    clear in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    @@ -641,15 +540,9 @@

    clear

  • size

    public int size()
    -
    Description copied from class: java.util.AbstractMap
    -
    Returns the number of key-value mappings in this map. If the - map contains more than Integer.MAX_VALUE elements, returns - Integer.MAX_VALUE.
    Specified by:
    size in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the number of key-value mappings in this map
    • @@ -660,25 +553,11 @@

    size

  • keySet

    public java.util.Set<K> keySet()
    -
    Description copied from class: java.util.AbstractMap
    -
    Returns a Set view of the keys contained in this map. - The set is backed by the map, so changes to the map are - reflected in the set, and vice-versa. If the map is modified - while an iteration over the set is in progress (except through - the iterator's own remove operation), the results of - the iteration are undefined. The set supports element removal, - which removes the corresponding mapping from the map, via the - Iterator.remove, Set.remove, - removeAll, retainAll, and clear - operations. It does not support the add or addAll - operations.
    Specified by:
    keySet in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    keySet in class java.util.AbstractMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a set view of the keys contained in this map
    • @@ -689,18 +568,10 @@

    keySet

  • values

    public java.util.Set<V> values()
    -
    Description copied from class: java.util.AbstractMap
    -
    Returns a Collection view of the values contained in this map. - The collection is backed by the map, so changes to the map are - reflected in the collection, and vice-versa. If the map is - modified while an iteration over the collection is in progress - (except through the iterator's own remove operation), - the results of the iteration are undefined. The collection - supports element removal, which removes the corresponding - mapping from the map, via the Iterator.remove, - Collection.remove, removeAll, - retainAll and clear operations. It does not - support the add or addAll operations.
    +
    Description copied from interface: BiMap
    +
    + +

    Because a bimap has unique values, this method returns a Set, instead of the Collection specified in the Map interface.

    Specified by:
    values in interface BiMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    @@ -708,8 +579,6 @@

    values

    values in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    values in class java.util.AbstractMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a collection view of the values contained in this map
    • @@ -720,17 +589,9 @@

    values

  • forEach

    public void forEach​(java.util.function.BiConsumer<? super K,​? super V> action)
    -
    Description copied from interface: java.util.Map
    -
    Performs the given action for each entry in this map until all entries - have been processed or the action throws an exception. Unless - otherwise specified by the implementing class, actions are performed in - the order of entry set iteration (if an iteration order is specified.) - Exceptions thrown by the action are relayed to the caller.
    Specified by:
    forEach in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    action - The action to be performed for each entry
    • @@ -741,16 +602,9 @@

    forEach

  • replaceAll

    public void replaceAll​(java.util.function.BiFunction<? super K,​? super V,​? extends V> function)
    -
    Description copied from interface: java.util.Map
    -
    Replaces each entry's value with the result of invoking the given - function on that entry until all entries have been processed or the - function throws an exception. Exceptions thrown by the function are - relayed to the caller.
    Specified by:
    replaceAll in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    function - the function to apply to each entry
    • @@ -783,26 +637,11 @@

    inverse

  • entrySet

    public java.util.Set<java.util.Map.Entry<K,​V>> entrySet()
    -
    Description copied from interface: java.util.Map
    -
    Returns a Set view of the mappings contained in this map. - The set is backed by the map, so changes to the map are - reflected in the set, and vice-versa. If the map is modified - while an iteration over the set is in progress (except through - the iterator's own remove operation, or through the - setValue operation on a map entry returned by the - iterator) the results of the iteration are undefined. The set - supports element removal, which removes the corresponding - mapping from the map, via the Iterator.remove, - Set.remove, removeAll, retainAll and - clear operations. It does not support the - add or addAll operations.
    Specified by:
    entrySet in interface java.util.Map<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Specified by:
    entrySet in class java.util.AbstractMap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a set view of the mappings contained in this map
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/HashMultimap.html b/releases/snapshot-jre/api/docs/com/google/common/collect/HashMultimap.html index 8a4a5a45b2c0..d3258b6bc618 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/HashMultimap.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/HashMultimap.html @@ -646,14 +646,6 @@

    equals

    equals in interface Multimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Specified by:
    equals in interface SetMultimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    • @@ -928,8 +920,6 @@

    hashCode

    hashCode in interface Multimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    See Also:
    Map.hashCode()
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/HashMultiset.html b/releases/snapshot-jre/api/docs/com/google/common/collect/HashMultiset.html index c8f82b25fd66..7f7b30d9ff9e 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/HashMultiset.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/HashMultiset.html @@ -195,8 +195,7 @@

    Method Summary

    boolean add​(E element) -
    Ensures that this collection contains the specified element (optional - operation).
    +
    Adds a single occurrence of the specified element to this multiset.
    @@ -210,23 +209,17 @@

    Method Summary

    boolean addAll​(java.util.Collection<? extends E> elementsToAdd) - -
    Adds all of the elements in the specified collection to this collection - (optional operation).
    - void clear() - -
    Removes all of the elements from this collection (optional operation).
    - +  boolean contains​(java.lang.Object element) -
    Returns true if this collection contains the specified element.
    +
    Determines whether this multiset contains the specified element.
    @@ -278,7 +271,7 @@

    Method Summary

    boolean equals​(java.lang.Object object) -
    Indicates whether some other object is "equal to" this one.
    +
    Compares the specified object with this multiset for equality.
    @@ -293,29 +286,23 @@

    Method Summary

    int hashCode() -
    Returns a hash code value for the object.
    +
    Returns the hash code for this multiset.
    boolean isEmpty() - -
    Returns true if this collection contains no elements.
    - +  java.util.Iterator<E> iterator() - -
    Returns an iterator over the elements contained in this collection.
    - boolean remove​(java.lang.Object element) -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation).
    +
    Removes a single occurrence of the specified element from this multiset, if present.
    @@ -329,18 +316,10 @@

    Method Summary

    boolean removeAll​(java.util.Collection<?> elementsToRemove) - -
    Removes all of this collection's elements that are also contained in the - specified collection (optional operation).
    - boolean retainAll​(java.util.Collection<?> elementsToRetain) - -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation).
    - int @@ -364,15 +343,12 @@

    Method Summary

    int size() -
    Returns the number of elements in this collection.
    +
    Returns the total number of all occurrences of all elements in this multiset.
    java.lang.String toString() - -
    Returns a string representation of this collection.
    -
      @@ -518,9 +494,6 @@

      forEachEntry

    • clear

      public void clear()
      -
      Description copied from class: java.util.AbstractCollection
      -
      Removes all of the elements from this collection (optional operation). - The collection will be empty after this method returns.
      Specified by:
      clear in interface java.util.Collection<E extends @Nullable java.lang.Object>
      @@ -534,10 +507,11 @@

      clear

    • size

      public int size()
      -
      Description copied from interface: java.util.Collection
      -
      Returns the number of elements in this collection. If this collection - contains more than Integer.MAX_VALUE elements, returns - Integer.MAX_VALUE.
      +
      Description copied from interface: Multiset
      +
      Returns the total number of all occurrences of all elements in this multiset. + +

      Note: this method does not return the number of distinct elements in the + multiset, which is given by entrySet().size().

      Specified by:
      size in interface java.util.Collection<E extends @Nullable java.lang.Object>
      @@ -545,8 +519,6 @@

      size

      size in interface Multiset<E extends @Nullable java.lang.Object>
      Specified by:
      size in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
      -
      Returns:
      -
      the number of elements in this collection
    @@ -557,8 +529,11 @@

    size

  • iterator

    public java.util.Iterator<E> iterator()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns an iterator over the elements contained in this collection.
    +
    Description copied from interface: Multiset
    +
    + +

    Elements that occur multiple times in the multiset will appear multiple times in this + iterator, though not necessarily sequentially.

    Specified by:
    iterator in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -568,8 +543,6 @@

    iterator

    iterator in interface Multiset<E extends @Nullable java.lang.Object>
    Specified by:
    iterator in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    an iterator over the elements contained in this collection
    • @@ -691,15 +664,11 @@

    setCount

  • isEmpty

    public boolean isEmpty()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains no elements.
    Specified by:
    isEmpty in interface java.util.Collection<E extends @Nullable java.lang.Object>
    Overrides:
    isEmpty in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    true if this collection contains no elements
    • @@ -711,11 +680,11 @@

    isEmpty

    contains

    public boolean contains​(@CheckForNull
                         java.lang.Object element)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains the specified element. - More formally, returns true if and only if this collection - contains at least one element e such that - Objects.equals(o, e).
    +
    Description copied from interface: Multiset
    +
    Determines whether this multiset contains the specified element. + +

    This method refines Collection.contains(java.lang.Object) to further specify that it may not + throw an exception in response to element being null or of the wrong type.

    Specified by:
    contains in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -724,10 +693,9 @@

    contains

    Overrides:
    contains in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    Parameters:
    -
    element - element whose presence in this collection is to be tested
    +
    element - the element to check for
    Returns:
    -
    true if this collection contains the specified - element
    +
    true if this multiset contains at least one occurrence of the element
    @@ -741,24 +709,14 @@

    contains

    add

    @CanIgnoreReturnValue
 public final boolean add​(E element)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Ensures that this collection contains the specified element (optional - operation). Returns true if this collection changed as a - result of the call. (Returns false if this collection does - not permit duplicates and already contains the specified element.)

    +

    Description copied from interface: Multiset
    +
    Adds a single occurrence of the specified element to this multiset. - Collections that support this operation may place limitations on what - elements may be added to this collection. In particular, some - collections will refuse to add null elements, and others will - impose restrictions on the type of elements that may be added. - Collection classes should clearly specify in their documentation any - restrictions on what elements may be added.

    +

    This method refines Collection.add(E), which only ensures the presence of the + element, to further specify that a successful call must always increment the count of the + element, and the overall size of the collection, by one. - If a collection refuses to add a particular element for any reason - other than that it already contains the element, it must throw - an exception (rather than returning false). This preserves - the invariant that a collection always contains the specified element - after this call returns.

    +

    To both add the element and obtain the previous count of that element, use add(element, 1) instead.

    Specified by:
    add in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -767,10 +725,11 @@

    add

    Overrides:
    add in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    Parameters:
    -
    element - element whose presence in this collection is to be ensured
    +
    element - the element to add one occurrence of; may be null only if explicitly allowed by + the implementation
    Returns:
    -
    true if this collection changed as a result of the - call
    +
    true always, since this call is required to modify the multiset, unlike other + Collection types
    @@ -783,14 +742,13 @@

    remove

    @CanIgnoreReturnValue
 public final boolean remove​(@CheckForNull
                             java.lang.Object element)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation). More formally, - removes an element e such that - Objects.equals(o, e), if - this collection contains one or more such elements. Returns - true if this collection contained the specified element (or - equivalently, if this collection changed as a result of the call).
    +
    Description copied from interface: Multiset
    +
    Removes a single occurrence of the specified element from this multiset, if present. + +

    This method refines Collection.remove(java.lang.Object) to further specify that it may not + throw an exception in response to element being null or of the wrong type. + +

    To both remove the element and obtain the previous count of that element, use remove(element, 1) instead.

    Specified by:
    remove in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -799,9 +757,9 @@

    remove

    Overrides:
    remove in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    Parameters:
    -
    element - element to be removed from this collection, if present
    +
    element - the element to remove one occurrence of
    Returns:
    -
    true if an element was removed as a result of this call
    +
    true if an occurrence was found and removed
    @@ -842,12 +800,7 @@

    setCount

    addAll

    @CanIgnoreReturnValue
 public final boolean addAll​(java.util.Collection<? extends E> elementsToAdd)
    -
    Adds all of the elements in the specified collection to this collection - (optional operation). The behavior of this operation is undefined if - the specified collection is modified while the operation is in progress. - (This implies that the behavior of this call is undefined if the - specified collection is this collection, and this collection is - nonempty.) +

    This implementation is highly efficient when elementsToAdd is itself a Multiset.

    @@ -855,12 +808,6 @@

    addAll

    addAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    Overrides:
    addAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    elementsToAdd - collection containing elements to be added to this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    -
    See Also:
    -
    AbstractCollection.add(Object)
    @@ -872,11 +819,16 @@

    addAll

    removeAll

    @CanIgnoreReturnValue
 public final boolean removeAll​(java.util.Collection<?> elementsToRemove)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes all of this collection's elements that are also contained in the - specified collection (optional operation). After this call returns, - this collection will contain no elements in common with the specified - collection.
    +
    Description copied from interface: Multiset
    +
    + +

    Note: This method ignores how often any element might appear in c, and only + cares whether or not an element appears at all. If you wish to remove one occurrence in this + multiset for every occurrence in c, see Multisets.removeOccurrences(Multiset, + Multiset). + +

    This method refines Collection.removeAll(java.util.Collection<?>) to further specify that it may not + throw an exception in response to any of elements being null or of the wrong type.

    Specified by:
    removeAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -884,14 +836,6 @@

    removeAll

    removeAll in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    removeAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    elementsToRemove - collection containing elements to be removed from this collection
    -
    Returns:
    -
    true if this collection changed as a result of the - call
    -
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    @@ -903,11 +847,16 @@

    removeAll

    retainAll

    @CanIgnoreReturnValue
 public final boolean retainAll​(java.util.Collection<?> elementsToRetain)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation). In other words, removes from - this collection all of its elements that are not contained in the - specified collection.
    +
    Description copied from interface: Multiset
    +
    + +

    Note: This method ignores how often any element might appear in c, and only + cares whether or not an element appears at all. If you wish to remove one occurrence in this + multiset for every occurrence in c, see Multisets.retainOccurrences(Multiset, + Multiset). + +

    This method refines Collection.retainAll(java.util.Collection<?>) to further specify that it may not + throw an exception in response to any of elements being null or of the wrong type.

    Specified by:
    retainAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -915,13 +864,8 @@

    retainAll

    retainAll in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    retainAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    elementsToRetain - collection containing elements to be retained in this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    +
    Multisets.retainOccurrences(Multiset, Multiset)
    @@ -959,44 +903,9 @@

    elementSet

    equals

    public final boolean equals​(@CheckForNull
                             java.lang.Object object)
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes. +

    Compares the specified object with this multiset for equality. Returns true if the + given object is also a multiset and contains equal elements with equal counts, regardless of + order.

    This implementation returns true if object is a multiset of the same size and if, for each element, the two multisets have the same count.

    @@ -1007,14 +916,6 @@

    equals

    equals in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -1025,34 +926,14 @@

    equals

  • hashCode

    public final int hashCode()
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.) +

    Returns the hash code for this multiset. This is defined as the sum of + + 
    
+ ((element == null) ? 0 : element.hashCode()) ^ count(element)
+
    + +

    over all distinct elements in the multiset. It follows that a multiset and its entry set + always have the same hash code.

    This implementation returns the hash code of Multiset.entrySet().

    @@ -1062,11 +943,6 @@

    hashCode

    hashCode in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -1077,12 +953,11 @@

    hashCode

  • toString

    public final java.lang.String toString()
    -
    Returns a string representation of this collection. The string - representation consists of a list of the collection's elements in the - order they are returned by its iterator, enclosed in square brackets - ("[]"). Adjacent elements are separated by the characters - ", " (comma and space). Elements are converted to strings as - by String.valueOf(Object). +
    + +

    It is recommended, though not mandatory, that this method return the result of invoking + Multiset.toString() on the Multiset.entrySet(), yielding a result such as [a x 3, c, d x 2, + e].

    This implementation returns the result of invoking toString on Multiset.entrySet().

    @@ -1090,8 +965,6 @@

    toString

    toString in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    toString in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a string representation of this collection
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableBiMap.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableBiMap.html index 2795cae669e1..583f59cc5246 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableBiMap.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableBiMap.html @@ -190,7 +190,7 @@

    Nested Class Summary

    Nested classes/interfaces inherited from interface java.util.Map

    -java.util.Map.Entry<K,​V> +java.util.Map.Entry<K extends java.lang.Object,​V extends java.lang.Object> @@ -549,13 +549,6 @@

    of

    Returns the empty bimap.

    Performance note: the instance returned is a singleton.

    -
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Returns:
    -
    an empty Map
    -
    @@ -569,16 +562,6 @@

    of

    public static <K,​V> ImmutableBiMap<K,​V> of​(K k1,
                                                        V v1)
    Returns an immutable bimap containing a single entry.
    -
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the mapping's key
    -
    v1 - the mapping's value
    -
    Returns:
    -
    a Map containing the specified mapping
    -
    @@ -595,16 +578,6 @@

    of

    V v2)
    Returns an immutable map containing the given entries, in order.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if duplicate keys or values are added
    @@ -626,18 +599,6 @@

    of

    V v3)
    Returns an immutable map containing the given entries, in order.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if duplicate keys or values are added
    @@ -661,20 +622,6 @@

    of

    V v4)
    Returns an immutable map containing the given entries, in order.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if duplicate keys or values are added
    @@ -700,22 +647,6 @@

    of

    V v5)
    Returns an immutable map containing the given entries, in order.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if duplicate keys or values are added
    @@ -743,24 +674,6 @@

    of

    V v6)
    Returns an immutable map containing the given entries, in order.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    k6 - the sixth mapping's key
    -
    v6 - the sixth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if duplicate keys or values are added
    Since:
    @@ -792,26 +705,6 @@

    of

    V v7)
    Returns an immutable map containing the given entries, in order.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    k6 - the sixth mapping's key
    -
    v6 - the sixth mapping's value
    -
    k7 - the seventh mapping's key
    -
    v7 - the seventh mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if duplicate keys or values are added
    Since:
    @@ -845,28 +738,6 @@

    of

    V v8)
    Returns an immutable map containing the given entries, in order.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    k6 - the sixth mapping's key
    -
    v6 - the sixth mapping's value
    -
    k7 - the seventh mapping's key
    -
    v7 - the seventh mapping's value
    -
    k8 - the eighth mapping's key
    -
    v8 - the eighth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if duplicate keys or values are added
    Since:
    @@ -902,30 +773,6 @@

    of

    V v9)
    Returns an immutable map containing the given entries, in order.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    k6 - the sixth mapping's key
    -
    v6 - the sixth mapping's value
    -
    k7 - the seventh mapping's key
    -
    v7 - the seventh mapping's value
    -
    k8 - the eighth mapping's key
    -
    v8 - the eighth mapping's value
    -
    k9 - the ninth mapping's key
    -
    v9 - the ninth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if duplicate keys or values are added
    Since:
    @@ -963,32 +810,6 @@

    of

    V v10)
    Returns an immutable map containing the given entries, in order.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    k6 - the sixth mapping's key
    -
    v6 - the sixth mapping's value
    -
    k7 - the seventh mapping's key
    -
    v7 - the seventh mapping's value
    -
    k8 - the eighth mapping's key
    -
    v8 - the eighth mapping's value
    -
    k9 - the ninth mapping's key
    -
    v9 - the ninth mapping's value
    -
    k10 - the tenth mapping's key
    -
    v10 - the tenth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if duplicate keys or values are added
    Since:
    @@ -1006,19 +827,10 @@

    ofEntries

    public static <K,​V>     ImmutableBiMap<K,​V> ofEntries​(java.util.Map.Entry<? extends K,​? extends V>... entries)
    Returns an immutable map containing the given entries, in order.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    entries - Map.Entrys containing the keys and values from which the map is populated
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if duplicate keys or values are provided
    Since:
    31.0
    -
    See Also:
    -
    Map.entry()
    @@ -1070,13 +882,6 @@

    copyOf

    safe to do so. The exact circumstances under which a copy will or will not be performed are undocumented and subject to change.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    map - a Map from which entries are drawn, must be non-null
    -
    Returns:
    -
    a Map containing the entries of the given Map
    Throws:
    java.lang.IllegalArgumentException - if two keys have the same value or two values have the same key
    @@ -1142,8 +947,6 @@

    values

    values in interface java.util.Map<K,​V>
    Overrides:
    values in class ImmutableMap<K,​V>
    -
    Returns:
    -
    a collection view of the values contained in this map
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableClassToInstanceMap.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableClassToInstanceMap.html index ef17d81003aa..7bd1090e9e03 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableClassToInstanceMap.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableClassToInstanceMap.html @@ -201,7 +201,7 @@

    Nested classes/interfaces inherited from class com.google.common.collec

    Nested classes/interfaces inherited from interface java.util.Map

    -java.util.Map.Entry<K,​V> +java.util.Map.Entry<K extends java.lang.Object,​V extends java.lang.Object> @@ -330,10 +330,6 @@

    of

    Performance note: the instance returned is a singleton.

    -
    Type Parameters:
    -
    B - the Map's key type
    -
    Returns:
    -
    an empty Map
    Since:
    19.0
    @@ -351,14 +347,6 @@

    of

    T value)
    Returns an ImmutableClassToInstanceMap containing a single entry.
    -
    Type Parameters:
    -
    B - the Map's key type
    -
    T - the Map's value type
    -
    Parameters:
    -
    type - the mapping's key
    -
    value - the mapping's value
    -
    Returns:
    -
    a Map containing the specified mapping
    Since:
    19.0
    @@ -388,13 +376,6 @@

    copyOf

    Note: Despite what the method name suggests, if map is an ImmutableClassToInstanceMap, no copy will actually be performed.

    -
    Type Parameters:
    -
    B - the Map's key type
    -
    S - the Map's value type
    -
    Parameters:
    -
    map - a Map from which entries are drawn, must be non-null
    -
    Returns:
    -
    a Map containing the entries of the given Map
    Throws:
    java.lang.NullPointerException - if any key or value in map is null
    java.lang.ClassCastException - if any value is not an instance of the type specified by its key
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableCollection.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableCollection.html index f1b1a077acf6..eb3f05a408d9 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableCollection.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableCollection.html @@ -354,9 +354,7 @@

    Method Summary

    abstract boolean contains​(java.lang.Object object) - -
    Returns true if this collection contains the specified element.
    - +  abstract UnmodifiableIterator<E> @@ -404,24 +402,17 @@

    Method Summary

    java.util.Spliterator<E> spliterator() - -
    Creates a Spliterator over the elements in this collection.
    - +  java.lang.Object[] toArray() - -
    Returns an array containing all of the elements in this collection.
    - +  <T extends @Nullable java.lang.Object>
    T[]     toArray​(T[] other) - -
    Returns an array containing all of the elements in this collection; - the runtime type of the returned array is that of the specified array.
    - + 
      @@ -483,8 +474,6 @@

      iterator

      iterator in interface java.lang.Iterable<E>
      Specified by:
      iterator in class java.util.AbstractCollection<E>
      -
      Returns:
      -
      an iterator over the elements contained in this collection
    @@ -495,39 +484,11 @@

    iterator

  • spliterator

    public java.util.Spliterator<E> spliterator()
    -
    Description copied from interface: java.util.Collection
    -
    Creates a Spliterator over the elements in this collection. - - Implementations should document characteristic values reported by the - spliterator. Such characteristic values are not required to be reported - if the spliterator reports Spliterator.SIZED and this collection - contains no elements. - -

    The default implementation should be overridden by subclasses that - can return a more efficient spliterator. In order to - preserve expected laziness behavior for the Collection.stream() and - Collection.parallelStream() methods, spliterators should either have the - characteristic of IMMUTABLE or CONCURRENT, or be - late-binding. - If none of these is practical, the overriding class should describe the - spliterator's documented policy of binding and structural interference, - and should override the Collection.stream() and Collection.parallelStream() - methods to create streams using a Supplier of the spliterator, - as in: - 

    
-     Stream<E> s = StreamSupport.stream(() -> spliterator(), spliteratorCharacteristics)
-
    -

    These requirements ensure that streams produced by the - Collection.stream() and Collection.parallelStream() methods will reflect the - contents of the collection as of initiation of the terminal stream - operation.

    Specified by:
    spliterator in interface java.util.Collection<E>
    Specified by:
    spliterator in interface java.lang.Iterable<E>
    -
    Returns:
    -
    a Spliterator over the elements in this collection
    • @@ -538,24 +499,11 @@

    spliterator

  • toArray

    public final java.lang.Object[] toArray()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns an array containing all of the elements in this collection. - If this collection makes any guarantees as to what order its elements - are returned by its iterator, this method must return the elements in - the same order. The returned array's runtime component type is Object. - -

    The returned array will be "safe" in that no references to it are - maintained by this collection. (In other words, this method must - allocate a new array even if this collection is backed by an array). - The caller is thus free to modify the returned array.

    Specified by:
    toArray in interface java.util.Collection<E>
    Overrides:
    toArray in class java.util.AbstractCollection<E>
    -
    Returns:
    -
    an array, whose runtime component - type is Object, containing all of the elements in this collection
    • @@ -569,36 +517,11 @@

    toArray

    toArray

    @CanIgnoreReturnValue
 public final <T extends @Nullable java.lang.Object> T[] toArray​(T[] other)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns an array containing all of the elements in this collection; - the runtime type of the returned array is that of the specified array. - If the collection fits in the specified array, it is returned therein. - Otherwise, a new array is allocated with the runtime type of the - specified array and the size of this collection. - -

    If this collection fits in the specified array with room to spare - (i.e., the array has more elements than this collection), the element - in the array immediately following the end of the collection is set to - null. (This is useful in determining the length of this - collection only if the caller knows that this collection does - not contain any null elements.) - -

    If this collection makes any guarantees as to what order its elements - are returned by its iterator, this method must return the elements in - the same order.

    Specified by:
    toArray in interface java.util.Collection<E>
    Overrides:
    toArray in class java.util.AbstractCollection<E>
    -
    Type Parameters:
    -
    T - the component type of the array to contain the collection
    -
    Parameters:
    -
    other - the array into which the elements of this collection are to be - stored, if it is big enough; otherwise, a new array of the same - runtime type is allocated for this purpose.
    -
    Returns:
    -
    an array containing all of the elements in this collection
    @@ -610,21 +533,11 @@

    toArray

    contains

    public abstract boolean contains​(@CheckForNull
                                  java.lang.Object object)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains the specified element. - More formally, returns true if and only if this collection - contains at least one element e such that - Objects.equals(o, e).
    Specified by:
    contains in interface java.util.Collection<E>
    Overrides:
    contains in class java.util.AbstractCollection<E>
    -
    Parameters:
    -
    object - element whose presence in this collection is to be tested
    -
    Returns:
    -
    true if this collection contains the specified - element
    @@ -648,11 +561,6 @@

    add

    add in interface java.util.Collection<E>
    Overrides:
    add in class java.util.AbstractCollection<E>
    -
    Parameters:
    -
    e - element whose presence in this collection is to be ensured
    -
    Returns:
    -
    true if this collection changed as a result of the - call
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -677,10 +585,6 @@

    remove

    remove in interface java.util.Collection<E>
    Overrides:
    remove in class java.util.AbstractCollection<E>
    -
    Parameters:
    -
    object - element to be removed from this collection, if present
    -
    Returns:
    -
    true if an element was removed as a result of this call
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -704,14 +608,8 @@

    addAll

    addAll in interface java.util.Collection<E>
    Overrides:
    addAll in class java.util.AbstractCollection<E>
    -
    Parameters:
    -
    newElements - collection containing elements to be added to this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    Throws:
    java.lang.UnsupportedOperationException - always
    -
    See Also:
    -
    AbstractCollection.add(Object)
    @@ -733,16 +631,8 @@

    removeAll

    removeAll in interface java.util.Collection<E>
    Overrides:
    removeAll in class java.util.AbstractCollection<E>
    -
    Parameters:
    -
    oldElements - collection containing elements to be removed from this collection
    -
    Returns:
    -
    true if this collection changed as a result of the - call
    Throws:
    java.lang.UnsupportedOperationException - always
    -
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    @@ -762,11 +652,6 @@

    removeIf

    Specified by:
    removeIf in interface java.util.Collection<E>
    -
    Parameters:
    -
    filter - a predicate which returns true for elements to be - removed
    -
    Returns:
    -
    true if any elements were removed
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -789,15 +674,8 @@

    retainAll

    retainAll in interface java.util.Collection<E>
    Overrides:
    retainAll in class java.util.AbstractCollection<E>
    -
    Parameters:
    -
    elementsToKeep - collection containing elements to be retained in this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    Throws:
    java.lang.UnsupportedOperationException - always
    -
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableList.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableList.html index 35febfff3565..30604d2009e3 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableList.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableList.html @@ -257,9 +257,7 @@

    Method Summary

    boolean contains​(java.lang.Object object) - -
    Returns true if this collection contains the specified element.
    - +  static <E> ImmutableList<E> @@ -292,33 +290,22 @@

    Method Summary

    boolean equals​(java.lang.Object obj) - -
    Indicates whether some other object is "equal to" this one.
    - +  void forEach​(java.util.function.Consumer<? super E> consumer) - -
    Performs the given action for each element of the Iterable - until all elements have been processed or the action throws an - exception.
    - +  int hashCode() - -
    Returns a hash code value for the object.
    - +  int indexOf​(java.lang.Object object) - -
    Returns the index of the first occurrence of the specified element - in this list, or -1 if this list does not contain the element.
    - +  UnmodifiableIterator<E> @@ -330,26 +317,17 @@

    Method Summary

    int lastIndexOf​(java.lang.Object object) - -
    Returns the index of the last occurrence of the specified element - in this list, or -1 if this list does not contain the element.
    - +  UnmodifiableListIterator<E> listIterator() - -
    Returns a list iterator over the elements in this list (in proper - sequence).
    - +  UnmodifiableListIterator<E> listIterator​(int index) - -
    Returns a list iterator over the elements in this list (in proper - sequence), starting at the specified position in the list.
    - +  static <E> ImmutableList<E> @@ -573,9 +551,7 @@

    Method Summary

    java.util.Spliterator<E> spliterator() - -
    Creates a Spliterator over the elements in this collection.
    - +  ImmutableList<E> @@ -672,12 +648,6 @@

    of

    code.

    Performance note: the instance returned is a singleton.

    -
    -
    Type Parameters:
    -
    E - the List's element type
    -
    Returns:
    -
    an empty List
    -
    @@ -693,12 +663,6 @@

    of

    comparably to Collections.singletonList(T), but will not accept a null element. It is preferable mainly for consistency and maintainability of your code.
    -
    Type Parameters:
    -
    E - the List's element type
    -
    Parameters:
    -
    element - the single element
    -
    Returns:
    -
    a List containing the specified element
    Throws:
    java.lang.NullPointerException - if element is null
    @@ -716,13 +680,6 @@

    of

    E e2)
    Returns an immutable list containing the given elements, in order.
    -
    Type Parameters:
    -
    E - the List's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    Returns:
    -
    a List containing the specified elements
    Throws:
    java.lang.NullPointerException - if any element is null
    @@ -741,14 +698,6 @@

    of

    E e3)
    Returns an immutable list containing the given elements, in order.
    -
    Type Parameters:
    -
    E - the List's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    Returns:
    -
    a List containing the specified elements
    Throws:
    java.lang.NullPointerException - if any element is null
    @@ -768,15 +717,6 @@

    of

    E e4)
    Returns an immutable list containing the given elements, in order.
    -
    Type Parameters:
    -
    E - the List's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    e4 - the fourth element
    -
    Returns:
    -
    a List containing the specified elements
    Throws:
    java.lang.NullPointerException - if any element is null
    @@ -797,16 +737,6 @@

    of

    E e5)
    Returns an immutable list containing the given elements, in order.
    -
    Type Parameters:
    -
    E - the List's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    e4 - the fourth element
    -
    e5 - the fifth element
    -
    Returns:
    -
    a List containing the specified elements
    Throws:
    java.lang.NullPointerException - if any element is null
    @@ -828,17 +758,6 @@

    of

    E e6)
    Returns an immutable list containing the given elements, in order.
    -
    Type Parameters:
    -
    E - the List's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    e4 - the fourth element
    -
    e5 - the fifth element
    -
    e6 - the sixth element
    -
    Returns:
    -
    a List containing the specified elements
    Throws:
    java.lang.NullPointerException - if any element is null
    @@ -861,18 +780,6 @@

    of

    E e7)
    Returns an immutable list containing the given elements, in order.
    -
    Type Parameters:
    -
    E - the List's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    e4 - the fourth element
    -
    e5 - the fifth element
    -
    e6 - the sixth element
    -
    e7 - the seventh element
    -
    Returns:
    -
    a List containing the specified elements
    Throws:
    java.lang.NullPointerException - if any element is null
    @@ -896,19 +803,6 @@

    of

    E e8)
    Returns an immutable list containing the given elements, in order.
    -
    Type Parameters:
    -
    E - the List's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    e4 - the fourth element
    -
    e5 - the fifth element
    -
    e6 - the sixth element
    -
    e7 - the seventh element
    -
    e8 - the eighth element
    -
    Returns:
    -
    a List containing the specified elements
    Throws:
    java.lang.NullPointerException - if any element is null
    @@ -933,20 +827,6 @@

    of

    E e9)
    Returns an immutable list containing the given elements, in order.
    -
    Type Parameters:
    -
    E - the List's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    e4 - the fourth element
    -
    e5 - the fifth element
    -
    e6 - the sixth element
    -
    e7 - the seventh element
    -
    e8 - the eighth element
    -
    e9 - the ninth element
    -
    Returns:
    -
    a List containing the specified elements
    Throws:
    java.lang.NullPointerException - if any element is null
    @@ -972,21 +852,6 @@

    of

    E e10)
    Returns an immutable list containing the given elements, in order.
    -
    Type Parameters:
    -
    E - the List's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    e4 - the fourth element
    -
    e5 - the fifth element
    -
    e6 - the sixth element
    -
    e7 - the seventh element
    -
    e8 - the eighth element
    -
    e9 - the ninth element
    -
    e10 - the tenth element
    -
    Returns:
    -
    a List containing the specified elements
    Throws:
    java.lang.NullPointerException - if any element is null
    @@ -1088,12 +953,6 @@

    copyOf

    This method is safe to use even when elements is a synchronized or concurrent collection that is currently being modified by another thread.

    -
    Type Parameters:
    -
    E - the List's element type
    -
    Parameters:
    -
    elements - a Collection from which elements are drawn, must be non-null
    -
    Returns:
    -
    a List containing the elements of the given Collection
    Throws:
    java.lang.NullPointerException - if elements contains a null element
    @@ -1200,8 +1059,6 @@

    iterator

    iterator in interface java.util.List<E>
    Specified by:
    iterator in class ImmutableCollection<E>
    -
    Returns:
    -
    an iterator over the elements contained in this collection
    @@ -1212,15 +1069,9 @@

    iterator

  • listIterator

    public UnmodifiableListIterator<E> listIterator()
    -
    Description copied from interface: java.util.List
    -
    Returns a list iterator over the elements in this list (in proper - sequence).
    Specified by:
    listIterator in interface java.util.List<E>
    -
    Returns:
    -
    a list iterator over the elements in this list (in proper - sequence)
    • @@ -1231,22 +1082,9 @@

    listIterator

  • listIterator

    public UnmodifiableListIterator<E> listIterator​(int index)
    -
    Description copied from interface: java.util.List
    -
    Returns a list iterator over the elements in this list (in proper - sequence), starting at the specified position in the list. - The specified index indicates the first element that would be - returned by an initial call to next. - An initial call to previous would - return the element with the specified index minus one.
    Specified by:
    listIterator in interface java.util.List<E>
    -
    Parameters:
    -
    index - index of the first element to be returned from the - list iterator (by a call to next)
    -
    Returns:
    -
    a list iterator over the elements in this list (in proper - sequence), starting at the specified position in the list
    • @@ -1257,21 +1095,9 @@

    listIterator

  • forEach

    public void forEach​(java.util.function.Consumer<? super E> consumer)
    -
    Description copied from interface: java.lang.Iterable
    -
    Performs the given action for each element of the Iterable - until all elements have been processed or the action throws an - exception. Actions are performed in the order of iteration, if that - order is specified. Exceptions thrown by the action are relayed to the - caller. -

    - The behavior of this method is unspecified if the action performs - side-effects that modify the underlying source of elements, unless an - overriding class has specified a concurrent modification policy.

    Specified by:
    forEach in interface java.lang.Iterable<E>
    -
    Parameters:
    -
    consumer - The action to be performed for each element
    • @@ -1283,20 +1109,9 @@

    forEach

    indexOf

    public int indexOf​(@CheckForNull
                    java.lang.Object object)
    -
    Description copied from interface: java.util.List
    -
    Returns the index of the first occurrence of the specified element - in this list, or -1 if this list does not contain the element. - More formally, returns the lowest index i such that - Objects.equals(o, get(i)), - or -1 if there is no such index.
    Specified by:
    indexOf in interface java.util.List<E>
    -
    Parameters:
    -
    object - element to search for
    -
    Returns:
    -
    the index of the first occurrence of the specified element in - this list, or -1 if this list does not contain the element
    @@ -1308,20 +1123,9 @@

    indexOf

    lastIndexOf

    public int lastIndexOf​(@CheckForNull
                        java.lang.Object object)
    -
    Description copied from interface: java.util.List
    -
    Returns the index of the last occurrence of the specified element - in this list, or -1 if this list does not contain the element. - More formally, returns the highest index i such that - Objects.equals(o, get(i)), - or -1 if there is no such index.
    Specified by:
    lastIndexOf in interface java.util.List<E>
    -
    Parameters:
    -
    object - element to search for
    -
    Returns:
    -
    the index of the last occurrence of the specified element in - this list, or -1 if this list does not contain the element
    @@ -1333,11 +1137,6 @@

    lastIndexOf

    contains

    public boolean contains​(@CheckForNull
                         java.lang.Object object)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains the specified element. - More formally, returns true if and only if this collection - contains at least one element e such that - Objects.equals(o, e).
    Specified by:
    contains in interface java.util.Collection<E>
    @@ -1345,11 +1144,6 @@

    contains

    contains in interface java.util.List<E>
    Specified by:
    contains in class ImmutableCollection<E>
    -
    Parameters:
    -
    object - element whose presence in this collection is to be tested
    -
    Returns:
    -
    true if this collection contains the specified - element
    @@ -1367,11 +1161,6 @@

    subList

    Specified by:
    subList in interface java.util.List<E>
    -
    Parameters:
    -
    fromIndex - low endpoint (inclusive) of the subList
    -
    toIndex - high endpoint (exclusive) of the subList
    -
    Returns:
    -
    a view of the specified range within this list
    @@ -1392,12 +1181,6 @@

    addAll

    Specified by:
    addAll in interface java.util.List<E>
    -
    Parameters:
    -
    index - index at which to insert the first element from the - specified collection
    -
    newElements - collection containing elements to be added to this list
    -
    Returns:
    -
    true if this list changed as a result of the call
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -1422,11 +1205,6 @@

    set

    Specified by:
    set in interface java.util.List<E>
    -
    Parameters:
    -
    index - index of the element to replace
    -
    element - element to be stored at the specified position
    -
    Returns:
    -
    the element previously at the specified position
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -1450,9 +1228,6 @@

    add

    Specified by:
    add in interface java.util.List<E>
    -
    Parameters:
    -
    index - index at which the specified element is to be inserted
    -
    element - element to be inserted
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -1474,10 +1249,6 @@

    remove

    Specified by:
    remove in interface java.util.List<E>
    -
    Parameters:
    -
    index - the index of the element to be removed
    -
    Returns:
    -
    the element previously at the specified position
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -1498,8 +1269,6 @@

    replaceAll

    Specified by:
    replaceAll in interface java.util.List<E>
    -
    Parameters:
    -
    operator - the operator to apply to each element
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -1520,10 +1289,6 @@

    sort

    Specified by:
    sort in interface java.util.List<E>
    -
    Parameters:
    -
    c - the Comparator used to compare list elements. - A null value indicates that the elements' - natural ordering should be used
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -1557,32 +1322,6 @@

    asList

  • spliterator

    public java.util.Spliterator<E> spliterator()
    -
    Description copied from interface: java.util.Collection
    -
    Creates a Spliterator over the elements in this collection. - - Implementations should document characteristic values reported by the - spliterator. Such characteristic values are not required to be reported - if the spliterator reports Spliterator.SIZED and this collection - contains no elements. - -

    The default implementation should be overridden by subclasses that - can return a more efficient spliterator. In order to - preserve expected laziness behavior for the Collection.stream() and - Collection.parallelStream() methods, spliterators should either have the - characteristic of IMMUTABLE or CONCURRENT, or be - late-binding. - If none of these is practical, the overriding class should describe the - spliterator's documented policy of binding and structural interference, - and should override the Collection.stream() and Collection.parallelStream() - methods to create streams using a Supplier of the spliterator, - as in: - 

    
-     Stream<E> s = StreamSupport.stream(() -> spliterator(), spliteratorCharacteristics)
-
    -

    These requirements ensure that streams produced by the - Collection.stream() and Collection.parallelStream() methods will reflect the - contents of the collection as of initiation of the terminal stream - operation.

    Specified by:
    spliterator in interface java.util.Collection<E>
    @@ -1592,8 +1331,6 @@

    spliterator

    spliterator in interface java.util.List<E>
    Overrides:
    spliterator in class ImmutableCollection<E>
    -
    Returns:
    -
    a Spliterator over the elements in this collection
    • @@ -1622,45 +1359,6 @@

    reverse

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object obj)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    Specified by:
    equals in interface java.util.Collection<E>
    @@ -1668,14 +1366,6 @@

    equals

    equals in interface java.util.List<E>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -1686,35 +1376,6 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    Specified by:
    hashCode in interface java.util.Collection<E>
    @@ -1722,11 +1383,6 @@

    hashCode

    hashCode in interface java.util.List<E>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableListMultimap.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableListMultimap.html index 8af985f19e88..394a89c407ed 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableListMultimap.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableListMultimap.html @@ -238,7 +238,7 @@

    Method Summary

    boolean equals​(java.lang.Object object) -
    Indicates whether some other object is "equal to" this one.
    +
    Compares the specified object with this multimap for equality.
    @@ -796,58 +796,23 @@

    containsEntry

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object object)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    +
    Description copied from interface: Multimap
    +
    Compares the specified object with this multimap for equality. Two multimaps are equal when + their map views, as returned by Multimap.asMap(), are also equal. + +

    In general, two multimaps with identical key-value mappings may or may not be equal, + depending on the implementation. For example, two SetMultimap instances with the same + key-value mappings are equal, but equality of two ListMultimap instances depends on the + ordering of the values for each key. + +

    A non-empty SetMultimap cannot be equal to a non-empty ListMultimap, since + their Multimap.asMap() views contain unequal collections as values. However, any two empty + multimaps are equal, because they both have empty Multimap.asMap() views.

    Specified by:
    equals in interface Multimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -867,8 +832,6 @@

    hashCode

    hashCode in interface Multimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    See Also:
    Map.hashCode()
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableMap.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableMap.html index b2989b8f7c4f..12a36816340a 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableMap.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableMap.html @@ -192,7 +192,7 @@

    Nested Class Summary

    Nested classes/interfaces inherited from interface java.util.Map

    -java.util.Map.Entry<K,​V> +java.util.Map.Entry<K extends java.lang.Object,​V extends java.lang.Object> @@ -274,18 +274,12 @@

    Method Summary

    boolean containsKey​(java.lang.Object key) - -
    Returns true if this map contains a mapping for the specified - key.
    - +  boolean containsValue​(java.lang.Object value) - -
    Returns true if this map maps one or more keys to the - specified value.
    - +  static <K,​V>
    ImmutableMap<K,​V>     @@ -311,40 +305,28 @@

    Method Summary

    boolean equals​(java.lang.Object object) - -
    Indicates whether some other object is "equal to" this one.
    - +  abstract V get​(java.lang.Object key) - -
    Returns the value to which the specified key is mapped, - or null if this map contains no mapping for the key.
    - +  V getOrDefault​(java.lang.Object key, V defaultValue) - -
    Returns the value to which the specified key is mapped, or - defaultValue if this map contains no mapping for the key.
    - +  int hashCode() - -
    Returns a hash code value for the object.
    - +  boolean isEmpty() - -
    Returns true if this map contains no key-value mappings.
    - +  ImmutableSet<K> @@ -648,9 +630,7 @@

    Method Summary

    java.lang.String toString() - -
    Returns a string representation of the object.
    - +  ImmutableCollection<V> @@ -745,13 +725,6 @@

    of

    code.

    Performance note: the instance returned is a singleton.

    -
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Returns:
    -
    an empty Map
    -
    @@ -767,16 +740,6 @@

    of

    Returns an immutable map containing a single entry. This map behaves and performs comparably to Collections.singletonMap(K, V) but will not accept a null key or value. It is preferable mainly for consistency and maintainability of your code.
    -
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the mapping's key
    -
    v1 - the mapping's value
    -
    Returns:
    -
    a Map containing the specified mapping
    -
     @@ -793,16 +756,6 @@

    of

    V v2)
    Returns an immutable map containing the given entries, in order.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if duplicate keys are provided
    @@ -824,18 +777,6 @@

    of

    V v3)
    Returns an immutable map containing the given entries, in order.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if duplicate keys are provided
    @@ -859,20 +800,6 @@

    of

    V v4)
    Returns an immutable map containing the given entries, in order.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if duplicate keys are provided
    @@ -898,22 +825,6 @@

    of

    V v5)
    Returns an immutable map containing the given entries, in order.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if duplicate keys are provided
    @@ -941,24 +852,6 @@

    of

    V v6)
    Returns an immutable map containing the given entries, in order.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    k6 - the sixth mapping's key
    -
    v6 - the sixth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if duplicate keys are provided
    Since:
    @@ -990,26 +883,6 @@

    of

    V v7)
    Returns an immutable map containing the given entries, in order.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    k6 - the sixth mapping's key
    -
    v6 - the sixth mapping's value
    -
    k7 - the seventh mapping's key
    -
    v7 - the seventh mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if duplicate keys are provided
    Since:
    @@ -1043,28 +916,6 @@

    of

    V v8)
    Returns an immutable map containing the given entries, in order.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    k6 - the sixth mapping's key
    -
    v6 - the sixth mapping's value
    -
    k7 - the seventh mapping's key
    -
    v7 - the seventh mapping's value
    -
    k8 - the eighth mapping's key
    -
    v8 - the eighth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if duplicate keys are provided
    Since:
    @@ -1100,30 +951,6 @@

    of

    V v9)
    Returns an immutable map containing the given entries, in order.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    k6 - the sixth mapping's key
    -
    v6 - the sixth mapping's value
    -
    k7 - the seventh mapping's key
    -
    v7 - the seventh mapping's value
    -
    k8 - the eighth mapping's key
    -
    v8 - the eighth mapping's value
    -
    k9 - the ninth mapping's key
    -
    v9 - the ninth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if duplicate keys are provided
    Since:
    @@ -1161,32 +988,6 @@

    of

    V v10)
    Returns an immutable map containing the given entries, in order.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    k6 - the sixth mapping's key
    -
    v6 - the sixth mapping's value
    -
    k7 - the seventh mapping's key
    -
    v7 - the seventh mapping's value
    -
    k8 - the eighth mapping's key
    -
    v8 - the eighth mapping's value
    -
    k9 - the ninth mapping's key
    -
    v9 - the ninth mapping's value
    -
    k10 - the tenth mapping's key
    -
    v10 - the tenth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if duplicate keys are provided
    Since:
    @@ -1204,19 +1005,10 @@

    ofEntries

    public static <K,​V>     ImmutableMap<K,​V> ofEntries​(java.util.Map.Entry<? extends K,​? extends V>... entries)
    Returns an immutable map containing the given entries, in order.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    entries - Map.Entrys containing the keys and values from which the map is populated
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if duplicate keys are provided
    Since:
    31.0
    -
    See Also:
    -
    Map.entry()
    @@ -1266,13 +1058,6 @@

    copyOf

    safe to do so. The exact circumstances under which a copy will or will not be performed are undocumented and subject to change.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    map - a Map from which entries are drawn, must be non-null
    -
    Returns:
    -
    a Map containing the entries of the given Map
    Throws:
    java.lang.NullPointerException - if any key or value in map is null
    @@ -1317,15 +1102,6 @@

    put

    Specified by:
    put in interface java.util.Map<K,​V>
    -
    Parameters:
    -
    k - key with which the specified value is to be associated
    -
    v - value to be associated with the specified key
    -
    Returns:
    -
    the previous value associated with key, or - null if there was no mapping for key. - (A null return can also indicate that the map - previously associated null with key, - if the implementation supports null values.)
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -1351,15 +1127,6 @@

    putIfAbsent

    Specified by:
    putIfAbsent in interface java.util.Map<K,​V>
    -
    Parameters:
    -
    key - key with which the specified value is to be associated
    -
    value - value to be associated with the specified key
    -
    Returns:
    -
    the previous value associated with the specified key, or - null if there was no mapping for the key. - (A null return can also indicate that the map - previously associated null with the key, - if the implementation supports null values.)
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -1384,12 +1151,6 @@

    replace

    Specified by:
    replace in interface java.util.Map<K,​V>
    -
    Parameters:
    -
    key - key with which the specified value is associated
    -
    oldValue - value expected to be associated with the specified key
    -
    newValue - value to be associated with the specified key
    -
    Returns:
    -
    true if the value was replaced
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -1414,15 +1175,6 @@

    replace

    Specified by:
    replace in interface java.util.Map<K,​V>
    -
    Parameters:
    -
    key - key with which the specified value is associated
    -
    value - value to be associated with the specified key
    -
    Returns:
    -
    the previous value associated with the specified key, or - null if there was no mapping for the key. - (A null return can also indicate that the map - previously associated null with the key, - if the implementation supports null values.)
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -1446,12 +1198,6 @@

    computeIfAbsent

    Specified by:
    computeIfAbsent in interface java.util.Map<K,​V>
    -
    Parameters:
    -
    key - key with which the specified value is to be associated
    -
    mappingFunction - the mapping function to compute a value
    -
    Returns:
    -
    the current (existing or computed) value associated with - the specified key, or null if the computed value is null
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -1475,11 +1221,6 @@

    computeIfPresent

    Specified by:
    computeIfPresent in interface java.util.Map<K,​V>
    -
    Parameters:
    -
    key - key with which the specified value is to be associated
    -
    remappingFunction - the remapping function to compute a value
    -
    Returns:
    -
    the new value associated with the specified key, or null if none
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -1503,11 +1244,6 @@

    compute

    Specified by:
    compute in interface java.util.Map<K,​V>
    -
    Parameters:
    -
    key - key with which the specified value is to be associated
    -
    remappingFunction - the remapping function to compute a value
    -
    Returns:
    -
    the new value associated with the specified key, or null if none
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -1532,16 +1268,6 @@

    merge

    Specified by:
    merge in interface java.util.Map<K,​V>
    -
    Parameters:
    -
    key - key with which the resulting value is to be associated
    -
    value - the non-null value to be merged with the existing value - associated with the key or, if no existing value or a null value - is associated with the key, to be associated with the key
    -
    remappingFunction - the remapping function to recompute a value if - present
    -
    Returns:
    -
    the new value associated with the specified key, or null if no - value is associated with the key
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -1562,8 +1288,6 @@

    putAll

    Specified by:
    putAll in interface java.util.Map<K,​V>
    -
    Parameters:
    -
    map - mappings to be stored in this map
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -1584,8 +1308,6 @@

    replaceAll

    Specified by:
    replaceAll in interface java.util.Map<K,​V>
    -
    Parameters:
    -
    function - the function to apply to each entry
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -1608,11 +1330,6 @@

    remove

    Specified by:
    remove in interface java.util.Map<K,​V>
    -
    Parameters:
    -
    o - key whose mapping is to be removed from the map
    -
    Returns:
    -
    the previous value associated with key, or - null if there was no mapping for key.
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -1636,11 +1353,6 @@

    remove

    Specified by:
    remove in interface java.util.Map<K,​V>
    -
    Parameters:
    -
    key - key with which the specified value is associated
    -
    value - value expected to be associated with the specified key
    -
    Returns:
    -
    true if the value was removed
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -1673,13 +1385,9 @@

    clear

  • isEmpty

    public boolean isEmpty()
    -
    Description copied from interface: java.util.Map
    -
    Returns true if this map contains no key-value mappings.
    Specified by:
    isEmpty in interface java.util.Map<K,​V>
    -
    Returns:
    -
    true if this map contains no key-value mappings
    • @@ -1691,20 +1399,9 @@

    isEmpty

    containsKey

    public boolean containsKey​(@CheckForNull
                            java.lang.Object key)
    -
    Description copied from interface: java.util.Map
    -
    Returns true if this map contains a mapping for the specified - key. More formally, returns true if and only if - this map contains a mapping for a key k such that - Objects.equals(key, k). (There can be - at most one such mapping.)
    Specified by:
    containsKey in interface java.util.Map<K,​V>
    -
    Parameters:
    -
    key - key whose presence in this map is to be tested
    -
    Returns:
    -
    true if this map contains a mapping for the specified - key
    @@ -1716,21 +1413,9 @@

    containsKey

    containsValue

    public boolean containsValue​(@CheckForNull
                              java.lang.Object value)
    -
    Description copied from interface: java.util.Map
    -
    Returns true if this map maps one or more keys to the - specified value. More formally, returns true if and only if - this map contains at least one mapping to a value v such that - Objects.equals(value, v). This operation - will probably require time linear in the map size for most - implementations of the Map interface.
    Specified by:
    containsValue in interface java.util.Map<K,​V>
    -
    Parameters:
    -
    value - value whose presence in this map is to be tested
    -
    Returns:
    -
    true if this map maps one or more keys to the - specified value
    @@ -1743,28 +1428,9 @@

    get

    @CheckForNull
 public abstract V get​(@CheckForNull
                       java.lang.Object key)
    -
    Description copied from interface: java.util.Map
    -
    Returns the value to which the specified key is mapped, - or null if this map contains no mapping for the key. - -

    More formally, if this map contains a mapping from a key - k to a value v such that - Objects.equals(key, k), - then this method returns v; otherwise - it returns null. (There can be at most one such mapping.) - -

    If this map permits null values, then a return value of - null does not necessarily indicate that the map - contains no mapping for the key; it's also possible that the map - explicitly maps the key to null. The containsKey operation may be used to distinguish these two cases.

    Specified by:
    get in interface java.util.Map<K,​V>
    -
    Parameters:
    -
    key - the key whose associated value is to be returned
    -
    Returns:
    -
    the value to which the specified key is mapped, or - null if this map contains no mapping for the key
    @@ -1781,18 +1447,9 @@

    getOrDefault

    java.lang.Object key, @CheckForNull V defaultValue) -
    Description copied from interface: java.util.Map
    -
    Returns the value to which the specified key is mapped, or - defaultValue if this map contains no mapping for the key.
    Specified by:
    getOrDefault in interface java.util.Map<K,​V>
    -
    Parameters:
    -
    key - the key whose associated value is to be returned
    -
    defaultValue - the default mapping of the key
    -
    Returns:
    -
    the value to which the specified key is mapped, or - defaultValue if this map contains no mapping for the key
    Since:
    21.0 (but only since 23.5 in the Android flavor). Note, however, that Java 8 users can call this method with any version and flavor of Guava.
    @@ -1811,8 +1468,6 @@

    entrySet

    Specified by:
    entrySet in interface java.util.Map<K,​V>
    -
    Returns:
    -
    a set view of the mappings contained in this map
    @@ -1827,8 +1482,6 @@

    keySet

    Specified by:
    keySet in interface java.util.Map<K,​V>
    -
    Returns:
    -
    a set view of the keys contained in this map
    @@ -1844,8 +1497,6 @@

    values

    Specified by:
    values in interface java.util.Map<K,​V>
    -
    Returns:
    -
    a collection view of the values contained in this map
    @@ -1871,58 +1522,11 @@

    asMultimap

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object object)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    Specified by:
    equals in interface java.util.Map<K,​V>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -1933,45 +1537,11 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    Specified by:
    hashCode in interface java.util.Map<K,​V>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -1982,29 +1552,9 @@

    hashCode

  • toString

    public java.lang.String toString()
    -
    Description copied from class: java.lang.Object
    -
    Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

    - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

    - 
    - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableMultimap.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableMultimap.html index d3c601b22906..4c19728cccb0 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableMultimap.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableMultimap.html @@ -291,7 +291,7 @@

    Method Summary

    boolean equals​(java.lang.Object object) -
    Indicates whether some other object is "equal to" this one.
    +
    Compares the specified object with this multimap for equality.
    @@ -1067,58 +1067,23 @@

    containsEntry

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object object)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    +
    Description copied from interface: Multimap
    +
    Compares the specified object with this multimap for equality. Two multimaps are equal when + their map views, as returned by Multimap.asMap(), are also equal. + +

    In general, two multimaps with identical key-value mappings may or may not be equal, + depending on the implementation. For example, two SetMultimap instances with the same + key-value mappings are equal, but equality of two ListMultimap instances depends on the + ordering of the values for each key. + +

    A non-empty SetMultimap cannot be equal to a non-empty ListMultimap, since + their Multimap.asMap() views contain unequal collections as values. However, any two empty + multimaps are equal, because they both have empty Multimap.asMap() views.

    Specified by:
    equals in interface Multimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -1138,8 +1103,6 @@

    hashCode

    hashCode in interface Multimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    See Also:
    Map.hashCode()
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableMultiset.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableMultiset.html index 3f3b358c61e4..d481de26a0f3 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableMultiset.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableMultiset.html @@ -253,7 +253,7 @@

    Method Summary

    boolean contains​(java.lang.Object object) -
    Returns true if this collection contains the specified element.
    +
    Determines whether this multiset contains the specified element.
    @@ -299,14 +299,14 @@

    Method Summary

    boolean equals​(java.lang.Object object) -
    Indicates whether some other object is "equal to" this one.
    +
    Compares the specified object with this multiset for equality.
    int hashCode() -
    Returns a hash code value for the object.
    +
    Returns the hash code for this multiset.
    @@ -437,9 +437,6 @@

    Method Summary

    java.lang.String toString() - -
    Returns a string representation of this collection.
    - @@ -770,11 +765,11 @@

    asList

    contains

    public boolean contains​(@CheckForNull
                         java.lang.Object object)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains the specified element. - More formally, returns true if and only if this collection - contains at least one element e such that - Objects.equals(o, e).
    +
    Description copied from interface: Multiset
    +
    Determines whether this multiset contains the specified element. + +

    This method refines Collection.contains(java.lang.Object) to further specify that it may not + throw an exception in response to element being null or of the wrong type.

    Specified by:
    contains in interface java.util.Collection<E>
    @@ -783,10 +778,9 @@

    contains

    Specified by:
    contains in class ImmutableCollection<E>
    Parameters:
    -
    object - element whose presence in this collection is to be tested
    +
    object - the element to check for
    Returns:
    -
    true if this collection contains the specified - element
    +
    true if this multiset contains at least one occurrence of the element
    @@ -921,45 +915,10 @@

    setCount

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object object)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    +
    Description copied from interface: Multiset
    +
    Compares the specified object with this multiset for equality. Returns true if the + given object is also a multiset and contains equal elements with equal counts, regardless of + order.
    Specified by:
    equals in interface java.util.Collection<E>
    @@ -967,14 +926,6 @@

    equals

    equals in interface Multiset<E>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -985,35 +936,15 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    +
    Description copied from interface: Multiset
    +
    Returns the hash code for this multiset. This is defined as the sum of + + 
    
+ ((element == null) ? 0 : element.hashCode()) ^ count(element)
+
    + +

    over all distinct elements in the multiset. It follows that a multiset and its entry set + always have the same hash code.

    Specified by:
    hashCode in interface java.util.Collection<E>
    @@ -1021,11 +952,6 @@

    hashCode

    hashCode in interface Multiset<E>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -1036,20 +962,17 @@

    hashCode

  • toString

    public java.lang.String toString()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns a string representation of this collection. The string - representation consists of a list of the collection's elements in the - order they are returned by its iterator, enclosed in square brackets - ("[]"). Adjacent elements are separated by the characters - ", " (comma and space). Elements are converted to strings as - by String.valueOf(Object).
    +
    Description copied from interface: Multiset
    +
    + +

    It is recommended, though not mandatory, that this method return the result of invoking + Multiset.toString() on the Multiset.entrySet(), yielding a result such as [a x 3, c, d x 2, + e].

    Specified by:
    toString in interface Multiset<E>
    Overrides:
    toString in class java.util.AbstractCollection<E>
    -
    Returns:
    -
    a string representation of this collection
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableRangeMap.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableRangeMap.html index 91e75ef76b29..9056477f8e69 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableRangeMap.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableRangeMap.html @@ -235,7 +235,7 @@

    Method Summary

    boolean equals​(java.lang.Object o) -
    Indicates whether some other object is "equal to" this one.
    +
    Returns true if obj is another RangeMap that has an equivalent RangeMap.asMapOfRanges().
    @@ -257,7 +257,7 @@

    Method Summary

    int hashCode() -
    Returns a hash code value for the object.
    +
    Returns asMapOfRanges().hashCode().
    @@ -352,7 +352,7 @@

    Method Summary

    java.lang.String toString() -
    Returns a string representation of the object.
    +
    Returns a readable string representation of this range map.
    @@ -700,45 +700,13 @@

    subRangeMap

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    +
    Description copied from interface: RangeMap
    +
    Returns asMapOfRanges().hashCode().
    Specified by:
    hashCode in interface RangeMap<K extends java.lang.Comparable<?>,​V>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -750,58 +718,13 @@

    hashCode

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object o)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    +
    Description copied from interface: RangeMap
    +
    Returns true if obj is another RangeMap that has an equivalent RangeMap.asMapOfRanges().
    Specified by:
    equals in interface RangeMap<K extends java.lang.Comparable<?>,​V>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    o - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -812,31 +735,13 @@

    equals

  • toString

    public java.lang.String toString()
    -
    Description copied from class: java.lang.Object
    -
    Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

    - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

    - 
    - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
    +
    Description copied from interface: RangeMap
    +
    Returns a readable string representation of this range map.
    Specified by:
    toString in interface RangeMap<K extends java.lang.Comparable<?>,​V>
    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableRangeSet.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableRangeSet.html index 93a0f2d9a7d7..4cf223049042 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableRangeSet.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableRangeSet.html @@ -315,14 +315,15 @@

    Method Summary

    boolean equals​(java.lang.Object obj) -
    Indicates whether some other object is "equal to" this one.
    +
    Returns true if obj is another RangeSet that contains the same ranges + according to Range.equals(Object).
    int hashCode() -
    Returns a hash code value for the object.
    +
    Returns asRanges().hashCode().
    @@ -423,7 +424,7 @@

    Method Summary

    java.lang.String toString() -
    Returns a string representation of the object.
    +
    Returns a readable string representation of this range set.
    @@ -975,58 +976,14 @@

    enclosesAll

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object obj)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    +
    Description copied from interface: RangeSet
    +
    Returns true if obj is another RangeSet that contains the same ranges + according to Range.equals(Object).
    Specified by:
    equals in interface RangeSet<C extends java.lang.Comparable>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -1037,45 +994,13 @@

    equals

  • hashCode

    public final int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    +
    Description copied from interface: RangeSet
    +
    Returns asRanges().hashCode().
    Specified by:
    hashCode in interface RangeSet<C extends java.lang.Comparable>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -1086,31 +1011,15 @@

    hashCode

  • toString

    public final java.lang.String toString()
    -
    Description copied from class: java.lang.Object
    -
    Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

    - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

    - 
    - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
    +
    Description copied from interface: RangeSet
    +
    Returns a readable string representation of this range set. For example, if this + RangeSet consisted of Range.closed(1, 3) and Range.greaterThan(4), this might + return " [1..3](4..+∞)"}.
    Specified by:
    toString in interface RangeSet<C extends java.lang.Comparable>
    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableSet.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableSet.html index b30aae7e182c..2108bdde0e36 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableSet.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableSet.html @@ -257,16 +257,12 @@

    Method Summary

    boolean equals​(java.lang.Object object) - -
    Indicates whether some other object is "equal to" this one.
    - +  int hashCode() - -
    Returns a hash code value for the object.
    - +  abstract UnmodifiableIterator<E> @@ -440,12 +436,6 @@

    of

    consistency, and because the return type conveys the immutability guarantee.

    Performance note: the instance returned is a singleton.

    -
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Returns:
    -
    an empty Set
    -
    @@ -459,14 +449,6 @@

    of

    public static <E> ImmutableSet<E> of​(E element)
    Returns an immutable set containing element. Preferred over Collections.singleton(T) for code consistency, null rejection, and because the return type conveys the immutability guarantee.
    -
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    element - the single element
    -
    Returns:
    -
    a Set containing the specified element
    -
    @@ -482,15 +464,6 @@

    of

    Returns an immutable set containing the given elements, minus duplicates, in the order each was first specified. That is, if multiple elements are equal, all except the first are ignored.
    -
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    Returns:
    -
    a Set containing the specified elements
    -
     @@ -507,16 +480,6 @@

    of

    Returns an immutable set containing the given elements, minus duplicates, in the order each was first specified. That is, if multiple elements are equal, all except the first are ignored.
    -
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    Returns:
    -
    a Set containing the specified elements
    -
     @@ -534,17 +497,6 @@

    of

    Returns an immutable set containing the given elements, minus duplicates, in the order each was first specified. That is, if multiple elements are equal, all except the first are ignored.
    -
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    e4 - the fourth element
    -
    Returns:
    -
    a Set containing the specified elements
    -
     @@ -563,18 +515,6 @@

    of

    Returns an immutable set containing the given elements, minus duplicates, in the order each was first specified. That is, if multiple elements are equal, all except the first are ignored.
    -
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    e4 - the fourth element
    -
    e5 - the fifth element
    -
    Returns:
    -
    a Set containing the specified elements
    -
     @@ -599,18 +539,6 @@

    of

    The array others must not be longer than Integer.MAX_VALUE - 6.

    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    e4 - the fourth element
    -
    e5 - the fifth element
    -
    e6 - the sixth element
    -
    others - the seventh element
    -
    Returns:
    -
    a Set containing the specified elements
    Since:
    3.0 (source-compatible since 2.0)
    @@ -631,12 +559,6 @@

    copyOf

    This reduces the expense of habitually making defensive copies at API boundaries. However, the precise conditions for skipping the copy operation are undefined.
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    elements - a Collection from which elements are drawn, must be non-null
    -
    Returns:
    -
    a Set containing the elements of the given Collection
    Throws:
    java.lang.NullPointerException - if any of elements is null
    Since:
    @@ -707,45 +629,6 @@

    copyOf

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object object)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    Specified by:
    equals in interface java.util.Collection<E>
    @@ -753,14 +636,6 @@

    equals

    equals in interface java.util.Set<E>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -771,35 +646,6 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    Specified by:
    hashCode in interface java.util.Collection<E>
    @@ -807,11 +653,6 @@

    hashCode

    hashCode in interface java.util.Set<E>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -833,8 +674,6 @@

    iterator

    iterator in interface java.util.Set<E>
    Specified by:
    iterator in class ImmutableCollection<E>
    -
    Returns:
    -
    an iterator over the elements contained in this collection
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableSetMultimap.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableSetMultimap.html index 4b2962623aa2..283c89ebe97c 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableSetMultimap.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableSetMultimap.html @@ -249,7 +249,7 @@

    Method Summary

    boolean equals​(java.lang.Object object) -
    Indicates whether some other object is "equal to" this one.
    +
    Compares the specified object with this multimap for equality.
    @@ -838,58 +838,23 @@

    containsEntry

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object object)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    +
    Description copied from interface: Multimap
    +
    Compares the specified object with this multimap for equality. Two multimaps are equal when + their map views, as returned by Multimap.asMap(), are also equal. + +

    In general, two multimaps with identical key-value mappings may or may not be equal, + depending on the implementation. For example, two SetMultimap instances with the same + key-value mappings are equal, but equality of two ListMultimap instances depends on the + ordering of the values for each key. + +

    A non-empty SetMultimap cannot be equal to a non-empty ListMultimap, since + their Multimap.asMap() views contain unequal collections as values. However, any two empty + multimaps are equal, because they both have empty Multimap.asMap() views.

    Specified by:
    equals in interface Multimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -909,8 +874,6 @@

    hashCode

    hashCode in interface Multimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    See Also:
    Map.hashCode()
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableSortedMap.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableSortedMap.html index a8e88bf05e90..29745f448a8a 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableSortedMap.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableSortedMap.html @@ -197,7 +197,7 @@

    Nested Class Summary

    Nested classes/interfaces inherited from interface java.util.Map

    -java.util.Map.Entry<K,​V> +java.util.Map.Entry<K extends java.lang.Object,​V extends java.lang.Object> @@ -237,19 +237,12 @@

    Method Summary

    java.util.Map.Entry<K,​V> ceilingEntry​(K key) - -
    Returns a key-value mapping associated with the least key - greater than or equal to the given key, or null if - there is no such key.
    - +  K ceilingKey​(K key) - -
    Returns the least key greater than or equal to the given key, - or null if there is no such key.
    - +  java.util.Comparator<? super K> @@ -304,16 +297,12 @@

    Method Summary

    ImmutableSortedSet<K> descendingKeySet() - -
    Returns a reverse order NavigableSet view of the keys contained in this map.
    - +  ImmutableSortedMap<K,​V> descendingMap() - -
    Returns a reverse order view of the mappings contained in this map.
    - +  ImmutableSet<java.util.Map.Entry<K,​V>> @@ -325,50 +314,32 @@

    Method Summary

    java.util.Map.Entry<K,​V> firstEntry() - -
    Returns a key-value mapping associated with the least - key in this map, or null if the map is empty.
    - +  K firstKey() - -
    Returns the first (lowest) key currently in this map.
    - +  java.util.Map.Entry<K,​V> floorEntry​(K key) - -
    Returns a key-value mapping associated with the greatest key - less than or equal to the given key, or null if there - is no such key.
    - +  K floorKey​(K key) - -
    Returns the greatest key less than or equal to the given key, - or null if there is no such key.
    - +  void forEach​(java.util.function.BiConsumer<? super K,​? super V> action) - -
    Performs the given action for each entry in this map until all entries - have been processed or the action throws an exception.
    - +  V get​(java.lang.Object key) - -
    Returns the value to which the specified key is mapped, - or null if this map contains no mapping for the key.
    - +  ImmutableSortedMap<K,​V> @@ -390,19 +361,12 @@

    Method Summary

    java.util.Map.Entry<K,​V> higherEntry​(K key) - -
    Returns a key-value mapping associated with the least key - strictly greater than the given key, or null if there - is no such key.
    - +  K higherKey​(K key) - -
    Returns the least key strictly greater than the given key, or - null if there is no such key.
    - +  ImmutableSortedSet<K> @@ -414,34 +378,22 @@

    Method Summary

    java.util.Map.Entry<K,​V> lastEntry() - -
    Returns a key-value mapping associated with the greatest - key in this map, or null if the map is empty.
    - +  K lastKey() - -
    Returns the last (highest) key currently in this map.
    - +  java.util.Map.Entry<K,​V> lowerEntry​(K key) - -
    Returns a key-value mapping associated with the greatest key - strictly less than the given key, or null if there is - no such key.
    - +  K lowerKey​(K key) - -
    Returns the greatest key strictly less than the given key, or - null if there is no such key.
    - +  static <K extends java.lang.Comparable<?>,​V>
    ImmutableSortedMap.Builder<K,​V>     @@ -454,9 +406,7 @@

    Method Summary

    ImmutableSortedSet<K> navigableKeySet() - -
    Returns a NavigableSet view of the keys contained in this map.
    - +  static <K,​V>
    ImmutableSortedMap<K,​V>     @@ -886,9 +836,7 @@

    Method Summary

    int size() - -
    Returns the number of key-value mappings in this map.
    - +  ImmutableSortedMap<K,​V> @@ -1074,13 +1022,6 @@

    of

    Returns the empty sorted map.

    Performance note: the instance returned is a singleton.

    -
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Returns:
    -
    an empty Map
    -
    @@ -1094,16 +1035,6 @@

    of

    public static <K extends java.lang.Comparable<? super K>,​V> ImmutableSortedMap<K,​V> of​(K k1,
                                                                                                    V v1)
    Returns an immutable map containing a single entry.
    -
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the mapping's key
    -
    v1 - the mapping's value
    -
    Returns:
    -
    a Map containing the specified mapping
    -
    @@ -1121,16 +1052,6 @@

    of

    Returns an immutable sorted map containing the given entries, sorted by the natural ordering of their keys.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if the two keys are equal according to their natural ordering
    @@ -1153,18 +1074,6 @@

    of

    Returns an immutable sorted map containing the given entries, sorted by the natural ordering of their keys.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if any two keys are equal according to their natural ordering
    @@ -1189,20 +1098,6 @@

    of

    Returns an immutable sorted map containing the given entries, sorted by the natural ordering of their keys.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if any two keys are equal according to their natural ordering
    @@ -1229,22 +1124,6 @@

    of

    Returns an immutable sorted map containing the given entries, sorted by the natural ordering of their keys.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if any two keys are equal according to their natural ordering
    @@ -1273,24 +1152,6 @@

    of

    Returns an immutable sorted map containing the given entries, sorted by the natural ordering of their keys.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    k6 - the sixth mapping's key
    -
    v6 - the sixth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if any two keys are equal according to their natural ordering
    Since:
    @@ -1323,26 +1184,6 @@

    of

    Returns an immutable sorted map containing the given entries, sorted by the natural ordering of their keys.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    k6 - the sixth mapping's key
    -
    v6 - the sixth mapping's value
    -
    k7 - the seventh mapping's key
    -
    v7 - the seventh mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if any two keys are equal according to their natural ordering
    Since:
    @@ -1377,28 +1218,6 @@

    of

    Returns an immutable sorted map containing the given entries, sorted by the natural ordering of their keys.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    k6 - the sixth mapping's key
    -
    v6 - the sixth mapping's value
    -
    k7 - the seventh mapping's key
    -
    v7 - the seventh mapping's value
    -
    k8 - the eighth mapping's key
    -
    v8 - the eighth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if any two keys are equal according to their natural ordering
    Since:
    @@ -1435,30 +1254,6 @@

    of

    Returns an immutable sorted map containing the given entries, sorted by the natural ordering of their keys.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    k6 - the sixth mapping's key
    -
    v6 - the sixth mapping's value
    -
    k7 - the seventh mapping's key
    -
    v7 - the seventh mapping's value
    -
    k8 - the eighth mapping's key
    -
    v8 - the eighth mapping's value
    -
    k9 - the ninth mapping's key
    -
    v9 - the ninth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if any two keys are equal according to their natural ordering
    Since:
    @@ -1497,32 +1292,6 @@

    of

    Returns an immutable sorted map containing the given entries, sorted by the natural ordering of their keys.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    k6 - the sixth mapping's key
    -
    v6 - the sixth mapping's value
    -
    k7 - the seventh mapping's key
    -
    v7 - the seventh mapping's value
    -
    k8 - the eighth mapping's key
    -
    v8 - the eighth mapping's value
    -
    k9 - the ninth mapping's key
    -
    v9 - the ninth mapping's value
    -
    k10 - the tenth mapping's key
    -
    v10 - the tenth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.IllegalArgumentException - if any two keys are equal according to their natural ordering
    Since:
    @@ -1547,13 +1316,6 @@

    copyOf

    This method is not type-safe, as it may be called on a map with keys that are not mutually comparable.

    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    map - a Map from which entries are drawn, must be non-null
    -
    Returns:
    -
    a Map containing the entries of the given Map
    Throws:
    java.lang.ClassCastException - if the keys in map are not mutually comparable
    java.lang.NullPointerException - if any key or value in map is null
    @@ -1689,15 +1451,9 @@

    reverseOrder

  • size

    public int size()
    -
    Description copied from interface: java.util.Map
    -
    Returns the number of key-value mappings in this map. If the - map contains more than Integer.MAX_VALUE elements, returns - Integer.MAX_VALUE.
    Specified by:
    size in interface java.util.Map<K,​V>
    -
    Returns:
    -
    the number of key-value mappings in this map
    • @@ -1708,17 +1464,9 @@

    size

  • forEach

    public void forEach​(java.util.function.BiConsumer<? super K,​? super V> action)
    -
    Description copied from interface: java.util.Map
    -
    Performs the given action for each entry in this map until all entries - have been processed or the action throws an exception. Unless - otherwise specified by the implementing class, actions are performed in - the order of entry set iteration (if an iteration order is specified.) - Exceptions thrown by the action are relayed to the caller.
    Specified by:
    forEach in interface java.util.Map<K,​V>
    -
    Parameters:
    -
    action - The action to be performed for each entry
    • @@ -1731,30 +1479,11 @@

    get

    @CheckForNull
 public V get​(@CheckForNull
              java.lang.Object key)
    -
    Description copied from interface: java.util.Map
    -
    Returns the value to which the specified key is mapped, - or null if this map contains no mapping for the key. - -

    More formally, if this map contains a mapping from a key - k to a value v such that - Objects.equals(key, k), - then this method returns v; otherwise - it returns null. (There can be at most one such mapping.) - -

    If this map permits null values, then a return value of - null does not necessarily indicate that the map - contains no mapping for the key; it's also possible that the map - explicitly maps the key to null. The containsKey operation may be used to distinguish these two cases.

    Specified by:
    get in interface java.util.Map<K,​V>
    Specified by:
    get in class ImmutableMap<K,​V>
    -
    Parameters:
    -
    key - the key whose associated value is to be returned
    -
    Returns:
    -
    the value to which the specified key is mapped, or - null if this map contains no mapping for the key
    @@ -1773,8 +1502,6 @@

    entrySet

    entrySet in interface java.util.SortedMap<K,​V>
    Overrides:
    entrySet in class ImmutableMap<K,​V>
    -
    Returns:
    -
    a set view of the mappings contained in this map
    @@ -1793,8 +1520,6 @@

    keySet

    keySet in interface java.util.SortedMap<K,​V>
    Overrides:
    keySet in class ImmutableMap<K,​V>
    -
    Returns:
    -
    a set view of the keys contained in this map
    @@ -1814,8 +1539,6 @@

    values

    values in interface java.util.SortedMap<K,​V>
    Overrides:
    values in class ImmutableMap<K,​V>
    -
    Returns:
    -
    a collection view of the values contained in this map
    @@ -1831,10 +1554,6 @@

    comparator

    Specified by:
    comparator in interface java.util.SortedMap<K,​V>
    -
    Returns:
    -
    the comparator used to order the keys in this map, - or null if this map uses the natural ordering - of its keys
    @@ -1845,13 +1564,9 @@

    comparator

  • firstKey

    public K firstKey()
    -
    Description copied from interface: java.util.SortedMap
    -
    Returns the first (lowest) key currently in this map.
    Specified by:
    firstKey in interface java.util.SortedMap<K,​V>
    -
    Returns:
    -
    the first (lowest) key currently in this map
    • @@ -1862,13 +1577,9 @@

    firstKey

  • lastKey

    public K lastKey()
    -
    Description copied from interface: java.util.SortedMap
    -
    Returns the last (highest) key currently in this map.
    Specified by:
    lastKey in interface java.util.SortedMap<K,​V>
    -
    Returns:
    -
    the last (highest) key currently in this map
    • @@ -1893,11 +1604,6 @@

    headMap

    headMap in interface java.util.NavigableMap<K,​V>
    Specified by:
    headMap in interface java.util.SortedMap<K,​V>
    -
    Parameters:
    -
    toKey - high endpoint (exclusive) of the keys in the returned map
    -
    Returns:
    -
    a view of the portion of this map whose keys are strictly - less than toKey
    @@ -1921,13 +1627,6 @@

    headMap

    Specified by:
    headMap in interface java.util.NavigableMap<K,​V>
    -
    Parameters:
    -
    toKey - high endpoint of the keys in the returned map
    -
    inclusive - true if the high endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this map whose keys are less than - (or equal to, if inclusive is true) toKey
    Since:
    12.0
    @@ -1955,12 +1654,6 @@

    subMap

    subMap in interface java.util.NavigableMap<K,​V>
    Specified by:
    subMap in interface java.util.SortedMap<K,​V>
    -
    Parameters:
    -
    fromKey - low endpoint (inclusive) of the keys in the returned map
    -
    toKey - high endpoint (exclusive) of the keys in the returned map
    -
    Returns:
    -
    a view of the portion of this map whose keys range from - fromKey, inclusive, to toKey, exclusive
    @@ -1987,16 +1680,6 @@

    subMap

    Specified by:
    subMap in interface java.util.NavigableMap<K,​V>
    -
    Parameters:
    -
    fromKey - low endpoint of the keys in the returned map
    -
    fromInclusive - true if the low endpoint - is to be included in the returned view
    -
    toKey - high endpoint of the keys in the returned map
    -
    toInclusive - true if the high endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this map whose keys range from - fromKey to toKey
    Since:
    12.0
    @@ -2023,11 +1706,6 @@

    tailMap

    tailMap in interface java.util.NavigableMap<K,​V>
    Specified by:
    tailMap in interface java.util.SortedMap<K,​V>
    -
    Parameters:
    -
    fromKey - low endpoint (inclusive) of the keys in the returned map
    -
    Returns:
    -
    a view of the portion of this map whose keys are greater - than or equal to fromKey
    @@ -2051,13 +1729,6 @@

    tailMap

    Specified by:
    tailMap in interface java.util.NavigableMap<K,​V>
    -
    Parameters:
    -
    fromKey - low endpoint of the keys in the returned map
    -
    inclusive - true if the low endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this map whose keys are greater than - (or equal to, if inclusive is true) fromKey
    Since:
    12.0
    @@ -2073,18 +1744,9 @@

    tailMap

    lowerEntry

    @CheckForNull
 public java.util.Map.Entry<K,​V> lowerEntry​(K key)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a key-value mapping associated with the greatest key - strictly less than the given key, or null if there is - no such key.
    Specified by:
    lowerEntry in interface java.util.NavigableMap<K,​V>
    -
    Parameters:
    -
    key - the key
    -
    Returns:
    -
    an entry with the greatest key less than key, - or null if there is no such key
    @@ -2098,17 +1760,9 @@

    lowerEntry

    lowerKey

    @CheckForNull
 public K lowerKey​(K key)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns the greatest key strictly less than the given key, or - null if there is no such key.
    Specified by:
    lowerKey in interface java.util.NavigableMap<K,​V>
    -
    Parameters:
    -
    key - the key
    -
    Returns:
    -
    the greatest key less than key, - or null if there is no such key
    @@ -2122,18 +1776,9 @@

    lowerKey

    floorEntry

    @CheckForNull
 public java.util.Map.Entry<K,​V> floorEntry​(K key)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a key-value mapping associated with the greatest key - less than or equal to the given key, or null if there - is no such key.
    Specified by:
    floorEntry in interface java.util.NavigableMap<K,​V>
    -
    Parameters:
    -
    key - the key
    -
    Returns:
    -
    an entry with the greatest key less than or equal to - key, or null if there is no such key
    @@ -2147,17 +1792,9 @@

    floorEntry

    floorKey

    @CheckForNull
 public K floorKey​(K key)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns the greatest key less than or equal to the given key, - or null if there is no such key.
    Specified by:
    floorKey in interface java.util.NavigableMap<K,​V>
    -
    Parameters:
    -
    key - the key
    -
    Returns:
    -
    the greatest key less than or equal to key, - or null if there is no such key
    @@ -2171,18 +1808,9 @@

    floorKey

    ceilingEntry

    @CheckForNull
 public java.util.Map.Entry<K,​V> ceilingEntry​(K key)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a key-value mapping associated with the least key - greater than or equal to the given key, or null if - there is no such key.
    Specified by:
    ceilingEntry in interface java.util.NavigableMap<K,​V>
    -
    Parameters:
    -
    key - the key
    -
    Returns:
    -
    an entry with the least key greater than or equal to - key, or null if there is no such key
    @@ -2196,17 +1824,9 @@

    ceilingEntry

    ceilingKey

    @CheckForNull
 public K ceilingKey​(K key)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns the least key greater than or equal to the given key, - or null if there is no such key.
    Specified by:
    ceilingKey in interface java.util.NavigableMap<K,​V>
    -
    Parameters:
    -
    key - the key
    -
    Returns:
    -
    the least key greater than or equal to key, - or null if there is no such key
    @@ -2220,18 +1840,9 @@

    ceilingKey

    higherEntry

    @CheckForNull
 public java.util.Map.Entry<K,​V> higherEntry​(K key)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a key-value mapping associated with the least key - strictly greater than the given key, or null if there - is no such key.
    Specified by:
    higherEntry in interface java.util.NavigableMap<K,​V>
    -
    Parameters:
    -
    key - the key
    -
    Returns:
    -
    an entry with the least key greater than key, - or null if there is no such key
    @@ -2245,17 +1856,9 @@

    higherEntry

    higherKey

    @CheckForNull
 public K higherKey​(K key)
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns the least key strictly greater than the given key, or - null if there is no such key.
    Specified by:
    higherKey in interface java.util.NavigableMap<K,​V>
    -
    Parameters:
    -
    key - the key
    -
    Returns:
    -
    the least key greater than key, - or null if there is no such key
    @@ -2267,15 +1870,9 @@

    higherKey

    firstEntry

    @CheckForNull
 public java.util.Map.Entry<K,​V> firstEntry()
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a key-value mapping associated with the least - key in this map, or null if the map is empty.
    Specified by:
    firstEntry in interface java.util.NavigableMap<K,​V>
    -
    Returns:
    -
    an entry with the least key, - or null if this map is empty
    @@ -2287,15 +1884,9 @@

    firstEntry

    lastEntry

    @CheckForNull
 public java.util.Map.Entry<K,​V> lastEntry()
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a key-value mapping associated with the greatest - key in this map, or null if the map is empty.
    Specified by:
    lastEntry in interface java.util.NavigableMap<K,​V>
    -
    Returns:
    -
    an entry with the greatest key, - or null if this map is empty
    @@ -2316,9 +1907,6 @@

    pollFirstEntry

    Specified by:
    pollFirstEntry in interface java.util.NavigableMap<K,​V>
    -
    Returns:
    -
    the removed first entry of this map, - or null if this map is empty
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -2341,9 +1929,6 @@

    pollLastEntry

    Specified by:
    pollLastEntry in interface java.util.NavigableMap<K,​V>
    -
    Returns:
    -
    the removed last entry of this map, - or null if this map is empty
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -2356,23 +1941,9 @@

    pollLastEntry

  • descendingMap

    public ImmutableSortedMap<K,​V> descendingMap()
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a reverse order view of the mappings contained in this map. - The descending map is backed by this map, so changes to the map are - reflected in the descending map, and vice-versa. If either map is - modified while an iteration over a collection view of either map - is in progress (except through the iterator's own remove - operation), the results of the iteration are undefined. - -

    The returned map has an ordering equivalent to - Collections.reverseOrder(comparator()). - The expression m.descendingMap().descendingMap() returns a - view of m essentially equivalent to m.

    Specified by:
    descendingMap in interface java.util.NavigableMap<K,​V>
    -
    Returns:
    -
    a reverse order view of this map
    • @@ -2383,22 +1954,9 @@

    descendingMap

  • navigableKeySet

    public ImmutableSortedSet<K> navigableKeySet()
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a NavigableSet view of the keys contained in this map. - The set's iterator returns the keys in ascending order. - The set is backed by the map, so changes to the map are reflected in - the set, and vice-versa. If the map is modified while an iteration - over the set is in progress (except through the iterator's own - remove operation), the results of the iteration are undefined. The - set supports element removal, which removes the corresponding mapping - from the map, via the Iterator.remove, Set.remove, - removeAll, retainAll, and clear operations. - It does not support the add or addAll operations.
    Specified by:
    navigableKeySet in interface java.util.NavigableMap<K,​V>
    -
    Returns:
    -
    a navigable set view of the keys in this map
    • @@ -2409,22 +1967,9 @@

    navigableKeySet

  • descendingKeySet

    public ImmutableSortedSet<K> descendingKeySet()
    -
    Description copied from interface: java.util.NavigableMap
    -
    Returns a reverse order NavigableSet view of the keys contained in this map. - The set's iterator returns the keys in descending order. - The set is backed by the map, so changes to the map are reflected in - the set, and vice-versa. If the map is modified while an iteration - over the set is in progress (except through the iterator's own - remove operation), the results of the iteration are undefined. The - set supports element removal, which removes the corresponding mapping - from the map, via the Iterator.remove, Set.remove, - removeAll, retainAll, and clear operations. - It does not support the add or addAll operations.
    Specified by:
    descendingKeySet in interface java.util.NavigableMap<K,​V>
    -
    Returns:
    -
    a reverse order navigable set view of the keys in this map
    • @@ -2527,14 +2072,6 @@

    of

    key. Proper calls will resolve to the version in ImmutableSortedMap, not this dummy version.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the mapping's key
    -
    v1 - the mapping's value
    -
    Returns:
    -
    a Map containing the specified mapping
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -2560,16 +2097,6 @@

    of

    keys. Proper calls will resolve to the version in ImmutableSortedMap, not this dummy version.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -2597,18 +2124,6 @@

    of

    keys. Proper calls to will resolve to the version in ImmutableSortedMap, not this dummy version.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -2639,20 +2154,6 @@

    of

    keys. Proper calls will resolve to the version in ImmutableSortedMap, not this dummy version.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -2685,22 +2186,6 @@

    of

    keys. Proper calls will resolve to the version in ImmutableSortedMap, not this dummy version.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -2735,24 +2220,6 @@

    of

    keys. Proper calls will resolve to the version in ImmutableSortedMap, not this dummy version.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    k6 - the sixth mapping's key
    -
    v6 - the sixth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -2789,26 +2256,6 @@

    of

    keys. Proper calls will resolve to the version in ImmutableSortedMap, not this dummy version.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    k6 - the sixth mapping's key
    -
    v6 - the sixth mapping's value
    -
    k7 - the seventh mapping's key
    -
    v7 - the seventh mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -2847,28 +2294,6 @@

    of

    keys. Proper calls will resolve to the version in ImmutableSortedMap, not this dummy version.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    k6 - the sixth mapping's key
    -
    v6 - the sixth mapping's value
    -
    k7 - the seventh mapping's key
    -
    v7 - the seventh mapping's value
    -
    k8 - the eighth mapping's key
    -
    v8 - the eighth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -2909,30 +2334,6 @@

    of

    keys. Proper calls will resolve to the version in ImmutableSortedMap, not this dummy version.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    k6 - the sixth mapping's key
    -
    v6 - the sixth mapping's value
    -
    k7 - the seventh mapping's key
    -
    v7 - the seventh mapping's value
    -
    k8 - the eighth mapping's key
    -
    v8 - the eighth mapping's value
    -
    k9 - the ninth mapping's key
    -
    v9 - the ninth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -2975,32 +2376,6 @@

    of

    keys. Proper calls will resolve to the version in ImmutableSortedMap, not this dummy version.
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    k1 - the first mapping's key
    -
    v1 - the first mapping's value
    -
    k2 - the second mapping's key
    -
    v2 - the second mapping's value
    -
    k3 - the third mapping's key
    -
    v3 - the third mapping's value
    -
    k4 - the fourth mapping's key
    -
    v4 - the fourth mapping's value
    -
    k5 - the fifth mapping's key
    -
    v5 - the fifth mapping's value
    -
    k6 - the sixth mapping's key
    -
    v6 - the sixth mapping's value
    -
    k7 - the seventh mapping's key
    -
    v7 - the seventh mapping's value
    -
    k8 - the eighth mapping's key
    -
    v8 - the eighth mapping's value
    -
    k9 - the ninth mapping's key
    -
    v9 - the ninth mapping's value
    -
    k10 - the tenth mapping's key
    -
    v10 - the tenth mapping's value
    -
    Returns:
    -
    a Map containing the specified mappings
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -3018,17 +2393,6 @@

    ofEntries

    Use ImmutableSortedMap.copyOf(ImmutableMap.ofEntries(...)).
    Not supported. Use ImmutableSortedMap.copyOf(ImmutableMap.ofEntries(...)).
    -
    -
    Type Parameters:
    -
    K - the Map's key type
    -
    V - the Map's value type
    -
    Parameters:
    -
    entries - Map.Entrys containing the keys and values from which the map is populated
    -
    Returns:
    -
    a Map containing the specified mappings
    -
    See Also:
    -
    Map.entry()
    -
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableSortedSet.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableSortedSet.html index 58105020f599..0cba51cd9922 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableSortedSet.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableSortedSet.html @@ -252,10 +252,7 @@

    Method Summary

    E ceiling​(E e) - -
    Returns the least element in this set greater than or equal to - the given element, or null if there is no such element.
    - +  java.util.Comparator<? super E> @@ -340,56 +337,37 @@

    Method Summary

    abstract UnmodifiableIterator<E> descendingIterator() - -
    Returns an iterator over the elements in this set, in descending order.
    - +  ImmutableSortedSet<E> descendingSet() - -
    Returns a reverse order view of the elements contained in this set.
    - +  E first() - -
    Returns the first (lowest) element currently in this set.
    - +  E floor​(E e) - -
    Returns the greatest element in this set less than or equal to - the given element, or null if there is no such element.
    - +  ImmutableSortedSet<E> headSet​(E toElement) - -
    Returns a view of the portion of this set whose elements are - strictly less than toElement.
    - ImmutableSortedSet<E> headSet​(E toElement, boolean inclusive) - -
    Returns a view of the portion of this set whose elements are less than - (or equal to, if inclusive is true) toElement.
    - +  E higher​(E e) - -
    Returns the least element in this set strictly greater than the - given element, or null if there is no such element.
    - +  abstract UnmodifiableIterator<E> @@ -401,17 +379,12 @@

    Method Summary

    E last() - -
    Returns the last (highest) element currently in this set.
    - +  E lower​(E e) - -
    Returns the greatest element in this set strictly less than the - given element, or null if there is no such element.
    - +  static <E extends java.lang.Comparable<?>>
    ImmutableSortedSet.Builder<E>     @@ -593,9 +566,7 @@

    Method Summary

    java.util.Spliterator<E> spliterator() - -
    Creates a Spliterator over the elements in this collection.
    - +  ImmutableSortedSet<E> @@ -603,37 +574,22 @@

    Method Summary

    boolean fromInclusive, E toElement, boolean toInclusive) - -
    Returns a view of the portion of this set whose elements range from - fromElement to toElement.
    - +  ImmutableSortedSet<E> subSet​(E fromElement, E toElement) - -
    Returns a view of the portion of this set whose elements range - from fromElement, inclusive, to toElement, - exclusive.
    - ImmutableSortedSet<E> tailSet​(E fromElement) - -
    Returns a view of the portion of this set whose elements are - greater than or equal to fromElement.
    - ImmutableSortedSet<E> tailSet​(E fromElement, boolean inclusive) - -
    Returns a view of the portion of this set whose elements are greater - than (or equal to, if inclusive is true) fromElement.
    - +  static <E> java.util.stream.Collector<E,​?,​ImmutableSet<E>> @@ -746,12 +702,6 @@

    of

    Returns the empty immutable sorted set.

    Performance note: the instance returned is a singleton.

    -
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Returns:
    -
    an empty Set
    -
    @@ -764,14 +714,6 @@

    of

    of

    public static <E extends java.lang.Comparable<? super E>> ImmutableSortedSet<E> of​(E element)
    Returns an immutable sorted set containing a single element.
    -
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    element - the single element
    -
    Returns:
    -
    a Set containing the specified element
    -
    @@ -788,13 +730,6 @@

    of

    When multiple elements are equivalent according to Comparable.compareTo(T), only the first one specified is included.
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    Returns:
    -
    a Set containing the specified elements
    Throws:
    java.lang.NullPointerException - if any element is null
    @@ -815,14 +750,6 @@

    of

    When multiple elements are equivalent according to Comparable.compareTo(T), only the first one specified is included.
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    Returns:
    -
    a Set containing the specified elements
    Throws:
    java.lang.NullPointerException - if any element is null
    @@ -844,15 +771,6 @@

    of

    When multiple elements are equivalent according to Comparable.compareTo(T), only the first one specified is included.
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    e4 - the fourth element
    -
    Returns:
    -
    a Set containing the specified elements
    Throws:
    java.lang.NullPointerException - if any element is null
    @@ -875,16 +793,6 @@

    of

    When multiple elements are equivalent according to Comparable.compareTo(T), only the first one specified is included.
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    e4 - the fourth element
    -
    e5 - the fifth element
    -
    Returns:
    -
    a Set containing the specified elements
    Throws:
    java.lang.NullPointerException - if any element is null
    @@ -909,18 +817,6 @@

    of

    When multiple elements are equivalent according to Comparable.compareTo(T), only the first one specified is included.
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    e4 - the fourth element
    -
    e5 - the fifth element
    -
    e6 - the sixth element
    -
    remaining - the seventh element
    -
    Returns:
    -
    a Set containing the specified elements
    Throws:
    java.lang.NullPointerException - if any element is null
    Since:
    @@ -1004,12 +900,6 @@

    copyOf

    This method is safe to use even when elements is a synchronized or concurrent collection that is currently being modified by another thread.

    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    elements - a Collection from which elements are drawn, must be non-null
    -
    Returns:
    -
    a Set containing the elements of the given Collection
    Throws:
    java.lang.ClassCastException - if the elements are not mutually comparable
    java.lang.NullPointerException - if any of elements is null
    @@ -1178,10 +1068,6 @@

    comparator

    Specified by:
    comparator in interface java.util.SortedSet<E>
    -
    Returns:
    -
    the comparator used to order the elements in this set, - or null if this set uses the natural ordering - of its elements
    @@ -1205,8 +1091,6 @@

    iterator

    iterator in interface java.util.Set<E>
    Specified by:
    iterator in class ImmutableSet<E>
    -
    Returns:
    -
    an iterator over the elements contained in this collection
    @@ -1219,16 +1103,7 @@

    iterator

  • headSet

    public ImmutableSortedSet<E> headSet​(E toElement)
    -
    Returns a view of the portion of this set whose elements are - strictly less than toElement. The returned set is - backed by this set, so changes in the returned set are - reflected in this set, and vice-versa. The returned set - supports all optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range. - -

    Equivalent to headSet(toElement, false). +

    This method returns a serializable ImmutableSortedSet. @@ -1241,11 +1116,6 @@

    headSet

    headSet in interface java.util.NavigableSet<E>
    Specified by:
    headSet in interface java.util.SortedSet<E>
    -
    Parameters:
    -
    toElement - high endpoint (exclusive) of the returned set
    -
    Returns:
    -
    a view of the portion of this set whose elements are strictly - less than toElement
    • @@ -1259,25 +1129,9 @@

    headSet

    headSet

    public ImmutableSortedSet<E> headSet​(E toElement,
                                      boolean inclusive)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns a view of the portion of this set whose elements are less than - (or equal to, if inclusive is true) toElement. The - returned set is backed by this set, so changes in the returned set are - reflected in this set, and vice-versa. The returned set supports all - optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    headSet in interface java.util.NavigableSet<E>
    -
    Parameters:
    -
    toElement - high endpoint of the returned set
    -
    inclusive - true if the high endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this set whose elements are less than - (or equal to, if inclusive is true) toElement
    Since:
    12.0
    @@ -1293,18 +1147,7 @@

    headSet

    subSet

    public ImmutableSortedSet<E> subSet​(E fromElement,
                                     E toElement)
    -
    Returns a view of the portion of this set whose elements range - from fromElement, inclusive, to toElement, - exclusive. (If fromElement and toElement are - equal, the returned set is empty.) The returned set is backed - by this set, so changes in the returned set are reflected in - this set, and vice-versa. The returned set supports all - optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range. - -

    Equivalent to subSet(fromElement, true, toElement, false). +

    This method returns a serializable ImmutableSortedSet. @@ -1318,12 +1161,6 @@

    subSet

    subSet in interface java.util.NavigableSet<E>
    Specified by:
    subSet in interface java.util.SortedSet<E>
    -
    Parameters:
    -
    fromElement - low endpoint (inclusive) of the returned set
    -
    toElement - high endpoint (exclusive) of the returned set
    -
    Returns:
    -
    a view of the portion of this set whose elements range from - fromElement, inclusive, to toElement, exclusive
    @@ -1340,30 +1177,9 @@

    subSet

    boolean fromInclusive, E toElement, boolean toInclusive) -
    Description copied from interface: java.util.NavigableSet
    -
    Returns a view of the portion of this set whose elements range from - fromElement to toElement. If fromElement and - toElement are equal, the returned set is empty unless - fromInclusive and toInclusive are both true. The returned set - is backed by this set, so changes in the returned set are reflected in - this set, and vice-versa. The returned set supports all optional set - operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    subSet in interface java.util.NavigableSet<E>
    -
    Parameters:
    -
    fromElement - low endpoint of the returned set
    -
    fromInclusive - true if the low endpoint - is to be included in the returned view
    -
    toElement - high endpoint of the returned set
    -
    toInclusive - true if the high endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this set whose elements range from - fromElement, inclusive, to toElement, exclusive
    Since:
    12.0
    @@ -1378,16 +1194,7 @@

    subSet

  • tailSet

    public ImmutableSortedSet<E> tailSet​(E fromElement)
    -
    Returns a view of the portion of this set whose elements are - greater than or equal to fromElement. The returned - set is backed by this set, so changes in the returned set are - reflected in this set, and vice-versa. The returned set - supports all optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range. - -

    Equivalent to tailSet(fromElement, true). +

    This method returns a serializable ImmutableSortedSet. @@ -1400,11 +1207,6 @@

    tailSet

    tailSet in interface java.util.NavigableSet<E>
    Specified by:
    tailSet in interface java.util.SortedSet<E>
    -
    Parameters:
    -
    fromElement - low endpoint (inclusive) of the returned set
    -
    Returns:
    -
    a view of the portion of this set whose elements are greater - than or equal to fromElement
    • @@ -1418,25 +1220,9 @@

    tailSet

    tailSet

    public ImmutableSortedSet<E> tailSet​(E fromElement,
                                      boolean inclusive)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns a view of the portion of this set whose elements are greater - than (or equal to, if inclusive is true) fromElement. - The returned set is backed by this set, so changes in the returned set - are reflected in this set, and vice-versa. The returned set supports - all optional set operations that this set supports. - -

    The returned set will throw an IllegalArgumentException - on an attempt to insert an element outside its range.

    Specified by:
    tailSet in interface java.util.NavigableSet<E>
    -
    Parameters:
    -
    fromElement - low endpoint of the returned set
    -
    inclusive - true if the low endpoint - is to be included in the returned view
    -
    Returns:
    -
    a view of the portion of this set whose elements are greater - than or equal to fromElement
    Since:
    12.0
    @@ -1453,17 +1239,9 @@

    lower

    @GwtIncompatible
 @CheckForNull
 public E lower​(E e)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns the greatest element in this set strictly less than the - given element, or null if there is no such element.
    Specified by:
    lower in interface java.util.NavigableSet<E>
    -
    Parameters:
    -
    e - the value to match
    -
    Returns:
    -
    the greatest element less than e, - or null if there is no such element
    Since:
    12.0
    @@ -1479,17 +1257,9 @@

    lower

    floor

    @CheckForNull
 public E floor​(E e)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns the greatest element in this set less than or equal to - the given element, or null if there is no such element.
    Specified by:
    floor in interface java.util.NavigableSet<E>
    -
    Parameters:
    -
    e - the value to match
    -
    Returns:
    -
    the greatest element less than or equal to e, - or null if there is no such element
    Since:
    12.0
    @@ -1505,17 +1275,9 @@

    floor

    ceiling

    @CheckForNull
 public E ceiling​(E e)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns the least element in this set greater than or equal to - the given element, or null if there is no such element.
    Specified by:
    ceiling in interface java.util.NavigableSet<E>
    -
    Parameters:
    -
    e - the value to match
    -
    Returns:
    -
    the least element greater than or equal to e, - or null if there is no such element
    Since:
    12.0
    @@ -1532,17 +1294,9 @@

    higher

    @GwtIncompatible
 @CheckForNull
 public E higher​(E e)
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns the least element in this set strictly greater than the - given element, or null if there is no such element.
    Specified by:
    higher in interface java.util.NavigableSet<E>
    -
    Parameters:
    -
    e - the value to match
    -
    Returns:
    -
    the least element greater than e, - or null if there is no such element
    Since:
    12.0
    @@ -1555,13 +1309,9 @@

    higher

  • first

    public E first()
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns the first (lowest) element currently in this set.
    Specified by:
    first in interface java.util.SortedSet<E>
    -
    Returns:
    -
    the first (lowest) element currently in this set
    • @@ -1572,13 +1322,9 @@

    first

  • last

    public E last()
    -
    Description copied from interface: java.util.SortedSet
    -
    Returns the last (highest) element currently in this set.
    Specified by:
    last in interface java.util.SortedSet<E>
    -
    Returns:
    -
    the last (highest) element currently in this set
    • @@ -1600,8 +1346,6 @@

    pollFirst

    Specified by:
    pollFirst in interface java.util.NavigableSet<E>
    -
    Returns:
    -
    the first element, or null if this set is empty
    Throws:
    java.lang.UnsupportedOperationException - always
    Since:
    @@ -1627,8 +1371,6 @@

    pollLast

    Specified by:
    pollLast in interface java.util.NavigableSet<E>
    -
    Returns:
    -
    the last element, or null if this set is empty
    Throws:
    java.lang.UnsupportedOperationException - always
    Since:
    @@ -1644,23 +1386,9 @@

    pollLast

    descendingSet

    @GwtIncompatible
 public ImmutableSortedSet<E> descendingSet()
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns a reverse order view of the elements contained in this set. - The descending set is backed by this set, so changes to the set are - reflected in the descending set, and vice-versa. If either set is - modified while an iteration over either set is in progress (except - through the iterator's own remove operation), the results of - the iteration are undefined. - -

    The returned set has an ordering equivalent to - Collections.reverseOrder(comparator()). - The expression s.descendingSet().descendingSet() returns a - view of s essentially equivalent to s.

    Specified by:
    descendingSet in interface java.util.NavigableSet<E>
    -
    Returns:
    -
    a reverse order view of this set
    Since:
    12.0
    @@ -1673,32 +1401,6 @@

    descendingSet

  • spliterator

    public java.util.Spliterator<E> spliterator()
    -
    Description copied from interface: java.util.Collection
    -
    Creates a Spliterator over the elements in this collection. - - Implementations should document characteristic values reported by the - spliterator. Such characteristic values are not required to be reported - if the spliterator reports Spliterator.SIZED and this collection - contains no elements. - -

    The default implementation should be overridden by subclasses that - can return a more efficient spliterator. In order to - preserve expected laziness behavior for the Collection.stream() and - Collection.parallelStream() methods, spliterators should either have the - characteristic of IMMUTABLE or CONCURRENT, or be - late-binding. - If none of these is practical, the overriding class should describe the - spliterator's documented policy of binding and structural interference, - and should override the Collection.stream() and Collection.parallelStream() - methods to create streams using a Supplier of the spliterator, - as in: - 

    
-     Stream<E> s = StreamSupport.stream(() -> spliterator(), spliteratorCharacteristics)
-
    -

    These requirements ensure that streams produced by the - Collection.stream() and Collection.parallelStream() methods will reflect the - contents of the collection as of initiation of the terminal stream - operation.

    Specified by:
    spliterator in interface java.util.Collection<E>
    @@ -1710,8 +1412,6 @@

    spliterator

    spliterator in interface java.util.SortedSet<E>
    Overrides:
    spliterator in class ImmutableCollection<E>
    -
    Returns:
    -
    a Spliterator over the elements in this collection
    • @@ -1723,14 +1423,9 @@

    spliterator

    descendingIterator

    @GwtIncompatible
 public abstract UnmodifiableIterator<E> descendingIterator()
    -
    Description copied from interface: java.util.NavigableSet
    -
    Returns an iterator over the elements in this set, in descending order. - Equivalent in effect to descendingSet().iterator().
    Specified by:
    descendingIterator in interface java.util.NavigableSet<E>
    -
    Returns:
    -
    an iterator over the elements in this set, in descending order
    Since:
    12.0
    @@ -1813,12 +1508,6 @@

    of

    element. Proper calls will resolve to the version in ImmutableSortedSet, not this dummy version.
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    element - the single element
    -
    Returns:
    -
    a Set containing the specified element
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -1842,13 +1531,6 @@

    of

    element. Proper calls will resolve to the version in ImmutableSortedSet, not this dummy version.
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    Returns:
    -
    a Set containing the specified elements
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -1873,14 +1555,6 @@

    of

    element. Proper calls will resolve to the version in ImmutableSortedSet, not this dummy version.
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    Returns:
    -
    a Set containing the specified elements
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -1906,15 +1580,6 @@

    of

    element. Proper calls will resolve to the version in ImmutableSortedSet, not this dummy version.
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    e4 - the fourth element
    -
    Returns:
    -
    a Set containing the specified elements
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -1941,16 +1606,6 @@

    of

    element. Proper calls will resolve to the version in ImmutableSortedSet, not this dummy version.
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    e4 - the fourth element
    -
    e5 - the fifth element
    -
    Returns:
    -
    a Set containing the specified elements
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -1980,18 +1635,6 @@

    of

    element. Proper calls will resolve to the version in ImmutableSortedSet, not this dummy version.
    -
    Type Parameters:
    -
    E - the Set's element type
    -
    Parameters:
    -
    e1 - the first element
    -
    e2 - the second element
    -
    e3 - the third element
    -
    e4 - the fourth element
    -
    e5 - the fifth element
    -
    e6 - the sixth element
    -
    remaining - the seventh element
    -
    Returns:
    -
    a Set containing the specified elements
    Throws:
    java.lang.UnsupportedOperationException - always
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableTable.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableTable.html index e1a2a3978268..b3f6fbe0d912 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableTable.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ImmutableTable.html @@ -290,7 +290,7 @@

    Method Summary

    boolean equals​(java.lang.Object obj) -
    Indicates whether some other object is "equal to" this one.
    +
    Compares the specified object with this table for equality.
    @@ -306,7 +306,7 @@

    Method Summary

    int hashCode() -
    Returns a hash code value for the object.
    +
    Returns the hash code for this table.
    @@ -949,58 +949,14 @@

    isEmpty

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object obj)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    +
    Description copied from interface: Table
    +
    Compares the specified object with this table for equality. Two tables are equal when their + cell views, as returned by Table.cellSet(), are equal.
    Specified by:
    equals in interface Table<R extends @Nullable java.lang.Object,​C extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -1011,45 +967,14 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    +
    Description copied from interface: Table
    +
    Returns the hash code for this table. The hash code of a table is defined as the hash code of + its cell view, as returned by Table.cellSet().
    Specified by:
    hashCode in interface Table<R extends @Nullable java.lang.Object,​C extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -1064,8 +989,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/LinkedHashMultimap.html b/releases/snapshot-jre/api/docs/com/google/common/collect/LinkedHashMultimap.html index 0011c4d75b4c..6c4ec10d49cc 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/LinkedHashMultimap.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/LinkedHashMultimap.html @@ -706,14 +706,6 @@

    equals

    equals in interface Multimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Specified by:
    equals in interface SetMultimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -933,8 +925,6 @@

    hashCode

    hashCode in interface Multimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    See Also:
    Map.hashCode()
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/LinkedHashMultiset.html b/releases/snapshot-jre/api/docs/com/google/common/collect/LinkedHashMultiset.html index d6949f4426ab..d0dc233ee06a 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/LinkedHashMultiset.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/LinkedHashMultiset.html @@ -201,8 +201,7 @@

    Method Summary

    boolean add​(E element) -
    Ensures that this collection contains the specified element (optional - operation).
    +
    Adds a single occurrence of the specified element to this multiset.
    @@ -216,23 +215,17 @@

    Method Summary

    boolean addAll​(java.util.Collection<? extends E> elementsToAdd) - -
    Adds all of the elements in the specified collection to this collection - (optional operation).
    - void clear() - -
    Removes all of the elements from this collection (optional operation).
    - +  boolean contains​(java.lang.Object element) -
    Returns true if this collection contains the specified element.
    +
    Determines whether this multiset contains the specified element.
    @@ -284,7 +277,7 @@

    Method Summary

    boolean equals​(java.lang.Object object) -
    Indicates whether some other object is "equal to" this one.
    +
    Compares the specified object with this multiset for equality.
    @@ -299,29 +292,23 @@

    Method Summary

    int hashCode() -
    Returns a hash code value for the object.
    +
    Returns the hash code for this multiset.
    boolean isEmpty() - -
    Returns true if this collection contains no elements.
    - +  java.util.Iterator<E> iterator() - -
    Returns an iterator over the elements contained in this collection.
    - boolean remove​(java.lang.Object element) -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation).
    +
    Removes a single occurrence of the specified element from this multiset, if present.
    @@ -335,18 +322,10 @@

    Method Summary

    boolean removeAll​(java.util.Collection<?> elementsToRemove) - -
    Removes all of this collection's elements that are also contained in the - specified collection (optional operation).
    - boolean retainAll​(java.util.Collection<?> elementsToRetain) - -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation).
    - int @@ -370,15 +349,12 @@

    Method Summary

    int size() -
    Returns the number of elements in this collection.
    +
    Returns the total number of all occurrences of all elements in this multiset.
    java.lang.String toString() - -
    Returns a string representation of this collection.
    - @@ -563,8 +535,11 @@

    size

  • iterator

    public java.util.Iterator<E> iterator()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns an iterator over the elements contained in this collection.
    +
    Description copied from interface: Multiset
    +
    + +

    Elements that occur multiple times in the multiset will appear multiple times in this + iterator, though not necessarily sequentially.

    Specified by:
    iterator in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -574,8 +549,6 @@

    iterator

    iterator in interface Multiset<E extends @Nullable java.lang.Object>
    Specified by:
    iterator in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    an iterator over the elements contained in this collection
    • @@ -697,15 +670,11 @@

    setCount

  • isEmpty

    public boolean isEmpty()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains no elements.
    Specified by:
    isEmpty in interface java.util.Collection<E extends @Nullable java.lang.Object>
    Overrides:
    isEmpty in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    true if this collection contains no elements
    • @@ -717,11 +686,11 @@

    isEmpty

    contains

    public boolean contains​(@CheckForNull
                         java.lang.Object element)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains the specified element. - More formally, returns true if and only if this collection - contains at least one element e such that - Objects.equals(o, e).
    +
    Description copied from interface: Multiset
    +
    Determines whether this multiset contains the specified element. + +

    This method refines Collection.contains(java.lang.Object) to further specify that it may not + throw an exception in response to element being null or of the wrong type.

    Specified by:
    contains in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -730,10 +699,9 @@

    contains

    Overrides:
    contains in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    Parameters:
    -
    element - element whose presence in this collection is to be tested
    +
    element - the element to check for
    Returns:
    -
    true if this collection contains the specified - element
    +
    true if this multiset contains at least one occurrence of the element
    @@ -747,24 +715,14 @@

    contains

    add

    @CanIgnoreReturnValue
 public final boolean add​(E element)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Ensures that this collection contains the specified element (optional - operation). Returns true if this collection changed as a - result of the call. (Returns false if this collection does - not permit duplicates and already contains the specified element.)

    +

    Description copied from interface: Multiset
    +
    Adds a single occurrence of the specified element to this multiset. - Collections that support this operation may place limitations on what - elements may be added to this collection. In particular, some - collections will refuse to add null elements, and others will - impose restrictions on the type of elements that may be added. - Collection classes should clearly specify in their documentation any - restrictions on what elements may be added.

    +

    This method refines Collection.add(E), which only ensures the presence of the + element, to further specify that a successful call must always increment the count of the + element, and the overall size of the collection, by one. - If a collection refuses to add a particular element for any reason - other than that it already contains the element, it must throw - an exception (rather than returning false). This preserves - the invariant that a collection always contains the specified element - after this call returns.

    +

    To both add the element and obtain the previous count of that element, use add(element, 1) instead.

    Specified by:
    add in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -773,10 +731,11 @@

    add

    Overrides:
    add in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    Parameters:
    -
    element - element whose presence in this collection is to be ensured
    +
    element - the element to add one occurrence of; may be null only if explicitly allowed by + the implementation
    Returns:
    -
    true if this collection changed as a result of the - call
    +
    true always, since this call is required to modify the multiset, unlike other + Collection types
    @@ -789,14 +748,13 @@

    remove

    @CanIgnoreReturnValue
 public final boolean remove​(@CheckForNull
                             java.lang.Object element)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation). More formally, - removes an element e such that - Objects.equals(o, e), if - this collection contains one or more such elements. Returns - true if this collection contained the specified element (or - equivalently, if this collection changed as a result of the call).
    +
    Description copied from interface: Multiset
    +
    Removes a single occurrence of the specified element from this multiset, if present. + +

    This method refines Collection.remove(java.lang.Object) to further specify that it may not + throw an exception in response to element being null or of the wrong type. + +

    To both remove the element and obtain the previous count of that element, use remove(element, 1) instead.

    Specified by:
    remove in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -805,9 +763,9 @@

    remove

    Overrides:
    remove in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    Parameters:
    -
    element - element to be removed from this collection, if present
    +
    element - the element to remove one occurrence of
    Returns:
    -
    true if an element was removed as a result of this call
    +
    true if an occurrence was found and removed
    @@ -848,12 +806,7 @@

    setCount

    addAll

    @CanIgnoreReturnValue
 public final boolean addAll​(java.util.Collection<? extends E> elementsToAdd)
    -
    Adds all of the elements in the specified collection to this collection - (optional operation). The behavior of this operation is undefined if - the specified collection is modified while the operation is in progress. - (This implies that the behavior of this call is undefined if the - specified collection is this collection, and this collection is - nonempty.) +

    This implementation is highly efficient when elementsToAdd is itself a Multiset.

    @@ -861,12 +814,6 @@

    addAll

    addAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    Overrides:
    addAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    elementsToAdd - collection containing elements to be added to this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    -
    See Also:
    -
    AbstractCollection.add(Object)
    @@ -878,11 +825,16 @@

    addAll

    removeAll

    @CanIgnoreReturnValue
 public final boolean removeAll​(java.util.Collection<?> elementsToRemove)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes all of this collection's elements that are also contained in the - specified collection (optional operation). After this call returns, - this collection will contain no elements in common with the specified - collection.
    +
    Description copied from interface: Multiset
    +
    + +

    Note: This method ignores how often any element might appear in c, and only + cares whether or not an element appears at all. If you wish to remove one occurrence in this + multiset for every occurrence in c, see Multisets.removeOccurrences(Multiset, + Multiset). + +

    This method refines Collection.removeAll(java.util.Collection<?>) to further specify that it may not + throw an exception in response to any of elements being null or of the wrong type.

    Specified by:
    removeAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -890,14 +842,6 @@

    removeAll

    removeAll in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    removeAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    elementsToRemove - collection containing elements to be removed from this collection
    -
    Returns:
    -
    true if this collection changed as a result of the - call
    -
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    @@ -909,11 +853,16 @@

    removeAll

    retainAll

    @CanIgnoreReturnValue
 public final boolean retainAll​(java.util.Collection<?> elementsToRetain)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation). In other words, removes from - this collection all of its elements that are not contained in the - specified collection.
    +
    Description copied from interface: Multiset
    +
    + +

    Note: This method ignores how often any element might appear in c, and only + cares whether or not an element appears at all. If you wish to remove one occurrence in this + multiset for every occurrence in c, see Multisets.retainOccurrences(Multiset, + Multiset). + +

    This method refines Collection.retainAll(java.util.Collection<?>) to further specify that it may not + throw an exception in response to any of elements being null or of the wrong type.

    Specified by:
    retainAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -921,13 +870,8 @@

    retainAll

    retainAll in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    retainAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    elementsToRetain - collection containing elements to be retained in this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    +
    Multisets.retainOccurrences(Multiset, Multiset)
    @@ -965,44 +909,9 @@

    elementSet

    equals

    public final boolean equals​(@CheckForNull
                             java.lang.Object object)
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes. +

    Compares the specified object with this multiset for equality. Returns true if the + given object is also a multiset and contains equal elements with equal counts, regardless of + order.

    This implementation returns true if object is a multiset of the same size and if, for each element, the two multisets have the same count.

    @@ -1013,14 +922,6 @@

    equals

    equals in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -1031,34 +932,14 @@

    equals

  • hashCode

    public final int hashCode()
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.) +

    Returns the hash code for this multiset. This is defined as the sum of + + 
    
+ ((element == null) ? 0 : element.hashCode()) ^ count(element)
+
    + +

    over all distinct elements in the multiset. It follows that a multiset and its entry set + always have the same hash code.

    This implementation returns the hash code of Multiset.entrySet().

    @@ -1068,11 +949,6 @@

    hashCode

    hashCode in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -1083,12 +959,11 @@

    hashCode

  • toString

    public final java.lang.String toString()
    -
    Returns a string representation of this collection. The string - representation consists of a list of the collection's elements in the - order they are returned by its iterator, enclosed in square brackets - ("[]"). Adjacent elements are separated by the characters - ", " (comma and space). Elements are converted to strings as - by String.valueOf(Object). +
    + +

    It is recommended, though not mandatory, that this method return the result of invoking + Multiset.toString() on the Multiset.entrySet(), yielding a result such as [a x 3, c, d x 2, + e].

    This implementation returns the result of invoking toString on Multiset.entrySet().

    @@ -1096,8 +971,6 @@

    toString

    toString in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    toString in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a string representation of this collection
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/LinkedListMultimap.html b/releases/snapshot-jre/api/docs/com/google/common/collect/LinkedListMultimap.html index 7d9162d2b1d6..43fed0b4e811 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/LinkedListMultimap.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/LinkedListMultimap.html @@ -288,7 +288,7 @@

    Method Summary

    boolean equals​(java.lang.Object object) -
    Indicates whether some other object is "equal to" this one.
    +
    Compares the specified object with this multimap for equality.
    @@ -893,58 +893,23 @@

    asMap

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object object)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    +
    Description copied from interface: Multimap
    +
    Compares the specified object with this multimap for equality. Two multimaps are equal when + their map views, as returned by Multimap.asMap(), are also equal. + +

    In general, two multimaps with identical key-value mappings may or may not be equal, + depending on the implementation. For example, two SetMultimap instances with the same + key-value mappings are equal, but equality of two ListMultimap instances depends on the + ordering of the values for each key. + +

    A non-empty SetMultimap cannot be equal to a non-empty ListMultimap, since + their Multimap.asMap() views contain unequal collections as values. However, any two empty + multimaps are equal, because they both have empty Multimap.asMap() views.

    Specified by:
    equals in interface Multimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -964,8 +929,6 @@

    hashCode

    hashCode in interface Multimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    See Also:
    Map.hashCode()
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/ListMultimap.html b/releases/snapshot-jre/api/docs/com/google/common/collect/ListMultimap.html index bc06f84972b0..c2da171064fc 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/ListMultimap.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/ListMultimap.html @@ -352,14 +352,6 @@

    equals

    equals in interface Multimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/MapDifference.ValueDifference.html b/releases/snapshot-jre/api/docs/com/google/common/collect/MapDifference.ValueDifference.html index d7c4740e0e5a..5b5fec212f0c 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/MapDifference.ValueDifference.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/MapDifference.ValueDifference.html @@ -235,14 +235,6 @@

    equals

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    other - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -257,11 +249,6 @@

    hashCode

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/MapDifference.html b/releases/snapshot-jre/api/docs/com/google/common/collect/MapDifference.html index 83562fbc611c..38db4d13d2aa 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/MapDifference.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/MapDifference.html @@ -322,14 +322,6 @@

    equals

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -349,11 +341,6 @@

    hashCode

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/MapMaker.html b/releases/snapshot-jre/api/docs/com/google/common/collect/MapMaker.html index 6458678e8317..d632395bae14 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/MapMaker.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/MapMaker.html @@ -443,8 +443,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/MinMaxPriorityQueue.html b/releases/snapshot-jre/api/docs/com/google/common/collect/MinMaxPriorityQueue.html index e55167b4f376..e3dbf46131e8 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/MinMaxPriorityQueue.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/MinMaxPriorityQueue.html @@ -255,17 +255,12 @@

    Method Summary

    boolean addAll​(java.util.Collection<? extends E> newElements) - -
    Adds all of the elements in the specified collection to this - queue.
    - +  void clear() - -
    Removes all of the elements from this queue.
    - +  java.util.Comparator<? super E> @@ -332,10 +327,7 @@

    Method Summary

    E peek() - -
    Retrieves, but does not remove, the head of this queue, - or returns null if this queue is empty.
    - +  E @@ -356,10 +348,7 @@

    Method Summary

    E poll() - -
    Retrieves and removes the head of this queue, - or returns null if this queue is empty.
    - +  E @@ -394,16 +383,12 @@

    Method Summary

    int size() - -
    Returns the number of elements in this collection.
    - +  java.lang.Object[] toArray() - -
    Returns an array containing all of the elements in this collection.
    - + 
      @@ -521,17 +506,11 @@

      maximumSize

    • size

      public int size()
      -
      Description copied from interface: java.util.Collection
      -
      Returns the number of elements in this collection. If this collection - contains more than Integer.MAX_VALUE elements, returns - Integer.MAX_VALUE.
      Specified by:
      size in interface java.util.Collection<E>
      Specified by:
      size in class java.util.AbstractCollection<E>
      -
      Returns:
      -
      the number of elements in this collection
    @@ -555,8 +534,6 @@

    add

    add in interface java.util.Queue<E>
    Overrides:
    add in class java.util.AbstractQueue<E>
    -
    Parameters:
    -
    element - the element to add
    Returns:
    true always
    @@ -570,31 +547,11 @@

    add

    addAll

    @CanIgnoreReturnValue
 public boolean addAll​(java.util.Collection<? extends E> newElements)
    -
    Description copied from class: java.util.AbstractQueue
    -
    Adds all of the elements in the specified collection to this - queue. Attempts to addAll of a queue to itself result in - IllegalArgumentException. Further, the behavior of - this operation is undefined if the specified collection is - modified while the operation is in progress. - -

    This implementation iterates over the specified collection, - and adds each element returned by the iterator to this - queue, in turn. A runtime exception encountered while - trying to add an element (including, in particular, a - null element) may result in only some of the elements - having been successfully added when the associated exception is - thrown.

    Specified by:
    addAll in interface java.util.Collection<E>
    Overrides:
    addAll in class java.util.AbstractQueue<E>
    -
    Parameters:
    -
    newElements - collection containing elements to be added to this queue
    -
    Returns:
    -
    true if this queue changed as a result of the call
    -
    See Also:
    -
    AbstractQueue.add(Object)
    @@ -611,13 +568,6 @@

    offer

    Adds the given element to this queue. If this queue has a maximum size, after adding element the queue will automatically evict its greatest element (according to its comparator), which may be element itself.
    -
    -
    Parameters:
    -
    element - the element to add
    -
    Returns:
    -
    true if the element was added to this queue, else - false
    -
    @@ -629,13 +579,6 @@

    poll

    @CanIgnoreReturnValue
 @CheckForNull
 public E poll()
    -
    Description copied from interface: java.util.Queue
    -
    Retrieves and removes the head of this queue, - or returns null if this queue is empty.
    -
    -
    Returns:
    -
    the head of this queue, or null if this queue is empty
    -
    @@ -646,13 +589,6 @@

    poll

    peek

    @CheckForNull
 public E peek()
    -
    Description copied from interface: java.util.Queue
    -
    Retrieves, but does not remove, the head of this queue, - or returns null if this queue is empty.
    -
    -
    Returns:
    -
    the head of this queue, or null if this queue is empty
    -
    @@ -776,12 +712,6 @@

    iterator

  • clear

    public void clear()
    -
    Description copied from class: java.util.AbstractQueue
    -
    Removes all of the elements from this queue. - The queue will be empty after this call returns. - -

    This implementation repeatedly invokes poll until it - returns null.

    Specified by:
    clear in interface java.util.Collection<E>
    @@ -797,24 +727,11 @@

    clear

  • toArray

    public java.lang.Object[] toArray()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns an array containing all of the elements in this collection. - If this collection makes any guarantees as to what order its elements - are returned by its iterator, this method must return the elements in - the same order. The returned array's runtime component type is Object. - -

    The returned array will be "safe" in that no references to it are - maintained by this collection. (In other words, this method must - allocate a new array even if this collection is backed by an array). - The caller is thus free to modify the returned array.

    Specified by:
    toArray in interface java.util.Collection<E>
    Overrides:
    toArray in class java.util.AbstractCollection<E>
    -
    Returns:
    -
    an array, whose runtime component - type is Object, containing all of the elements in this collection
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/Multimap.html b/releases/snapshot-jre/api/docs/com/google/common/collect/Multimap.html index 7f06f39ad488..281e1cecbdb5 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/Multimap.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/Multimap.html @@ -788,14 +788,6 @@

    equals

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    • @@ -818,11 +810,6 @@

    hashCode

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/Multiset.Entry.html b/releases/snapshot-jre/api/docs/com/google/common/collect/Multiset.Entry.html index 42b1b5389e9b..6919001a2b62 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/Multiset.Entry.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/Multiset.Entry.html @@ -160,9 +160,6 @@

    Method Summary

    boolean equals​(java.lang.Object o) - -
    Indicates whether some other object is "equal to" this one.
    - int @@ -181,9 +178,6 @@

    Method Summary

    int hashCode() - -
    Returns a hash code value for the object.
    - java.lang.String @@ -250,44 +244,7 @@

    getCount

    equals

    boolean equals​(@CheckForNull
                java.lang.Object o)
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes. +

    Returns true if the given object is also a multiset entry and the two entries represent the same element and count. That is, two entries a and b are equal @@ -300,14 +257,6 @@

    equals

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    o - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -318,34 +267,7 @@

    equals

  • hashCode

    int hashCode()
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.) +

    The hash code of a multiset entry for element element and count count is defined as: @@ -356,11 +278,6 @@

    hashCode

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -378,8 +295,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/Multiset.html b/releases/snapshot-jre/api/docs/com/google/common/collect/Multiset.html index d2a8d5f6e362..c31fd96a4b00 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/Multiset.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/Multiset.html @@ -297,11 +297,6 @@

    Method Summary

    default void forEach​(java.util.function.Consumer<? super E> action) - -
    Performs the given action for each element of the Iterable - until all elements have been processed or the action throws an - exception.
    - default void @@ -321,9 +316,6 @@

    Method Summary

    java.util.Iterator<E> iterator() - -
    Returns an iterator over the elements in this collection.
    - boolean @@ -343,18 +335,10 @@

    Method Summary

    boolean removeAll​(java.util.Collection<?> c) - -
    Removes all of this collection's elements that are also contained in the - specified collection (optional operation).
    - boolean retainAll​(java.util.Collection<?> c) - -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation).
    - int @@ -384,16 +368,11 @@

    Method Summary

    default java.util.Spliterator<E> spliterator() - -
    Creates a Spliterator over the elements in this collection.
    - +  java.lang.String toString() - -
    Returns a string representation of the object.
    -
      @@ -433,8 +412,6 @@

      size

      Specified by:
      size in interface java.util.Collection<E extends @Nullable java.lang.Object>
      -
      Returns:
      -
      the number of elements in this collection
    @@ -721,14 +698,6 @@

    equals

    equals in interface java.util.Collection<E extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -752,11 +721,6 @@

    hashCode

    hashCode in interface java.util.Collection<E extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    @@ -767,23 +731,7 @@

    hashCode

  • toString

    java.lang.String toString()
    -
    Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

    - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

    - 
    - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
    +

    It is recommended, though not mandatory, that this method return the result of invoking toString() on the entrySet(), yielding a result such as [a x 3, c, d x 2, @@ -791,8 +739,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    • @@ -803,10 +749,7 @@

    toString

  • iterator

    java.util.Iterator<E> iterator()
    -
    Returns an iterator over the elements in this collection. There are no - guarantees concerning the order in which the elements are returned - (unless this collection is an instance of some class that provides a - guarantee). +

    Elements that occur multiple times in the multiset will appear multiple times in this iterator, though not necessarily sequentially.

    @@ -815,8 +758,6 @@

    iterator

    iterator in interface java.util.Collection<E extends @Nullable java.lang.Object>
    Specified by:
    iterator in interface java.lang.Iterable<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    an Iterator over the elements in this collection
    • @@ -869,8 +810,6 @@

    containsAll

    contained in elements
    Throws:
    java.lang.NullPointerException - if elements is null
    -
    See Also:
    -
    Collection.contains(Object)
    @@ -882,10 +821,7 @@

    containsAll

    removeAll

    @CanIgnoreReturnValue
 boolean removeAll​(java.util.Collection<?> c)
    -
    Removes all of this collection's elements that are also contained in the - specified collection (optional operation). After this call returns, - this collection will contain no elements in common with the specified - collection. +

    Note: This method ignores how often any element might appear in c, and only cares whether or not an element appears at all. If you wish to remove one occurrence in this @@ -897,14 +833,6 @@

    removeAll

    Specified by:
    removeAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    c - collection containing elements to be removed from this collection
    -
    Returns:
    -
    true if this collection changed as a result of the - call
    -
    See Also:
    -
    Collection.remove(Object), -Collection.contains(Object)
    @@ -916,10 +844,7 @@

    removeAll

    retainAll

    @CanIgnoreReturnValue
 boolean retainAll​(java.util.Collection<?> c)
    -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation). In other words, removes from - this collection all of its elements that are not contained in the - specified collection. +

    Note: This method ignores how often any element might appear in c, and only cares whether or not an element appears at all. If you wish to remove one occurrence in this @@ -931,10 +856,6 @@

    retainAll

    Specified by:
    retainAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    c - collection containing elements to be retained in this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    See Also:
    Multisets.retainOccurrences(Multiset, Multiset)
    @@ -947,23 +868,13 @@

    retainAll

  • forEach

    default void forEach​(java.util.function.Consumer<? super E> action)
    -
    Performs the given action for each element of the Iterable - until all elements have been processed or the action throws an - exception. Actions are performed in the order of iteration, if that - order is specified. Exceptions thrown by the action are relayed to the - caller. -

    - The behavior of this method is unspecified if the action performs - side-effects that modify the underlying source of elements, unless an - overriding class has specified a concurrent modification policy. +

    Elements that occur multiple times in the multiset will be passed to the Consumer correspondingly many times, though not necessarily sequentially.

    Specified by:
    forEach in interface java.lang.Iterable<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    action - The action to be performed for each element
    • @@ -974,39 +885,11 @@

    forEach

  • spliterator

    default java.util.Spliterator<E> spliterator()
    -
    Description copied from interface: java.util.Collection
    -
    Creates a Spliterator over the elements in this collection. - - Implementations should document characteristic values reported by the - spliterator. Such characteristic values are not required to be reported - if the spliterator reports Spliterator.SIZED and this collection - contains no elements. - -

    The default implementation should be overridden by subclasses that - can return a more efficient spliterator. In order to - preserve expected laziness behavior for the Collection.stream() and - Collection.parallelStream() methods, spliterators should either have the - characteristic of IMMUTABLE or CONCURRENT, or be - late-binding. - If none of these is practical, the overriding class should describe the - spliterator's documented policy of binding and structural interference, - and should override the Collection.stream() and Collection.parallelStream() - methods to create streams using a Supplier of the spliterator, - as in: - 

    
-     Stream<E> s = StreamSupport.stream(() -> spliterator(), spliteratorCharacteristics)
-
    -

    These requirements ensure that streams produced by the - Collection.stream() and Collection.parallelStream() methods will reflect the - contents of the collection as of initiation of the terminal stream - operation.

    Specified by:
    spliterator in interface java.util.Collection<E extends @Nullable java.lang.Object>
    Specified by:
    spliterator in interface java.lang.Iterable<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a Spliterator over the elements in this collection
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/MutableClassToInstanceMap.html b/releases/snapshot-jre/api/docs/com/google/common/collect/MutableClassToInstanceMap.html index f2d697b69fc9..02f8b0476cf3 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/MutableClassToInstanceMap.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/MutableClassToInstanceMap.html @@ -190,7 +190,7 @@

    Nested classes/interfaces inherited from class com.google.common.collec

    Nested classes/interfaces inherited from interface java.util.Map

    -java.util.Map.Entry<K,​V> +java.util.Map.Entry<K extends java.lang.Object,​V extends java.lang.Object> @@ -235,9 +235,7 @@

    Method Summary

    java.util.Set<java.util.Map.Entry<java.lang.Class<? extends B>,​B>> entrySet() - -
    Returns a Set view of the mappings contained in this map.
    - +  <T extends B>
    T     @@ -251,18 +249,12 @@

    Method Summary

    B put​(java.lang.Class<? extends B> key, B value) - -
    Associates the specified value with the specified key in this map - (optional operation).
    - +  void putAll​(java.util.Map<? extends java.lang.Class<? extends B>,​? extends B> map) - -
    Copies all of the mappings from the specified map to this map - (optional operation).
    - +  <T extends B>
    T     @@ -365,26 +357,11 @@

    delegate

  • entrySet

    public java.util.Set<java.util.Map.Entry<java.lang.Class<? extends B>,​B>> entrySet()
    -
    Description copied from interface: java.util.Map
    -
    Returns a Set view of the mappings contained in this map. - The set is backed by the map, so changes to the map are - reflected in the set, and vice-versa. If the map is modified - while an iteration over the set is in progress (except through - the iterator's own remove operation, or through the - setValue operation on a map entry returned by the - iterator) the results of the iteration are undefined. The set - supports element removal, which removes the corresponding - mapping from the map, via the Iterator.remove, - Set.remove, removeAll, retainAll and - clear operations. It does not support the - add or addAll operations.
    Specified by:
    entrySet in interface java.util.Map<java.lang.Class<? extends B>,​B>
    Overrides:
    entrySet in class ForwardingMap<java.lang.Class<? extends B>,​B>
    -
    Returns:
    -
    a set view of the mappings contained in this map
    • @@ -400,27 +377,11 @@

    put

    @CheckForNull public B put​(java.lang.Class<? extends B> key, B value) -
    Description copied from interface: java.util.Map
    -
    Associates the specified value with the specified key in this map - (optional operation). If the map previously contained a mapping for - the key, the old value is replaced by the specified value. (A map - m is said to contain a mapping for a key k if and only - if m.containsKey(k) would return - true.)
    Specified by:
    put in interface java.util.Map<java.lang.Class<? extends B>,​B>
    Overrides:
    put in class ForwardingMap<java.lang.Class<? extends B>,​B>
    -
    Parameters:
    -
    key - key with which the specified value is to be associated
    -
    value - value to be associated with the specified key
    -
    Returns:
    -
    the previous value associated with key, or - null if there was no mapping for key. - (A null return can also indicate that the map - previously associated null with key, - if the implementation supports null values.)
    @@ -431,20 +392,11 @@

    put

  • putAll

    public void putAll​(java.util.Map<? extends java.lang.Class<? extends B>,​? extends B> map)
    -
    Description copied from interface: java.util.Map
    -
    Copies all of the mappings from the specified map to this map - (optional operation). The effect of this call is equivalent to that - of calling put(k, v) on this map once - for each mapping from key k to value v in the - specified map. The behavior of this operation is undefined if the - specified map is modified while the operation is in progress.
    Specified by:
    putAll in interface java.util.Map<java.lang.Class<? extends B>,​B>
    Overrides:
    putAll in class ForwardingMap<java.lang.Class<? extends B>,​B>
    -
    Parameters:
    -
    map - mappings to be stored in this map
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/Ordering.html b/releases/snapshot-jre/api/docs/com/google/common/collect/Ordering.html index 47e20b4b9a0e..992ff5da3e8c 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/Ordering.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/Ordering.html @@ -318,9 +318,7 @@

    Method Summary

    abstract int compare​(T left, T right) - -
    Compares its two arguments for order.
    - +  static <T extends @Nullable java.lang.Object>
    Ordering<T>     @@ -949,45 +947,9 @@

    lexicographical

    compare

    public abstract int compare​(T left,
                             T right)
    -
    Description copied from interface: java.util.Comparator
    -
    Compares its two arguments for order. Returns a negative integer, - zero, or a positive integer as the first argument is less than, equal - to, or greater than the second.

    - - The implementor must ensure that sgn(compare(x, y)) == - -sgn(compare(y, x)) for all x and y. (This - implies that compare(x, y) must throw an exception if and only - if compare(y, x) throws an exception.)

    - - The implementor must also ensure that the relation is transitive: - ((compare(x, y)>0) && (compare(y, z)>0)) implies - compare(x, z)>0.

    - - Finally, the implementor must ensure that compare(x, y)==0 - implies that sgn(compare(x, z))==sgn(compare(y, z)) for all - z.

    - - It is generally the case, but not strictly required that - (compare(x, y)==0) == (x.equals(y)). Generally speaking, - any comparator that violates this condition should clearly indicate - this fact. The recommended language is "Note: this comparator - imposes orderings that are inconsistent with equals."

    - - In the foregoing description, the notation - sgn(expression) designates the mathematical - signum function, which is defined to return one of -1, - 0, or 1 according to whether the value of - expression is negative, zero, or positive, respectively.

    Specified by:
    compare in interface java.util.Comparator<T extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    left - the first object to be compared.
    -
    right - the second object to be compared.
    -
    Returns:
    -
    a negative integer, zero, or a positive integer as the - first argument is less than, equal to, or greater than the - second.
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/PeekingIterator.html b/releases/snapshot-jre/api/docs/com/google/common/collect/PeekingIterator.html index 48691e5d25f3..c511aefcf157 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/PeekingIterator.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/PeekingIterator.html @@ -165,9 +165,6 @@

    Method Summary

    E next() - -
    Returns the next element in the iteration.
    - E @@ -179,10 +176,6 @@

    Method Summary

    void remove() - -
    Removes from the underlying collection the last element returned - by this iterator (optional operation).
    -
      @@ -233,15 +226,13 @@

      peek

      next

      @CanIgnoreReturnValue
 E next()
      -
      Returns the next element in the iteration. +

      The objects returned by consecutive calls to peek() then next() are guaranteed to be equal to each other.

      Specified by:
      next in interface java.util.Iterator<E extends @Nullable java.lang.Object>
      -
      Returns:
      -
      the next element in the iteration
    @@ -252,17 +243,7 @@

    next

  • remove

    void remove()
    -
    Removes from the underlying collection the last element returned - by this iterator (optional operation). This method can be called - only once per call to Iterator.next(). -

    - The behavior of an iterator is unspecified if the underlying collection - is modified while the iteration is in progress in any way other than by - calling this method, unless an overriding class has specified a - concurrent modification policy. -

    - The behavior of an iterator is unspecified if this method is called - after a call to the forEachRemaining method. +

    Implementations may or may not support removal when a call to peek() has occurred since the most recent call to next().

    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/Range.html b/releases/snapshot-jre/api/docs/com/google/common/collect/Range.html index 921f955bbe5a..28ef7c26a0b0 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/Range.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/Range.html @@ -1128,14 +1128,6 @@

    equals

    equals in interface Predicate<C extends java.lang.Comparable>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    • @@ -1150,11 +1142,6 @@

    hashCode

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    @@ -1170,8 +1157,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/RangeMap.html b/releases/snapshot-jre/api/docs/com/google/common/collect/RangeMap.html index d3695590f8fa..368803bfd396 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/RangeMap.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/RangeMap.html @@ -518,14 +518,6 @@

    equals

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    o - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -540,11 +532,6 @@

    hashCode

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    @@ -559,8 +546,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/RangeSet.html b/releases/snapshot-jre/api/docs/com/google/common/collect/RangeSet.html index 31f16b1907bb..4c0c0c372f96 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/RangeSet.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/RangeSet.html @@ -673,14 +673,6 @@

    equals

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -695,11 +687,6 @@

    hashCode

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    @@ -716,8 +703,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/SetMultimap.html b/releases/snapshot-jre/api/docs/com/google/common/collect/SetMultimap.html index 959e59ac3c03..9531109ea7a2 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/SetMultimap.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/SetMultimap.html @@ -398,14 +398,6 @@

    equals

    equals in interface Multimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/Sets.SetView.html b/releases/snapshot-jre/api/docs/com/google/common/collect/Sets.SetView.html index d7cde5c778fb..c596eb923121 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/Sets.SetView.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/Sets.SetView.html @@ -380,11 +380,6 @@

    add

    add in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    add in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    e - element whose presence in this collection is to be ensured
    -
    Returns:
    -
    true if this collection changed as a result of the - call
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -411,10 +406,6 @@

    remove

    remove in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    remove in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    object - element to be removed from this collection, if present
    -
    Returns:
    -
    true if an element was removed as a result of this call
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -440,14 +431,8 @@

    addAll

    addAll in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    addAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    newElements - collection containing elements to be added to this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    Throws:
    java.lang.UnsupportedOperationException - always
    -
    See Also:
    -
    AbstractCollection.add(Object)
    @@ -471,15 +456,8 @@

    removeAll

    removeAll in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    removeAll in class java.util.AbstractSet<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    oldElements - collection containing elements to be removed from this set
    -
    Returns:
    -
    true if this set changed as a result of the call
    Throws:
    java.lang.UnsupportedOperationException - always
    -
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    @@ -497,11 +475,6 @@

    removeIf

    Guaranteed to throw an exception and leave the collection unmodified.
    -
    Parameters:
    -
    filter - a predicate which returns true for elements to be - removed
    -
    Returns:
    -
    true if any elements were removed
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -527,15 +500,8 @@

    retainAll

    retainAll in interface java.util.Set<E extends @Nullable java.lang.Object>
    Overrides:
    retainAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    elementsToKeep - collection containing elements to be retained in this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    Throws:
    java.lang.UnsupportedOperationException - always
    -
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    @@ -580,8 +546,6 @@

    iterator

    iterator in interface java.util.Set<E extends @Nullable java.lang.Object>
    Specified by:
    iterator in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    an iterator over the elements contained in this collection
    Since:
    20.0 (present with return type Iterator since 2.0)
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/SortedMultiset.html b/releases/snapshot-jre/api/docs/com/google/common/collect/SortedMultiset.html index cce91cbf74c6..383cfa247922 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/SortedMultiset.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/SortedMultiset.html @@ -237,9 +237,6 @@

    Method Summary

    java.util.Iterator<E> iterator() - -
    Returns an iterator over the elements in this collection.
    - Multiset.Entry<E> @@ -430,10 +427,7 @@

    entrySet

  • iterator

    java.util.Iterator<E> iterator()
    -
    Returns an iterator over the elements in this collection. There are no - guarantees concerning the order in which the elements are returned - (unless this collection is an instance of some class that provides a - guarantee). +

    Elements that occur multiple times in the multiset will appear multiple times in this iterator, though not necessarily sequentially. @@ -447,8 +441,6 @@

    iterator

    iterator in interface java.lang.Iterable<E extends @Nullable java.lang.Object>
    Specified by:
    iterator in interface Multiset<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    an Iterator over the elements in this collection
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/Table.Cell.html b/releases/snapshot-jre/api/docs/com/google/common/collect/Table.Cell.html index 21f7294c1330..bee711ef6613 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/Table.Cell.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/Table.Cell.html @@ -249,14 +249,6 @@

    equals

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -274,11 +266,6 @@

    hashCode

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/Table.html b/releases/snapshot-jre/api/docs/com/google/common/collect/Table.html index 455845da8fa8..d4082b84ef54 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/Table.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/Table.html @@ -497,14 +497,6 @@

    equals

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -520,11 +512,6 @@

    hashCode

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/TreeBasedTable.html b/releases/snapshot-jre/api/docs/com/google/common/collect/TreeBasedTable.html index 4ba844627216..7c8300d35e09 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/TreeBasedTable.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/TreeBasedTable.html @@ -310,7 +310,7 @@

    Method Summary

    boolean equals​(java.lang.Object obj) -
    Indicates whether some other object is "equal to" this one.
    +
    Compares the specified object with this table for equality.
    @@ -326,7 +326,7 @@

    Method Summary

    int hashCode() -
    Returns a hash code value for the object.
    +
    Returns the hash code for this table.
    @@ -932,58 +932,14 @@

    putAll

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object obj)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    +
    Description copied from interface: Table
    +
    Compares the specified object with this table for equality. Two tables are equal when their + cell views, as returned by Table.cellSet(), are equal.
    Specified by:
    equals in interface Table<R extends @Nullable java.lang.Object,​C extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -994,45 +950,14 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    +
    Description copied from interface: Table
    +
    Returns the hash code for this table. The hash code of a table is defined as the hash code of + its cell view, as returned by Table.cellSet().
    Specified by:
    hashCode in interface Table<R extends @Nullable java.lang.Object,​C extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -1047,8 +972,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/TreeMultimap.html b/releases/snapshot-jre/api/docs/com/google/common/collect/TreeMultimap.html index bed5f59f9b51..dd5c5d9a939e 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/TreeMultimap.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/TreeMultimap.html @@ -747,14 +747,6 @@

    equals

    equals in interface Multimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Specified by:
    equals in interface SetMultimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -989,8 +981,6 @@

    hashCode

    hashCode in interface Multimap<K extends @Nullable java.lang.Object,​V extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    See Also:
    Map.hashCode()
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/TreeMultiset.html b/releases/snapshot-jre/api/docs/com/google/common/collect/TreeMultiset.html index f10273fb744f..05917541d1d4 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/TreeMultiset.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/TreeMultiset.html @@ -202,8 +202,7 @@

    Method Summary

    boolean add​(E element) -
    Ensures that this collection contains the specified element (optional - operation).
    +
    Adds a single occurrence of the specified element to this multiset.
    @@ -217,17 +216,11 @@

    Method Summary

    boolean addAll​(java.util.Collection<? extends E> elementsToAdd) - -
    Adds all of the elements in the specified collection to this collection - (optional operation).
    - void clear() - -
    Removes all of the elements from this collection (optional operation).
    - +  java.util.Comparator<? super E> @@ -241,7 +234,7 @@

    Method Summary

    boolean contains​(java.lang.Object element) -
    Returns true if this collection contains the specified element.
    +
    Determines whether this multiset contains the specified element.
    @@ -300,7 +293,7 @@

    Method Summary

    boolean equals​(java.lang.Object object) -
    Indicates whether some other object is "equal to" this one.
    +
    Compares the specified object with this multiset for equality.
    @@ -323,7 +316,7 @@

    Method Summary

    int hashCode() -
    Returns a hash code value for the object.
    +
    Returns the hash code for this multiset.
    @@ -338,16 +331,11 @@

    Method Summary

    boolean isEmpty() - -
    Returns true if this collection contains no elements.
    - +  java.util.Iterator<E> iterator() - -
    Returns an iterator over the elements contained in this collection.
    - Multiset.Entry<E> @@ -377,8 +365,7 @@

    Method Summary

    boolean remove​(java.lang.Object element) -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation).
    +
    Removes a single occurrence of the specified element from this multiset, if present.
    @@ -392,18 +379,10 @@

    Method Summary

    boolean removeAll​(java.util.Collection<?> elementsToRemove) - -
    Removes all of this collection's elements that are also contained in the - specified collection (optional operation).
    - boolean retainAll​(java.util.Collection<?> elementsToRetain) - -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation).
    - int @@ -427,7 +406,7 @@

    Method Summary

    int size() -
    Returns the number of elements in this collection.
    +
    Returns the total number of all occurrences of all elements in this multiset.
    @@ -453,9 +432,6 @@

    Method Summary

    java.lang.String toString() - -
    Returns a string representation of this collection.
    -
      @@ -572,10 +548,11 @@

      create

    • size

      public int size()
      -
      Description copied from interface: java.util.Collection
      -
      Returns the number of elements in this collection. If this collection - contains more than Integer.MAX_VALUE elements, returns - Integer.MAX_VALUE.
      +
      Description copied from interface: Multiset
      +
      Returns the total number of all occurrences of all elements in this multiset. + +

      Note: this method does not return the number of distinct elements in the + multiset, which is given by entrySet().size().

      Specified by:
      size in interface java.util.Collection<E extends @Nullable java.lang.Object>
      @@ -583,8 +560,6 @@

      size

      size in interface Multiset<E extends @Nullable java.lang.Object>
      Specified by:
      size in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
      -
      Returns:
      -
      the number of elements in this collection
    @@ -734,9 +709,6 @@

    setCount

  • clear

    public void clear()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes all of the elements from this collection (optional operation). - The collection will be empty after this method returns.
    Specified by:
    clear in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -768,8 +740,14 @@

    forEachEntry

  • iterator

    public java.util.Iterator<E> iterator()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns an iterator over the elements contained in this collection.
    +
    Description copied from interface: SortedMultiset
    +
    + +

    Elements that occur multiple times in the multiset will appear multiple times in this + iterator, though not necessarily sequentially. + +

    The iterator returns the elements in ascending order according to this multiset's + comparator.

    Specified by:
    iterator in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -781,8 +759,6 @@

    iterator

    iterator in interface SortedMultiset<E extends @Nullable java.lang.Object>
    Specified by:
    iterator in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    an iterator over the elements contained in this collection
    • @@ -998,15 +974,11 @@

    descendingMultiset

  • isEmpty

    public boolean isEmpty()
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains no elements.
    Specified by:
    isEmpty in interface java.util.Collection<E extends @Nullable java.lang.Object>
    Overrides:
    isEmpty in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    true if this collection contains no elements
    • @@ -1018,11 +990,11 @@

    isEmpty

    contains

    public boolean contains​(@CheckForNull
                         java.lang.Object element)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Returns true if this collection contains the specified element. - More formally, returns true if and only if this collection - contains at least one element e such that - Objects.equals(o, e).
    +
    Description copied from interface: Multiset
    +
    Determines whether this multiset contains the specified element. + +

    This method refines Collection.contains(java.lang.Object) to further specify that it may not + throw an exception in response to element being null or of the wrong type.

    Specified by:
    contains in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -1031,10 +1003,9 @@

    contains

    Overrides:
    contains in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    Parameters:
    -
    element - element whose presence in this collection is to be tested
    +
    element - the element to check for
    Returns:
    -
    true if this collection contains the specified - element
    +
    true if this multiset contains at least one occurrence of the element
    • @@ -1048,24 +1019,14 @@

    contains

    add

    @CanIgnoreReturnValue
 public final boolean add​(E element)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Ensures that this collection contains the specified element (optional - operation). Returns true if this collection changed as a - result of the call. (Returns false if this collection does - not permit duplicates and already contains the specified element.)

    +

    Description copied from interface: Multiset
    +
    Adds a single occurrence of the specified element to this multiset. - Collections that support this operation may place limitations on what - elements may be added to this collection. In particular, some - collections will refuse to add null elements, and others will - impose restrictions on the type of elements that may be added. - Collection classes should clearly specify in their documentation any - restrictions on what elements may be added.

    +

    This method refines Collection.add(E), which only ensures the presence of the + element, to further specify that a successful call must always increment the count of the + element, and the overall size of the collection, by one. - If a collection refuses to add a particular element for any reason - other than that it already contains the element, it must throw - an exception (rather than returning false). This preserves - the invariant that a collection always contains the specified element - after this call returns.

    +

    To both add the element and obtain the previous count of that element, use add(element, 1) instead.

    Specified by:
    add in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -1074,10 +1035,11 @@

    add

    Overrides:
    add in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    Parameters:
    -
    element - element whose presence in this collection is to be ensured
    +
    element - the element to add one occurrence of; may be null only if explicitly allowed by + the implementation
    Returns:
    -
    true if this collection changed as a result of the - call
    +
    true always, since this call is required to modify the multiset, unlike other + Collection types
    @@ -1090,14 +1052,13 @@

    remove

    @CanIgnoreReturnValue
 public final boolean remove​(@CheckForNull
                             java.lang.Object element)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes a single instance of the specified element from this - collection, if it is present (optional operation). More formally, - removes an element e such that - Objects.equals(o, e), if - this collection contains one or more such elements. Returns - true if this collection contained the specified element (or - equivalently, if this collection changed as a result of the call).
    +
    Description copied from interface: Multiset
    +
    Removes a single occurrence of the specified element from this multiset, if present. + +

    This method refines Collection.remove(java.lang.Object) to further specify that it may not + throw an exception in response to element being null or of the wrong type. + +

    To both remove the element and obtain the previous count of that element, use remove(element, 1) instead.

    Specified by:
    remove in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -1106,9 +1067,9 @@

    remove

    Overrides:
    remove in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    Parameters:
    -
    element - element to be removed from this collection, if present
    +
    element - the element to remove one occurrence of
    Returns:
    -
    true if an element was removed as a result of this call
    +
    true if an occurrence was found and removed
    @@ -1120,12 +1081,7 @@

    remove

    addAll

    @CanIgnoreReturnValue
 public final boolean addAll​(java.util.Collection<? extends E> elementsToAdd)
    -
    Adds all of the elements in the specified collection to this collection - (optional operation). The behavior of this operation is undefined if - the specified collection is modified while the operation is in progress. - (This implies that the behavior of this call is undefined if the - specified collection is this collection, and this collection is - nonempty.) +

    This implementation is highly efficient when elementsToAdd is itself a Multiset.

    @@ -1133,12 +1089,6 @@

    addAll

    addAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    Overrides:
    addAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    elementsToAdd - collection containing elements to be added to this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    -
    See Also:
    -
    AbstractCollection.add(Object)
    @@ -1150,11 +1100,16 @@

    addAll

    removeAll

    @CanIgnoreReturnValue
 public final boolean removeAll​(java.util.Collection<?> elementsToRemove)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Removes all of this collection's elements that are also contained in the - specified collection (optional operation). After this call returns, - this collection will contain no elements in common with the specified - collection.
    +
    Description copied from interface: Multiset
    +
    + +

    Note: This method ignores how often any element might appear in c, and only + cares whether or not an element appears at all. If you wish to remove one occurrence in this + multiset for every occurrence in c, see Multisets.removeOccurrences(Multiset, + Multiset). + +

    This method refines Collection.removeAll(java.util.Collection<?>) to further specify that it may not + throw an exception in response to any of elements being null or of the wrong type.

    Specified by:
    removeAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -1162,14 +1117,6 @@

    removeAll

    removeAll in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    removeAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    elementsToRemove - collection containing elements to be removed from this collection
    -
    Returns:
    -
    true if this collection changed as a result of the - call
    -
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    @@ -1181,11 +1128,16 @@

    removeAll

    retainAll

    @CanIgnoreReturnValue
 public final boolean retainAll​(java.util.Collection<?> elementsToRetain)
    -
    Description copied from class: java.util.AbstractCollection
    -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation). In other words, removes from - this collection all of its elements that are not contained in the - specified collection.
    +
    Description copied from interface: Multiset
    +
    + +

    Note: This method ignores how often any element might appear in c, and only + cares whether or not an element appears at all. If you wish to remove one occurrence in this + multiset for every occurrence in c, see Multisets.retainOccurrences(Multiset, + Multiset). + +

    This method refines Collection.retainAll(java.util.Collection<?>) to further specify that it may not + throw an exception in response to any of elements being null or of the wrong type.

    Specified by:
    retainAll in interface java.util.Collection<E extends @Nullable java.lang.Object>
    @@ -1193,13 +1145,8 @@

    retainAll

    retainAll in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    retainAll in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    elementsToRetain - collection containing elements to be retained in this collection
    -
    Returns:
    -
    true if this collection changed as a result of the call
    See Also:
    -
    AbstractCollection.remove(Object), -AbstractCollection.contains(Object)
    +
    Multisets.retainOccurrences(Multiset, Multiset)
    @@ -1239,44 +1186,9 @@

    entrySet

    equals

    public final boolean equals​(@CheckForNull
                             java.lang.Object object)
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes. +

    Compares the specified object with this multiset for equality. Returns true if the + given object is also a multiset and contains equal elements with equal counts, regardless of + order.

    This implementation returns true if object is a multiset of the same size and if, for each element, the two multisets have the same count.

    @@ -1287,14 +1199,6 @@

    equals

    equals in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -1305,34 +1209,14 @@

    equals

  • hashCode

    public final int hashCode()
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.) +

    Returns the hash code for this multiset. This is defined as the sum of + + 
    
+ ((element == null) ? 0 : element.hashCode()) ^ count(element)
+
    + +

    over all distinct elements in the multiset. It follows that a multiset and its entry set + always have the same hash code.

    This implementation returns the hash code of Multiset.entrySet().

    @@ -1342,11 +1226,6 @@

    hashCode

    hashCode in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -1357,12 +1236,11 @@

    hashCode

  • toString

    public final java.lang.String toString()
    -
    Returns a string representation of this collection. The string - representation consists of a list of the collection's elements in the - order they are returned by its iterator, enclosed in square brackets - ("[]"). Adjacent elements are separated by the characters - ", " (comma and space). Elements are converted to strings as - by String.valueOf(Object). +
    + +

    It is recommended, though not mandatory, that this method return the result of invoking + Multiset.toString() on the Multiset.entrySet(), yielding a result such as [a x 3, c, d x 2, + e].

    This implementation returns the result of invoking toString on Multiset.entrySet().

    @@ -1370,8 +1248,6 @@

    toString

    toString in interface Multiset<E extends @Nullable java.lang.Object>
    Overrides:
    toString in class java.util.AbstractCollection<E extends @Nullable java.lang.Object>
    -
    Returns:
    -
    a string representation of this collection
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/TreeRangeMap.html b/releases/snapshot-jre/api/docs/com/google/common/collect/TreeRangeMap.html index a90091848589..9391e800edd6 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/TreeRangeMap.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/TreeRangeMap.html @@ -201,7 +201,7 @@

    Method Summary

    boolean equals​(java.lang.Object o) -
    Indicates whether some other object is "equal to" this one.
    +
    Returns true if obj is another RangeMap that has an equivalent RangeMap.asMapOfRanges().
    @@ -223,7 +223,7 @@

    Method Summary

    int hashCode() -
    Returns a hash code value for the object.
    +
    Returns asMapOfRanges().hashCode().
    @@ -285,7 +285,7 @@

    Method Summary

    java.lang.String toString() -
    Returns a string representation of the object.
    +
    Returns a readable string representation of this range map.
    @@ -588,58 +588,13 @@

    subRangeMap

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object o)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    +
    Description copied from interface: RangeMap
    +
    Returns true if obj is another RangeMap that has an equivalent RangeMap.asMapOfRanges().
    Specified by:
    equals in interface RangeMap<K extends java.lang.Comparable,​V>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    o - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -650,45 +605,13 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    +
    Description copied from interface: RangeMap
    +
    Returns asMapOfRanges().hashCode().
    Specified by:
    hashCode in interface RangeMap<K extends java.lang.Comparable,​V>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -699,31 +622,13 @@

    hashCode

  • toString

    public java.lang.String toString()
    -
    Description copied from class: java.lang.Object
    -
    Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

    - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

    - 
    - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
    +
    Description copied from interface: RangeMap
    +
    Returns a readable string representation of this range map.
    Specified by:
    toString in interface RangeMap<K extends java.lang.Comparable,​V>
    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/TreeRangeSet.html b/releases/snapshot-jre/api/docs/com/google/common/collect/TreeRangeSet.html index de25e28544ee..1b6b62e5e890 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/TreeRangeSet.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/TreeRangeSet.html @@ -261,14 +261,15 @@

    Method Summary

    boolean equals​(java.lang.Object obj) -
    Indicates whether some other object is "equal to" this one.
    +
    Returns true if obj is another RangeSet that contains the same ranges + according to Range.equals(Object).
    int hashCode() -
    Returns a hash code value for the object.
    +
    Returns asRanges().hashCode().
    @@ -328,7 +329,7 @@

    Method Summary

    java.lang.String toString() -
    Returns a string representation of the object.
    +
    Returns a readable string representation of this range set.
    @@ -693,58 +694,14 @@

    removeAll

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object obj)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    +
    Description copied from interface: RangeSet
    +
    Returns true if obj is another RangeSet that contains the same ranges + according to Range.equals(Object).
    Specified by:
    equals in interface RangeSet<C extends java.lang.Comparable>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -755,45 +712,13 @@

    equals

  • hashCode

    public final int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    +
    Description copied from interface: RangeSet
    +
    Returns asRanges().hashCode().
    Specified by:
    hashCode in interface RangeSet<C extends java.lang.Comparable>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -804,31 +729,15 @@

    hashCode

  • toString

    public final java.lang.String toString()
    -
    Description copied from class: java.lang.Object
    -
    Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

    - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

    - 
    - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
    +
    Description copied from interface: RangeSet
    +
    Returns a readable string representation of this range set. For example, if this + RangeSet consisted of Range.closed(1, 3) and Range.greaterThan(4), this might + return " [1..3](4..+∞)"}.
    Specified by:
    toString in interface RangeSet<C extends java.lang.Comparable>
    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/UnmodifiableListIterator.html b/releases/snapshot-jre/api/docs/com/google/common/collect/UnmodifiableListIterator.html index 0c11403bb709..cee6a945e2b5 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/UnmodifiableListIterator.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/UnmodifiableListIterator.html @@ -297,8 +297,6 @@

    add

    Specified by:
    add in interface java.util.ListIterator<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    e - the element to insert
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -321,9 +319,6 @@

    set

    Specified by:
    set in interface java.util.ListIterator<E extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    e - the element with which to replace the last element returned by - next or previous
    Throws:
    java.lang.UnsupportedOperationException - always
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/collect/class-use/ImmutableSortedSet.html b/releases/snapshot-jre/api/docs/com/google/common/collect/class-use/ImmutableSortedSet.html index 5b15cda8d8c7..0d695639d135 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/collect/class-use/ImmutableSortedSet.html +++ b/releases/snapshot-jre/api/docs/com/google/common/collect/class-use/ImmutableSortedSet.html @@ -245,10 +245,6 @@

    Uses of ImmutableSortedSet<E> ImmutableSortedSet.headSet​(E toElement) - -
    Returns a view of the portion of this set whose elements are - strictly less than toElement.
    - ImmutableSortedSet<E> @@ -345,19 +341,10 @@

    Uses of ImmutableSortedSet<E> ImmutableSortedSet.subSet​(E fromElement, E toElement) - -
    Returns a view of the portion of this set whose elements range - from fromElement, inclusive, to toElement, - exclusive.
    - ImmutableSortedSet<E> ImmutableSortedSet.tailSet​(E fromElement) - -
    Returns a view of the portion of this set whose elements are - greater than or equal to fromElement.
    - ImmutableSortedSet<E> diff --git a/releases/snapshot-jre/api/docs/com/google/common/eventbus/DeadEvent.html b/releases/snapshot-jre/api/docs/com/google/common/eventbus/DeadEvent.html index c73f2991f6f3..836d508d7eeb 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/eventbus/DeadEvent.html +++ b/releases/snapshot-jre/api/docs/com/google/common/eventbus/DeadEvent.html @@ -207,9 +207,7 @@

    Method Summary

    java.lang.String toString() - -
    Returns a string representation of the object.
    - + 
      @@ -298,29 +296,9 @@

      getEvent

    • toString

      public java.lang.String toString()
      -
      Description copied from class: java.lang.Object
      -
      Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

      - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

      - 
      - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
      Overrides:
      toString in class java.lang.Object
      -
      Returns:
      -
      a string representation of the object.
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/eventbus/EventBus.html b/releases/snapshot-jre/api/docs/com/google/common/eventbus/EventBus.html index 1cb16b837113..1b4152285701 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/eventbus/EventBus.html +++ b/releases/snapshot-jre/api/docs/com/google/common/eventbus/EventBus.html @@ -328,9 +328,7 @@

    Method Summary

    java.lang.String toString() - -
    Returns a string representation of the object.
    - +  void @@ -484,29 +482,9 @@

    post

  • toString

    public java.lang.String toString()
    -
    Description copied from class: java.lang.Object
    -
    Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

    - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

    - 
    - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/graph/AbstractGraph.html b/releases/snapshot-jre/api/docs/com/google/common/graph/AbstractGraph.html index 8450010e9010..8501c71e2509 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/graph/AbstractGraph.html +++ b/releases/snapshot-jre/api/docs/com/google/common/graph/AbstractGraph.html @@ -221,7 +221,8 @@

    Method Summary

    boolean equals​(java.lang.Object obj) -
    Indicates whether some other object is "equal to" this one.
    +
    Returns true iff object is a Graph that has the same elements and the + same structural relationships as those in this graph.
    @@ -239,7 +240,7 @@

    Method Summary

    int hashCode() -
    Returns a hash code value for the object.
    +
    Returns the hash code for this graph.
    @@ -343,58 +344,29 @@

    Method Detail

    equals

    public final boolean equals​(@CheckForNull
                             java.lang.Object obj)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: +

    Description copied from interface: Graph
    +
    Returns true iff object is a Graph that has the same elements and the + same structural relationships as those in this graph. + +

    Thus, two graphs A and B are equal if all of the following are true: +

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. +
    • A and B have equal directedness. +
    • A and B have equal node sets. +
    • A and B have equal edge sets.
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    + +

    Graph properties besides directedness do not affect equality. + For example, two graphs may be considered equal even if one allows self-loops and the other + doesn't. Additionally, the order in which nodes or edges are added to the graph, and the order + in which they are iterated over, are irrelevant. + +

    A reference implementation of this is provided by equals(Object).

    Specified by:
    equals in interface Graph<N>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -405,45 +377,16 @@

    equals

  • hashCode

    public final int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    +
    Description copied from interface: Graph
    +
    Returns the hash code for this graph. The hash code of a graph is defined as the hash code of + the set returned by Graph.edges(). + +

    A reference implementation of this is provided by hashCode().

    Specified by:
    hashCode in interface Graph<N>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -458,8 +401,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/graph/AbstractNetwork.html b/releases/snapshot-jre/api/docs/com/google/common/graph/AbstractNetwork.html index 2c2fc5db6293..a37c2cd4fb56 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/graph/AbstractNetwork.html +++ b/releases/snapshot-jre/api/docs/com/google/common/graph/AbstractNetwork.html @@ -279,7 +279,8 @@

    Method Summary

    boolean equals​(java.lang.Object obj) -
    Indicates whether some other object is "equal to" this one.
    +
    Returns true iff object is a Network that has the same elements and the + same structural relationships as those in this network.
    @@ -302,7 +303,7 @@

    Method Summary

    int hashCode() -
    Returns a hash code value for the object.
    +
    Returns the hash code for this network.
    @@ -691,58 +692,30 @@

    isOrderingCompatible

    equals

    public final boolean equals​(@CheckForNull
                             java.lang.Object obj)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: +

    Description copied from interface: Network
    +
    Returns true iff object is a Network that has the same elements and the + same structural relationships as those in this network. + +

    Thus, two networks A and B are equal if all of the following are true: +

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. +
    • A and B have equal directedness. +
    • A and B have equal node sets. +
    • A and B have equal edge sets. +
    • Every edge in A and B connects the same nodes in the same direction (if any).
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    + +

    Network properties besides directedness do not affect equality. + For example, two networks may be considered equal even if one allows parallel edges and the + other doesn't. Additionally, the order in which nodes or edges are added to the network, and + the order in which they are iterated over, are irrelevant. + +

    A reference implementation of this is provided by equals(Object).

    Specified by:
    equals in interface Network<N,​E>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -753,45 +726,16 @@

    equals

  • hashCode

    public final int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    +
    Description copied from interface: Network
    +
    Returns the hash code for this network. The hash code of a network is defined as the hash code + of a map from each of its edges to their incident nodes. + +

    A reference implementation of this is provided by hashCode().

    Specified by:
    hashCode in interface Network<N,​E>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -806,8 +750,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/graph/AbstractValueGraph.html b/releases/snapshot-jre/api/docs/com/google/common/graph/AbstractValueGraph.html index 2262df4dc28f..4a7dfef95832 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/graph/AbstractValueGraph.html +++ b/releases/snapshot-jre/api/docs/com/google/common/graph/AbstractValueGraph.html @@ -250,7 +250,8 @@

    Method Summary

    boolean equals​(java.lang.Object obj) -
    Indicates whether some other object is "equal to" this one.
    +
    Returns true iff object is a ValueGraph that has the same elements and + the same structural relationships as those in this graph.
    @@ -268,7 +269,7 @@

    Method Summary

    int hashCode() -
    Returns a hash code value for the object.
    +
    Returns the hash code for this graph.
    @@ -426,58 +427,30 @@

    edgeValue

    equals

    public final boolean equals​(@CheckForNull
                             java.lang.Object obj)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: +

    Description copied from interface: ValueGraph
    +
    Returns true iff object is a ValueGraph that has the same elements and + the same structural relationships as those in this graph. + +

    Thus, two value graphs A and B are equal if all of the following are true: +

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. +
    • A and B have equal directedness. +
    • A and B have equal node sets. +
    • A and B have equal edge sets. +
    • The value of a given edge is the same in both A and B.
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    + +

    Graph properties besides directedness do not affect equality. + For example, two graphs may be considered equal even if one allows self-loops and the other + doesn't. Additionally, the order in which nodes or edges are added to the graph, and the order + in which they are iterated over, are irrelevant. + +

    A reference implementation of this is provided by equals(Object).

    Specified by:
    equals in interface ValueGraph<N,​V>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -488,45 +461,16 @@

    equals

  • hashCode

    public final int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    +
    Description copied from interface: ValueGraph
    +
    Returns the hash code for this graph. The hash code of a graph is defined as the hash code of a + map from each of its edges to the associated edge value. + +

    A reference implementation of this is provided by hashCode().

    Specified by:
    hashCode in interface ValueGraph<N,​V>
    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -541,8 +485,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/graph/ElementOrder.html b/releases/snapshot-jre/api/docs/com/google/common/graph/ElementOrder.html index 4cb2122d15f9..9e51b1bd3529 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/graph/ElementOrder.html +++ b/releases/snapshot-jre/api/docs/com/google/common/graph/ElementOrder.html @@ -206,16 +206,12 @@

    Method Summary

    boolean equals​(java.lang.Object obj) - -
    Indicates whether some other object is "equal to" this one.
    - +  int hashCode() - -
    Returns a hash code value for the object.
    - +  static <S> ElementOrder<S> @@ -250,9 +246,7 @@

    Method Summary

    java.lang.String toString() - -
    Returns a string representation of the object.
    - +  ElementOrder.Type @@ -410,56 +404,9 @@

    comparator

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object obj)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -470,43 +417,9 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -517,29 +430,9 @@

    hashCode

  • toString

    public java.lang.String toString()
    -
    Description copied from class: java.lang.Object
    -
    Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

    - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

    - 
    - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/graph/EndpointPair.html b/releases/snapshot-jre/api/docs/com/google/common/graph/EndpointPair.html index b56bfbe78e72..211a1743e3b8 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/graph/EndpointPair.html +++ b/releases/snapshot-jre/api/docs/com/google/common/graph/EndpointPair.html @@ -403,8 +403,6 @@

    iterator

    Specified by:
    iterator in interface java.lang.Iterable<N>
    -
    Returns:
    -
    an Iterator.
    @@ -422,14 +420,6 @@

    equals

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -446,11 +436,6 @@

    hashCode

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/graph/Graph.html b/releases/snapshot-jre/api/docs/com/google/common/graph/Graph.html index f9fa0d9ef92a..fc30b017549b 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/graph/Graph.html +++ b/releases/snapshot-jre/api/docs/com/google/common/graph/Graph.html @@ -660,14 +660,6 @@

    equals

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -685,11 +677,6 @@

    hashCode

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/graph/Network.html b/releases/snapshot-jre/api/docs/com/google/common/graph/Network.html index daf147208389..e09b01523c5a 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/graph/Network.html +++ b/releases/snapshot-jre/api/docs/com/google/common/graph/Network.html @@ -996,14 +996,6 @@

    equals

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -1021,11 +1013,6 @@

    hashCode

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/graph/ValueGraph.html b/releases/snapshot-jre/api/docs/com/google/common/graph/ValueGraph.html index 1e716c0ac74c..d8fe223169b6 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/graph/ValueGraph.html +++ b/releases/snapshot-jre/api/docs/com/google/common/graph/ValueGraph.html @@ -812,14 +812,6 @@

    equals

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -837,11 +829,6 @@

    hashCode

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/hash/BloomFilter.html b/releases/snapshot-jre/api/docs/com/google/common/hash/BloomFilter.html index d4e022e3fb2a..42b0f843a814 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/hash/BloomFilter.html +++ b/releases/snapshot-jre/api/docs/com/google/common/hash/BloomFilter.html @@ -258,7 +258,7 @@

    Method Summary

    boolean equals​(java.lang.Object object) -
    Indicates whether some other object is "equal to" this one.
    +
    Indicates whether another object is equal to this predicate.
    @@ -272,9 +272,7 @@

    Method Summary

    int hashCode() - -
    Returns a hash code value for the object.
    - +  boolean @@ -547,58 +545,20 @@

    putAll

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object object)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    +
    Description copied from interface: Predicate
    +
    Indicates whether another object is equal to this predicate. + +

    Most implementations will have no reason to override the behavior of Object.equals(java.lang.Object). + However, an implementation may also choose to return true whenever object is a + Predicate that it considers interchangeable with this one. "Interchangeable" + typically means that this.apply(t) == that.apply(t) for all t of type + T). Note that a false result from this method does not imply that the + predicates are known not to be interchangeable.

    Specified by:
    equals in interface Predicate<T extends @Nullable java.lang.Object>
    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -609,43 +569,9 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/hash/HashCode.html b/releases/snapshot-jre/api/docs/com/google/common/hash/HashCode.html index 1cbb2e6e271b..28979ccdb2d9 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/hash/HashCode.html +++ b/releases/snapshot-jre/api/docs/com/google/common/hash/HashCode.html @@ -457,14 +457,6 @@

    equals

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -481,11 +473,6 @@

    hashCode

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    @@ -508,8 +495,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/hash/Hasher.html b/releases/snapshot-jre/api/docs/com/google/common/hash/Hasher.html index 25cc181cf2e0..0fbc4eb9b169 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/hash/Hasher.html +++ b/releases/snapshot-jre/api/docs/com/google/common/hash/Hasher.html @@ -599,42 +599,9 @@

    hashCode

    This returns Object.hashCode(); you almost certainly mean to call hash().asInt().
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/hash/HashingInputStream.html b/releases/snapshot-jre/api/docs/com/google/common/hash/HashingInputStream.html index 36c2f0337b2c..b64c76a3d701 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/hash/HashingInputStream.html +++ b/releases/snapshot-jre/api/docs/com/google/common/hash/HashingInputStream.html @@ -340,13 +340,8 @@

    read

    Overrides:
    read in class java.io.FilterInputStream
    -
    Returns:
    -
    the next byte of data, or -1 if the end of the - stream is reached.
    Throws:
    -
    java.io.IOException - if an I/O error occurs.
    -
    See Also:
    -
    FilterInputStream.in
    +
    java.io.IOException
    @@ -366,18 +361,8 @@

    read

    Overrides:
    read in class java.io.FilterInputStream
    -
    Parameters:
    -
    bytes - the buffer into which the data is read.
    -
    off - the start offset in the destination array b
    -
    len - the maximum number of bytes read.
    -
    Returns:
    -
    the total number of bytes read into the buffer, or - -1 if there is no more data because the end of - the stream has been reached.
    Throws:
    -
    java.io.IOException - if an I/O error occurs.
    -
    See Also:
    -
    FilterInputStream.in
    +
    java.io.IOException
    @@ -394,10 +379,6 @@

    markSupported

    markSupported in class java.io.FilterInputStream
    Returns:
    false always
    -
    See Also:
    -
    FilterInputStream.in, -InputStream.mark(int), -InputStream.reset()
    @@ -412,12 +393,6 @@

    mark

    Overrides:
    mark in class java.io.FilterInputStream
    -
    Parameters:
    -
    readlimit - the maximum limit of bytes that can be read before - the mark position becomes invalid.
    -
    See Also:
    -
    FilterInputStream.in, -FilterInputStream.reset()
    @@ -435,9 +410,6 @@

    reset

    reset in class java.io.FilterInputStream
    Throws:
    java.io.IOException - this operation is not supported
    -
    See Also:
    -
    FilterInputStream.in, -FilterInputStream.mark(int)
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/hash/HashingOutputStream.html b/releases/snapshot-jre/api/docs/com/google/common/hash/HashingOutputStream.html index b7d13ed653e2..e4c30693e050 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/hash/HashingOutputStream.html +++ b/releases/snapshot-jre/api/docs/com/google/common/hash/HashingOutputStream.html @@ -221,10 +221,7 @@

    Method Summary

    void close() - -
    Closes this output stream and releases any system resources - associated with the stream.
    - +  HashCode @@ -238,18 +235,12 @@

    Method Summary

    write​(byte[] bytes, int off, int len) - -
    Writes len bytes from the specified - byte array starting at offset off to - this output stream.
    - +  void write​(int b) - -
    Writes the specified byte to this output stream.
    - + 
      @@ -321,21 +312,11 @@

      Method Detail

      write

      public void write​(int b)
            throws java.io.IOException
      -
      Description copied from class: java.io.FilterOutputStream
      -
      Writes the specified byte to this output stream. -

      - The write method of FilterOutputStream - calls the write method of its underlying output stream, - that is, it performs out.write(b). -

      - Implements the abstract write method of OutputStream.

      Overrides:
      write in class java.io.FilterOutputStream
      -
      Parameters:
      -
      b - the byte.
      Throws:
      -
      java.io.IOException - if an I/O error occurs.
      +
      java.io.IOException
    @@ -349,30 +330,11 @@

    write

    int off, int len) throws java.io.IOException -
    Description copied from class: java.io.FilterOutputStream
    -
    Writes len bytes from the specified - byte array starting at offset off to - this output stream. -

    - The write method of FilterOutputStream - calls the write method of one argument on each - byte to output. -

    - Note that this method does not call the write method - of its underlying output stream with the same arguments. Subclasses - of FilterOutputStream should provide a more efficient - implementation of this method.

    Overrides:
    write in class java.io.FilterOutputStream
    -
    Parameters:
    -
    bytes - the data.
    -
    off - the start offset in the data.
    -
    len - the number of bytes to write.
    Throws:
    -
    java.io.IOException - if an I/O error occurs.
    -
    See Also:
    -
    FilterOutputStream.write(int)
    +
    java.io.IOException
    @@ -395,13 +357,6 @@

    hash

    close

    public void close()
            throws java.io.IOException
    -
    Description copied from class: java.io.FilterOutputStream
    -
    Closes this output stream and releases any system resources - associated with the stream. -

    - When not already closed, the close method of - FilterOutputStream calls its flush method, and then - calls the close method of its underlying output stream.

    Specified by:
    close in interface java.lang.AutoCloseable
    @@ -410,10 +365,7 @@

    close

    Overrides:
    close in class java.io.FilterOutputStream
    Throws:
    -
    java.io.IOException - if an I/O error occurs.
    -
    See Also:
    -
    FilterOutputStream.flush(), -FilterOutputStream.out
    +
    java.io.IOException
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/io/ByteArrayDataInput.html b/releases/snapshot-jre/api/docs/com/google/common/io/ByteArrayDataInput.html index 1b31e42f1fe2..cb1b65c32f43 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/io/ByteArrayDataInput.html +++ b/releases/snapshot-jre/api/docs/com/google/common/io/ByteArrayDataInput.html @@ -166,131 +166,79 @@

    Method Summary

    boolean readBoolean() - -
    Reads one input byte and returns - true if that byte is nonzero, - false if that byte is zero.
    - +  byte readByte() - -
    Reads and returns one input byte.
    - +  char readChar() - -
    Reads two input bytes and returns a char value.
    - +  double readDouble() - -
    Reads eight input bytes and returns - a double value.
    - +  float readFloat() - -
    Reads four input bytes and returns - a float value.
    - +  void readFully​(byte[] b) - -
    Reads some bytes from an input - stream and stores them into the buffer - array b.
    - +  void readFully​(byte[] b, int off, int len) - -
    Reads len - bytes from - an input stream.
    - +  int readInt() - -
    Reads four input bytes and returns an - int value.
    - +  java.lang.String readLine() - -
    Reads the next line of text from the input stream.
    - +  long readLong() - -
    Reads eight input bytes and returns - a long value.
    - +  short readShort() - -
    Reads two input bytes and returns - a short value.
    - +  int readUnsignedByte() - -
    Reads one input byte, zero-extends - it to type int, and returns - the result, which is therefore in the range - 0 - through 255.
    - +  int readUnsignedShort() - -
    Reads two input bytes and returns - an int value in the range 0 - through 65535.
    - +  java.lang.String readUTF() - -
    Reads in a string that has been encoded using a - modified UTF-8 - format.
    - +  int skipBytes​(int n) - -
    Makes an attempt to skip over - n bytes - of data from the input - stream, discarding the skipped bytes.
    - +  @@ -316,45 +264,9 @@

    Method Detail

  • readFully

    void readFully​(byte[] b)
    -
    Description copied from interface: java.io.DataInput
    -
    Reads some bytes from an input - stream and stores them into the buffer - array b. The number of bytes - read is equal - to the length of b. -

    - This method blocks until one of the - following conditions occurs: -

      -
    • b.length - bytes of input data are available, in which - case a normal return is made. - -
    • End of - file is detected, in which case an EOFException - is thrown. - -
    • An I/O error occurs, in - which case an IOException other - than EOFException is thrown. -
    -

    - If b is null, - a NullPointerException is thrown. - If b.length is zero, then - no bytes are read. Otherwise, the first - byte read is stored into element b[0], - the next one into b[1], and - so on. - If an exception is thrown from - this method, then it may be that some but - not all bytes of b have been - updated with data from the input stream.

    Specified by:
    readFully in interface java.io.DataInput
    -
    Parameters:
    -
    b - the buffer into which the data is read.
    • @@ -367,48 +279,9 @@

    readFully

    void readFully​(byte[] b,
                int off,
                int len)
    -
    Description copied from interface: java.io.DataInput
    -
    Reads len - bytes from - an input stream. -

    - This method - blocks until one of the following conditions - occurs: -

      -
    • len bytes - of input data are available, in which case - a normal return is made. - -
    • End of file - is detected, in which case an EOFException - is thrown. - -
    • An I/O error occurs, in - which case an IOException other - than EOFException is thrown. -
    -

    - If b is null, - a NullPointerException is thrown. - If off is negative, or len - is negative, or off+len is - greater than the length of the array b, - then an IndexOutOfBoundsException - is thrown. - If len is zero, - then no bytes are read. Otherwise, the first - byte read is stored into element b[off], - the next one into b[off+1], - and so on. The number of bytes read is, - at most, equal to len.

    Specified by:
    readFully in interface java.io.DataInput
    -
    Parameters:
    -
    b - the buffer into which the data is read.
    -
    off - an int specifying the offset in the data array b.
    -
    len - an int specifying the number of bytes to read.
    @@ -419,29 +292,9 @@

    readFully

  • skipBytes

    int skipBytes​(int n)
    -
    Description copied from interface: java.io.DataInput
    -
    Makes an attempt to skip over - n bytes - of data from the input - stream, discarding the skipped bytes. However, - it may skip - over some smaller number of - bytes, possibly zero. This may result from - any of a - number of conditions; reaching - end of file before n bytes - have been skipped is - only one possibility. - This method never throws an EOFException. - The actual - number of bytes skipped is returned.
    Specified by:
    skipBytes in interface java.io.DataInput
    -
    Parameters:
    -
    n - the number of bytes to be skipped.
    -
    Returns:
    -
    the number of bytes actually skipped.
    • @@ -453,18 +306,9 @@

    skipBytes

    readBoolean

    @CanIgnoreReturnValue
 boolean readBoolean()
    -
    Description copied from interface: java.io.DataInput
    -
    Reads one input byte and returns - true if that byte is nonzero, - false if that byte is zero. - This method is suitable for reading - the byte written by the writeBoolean - method of interface DataOutput.
    Specified by:
    readBoolean in interface java.io.DataInput
    -
    Returns:
    -
    the boolean value read.
    @@ -476,19 +320,9 @@

    readBoolean

    readByte

    @CanIgnoreReturnValue
 byte readByte()
    -
    Description copied from interface: java.io.DataInput
    -
    Reads and returns one input byte. - The byte is treated as a signed value in - the range -128 through 127, - inclusive. - This method is suitable for - reading the byte written by the writeByte - method of interface DataOutput.
    Specified by:
    readByte in interface java.io.DataInput
    -
    Returns:
    -
    the 8-bit value read.
    @@ -500,23 +334,9 @@

    readByte

    readUnsignedByte

    @CanIgnoreReturnValue
 int readUnsignedByte()
    -
    Description copied from interface: java.io.DataInput
    -
    Reads one input byte, zero-extends - it to type int, and returns - the result, which is therefore in the range - 0 - through 255. - This method is suitable for reading - the byte written by the writeByte - method of interface DataOutput - if the argument to writeByte - was intended to be a value in the range - 0 through 255.
    Specified by:
    readUnsignedByte in interface java.io.DataInput
    -
    Returns:
    -
    the unsigned 8-bit value read.
    @@ -528,24 +348,9 @@

    readUnsignedByte

    readShort

    @CanIgnoreReturnValue
 short readShort()
    -
    Description copied from interface: java.io.DataInput
    -
    Reads two input bytes and returns - a short value. Let a - be the first byte read and b - be the second byte. The value - returned - is: - 
    (short)((a << 8) | (b & 0xff))
-
    - This method - is suitable for reading the bytes written - by the writeShort method of - interface DataOutput.
    Specified by:
    readShort in interface java.io.DataInput
    -
    Returns:
    -
    the 16-bit value read.
    @@ -557,26 +362,9 @@

    readShort

    readUnsignedShort

    @CanIgnoreReturnValue
 int readUnsignedShort()
    -
    Description copied from interface: java.io.DataInput
    -
    Reads two input bytes and returns - an int value in the range 0 - through 65535. Let a - be the first byte read and - b - be the second byte. The value returned is: - 
    (((a & 0xff) << 8) | (b & 0xff))
-
    - This method is suitable for reading the bytes - written by the writeShort method - of interface DataOutput if - the argument to writeShort - was intended to be a value in the range - 0 through 65535.
    Specified by:
    readUnsignedShort in interface java.io.DataInput
    -
    Returns:
    -
    the unsigned 16-bit value read.
    @@ -588,23 +376,9 @@

    readUnsignedShort

    readChar

    @CanIgnoreReturnValue
 char readChar()
    -
    Description copied from interface: java.io.DataInput
    -
    Reads two input bytes and returns a char value. - Let a - be the first byte read and b - be the second byte. The value - returned is: - 
    (char)((a << 8) | (b & 0xff))
-
    - This method - is suitable for reading bytes written by - the writeChar method of interface - DataOutput.
    Specified by:
    readChar in interface java.io.DataInput
    -
    Returns:
    -
    the char value read.
    @@ -616,22 +390,9 @@

    readChar

    readInt

    @CanIgnoreReturnValue
 int readInt()
    -
    Description copied from interface: java.io.DataInput
    -
    Reads four input bytes and returns an - int value. Let a-d - be the first through fourth bytes read. The value returned is: - 
    
- (((a & 0xff) << 24) | ((b & 0xff) << 16) |
-  ((c & 0xff) <<  8) | (d & 0xff))
-
    - This method is suitable - for reading bytes written by the writeInt - method of interface DataOutput.
    Specified by:
    readInt in interface java.io.DataInput
    -
    Returns:
    -
    the int value read.
    @@ -643,30 +404,9 @@

    readInt

    readLong

    @CanIgnoreReturnValue
 long readLong()
    -
    Description copied from interface: java.io.DataInput
    -
    Reads eight input bytes and returns - a long value. Let a-h - be the first through eighth bytes read. - The value returned is: - 
    
- (((long)(a & 0xff) << 56) |
-  ((long)(b & 0xff) << 48) |
-  ((long)(c & 0xff) << 40) |
-  ((long)(d & 0xff) << 32) |
-  ((long)(e & 0xff) << 24) |
-  ((long)(f & 0xff) << 16) |
-  ((long)(g & 0xff) <<  8) |
-  ((long)(h & 0xff)))
-
    -

    - This method is suitable - for reading bytes written by the writeLong - method of interface DataOutput.

    Specified by:
    readLong in interface java.io.DataInput
    -
    Returns:
    -
    the long value read.
    @@ -678,23 +418,9 @@

    readLong

    readFloat

    @CanIgnoreReturnValue
 float readFloat()
    -
    Description copied from interface: java.io.DataInput
    -
    Reads four input bytes and returns - a float value. It does this - by first constructing an int - value in exactly the manner - of the readInt - method, then converting this int - value to a float in - exactly the manner of the method Float.intBitsToFloat. - This method is suitable for reading - bytes written by the writeFloat - method of interface DataOutput.
    Specified by:
    readFloat in interface java.io.DataInput
    -
    Returns:
    -
    the float value read.
    @@ -706,23 +432,9 @@

    readFloat

    readDouble

    @CanIgnoreReturnValue
 double readDouble()
    -
    Description copied from interface: java.io.DataInput
    -
    Reads eight input bytes and returns - a double value. It does this - by first constructing a long - value in exactly the manner - of the readLong - method, then converting this long - value to a double in exactly - the manner of the method Double.longBitsToDouble. - This method is suitable for reading - bytes written by the writeDouble - method of interface DataOutput.
    Specified by:
    readDouble in interface java.io.DataInput
    -
    Returns:
    -
    the double value read.
    @@ -735,46 +447,9 @@

    readLine

    @CanIgnoreReturnValue
 @CheckForNull
 java.lang.String readLine()
    -
    Description copied from interface: java.io.DataInput
    -
    Reads the next line of text from the input stream. - It reads successive bytes, converting - each byte separately into a character, - until it encounters a line terminator or - end of - file; the characters read are then - returned as a String. Note - that because this - method processes bytes, - it does not support input of the full Unicode - character set. -

    - If end of file is encountered - before even one byte can be read, then null - is returned. Otherwise, each byte that is - read is converted to type char - by zero-extension. If the character '\n' - is encountered, it is discarded and reading - ceases. If the character '\r' - is encountered, it is discarded and, if - the following byte converts to the - character '\n', then that is - discarded also; reading then ceases. If - end of file is encountered before either - of the characters '\n' and - '\r' is encountered, reading - ceases. Once reading has ceased, a String - is returned that contains all the characters - read and not discarded, taken in order. - Note that every character in this string - will have a value less than \u0100, - that is, (char)256.

    Specified by:
    readLine in interface java.io.DataInput
    -
    Returns:
    -
    the next line of text from the input stream, - or null if the end of file is - encountered before a byte can be read.
    @@ -786,89 +461,9 @@

    readLine

    readUTF

    @CanIgnoreReturnValue
 java.lang.String readUTF()
    -
    Description copied from interface: java.io.DataInput
    -
    Reads in a string that has been encoded using a - modified UTF-8 - format. - The general contract of readUTF - is that it reads a representation of a Unicode - character string encoded in modified - UTF-8 format; this string of characters - is then returned as a String. -

    - First, two bytes are read and used to - construct an unsigned 16-bit integer in - exactly the manner of the readUnsignedShort - method . This integer value is called the - UTF length and specifies the number - of additional bytes to be read. These bytes - are then converted to characters by considering - them in groups. The length of each group - is computed from the value of the first - byte of the group. The byte following a - group, if any, is the first byte of the - next group. -

    - If the first byte of a group - matches the bit pattern 0xxxxxxx - (where x means "may be 0 - or 1"), then the group consists - of just that byte. The byte is zero-extended - to form a character. -

    - If the first byte - of a group matches the bit pattern 110xxxxx, - then the group consists of that byte a - and a second byte b. If there - is no byte b (because byte - a was the last of the bytes - to be read), or if byte b does - not match the bit pattern 10xxxxxx, - then a UTFDataFormatException - is thrown. Otherwise, the group is converted - to the character: - 

    (char)(((a & 0x1F) << 6) | (b & 0x3F))
-
    - If the first byte of a group - matches the bit pattern 1110xxxx, - then the group consists of that byte a - and two more bytes b and c. - If there is no byte c (because - byte a was one of the last - two of the bytes to be read), or either - byte b or byte c - does not match the bit pattern 10xxxxxx, - then a UTFDataFormatException - is thrown. Otherwise, the group is converted - to the character: - 
    
- (char)(((a & 0x0F) << 12) | ((b & 0x3F) << 6) | (c & 0x3F))
-
    - If the first byte of a group matches the - pattern 1111xxxx or the pattern - 10xxxxxx, then a UTFDataFormatException - is thrown. -

    - If end of file is encountered - at any time during this entire process, - then an EOFException is thrown. -

    - After every group has been converted to - a character by this process, the characters - are gathered, in the same order in which - their corresponding groups were read from - the input stream, to form a String, - which is returned. -

    - The writeUTF - method of interface DataOutput - may be used to write data that is suitable - for reading by this method.

    Specified by:
    readUTF in interface java.io.DataInput
    -
    Returns:
    -
    a Unicode string.
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/io/ByteArrayDataOutput.html b/releases/snapshot-jre/api/docs/com/google/common/io/ByteArrayDataOutput.html index 4a54b703e26f..0f728643e2c7 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/io/ByteArrayDataOutput.html +++ b/releases/snapshot-jre/api/docs/com/google/common/io/ByteArrayDataOutput.html @@ -169,43 +169,29 @@

    Method Summary

    void write​(byte[] b) - -
    Writes to the output stream all the bytes in array b.
    - +  void write​(byte[] b, int off, int len) - -
    Writes len bytes from array - b, in order, to - the output stream.
    - +  void write​(int b) - -
    Writes to the output stream the eight - low-order bits of the argument b.
    - +  void writeBoolean​(boolean v) - -
    Writes a boolean value to this output stream.
    - +  void writeByte​(int v) - -
    Writes to the output stream the eight low- - order bits of the argument v.
    - +  void @@ -219,72 +205,42 @@

    Method Summary

    void writeChar​(int v) - -
    Writes a char value, which - is comprised of two bytes, to the - output stream.
    - +  void writeChars​(java.lang.String s) - -
    Writes every character in the string s, - to the output stream, in order, - two bytes per character.
    - +  void writeDouble​(double v) - -
    Writes a double value, - which is comprised of eight bytes, to the output stream.
    - +  void writeFloat​(float v) - -
    Writes a float value, - which is comprised of four bytes, to the output stream.
    - +  void writeInt​(int v) - -
    Writes an int value, which is - comprised of four bytes, to the output stream.
    - +  void writeLong​(long v) - -
    Writes a long value, which is - comprised of eight bytes, to the output stream.
    - +  void writeShort​(int v) - -
    Writes two bytes to the output - stream to represent the value of the argument.
    - +  void writeUTF​(java.lang.String s) - -
    Writes two bytes of length information - to the output stream, followed - by the - modified UTF-8 - representation - of every character in the string s.
    - +  @@ -310,16 +266,9 @@

    Method Detail

  • write

    void write​(int b)
    -
    Description copied from interface: java.io.DataOutput
    -
    Writes to the output stream the eight - low-order bits of the argument b. - The 24 high-order bits of b - are ignored.
    Specified by:
    write in interface java.io.DataOutput
    -
    Parameters:
    -
    b - the byte to be written.
    • @@ -330,20 +279,9 @@

    write

  • write

    void write​(byte[] b)
    -
    Description copied from interface: java.io.DataOutput
    -
    Writes to the output stream all the bytes in array b. - If b is null, - a NullPointerException is thrown. - If b.length is zero, then - no bytes are written. Otherwise, the byte - b[0] is written first, then - b[1], and so on; the last byte - written is b[b.length-1].
    Specified by:
    write in interface java.io.DataOutput
    -
    Parameters:
    -
    b - the data.
    • @@ -356,27 +294,9 @@

    write

    void write​(byte[] b,
            int off,
            int len)
    -
    Description copied from interface: java.io.DataOutput
    -
    Writes len bytes from array - b, in order, to - the output stream. If b - is null, a NullPointerException - is thrown. If off is negative, - or len is negative, or off+len - is greater than the length of the array - b, then an IndexOutOfBoundsException - is thrown. If len is zero, - then no bytes are written. Otherwise, the - byte b[off] is written first, - then b[off+1], and so on; the - last byte written is b[off+len-1].
    Specified by:
    write in interface java.io.DataOutput
    -
    Parameters:
    -
    b - the data.
    -
    off - the start offset in the data.
    -
    len - the number of bytes to write.
    @@ -387,22 +307,9 @@

    write

  • writeBoolean

    void writeBoolean​(boolean v)
    -
    Description copied from interface: java.io.DataOutput
    -
    Writes a boolean value to this output stream. - If the argument v - is true, the value (byte)1 - is written; if v is false, - the value (byte)0 is written. - The byte written by this method may - be read by the readBoolean - method of interface DataInput, - which will then return a boolean - equal to v.
    Specified by:
    writeBoolean in interface java.io.DataOutput
    -
    Parameters:
    -
    v - the boolean to be written.
    • @@ -413,22 +320,9 @@

    writeBoolean

  • writeByte

    void writeByte​(int v)
    -
    Description copied from interface: java.io.DataOutput
    -
    Writes to the output stream the eight low- - order bits of the argument v. - The 24 high-order bits of v - are ignored. (This means that writeByte - does exactly the same thing as write - for an integer argument.) The byte written - by this method may be read by the readByte - method of interface DataInput, - which will then return a byte - equal to (byte)v.
    Specified by:
    writeByte in interface java.io.DataOutput
    -
    Parameters:
    -
    v - the byte value to be written.
    • @@ -439,25 +333,9 @@

    writeByte

  • writeShort

    void writeShort​(int v)
    -
    Description copied from interface: java.io.DataOutput
    -
    Writes two bytes to the output - stream to represent the value of the argument. - The byte values to be written, in the order - shown, are: - 
    
- (byte)(0xff & (v >> 8))
- (byte)(0xff & v)
-

    - The bytes written by this method may be - read by the readShort method - of interface DataInput , which - will then return a short equal - to (short)v.

    Specified by:
    writeShort in interface java.io.DataOutput
    -
    Parameters:
    -
    v - the short value to be written.
    • @@ -468,26 +346,9 @@

    writeShort

  • writeChar

    void writeChar​(int v)
    -
    Description copied from interface: java.io.DataOutput
    -
    Writes a char value, which - is comprised of two bytes, to the - output stream. - The byte values to be written, in the order - shown, are: - 
    
- (byte)(0xff & (v >> 8))
- (byte)(0xff & v)
-

    - The bytes written by this method may be - read by the readChar method - of interface DataInput , which - will then return a char equal - to (char)v.

    Specified by:
    writeChar in interface java.io.DataOutput
    -
    Parameters:
    -
    v - the char value to be written.
    • @@ -498,26 +359,9 @@

    writeChar

  • writeInt

    void writeInt​(int v)
    -
    Description copied from interface: java.io.DataOutput
    -
    Writes an int value, which is - comprised of four bytes, to the output stream. - The byte values to be written, in the order - shown, are: - 
    
- (byte)(0xff & (v >> 24))
- (byte)(0xff & (v >> 16))
- (byte)(0xff & (v >>  8))
- (byte)(0xff & v)
-

    - The bytes written by this method may be read - by the readInt method of interface - DataInput , which will then - return an int equal to v.

    Specified by:
    writeInt in interface java.io.DataOutput
    -
    Parameters:
    -
    v - the int value to be written.
    • @@ -528,31 +372,9 @@

    writeInt

  • writeLong

    void writeLong​(long v)
    -
    Description copied from interface: java.io.DataOutput
    -
    Writes a long value, which is - comprised of eight bytes, to the output stream. - The byte values to be written, in the order - shown, are: - 
    
- (byte)(0xff & (v >> 56))
- (byte)(0xff & (v >> 48))
- (byte)(0xff & (v >> 40))
- (byte)(0xff & (v >> 32))
- (byte)(0xff & (v >> 24))
- (byte)(0xff & (v >> 16))
- (byte)(0xff & (v >>  8))
- (byte)(0xff & v)
-

    - The bytes written by this method may be - read by the readLong method - of interface DataInput , which - will then return a long equal - to v.

    Specified by:
    writeLong in interface java.io.DataOutput
    -
    Parameters:
    -
    v - the long value to be written.
    • @@ -563,24 +385,9 @@

    writeLong

  • writeFloat

    void writeFloat​(float v)
    -
    Description copied from interface: java.io.DataOutput
    -
    Writes a float value, - which is comprised of four bytes, to the output stream. - It does this as if it first converts this - float value to an int - in exactly the manner of the Float.floatToIntBits - method and then writes the int - value in exactly the manner of the writeInt - method. The bytes written by this method - may be read by the readFloat - method of interface DataInput, - which will then return a float - equal to v.
    Specified by:
    writeFloat in interface java.io.DataOutput
    -
    Parameters:
    -
    v - the float value to be written.
    • @@ -591,24 +398,9 @@

    writeFloat

  • writeDouble

    void writeDouble​(double v)
    -
    Description copied from interface: java.io.DataOutput
    -
    Writes a double value, - which is comprised of eight bytes, to the output stream. - It does this as if it first converts this - double value to a long - in exactly the manner of the Double.doubleToLongBits - method and then writes the long - value in exactly the manner of the writeLong - method. The bytes written by this method - may be read by the readDouble - method of interface DataInput, - which will then return a double - equal to v.
    Specified by:
    writeDouble in interface java.io.DataOutput
    -
    Parameters:
    -
    v - the double value to be written.
    • @@ -619,25 +411,9 @@

    writeDouble

  • writeChars

    void writeChars​(java.lang.String s)
    -
    Description copied from interface: java.io.DataOutput
    -
    Writes every character in the string s, - to the output stream, in order, - two bytes per character. If s - is null, a NullPointerException - is thrown. If s.length - is zero, then no characters are written. - Otherwise, the character s[0] - is written first, then s[1], - and so on; the last character written is - s[s.length-1]. For each character, - two bytes are actually written, high-order - byte first, in exactly the manner of the - writeChar method.
    Specified by:
    writeChars in interface java.io.DataOutput
    -
    Parameters:
    -
    s - the string value to be written.
    • @@ -648,59 +424,9 @@

    writeChars

  • writeUTF

    void writeUTF​(java.lang.String s)
    -
    Description copied from interface: java.io.DataOutput
    -
    Writes two bytes of length information - to the output stream, followed - by the - modified UTF-8 - representation - of every character in the string s. - If s is null, - a NullPointerException is thrown. - Each character in the string s - is converted to a group of one, two, or - three bytes, depending on the value of the - character.

    - If a character c - is in the range \u0001 through - \u007f, it is represented - by one byte: - 

    (byte)c

    - If a character c is \u0000 - or is in the range \u0080 - through \u07ff, then it is - represented by two bytes, to be written - in the order shown: 

    
- (byte)(0xc0 | (0x1f & (c >> 6)))
- (byte)(0x80 | (0x3f & c))
-

    If a character - c is in the range \u0800 - through uffff, then it is - represented by three bytes, to be written - in the order shown: 

    
- (byte)(0xe0 | (0x0f & (c >> 12)))
- (byte)(0x80 | (0x3f & (c >>  6)))
- (byte)(0x80 | (0x3f & c))
-

    First, - the total number of bytes needed to represent - all the characters of s is - calculated. If this number is larger than - 65535, then a UTFDataFormatException - is thrown. Otherwise, this length is written - to the output stream in exactly the manner - of the writeShort method; - after this, the one-, two-, or three-byte - representation of each character in the - string s is written.

    The - bytes written by this method may be read - by the readUTF method of interface - DataInput , which will then - return a String equal to s.

    Specified by:
    writeUTF in interface java.io.DataOutput
    -
    Parameters:
    -
    s - the string value to be written.
    • @@ -716,27 +442,9 @@

    writeBytes

    This method is dangerous as it discards the high byte of every character. For UTF-8, use write(s.getBytes(StandardCharsets.UTF_8)).
    -
    Description copied from interface: java.io.DataOutput
    -
    Writes a string to the output stream. - For every character in the string - s, taken in order, one byte - is written to the output stream. If - s is null, a NullPointerException - is thrown.

    If s.length - is zero, then no bytes are written. Otherwise, - the character s[0] is written - first, then s[1], and so on; - the last character written is s[s.length-1]. - For each character, one byte is written, - the low-order byte, in exactly the manner - of the writeByte method . The - high-order eight bits of each character - in the string are ignored.

    Specified by:
    writeBytes in interface java.io.DataOutput
    -
    Parameters:
    -
    s - the string of bytes to be written.
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/io/Closer.html b/releases/snapshot-jre/api/docs/com/google/common/io/Closer.html index 334ac80db8d9..b6472bfb45d7 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/io/Closer.html +++ b/releases/snapshot-jre/api/docs/com/google/common/io/Closer.html @@ -414,7 +414,7 @@

    close

    Specified by:
    close in interface java.io.Closeable
    Throws:
    -
    java.io.IOException - if an I/O error occurs
    +
    java.io.IOException
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/io/CountingInputStream.html b/releases/snapshot-jre/api/docs/com/google/common/io/CountingInputStream.html index b92bc9008be3..c80ac303d356 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/io/CountingInputStream.html +++ b/releases/snapshot-jre/api/docs/com/google/common/io/CountingInputStream.html @@ -227,42 +227,29 @@

    Method Summary

    void mark​(int readlimit) - -
    Marks the current position in this input stream.
    - +  int read() - -
    Reads the next byte of data from this input stream.
    - +  int read​(byte[] b, int off, int len) - -
    Reads up to len bytes of data from this input stream - into an array of bytes.
    - +  void reset() - -
    Repositions this stream to the position at the time the - mark method was last called on this input stream.
    - +  long skip​(long n) - -
    Skips over and discards n bytes of data from the - input stream.
    - + 
      @@ -344,27 +331,11 @@

      getCount

      read

      public int read()
          throws java.io.IOException
      -
      Description copied from class: java.io.FilterInputStream
      -
      Reads the next byte of data from this input stream. The value - byte is returned as an int in the range - 0 to 255. If no byte is available - because the end of the stream has been reached, the value - -1 is returned. This method blocks until input data - is available, the end of the stream is detected, or an exception - is thrown. -

      - This method - simply performs in.read() and returns the result.

      Overrides:
      read in class java.io.FilterInputStream
      -
      Returns:
      -
      the next byte of data, or -1 if the end of the - stream is reached.
      Throws:
      -
      java.io.IOException - if an I/O error occurs.
      -
      See Also:
      -
      FilterInputStream.in
      +
      java.io.IOException
    @@ -378,29 +349,11 @@

    read

    int off, int len) throws java.io.IOException -
    Description copied from class: java.io.FilterInputStream
    -
    Reads up to len bytes of data from this input stream - into an array of bytes. If len is not zero, the method - blocks until some input is available; otherwise, no - bytes are read and 0 is returned. -

    - This method simply performs in.read(b, off, len) - and returns the result.

    Overrides:
    read in class java.io.FilterInputStream
    -
    Parameters:
    -
    b - the buffer into which the data is read.
    -
    off - the start offset in the destination array b
    -
    len - the maximum number of bytes read.
    -
    Returns:
    -
    the total number of bytes read into the buffer, or - -1 if there is no more data because the end of - the stream has been reached.
    Throws:
    -
    java.io.IOException - if an I/O error occurs.
    -
    See Also:
    -
    FilterInputStream.in
    +
    java.io.IOException
    @@ -412,23 +365,11 @@

    read

    skip

    public long skip​(long n)
           throws java.io.IOException
    -
    Description copied from class: java.io.FilterInputStream
    -
    Skips over and discards n bytes of data from the - input stream. The skip method may, for a variety of - reasons, end up skipping over some smaller number of bytes, - possibly 0. The actual number of bytes skipped is - returned. -

    - This method simply performs in.skip(n).

    Overrides:
    skip in class java.io.FilterInputStream
    -
    Parameters:
    -
    n - the number of bytes to be skipped.
    -
    Returns:
    -
    the actual number of bytes skipped.
    Throws:
    -
    java.io.IOException - if in.skip(n) throws an IOException.
    +
    java.io.IOException
    @@ -439,25 +380,9 @@

    skip

  • mark

    public void mark​(int readlimit)
    -
    Description copied from class: java.io.FilterInputStream
    -
    Marks the current position in this input stream. A subsequent - call to the reset method repositions this stream at - the last marked position so that subsequent reads re-read the same bytes. -

    - The readlimit argument tells this input stream to - allow that many bytes to be read before the mark position gets - invalidated. -

    - This method simply performs in.mark(readlimit).

    Overrides:
    mark in class java.io.FilterInputStream
    -
    Parameters:
    -
    readlimit - the maximum limit of bytes that can be read before - the mark position becomes invalid.
    -
    See Also:
    -
    FilterInputStream.in, -FilterInputStream.reset()
    • @@ -469,30 +394,11 @@

    mark

    reset

    public void reset()
            throws java.io.IOException
    -
    Description copied from class: java.io.FilterInputStream
    -
    Repositions this stream to the position at the time the - mark method was last called on this input stream. -

    - This method - simply performs in.reset(). -

    - Stream marks are intended to be used in - situations where you need to read ahead a little to see what's in - the stream. Often this is most easily done by invoking some - general parser. If the stream is of the type handled by the - parse, it just chugs along happily. If the stream is not of - that type, the parser should toss an exception when it fails. - If this happens within readlimit bytes, it allows the outer - code to reset the stream and try another parser.

    Overrides:
    reset in class java.io.FilterInputStream
    Throws:
    -
    java.io.IOException - if the stream has not been marked or if the - mark has been invalidated.
    -
    See Also:
    -
    FilterInputStream.in, -FilterInputStream.mark(int)
    +
    java.io.IOException
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/io/CountingOutputStream.html b/releases/snapshot-jre/api/docs/com/google/common/io/CountingOutputStream.html index c934d48f29c0..1efc0a6763bd 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/io/CountingOutputStream.html +++ b/releases/snapshot-jre/api/docs/com/google/common/io/CountingOutputStream.html @@ -219,10 +219,7 @@

    Method Summary

    void close() - -
    Closes this output stream and releases any system resources - associated with the stream.
    - +  long @@ -236,18 +233,12 @@

    Method Summary

    write​(byte[] b, int off, int len) - -
    Writes len bytes from the specified - byte array starting at offset off to - this output stream.
    - +  void write​(int b) - -
    Writes the specified byte to this output stream.
    - + 
      @@ -331,30 +322,11 @@

      write

      int off, int len) throws java.io.IOException -
      Description copied from class: java.io.FilterOutputStream
      -
      Writes len bytes from the specified - byte array starting at offset off to - this output stream. -

      - The write method of FilterOutputStream - calls the write method of one argument on each - byte to output. -

      - Note that this method does not call the write method - of its underlying output stream with the same arguments. Subclasses - of FilterOutputStream should provide a more efficient - implementation of this method.

      Overrides:
      write in class java.io.FilterOutputStream
      -
      Parameters:
      -
      b - the data.
      -
      off - the start offset in the data.
      -
      len - the number of bytes to write.
      Throws:
      -
      java.io.IOException - if an I/O error occurs.
      -
      See Also:
      -
      FilterOutputStream.write(int)
      +
      java.io.IOException
    @@ -366,21 +338,11 @@

    write

    write

    public void write​(int b)
            throws java.io.IOException
    -
    Description copied from class: java.io.FilterOutputStream
    -
    Writes the specified byte to this output stream. -

    - The write method of FilterOutputStream - calls the write method of its underlying output stream, - that is, it performs out.write(b). -

    - Implements the abstract write method of OutputStream.

    Overrides:
    write in class java.io.FilterOutputStream
    -
    Parameters:
    -
    b - the byte.
    Throws:
    -
    java.io.IOException - if an I/O error occurs.
    +
    java.io.IOException
    @@ -392,13 +354,6 @@

    write

    close

    public void close()
            throws java.io.IOException
    -
    Description copied from class: java.io.FilterOutputStream
    -
    Closes this output stream and releases any system resources - associated with the stream. -

    - When not already closed, the close method of - FilterOutputStream calls its flush method, and then - calls the close method of its underlying output stream.

    Specified by:
    close in interface java.lang.AutoCloseable
    @@ -407,10 +362,7 @@

    close

    Overrides:
    close in class java.io.FilterOutputStream
    Throws:
    -
    java.io.IOException - if an I/O error occurs.
    -
    See Also:
    -
    FilterOutputStream.flush(), -FilterOutputStream.out
    +
    java.io.IOException
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/io/FileBackedOutputStream.html b/releases/snapshot-jre/api/docs/com/google/common/io/FileBackedOutputStream.html index ad2ad895df9f..845b6e67d98e 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/io/FileBackedOutputStream.html +++ b/releases/snapshot-jre/api/docs/com/google/common/io/FileBackedOutputStream.html @@ -226,18 +226,12 @@

    Method Summary

    void close() - -
    Closes this output stream and releases any system resources - associated with this stream.
    - +  void flush() - -
    Flushes this output stream and forces any buffered output bytes - to be written out.
    - +  void @@ -250,27 +244,19 @@

    Method Summary

    void write​(byte[] b) - -
    Writes b.length bytes from the specified byte array - to this output stream.
    - +  void write​(byte[] b, int off, int len) - -
    Writes len bytes from the specified byte array - starting at offset off to this output stream.
    - +  void write​(int b) - -
    Writes the specified byte to this output stream.
    - + 
      @@ -383,24 +369,11 @@

      reset

      write

      public void write​(int b)
            throws java.io.IOException
      -
      Description copied from class: java.io.OutputStream
      -
      Writes the specified byte to this output stream. The general - contract for write is that one byte is written - to the output stream. The byte to be written is the eight - low-order bits of the argument b. The 24 - high-order bits of b are ignored. -

      - Subclasses of OutputStream must provide an - implementation for this method.

      Specified by:
      write in class java.io.OutputStream
      -
      Parameters:
      -
      b - the byte.
      Throws:
      -
      java.io.IOException - if an I/O error occurs. In particular, - an IOException may be thrown if the - output stream has been closed.
      +
      java.io.IOException
    @@ -412,20 +385,11 @@

    write

    write

    public void write​(byte[] b)
            throws java.io.IOException
    -
    Description copied from class: java.io.OutputStream
    -
    Writes b.length bytes from the specified byte array - to this output stream. The general contract for write(b) - is that it should have exactly the same effect as the call - write(b, 0, b.length).
    Overrides:
    write in class java.io.OutputStream
    -
    Parameters:
    -
    b - the data.
    Throws:
    -
    java.io.IOException - if an I/O error occurs.
    -
    See Also:
    -
    OutputStream.write(byte[], int, int)
    +
    java.io.IOException
    @@ -439,37 +403,11 @@

    write

    int off, int len) throws java.io.IOException -
    Description copied from class: java.io.OutputStream
    -
    Writes len bytes from the specified byte array - starting at offset off to this output stream. - The general contract for write(b, off, len) is that - some of the bytes in the array b are written to the - output stream in order; element b[off] is the first - byte written and b[off+len-1] is the last byte written - by this operation. -

    - The write method of OutputStream calls - the write method of one argument on each of the bytes to be - written out. Subclasses are encouraged to override this method and - provide a more efficient implementation. -

    - If b is null, a - NullPointerException is thrown. -

    - If off is negative, or len is negative, or - off+len is greater than the length of the array - b, then an IndexOutOfBoundsException is thrown.

    Overrides:
    write in class java.io.OutputStream
    -
    Parameters:
    -
    b - the data.
    -
    off - the start offset in the data.
    -
    len - the number of bytes to write.
    Throws:
    -
    java.io.IOException - if an I/O error occurs. In particular, - an IOException is thrown if the output - stream is closed.
    +
    java.io.IOException
    @@ -481,13 +419,6 @@

    write

    close

    public void close()
            throws java.io.IOException
    -
    Description copied from class: java.io.OutputStream
    -
    Closes this output stream and releases any system resources - associated with this stream. The general contract of close - is that it closes the output stream. A closed stream cannot perform - output operations and cannot be reopened. -

    - The close method of OutputStream does nothing.

    Specified by:
    close in interface java.lang.AutoCloseable
    @@ -496,7 +427,7 @@

    close

    Overrides:
    close in class java.io.OutputStream
    Throws:
    -
    java.io.IOException - if an I/O error occurs.
    +
    java.io.IOException
    @@ -508,28 +439,13 @@

    close

    flush

    public void flush()
            throws java.io.IOException
    -
    Description copied from class: java.io.OutputStream
    -
    Flushes this output stream and forces any buffered output bytes - to be written out. The general contract of flush is - that calling it is an indication that, if any bytes previously - written have been buffered by the implementation of the output - stream, such bytes should immediately be written to their - intended destination. -

    - If the intended destination of this stream is an abstraction provided by - the underlying operating system, for example a file, then flushing the - stream guarantees only that bytes previously written to the stream are - passed to the operating system for writing; it does not guarantee that - they are actually written to a physical device such as a disk drive. -

    - The flush method of OutputStream does nothing.

    Specified by:
    flush in interface java.io.Flushable
    Overrides:
    flush in class java.io.OutputStream
    Throws:
    -
    java.io.IOException - if an I/O error occurs.
    +
    java.io.IOException
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/io/LittleEndianDataInputStream.html b/releases/snapshot-jre/api/docs/com/google/common/io/LittleEndianDataInputStream.html index b1a45037afdc..38d90b3d9078 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/io/LittleEndianDataInputStream.html +++ b/releases/snapshot-jre/api/docs/com/google/common/io/LittleEndianDataInputStream.html @@ -225,18 +225,12 @@

    Method Summary

    boolean readBoolean() - -
    Reads one input byte and returns - true if that byte is nonzero, - false if that byte is zero.
    - +  byte readByte() - -
    Reads and returns one input byte.
    - +  char @@ -265,22 +259,14 @@

    Method Summary

    void readFully​(byte[] b) - -
    Reads some bytes from an input - stream and stores them into the buffer - array b.
    - +  void readFully​(byte[] b, int off, int len) - -
    Reads len - bytes from - an input stream.
    - +  int @@ -316,13 +302,7 @@

    Method Summary

    int readUnsignedByte() - -
    Reads one input byte, zero-extends - it to type int, and returns - the result, which is therefore in the range - 0 - through 255.
    - +  int @@ -335,21 +315,12 @@

    Method Summary

    java.lang.String readUTF() - -
    Reads in a string that has been encoded using a - modified UTF-8 - format.
    - +  int skipBytes​(int n) - -
    Makes an attempt to skip over - n bytes - of data from the input - stream, discarding the skipped bytes.
    - + 
      @@ -425,10 +396,6 @@

      readLine

      Specified by:
      readLine in interface java.io.DataInput
      -
      Returns:
      -
      the next line of text from the input stream, - or null if the end of file is - encountered before a byte can be read.
    @@ -440,49 +407,11 @@

    readLine

    readFully

    public void readFully​(byte[] b)
                throws java.io.IOException
    -
    Description copied from interface: java.io.DataInput
    -
    Reads some bytes from an input - stream and stores them into the buffer - array b. The number of bytes - read is equal - to the length of b. -

    - This method blocks until one of the - following conditions occurs: -

      -
    • b.length - bytes of input data are available, in which - case a normal return is made. - -
    • End of - file is detected, in which case an EOFException - is thrown. - -
    • An I/O error occurs, in - which case an IOException other - than EOFException is thrown. -
    -

    - If b is null, - a NullPointerException is thrown. - If b.length is zero, then - no bytes are read. Otherwise, the first - byte read is stored into element b[0], - the next one into b[1], and - so on. - If an exception is thrown from - this method, then it may be that some but - not all bytes of b have been - updated with data from the input stream.

    Specified by:
    readFully in interface java.io.DataInput
    -
    Parameters:
    -
    b - the buffer into which the data is read.
    Throws:
    -
    java.io.EOFException - if this stream reaches the end before reading - all the bytes.
    -
    java.io.IOException - if an I/O error occurs.
    +
    java.io.IOException
    @@ -496,52 +425,11 @@

    readFully

    int off, int len) throws java.io.IOException -
    Description copied from interface: java.io.DataInput
    -
    Reads len - bytes from - an input stream. -

    - This method - blocks until one of the following conditions - occurs: -

      -
    • len bytes - of input data are available, in which case - a normal return is made. - -
    • End of file - is detected, in which case an EOFException - is thrown. - -
    • An I/O error occurs, in - which case an IOException other - than EOFException is thrown. -
    -

    - If b is null, - a NullPointerException is thrown. - If off is negative, or len - is negative, or off+len is - greater than the length of the array b, - then an IndexOutOfBoundsException - is thrown. - If len is zero, - then no bytes are read. Otherwise, the first - byte read is stored into element b[off], - the next one into b[off+1], - and so on. The number of bytes read is, - at most, equal to len.

    Specified by:
    readFully in interface java.io.DataInput
    -
    Parameters:
    -
    b - the buffer into which the data is read.
    -
    off - an int specifying the offset in the data array b.
    -
    len - an int specifying the number of bytes to read.
    Throws:
    -
    java.io.EOFException - if this stream reaches the end before reading - all the bytes.
    -
    java.io.IOException - if an I/O error occurs.
    +
    java.io.IOException
    @@ -553,31 +441,11 @@

    readFully

    skipBytes

    public int skipBytes​(int n)
               throws java.io.IOException
    -
    Description copied from interface: java.io.DataInput
    -
    Makes an attempt to skip over - n bytes - of data from the input - stream, discarding the skipped bytes. However, - it may skip - over some smaller number of - bytes, possibly zero. This may result from - any of a - number of conditions; reaching - end of file before n bytes - have been skipped is - only one possibility. - This method never throws an EOFException. - The actual - number of bytes skipped is returned.
    Specified by:
    skipBytes in interface java.io.DataInput
    -
    Parameters:
    -
    n - the number of bytes to be skipped.
    -
    Returns:
    -
    the number of bytes actually skipped.
    Throws:
    -
    java.io.IOException - if an I/O error occurs.
    +
    java.io.IOException
    @@ -590,27 +458,11 @@

    readUnsignedByte

    @CanIgnoreReturnValue
 public int readUnsignedByte()
                      throws java.io.IOException
    -
    Description copied from interface: java.io.DataInput
    -
    Reads one input byte, zero-extends - it to type int, and returns - the result, which is therefore in the range - 0 - through 255. - This method is suitable for reading - the byte written by the writeByte - method of interface DataOutput - if the argument to writeByte - was intended to be a value in the range - 0 through 255.
    Specified by:
    readUnsignedByte in interface java.io.DataInput
    -
    Returns:
    -
    the unsigned 8-bit value read.
    Throws:
    -
    java.io.EOFException - if this stream reaches the end before reading - all the bytes.
    -
    java.io.IOException - if an I/O error occurs.
    +
    java.io.IOException
    @@ -733,95 +585,11 @@

    readUTF

    @CanIgnoreReturnValue
 public java.lang.String readUTF()
                          throws java.io.IOException
    -
    Description copied from interface: java.io.DataInput
    -
    Reads in a string that has been encoded using a - modified UTF-8 - format. - The general contract of readUTF - is that it reads a representation of a Unicode - character string encoded in modified - UTF-8 format; this string of characters - is then returned as a String. -

    - First, two bytes are read and used to - construct an unsigned 16-bit integer in - exactly the manner of the readUnsignedShort - method . This integer value is called the - UTF length and specifies the number - of additional bytes to be read. These bytes - are then converted to characters by considering - them in groups. The length of each group - is computed from the value of the first - byte of the group. The byte following a - group, if any, is the first byte of the - next group. -

    - If the first byte of a group - matches the bit pattern 0xxxxxxx - (where x means "may be 0 - or 1"), then the group consists - of just that byte. The byte is zero-extended - to form a character. -

    - If the first byte - of a group matches the bit pattern 110xxxxx, - then the group consists of that byte a - and a second byte b. If there - is no byte b (because byte - a was the last of the bytes - to be read), or if byte b does - not match the bit pattern 10xxxxxx, - then a UTFDataFormatException - is thrown. Otherwise, the group is converted - to the character: - 

    (char)(((a & 0x1F) << 6) | (b & 0x3F))
-
    - If the first byte of a group - matches the bit pattern 1110xxxx, - then the group consists of that byte a - and two more bytes b and c. - If there is no byte c (because - byte a was one of the last - two of the bytes to be read), or either - byte b or byte c - does not match the bit pattern 10xxxxxx, - then a UTFDataFormatException - is thrown. Otherwise, the group is converted - to the character: - 
    
- (char)(((a & 0x0F) << 12) | ((b & 0x3F) << 6) | (c & 0x3F))
-
    - If the first byte of a group matches the - pattern 1111xxxx or the pattern - 10xxxxxx, then a UTFDataFormatException - is thrown. -

    - If end of file is encountered - at any time during this entire process, - then an EOFException is thrown. -

    - After every group has been converted to - a character by this process, the characters - are gathered, in the same order in which - their corresponding groups were read from - the input stream, to form a String, - which is returned. -

    - The writeUTF - method of interface DataOutput - may be used to write data that is suitable - for reading by this method.

    Specified by:
    readUTF in interface java.io.DataInput
    -
    Returns:
    -
    a Unicode string.
    Throws:
    -
    java.io.EOFException - if this stream reaches the end - before reading all the bytes.
    -
    java.io.IOException - if an I/O error occurs.
    -
    java.io.UTFDataFormatException - if the bytes do not represent a - valid modified UTF-8 encoding of a string.
    +
    java.io.IOException
    @@ -878,23 +646,11 @@

    readByte

    @CanIgnoreReturnValue
 public byte readByte()
               throws java.io.IOException
    -
    Description copied from interface: java.io.DataInput
    -
    Reads and returns one input byte. - The byte is treated as a signed value in - the range -128 through 127, - inclusive. - This method is suitable for - reading the byte written by the writeByte - method of interface DataOutput.
    Specified by:
    readByte in interface java.io.DataInput
    -
    Returns:
    -
    the 8-bit value read.
    Throws:
    -
    java.io.EOFException - if this stream reaches the end before reading - all the bytes.
    -
    java.io.IOException - if an I/O error occurs.
    +
    java.io.IOException
    @@ -907,22 +663,11 @@

    readBoolean

    @CanIgnoreReturnValue
 public boolean readBoolean()
                     throws java.io.IOException
    -
    Description copied from interface: java.io.DataInput
    -
    Reads one input byte and returns - true if that byte is nonzero, - false if that byte is zero. - This method is suitable for reading - the byte written by the writeBoolean - method of interface DataOutput.
    Specified by:
    readBoolean in interface java.io.DataInput
    -
    Returns:
    -
    the boolean value read.
    Throws:
    -
    java.io.EOFException - if this stream reaches the end before reading - all the bytes.
    -
    java.io.IOException - if an I/O error occurs.
    +
    java.io.IOException
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/io/LittleEndianDataOutputStream.html b/releases/snapshot-jre/api/docs/com/google/common/io/LittleEndianDataOutputStream.html index 82c4483f7493..5ff8eb7d0386 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/io/LittleEndianDataOutputStream.html +++ b/releases/snapshot-jre/api/docs/com/google/common/io/LittleEndianDataOutputStream.html @@ -225,36 +225,24 @@

    Method Summary

    void close() - -
    Closes this output stream and releases any system resources - associated with the stream.
    - +  void write​(byte[] b, int off, int len) - -
    Writes len bytes from the specified - byte array starting at offset off to - this output stream.
    - +  void writeBoolean​(boolean v) - -
    Writes a boolean value to this output stream.
    - +  void writeByte​(int v) - -
    Writes to the output stream the eight low- - order bits of the argument v.
    - +  void @@ -324,14 +312,7 @@

    Method Summary

    void writeUTF​(java.lang.String str) - -
    Writes two bytes of length information - to the output stream, followed - by the - modified UTF-8 - representation - of every character in the string s.
    - + 
      @@ -412,32 +393,13 @@

      write

      int off, int len) throws java.io.IOException -
      Description copied from class: java.io.FilterOutputStream
      -
      Writes len bytes from the specified - byte array starting at offset off to - this output stream. -

      - The write method of FilterOutputStream - calls the write method of one argument on each - byte to output. -

      - Note that this method does not call the write method - of its underlying output stream with the same arguments. Subclasses - of FilterOutputStream should provide a more efficient - implementation of this method.

      Specified by:
      write in interface java.io.DataOutput
      Overrides:
      write in class java.io.FilterOutputStream
      -
      Parameters:
      -
      b - the data.
      -
      off - the start offset in the data.
      -
      len - the number of bytes to write.
      Throws:
      -
      java.io.IOException - if an I/O error occurs.
      -
      See Also:
      -
      FilterOutputStream.write(int)
      +
      java.io.IOException
    @@ -449,24 +411,11 @@

    write

    writeBoolean

    public void writeBoolean​(boolean v)
                   throws java.io.IOException
    -
    Description copied from interface: java.io.DataOutput
    -
    Writes a boolean value to this output stream. - If the argument v - is true, the value (byte)1 - is written; if v is false, - the value (byte)0 is written. - The byte written by this method may - be read by the readBoolean - method of interface DataInput, - which will then return a boolean - equal to v.
    Specified by:
    writeBoolean in interface java.io.DataOutput
    -
    Parameters:
    -
    v - the boolean to be written.
    Throws:
    -
    java.io.IOException - if an I/O error occurs.
    +
    java.io.IOException
    @@ -478,24 +427,11 @@

    writeBoolean

    writeByte

    public void writeByte​(int v)
                throws java.io.IOException
    -
    Description copied from interface: java.io.DataOutput
    -
    Writes to the output stream the eight low- - order bits of the argument v. - The 24 high-order bits of v - are ignored. (This means that writeByte - does exactly the same thing as write - for an integer argument.) The byte written - by this method may be read by the readByte - method of interface DataInput, - which will then return a byte - equal to (byte)v.
    Specified by:
    writeByte in interface java.io.DataOutput
    -
    Parameters:
    -
    v - the byte value to be written.
    Throws:
    -
    java.io.IOException - if an I/O error occurs.
    +
    java.io.IOException
    @@ -512,29 +448,11 @@

    writeBytes

    The semantics of writeBytes(String s) are considered dangerous. Please use writeUTF(String s), writeChars(String s) or another write method instead.
    -
    Description copied from interface: java.io.DataOutput
    -
    Writes a string to the output stream. - For every character in the string - s, taken in order, one byte - is written to the output stream. If - s is null, a NullPointerException - is thrown.

    If s.length - is zero, then no bytes are written. Otherwise, - the character s[0] is written - first, then s[1], and so on; - the last character written is s[s.length-1]. - For each character, one byte is written, - the low-order byte, in exactly the manner - of the writeByte method . The - high-order eight bits of each character - in the string are ignored.

    Specified by:
    writeBytes in interface java.io.DataOutput
    -
    Parameters:
    -
    s - the string of bytes to be written.
    Throws:
    -
    java.io.IOException - if an I/O error occurs.
    +
    java.io.IOException
    @@ -551,8 +469,6 @@

    writeChar

    Specified by:
    writeChar in interface java.io.DataOutput
    -
    Parameters:
    -
    v - the char value to be written.
    Throws:
    java.io.IOException - if an I/O error occurs
    @@ -571,8 +487,6 @@

    writeChars

    Specified by:
    writeChars in interface java.io.DataOutput
    -
    Parameters:
    -
    s - the string value to be written.
    Throws:
    java.io.IOException - if an I/O error occurs
    @@ -591,8 +505,6 @@

    writeDouble

    Specified by:
    writeDouble in interface java.io.DataOutput
    -
    Parameters:
    -
    v - the double value to be written.
    Throws:
    java.io.IOException - if an I/O error occurs
    @@ -611,8 +523,6 @@

    writeFloat

    Specified by:
    writeFloat in interface java.io.DataOutput
    -
    Parameters:
    -
    v - the float value to be written.
    Throws:
    java.io.IOException - if an I/O error occurs
    @@ -631,8 +541,6 @@

    writeInt

    Specified by:
    writeInt in interface java.io.DataOutput
    -
    Parameters:
    -
    v - the int value to be written.
    Throws:
    java.io.IOException - if an I/O error occurs
    @@ -651,8 +559,6 @@

    writeLong

    Specified by:
    writeLong in interface java.io.DataOutput
    -
    Parameters:
    -
    v - the long value to be written.
    Throws:
    java.io.IOException - if an I/O error occurs
    @@ -671,8 +577,6 @@

    writeShort

    Specified by:
    writeShort in interface java.io.DataOutput
    -
    Parameters:
    -
    v - the short value to be written.
    Throws:
    java.io.IOException - if an I/O error occurs
    @@ -686,61 +590,11 @@

    writeShort

    writeUTF

    public void writeUTF​(java.lang.String str)
               throws java.io.IOException
    -
    Description copied from interface: java.io.DataOutput
    -
    Writes two bytes of length information - to the output stream, followed - by the - modified UTF-8 - representation - of every character in the string s. - If s is null, - a NullPointerException is thrown. - Each character in the string s - is converted to a group of one, two, or - three bytes, depending on the value of the - character.

    - If a character c - is in the range \u0001 through - \u007f, it is represented - by one byte: - 

    (byte)c

    - If a character c is \u0000 - or is in the range \u0080 - through \u07ff, then it is - represented by two bytes, to be written - in the order shown: 

    
- (byte)(0xc0 | (0x1f & (c >> 6)))
- (byte)(0x80 | (0x3f & c))
-

    If a character - c is in the range \u0800 - through uffff, then it is - represented by three bytes, to be written - in the order shown: 

    
- (byte)(0xe0 | (0x0f & (c >> 12)))
- (byte)(0x80 | (0x3f & (c >>  6)))
- (byte)(0x80 | (0x3f & c))
-

    First, - the total number of bytes needed to represent - all the characters of s is - calculated. If this number is larger than - 65535, then a UTFDataFormatException - is thrown. Otherwise, this length is written - to the output stream in exactly the manner - of the writeShort method; - after this, the one-, two-, or three-byte - representation of each character in the - string s is written.

    The - bytes written by this method may be read - by the readUTF method of interface - DataInput , which will then - return a String equal to s.

    Specified by:
    writeUTF in interface java.io.DataOutput
    -
    Parameters:
    -
    str - the string value to be written.
    Throws:
    -
    java.io.IOException - if an I/O error occurs.
    +
    java.io.IOException
    @@ -752,13 +606,6 @@

    writeUTF

    close

    public void close()
            throws java.io.IOException
    -
    Description copied from class: java.io.FilterOutputStream
    -
    Closes this output stream and releases any system resources - associated with the stream. -

    - When not already closed, the close method of - FilterOutputStream calls its flush method, and then - calls the close method of its underlying output stream.

    Specified by:
    close in interface java.lang.AutoCloseable
    @@ -767,10 +614,7 @@

    close

    Overrides:
    close in class java.io.FilterOutputStream
    Throws:
    -
    java.io.IOException - if an I/O error occurs.
    -
    See Also:
    -
    FilterOutputStream.flush(), -FilterOutputStream.out
    +
    java.io.IOException
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/io/PatternFilenameFilter.html b/releases/snapshot-jre/api/docs/com/google/common/io/PatternFilenameFilter.html index 82e696c9b711..634f9cf5d0c6 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/io/PatternFilenameFilter.html +++ b/releases/snapshot-jre/api/docs/com/google/common/io/PatternFilenameFilter.html @@ -202,9 +202,7 @@

    Method Summary

    boolean accept​(java.io.File dir, java.lang.String fileName) - -
    Tests if a specified file should be included in a file list.
    - + 
      @@ -278,17 +276,9 @@

      Method Detail

      accept

      public boolean accept​(java.io.File dir,
                       java.lang.String fileName)
      -
      Description copied from interface: java.io.FilenameFilter
      -
      Tests if a specified file should be included in a file list.
      Specified by:
      accept in interface java.io.FilenameFilter
      -
      Parameters:
      -
      dir - the directory in which the file was found.
      -
      fileName - the name of the file.
      -
      Returns:
      -
      true if and only if the name should be - included in the file list; false otherwise.
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/math/PairedStats.html b/releases/snapshot-jre/api/docs/com/google/common/math/PairedStats.html index f9ba11964fd0..7ce04045a611 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/math/PairedStats.html +++ b/releases/snapshot-jre/api/docs/com/google/common/math/PairedStats.html @@ -181,9 +181,6 @@

    Method Summary

    boolean equals​(java.lang.Object obj) - -
    Indicates whether some other object is "equal to" this one.
    - static PairedStats @@ -196,9 +193,6 @@

    Method Summary

    int hashCode() - -
    Returns a hash code value for the object.
    - LinearTransformation @@ -240,9 +234,7 @@

    Method Summary

    java.lang.String toString() - -
    Returns a string representation of the object.
    - +  Stats @@ -424,44 +416,7 @@

    Non-finite values

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object obj)
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes. +

    Note: This tests exact equality of the calculated statistics, including the floating point values. Two instances are guaranteed to be considered equal if one is copied from the @@ -477,14 +432,6 @@

    equals

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -495,45 +442,13 @@

    equals

  • hashCode

    public int hashCode()
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.) +

    Note: This hash code is consistent with exact equality of the calculated statistics, including the floating point values. See the note on equals(java.lang.Object) for details.

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -544,29 +459,9 @@

    hashCode

  • toString

    public java.lang.String toString()
    -
    Description copied from class: java.lang.Object
    -
    Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

    - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

    - 
    - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/math/Stats.html b/releases/snapshot-jre/api/docs/com/google/common/math/Stats.html index f59e63487a9a..a6e88e44ab79 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/math/Stats.html +++ b/releases/snapshot-jre/api/docs/com/google/common/math/Stats.html @@ -197,9 +197,6 @@

    Method Summary

    boolean equals​(java.lang.Object obj) - -
    Indicates whether some other object is "equal to" this one.
    - static Stats @@ -211,9 +208,6 @@

    Method Summary

    int hashCode() - -
    Returns a hash code value for the object.
    - double @@ -390,9 +384,7 @@

    Method Summary

    java.lang.String toString() - -
    Returns a string representation of the object.
    - + 
      @@ -772,44 +764,7 @@

      Non-finite values

      equals

      public boolean equals​(@CheckForNull
                       java.lang.Object obj)
      -
      Indicates whether some other object is "equal to" this one. -

      - The equals method implements an equivalence relation - on non-null object references: -

        -
      • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
      • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
      • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
      • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
      • For any non-null reference value x, - x.equals(null) should return false. -
      -

      - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

      - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes. +

      Note: This tests exact equality of the calculated statistics, including the floating point values. Two instances are guaranteed to be considered equal if one is copied from the @@ -825,14 +780,6 @@

      equals

      Overrides:
      equals in class java.lang.Object
      -
      Parameters:
      -
      obj - the reference object with which to compare.
      -
      Returns:
      -
      true if this object is the same as the obj - argument; false otherwise.
      -
      See Also:
      -
      Object.hashCode(), -HashMap
    @@ -843,45 +790,13 @@

    equals

  • hashCode

    public int hashCode()
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.) +

    Note: This hash code is consistent with exact equality of the calculated statistics, including the floating point values. See the note on equals(java.lang.Object) for details.

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -892,29 +807,9 @@

    hashCode

  • toString

    public java.lang.String toString()
    -
    Description copied from class: java.lang.Object
    -
    Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

    - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

    - 
    - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/net/HostAndPort.html b/releases/snapshot-jre/api/docs/com/google/common/net/HostAndPort.html index 884771375943..77773c320628 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/net/HostAndPort.html +++ b/releases/snapshot-jre/api/docs/com/google/common/net/HostAndPort.html @@ -200,9 +200,7 @@

    Method Summary

    boolean equals​(java.lang.Object other) - -
    Indicates whether some other object is "equal to" this one.
    - +  static HostAndPort @@ -251,9 +249,7 @@

    Method Summary

    int hashCode() - -
    Returns a hash code value for the object.
    - +  boolean @@ -482,56 +478,9 @@

    requireBracketsForIPv6

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object other)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    other - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -542,43 +491,9 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -593,8 +508,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/net/HostSpecifier.html b/releases/snapshot-jre/api/docs/com/google/common/net/HostSpecifier.html index f3f249440e17..f48a66159637 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/net/HostSpecifier.html +++ b/releases/snapshot-jre/api/docs/com/google/common/net/HostSpecifier.html @@ -178,9 +178,7 @@

    Method Summary

    boolean equals​(java.lang.Object other) - -
    Indicates whether some other object is "equal to" this one.
    - +  static HostSpecifier @@ -201,9 +199,7 @@

    Method Summary

    int hashCode() - -
    Returns a hash code value for the object.
    - +  static boolean @@ -306,56 +302,9 @@

    isValid

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object other)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    other - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -366,43 +315,9 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -420,8 +335,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/net/InternetDomainName.html b/releases/snapshot-jre/api/docs/com/google/common/net/InternetDomainName.html index 3606ecaae8a9..6c0248286419 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/net/InternetDomainName.html +++ b/releases/snapshot-jre/api/docs/com/google/common/net/InternetDomainName.html @@ -221,9 +221,7 @@

    Method Summary

    int hashCode() - -
    Returns a hash code value for the object.
    - +  boolean @@ -768,8 +766,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    @@ -787,14 +783,6 @@

    equals

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -805,43 +793,9 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/net/MediaType.html b/releases/snapshot-jre/api/docs/com/google/common/net/MediaType.html index 5fc3c42e6620..1df8212ddf01 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/net/MediaType.html +++ b/releases/snapshot-jre/api/docs/com/google/common/net/MediaType.html @@ -959,16 +959,12 @@

    Method Summary

    boolean equals​(java.lang.Object obj) - -
    Indicates whether some other object is "equal to" this one.
    - +  int hashCode() - -
    Returns a hash code value for the object.
    - +  boolean @@ -2703,56 +2699,9 @@

    parse

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object obj)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -2763,43 +2712,9 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -2814,8 +2729,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/primitives/ImmutableDoubleArray.html b/releases/snapshot-jre/api/docs/com/google/common/primitives/ImmutableDoubleArray.html index 4ab150d95bd3..8047f05b8f00 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/primitives/ImmutableDoubleArray.html +++ b/releases/snapshot-jre/api/docs/com/google/common/primitives/ImmutableDoubleArray.html @@ -801,14 +801,6 @@

    equals

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -823,11 +815,6 @@

    hashCode

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    @@ -842,8 +829,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/primitives/ImmutableIntArray.html b/releases/snapshot-jre/api/docs/com/google/common/primitives/ImmutableIntArray.html index 02aed0f7a9db..b37c5fc5f509 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/primitives/ImmutableIntArray.html +++ b/releases/snapshot-jre/api/docs/com/google/common/primitives/ImmutableIntArray.html @@ -799,14 +799,6 @@

    equals

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -821,11 +813,6 @@

    hashCode

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    @@ -840,8 +827,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/primitives/ImmutableLongArray.html b/releases/snapshot-jre/api/docs/com/google/common/primitives/ImmutableLongArray.html index 017ea5439914..0bb57038cee6 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/primitives/ImmutableLongArray.html +++ b/releases/snapshot-jre/api/docs/com/google/common/primitives/ImmutableLongArray.html @@ -800,14 +800,6 @@

    equals

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    object - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -822,11 +814,6 @@

    hashCode

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    @@ -841,8 +828,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/primitives/UnsignedInteger.html b/releases/snapshot-jre/api/docs/com/google/common/primitives/UnsignedInteger.html index 814c63af327d..972019bae083 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/primitives/UnsignedInteger.html +++ b/releases/snapshot-jre/api/docs/com/google/common/primitives/UnsignedInteger.html @@ -245,9 +245,7 @@

    Method Summary

    boolean equals​(java.lang.Object obj) - -
    Indicates whether some other object is "equal to" this one.
    - +  float @@ -267,9 +265,7 @@

    Method Summary

    int hashCode() - -
    Returns a hash code value for the object.
    - +  int @@ -598,9 +594,6 @@

    intValue

    Specified by:
    intValue in class java.lang.Number
    -
    Returns:
    -
    the numeric value represented by this object after conversion - to type int.
    @@ -615,9 +608,6 @@

    longValue

    Specified by:
    longValue in class java.lang.Number
    -
    Returns:
    -
    the numeric value represented by this object after conversion - to type long.
    @@ -633,9 +623,6 @@

    floatValue

    Specified by:
    floatValue in class java.lang.Number
    -
    Returns:
    -
    the numeric value represented by this object after conversion - to type float.
    @@ -651,9 +638,6 @@

    doubleValue

    Specified by:
    doubleValue in class java.lang.Number
    -
    Returns:
    -
    the numeric value represented by this object after conversion - to type double.
    @@ -680,11 +664,6 @@

    compareTo

    Specified by:
    compareTo in interface java.lang.Comparable<UnsignedInteger>
    -
    Parameters:
    -
    other - the object to be compared.
    -
    Returns:
    -
    a negative integer, zero, or a positive integer as this object - is less than, equal to, or greater than the specified object.
    @@ -695,43 +674,9 @@

    compareTo

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -743,56 +688,9 @@

    hashCode

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object obj)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -807,8 +705,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/primitives/UnsignedLong.html b/releases/snapshot-jre/api/docs/com/google/common/primitives/UnsignedLong.html index cedaa4b0bcf8..5f62ca9f9716 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/primitives/UnsignedLong.html +++ b/releases/snapshot-jre/api/docs/com/google/common/primitives/UnsignedLong.html @@ -223,9 +223,7 @@

    Method Summary

    int compareTo​(UnsignedLong o) - -
    Compares this object with the specified object for order.
    - +  UnsignedLong @@ -245,9 +243,7 @@

    Method Summary

    boolean equals​(java.lang.Object obj) - -
    Indicates whether some other object is "equal to" this one.
    - +  float @@ -267,9 +263,7 @@

    Method Summary

    int hashCode() - -
    Returns a hash code value for the object.
    - +  int @@ -600,9 +594,6 @@

    intValue

    Specified by:
    intValue in class java.lang.Number
    -
    Returns:
    -
    the numeric value represented by this object after conversion - to type int.
    @@ -621,9 +612,6 @@

    longValue

    Specified by:
    longValue in class java.lang.Number
    -
    Returns:
    -
    the numeric value represented by this object after conversion - to type long.
    @@ -639,9 +627,6 @@

    floatValue

    Specified by:
    floatValue in class java.lang.Number
    -
    Returns:
    -
    the numeric value represented by this object after conversion - to type float.
    @@ -657,9 +642,6 @@

    doubleValue

    Specified by:
    doubleValue in class java.lang.Number
    -
    Returns:
    -
    the numeric value represented by this object after conversion - to type double.
    @@ -680,45 +662,9 @@

    bigIntegerValue

  • compareTo

    public int compareTo​(UnsignedLong o)
    -
    Description copied from interface: java.lang.Comparable
    -
    Compares this object with the specified object for order. Returns a - negative integer, zero, or a positive integer as this object is less - than, equal to, or greater than the specified object. - -

    The implementor must ensure - sgn(x.compareTo(y)) == -sgn(y.compareTo(x)) - for all x and y. (This - implies that x.compareTo(y) must throw an exception iff - y.compareTo(x) throws an exception.) - -

    The implementor must also ensure that the relation is transitive: - (x.compareTo(y) > 0 && y.compareTo(z) > 0) implies - x.compareTo(z) > 0. - -

    Finally, the implementor must ensure that x.compareTo(y)==0 - implies that sgn(x.compareTo(z)) == sgn(y.compareTo(z)), for - all z. - -

    It is strongly recommended, but not strictly required that - (x.compareTo(y)==0) == (x.equals(y)). Generally speaking, any - class that implements the Comparable interface and violates - this condition should clearly indicate this fact. The recommended - language is "Note: this class has a natural ordering that is - inconsistent with equals." - -

    In the foregoing description, the notation - sgn(expression) designates the mathematical - signum function, which is defined to return one of -1, - 0, or 1 according to whether the value of - expression is negative, zero, or positive, respectively.

    Specified by:
    compareTo in interface java.lang.Comparable<UnsignedLong>
    -
    Parameters:
    -
    o - the object to be compared.
    -
    Returns:
    -
    a negative integer, zero, or a positive integer as this object - is less than, equal to, or greater than the specified object.
    • @@ -729,43 +675,9 @@

    compareTo

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -777,56 +689,9 @@

    hashCode

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object obj)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -841,8 +706,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/reflect/AbstractInvocationHandler.html b/releases/snapshot-jre/api/docs/com/google/common/reflect/AbstractInvocationHandler.html index d394964c2b2a..87dec9656772 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/reflect/AbstractInvocationHandler.html +++ b/releases/snapshot-jre/api/docs/com/google/common/reflect/AbstractInvocationHandler.html @@ -228,8 +228,17 @@

    Method Summary

    java.lang.reflect.Method method, @Nullable java.lang.Object[] args)     -
    Processes a method invocation on a proxy instance and returns - the result.
    +
    + + + proxy.hashCode() delegates to hashCode() + proxy.toString() delegates to toString() + proxy.equals(argument) returns true if: + + proxy and argument are of the same type + and equals(java.lang.Object) returns true for the InvocationHandler of argument + + other method calls are dispatched to handleInvocation(java.lang.Object, java.lang.reflect.Method, java.lang.Object[]).
    @@ -294,10 +303,7 @@

    invoke

    @CheckForNull @Nullable java.lang.Object[] args) throws java.lang.Throwable -
    Processes a method invocation on a proxy instance and returns - the result. This method will be invoked on an invocation handler - when a method is invoked on a proxy instance that it is - associated with. +
    • proxy.hashCode() delegates to hashCode() @@ -312,48 +318,8 @@

      invoke

      Specified by:
      invoke in interface java.lang.reflect.InvocationHandler
      -
      Parameters:
      -
      proxy - the proxy instance that the method was invoked on
      -
      method - the Method instance corresponding to - the interface method invoked on the proxy instance. The declaring - class of the Method object will be the interface that - the method was declared in, which may be a superinterface of the - proxy interface that the proxy class inherits the method through.
      -
      args - an array of objects containing the values of the - arguments passed in the method invocation on the proxy instance, - or null if interface method takes no arguments. - Arguments of primitive types are wrapped in instances of the - appropriate primitive wrapper class, such as - java.lang.Integer or java.lang.Boolean.
      -
      Returns:
      -
      the value to return from the method invocation on the - proxy instance. If the declared return type of the interface - method is a primitive type, then the value returned by - this method must be an instance of the corresponding primitive - wrapper class; otherwise, it must be a type assignable to the - declared return type. If the value returned by this method is - null and the interface method's return type is - primitive, then a NullPointerException will be - thrown by the method invocation on the proxy instance. If the - value returned by this method is otherwise not compatible with - the interface method's declared return type as described above, - a ClassCastException will be thrown by the method - invocation on the proxy instance.
      Throws:
      -
      java.lang.Throwable - the exception to throw from the method - invocation on the proxy instance. The exception's type must be - assignable either to any of the exception types declared in the - throws clause of the interface method or to the - unchecked exception types java.lang.RuntimeException - or java.lang.Error. If a checked exception is - thrown by this method that is not assignable to any of the - exception types declared in the throws clause of - the interface method, then an - UndeclaredThrowableException containing the - exception that was thrown by this method will be thrown by the - method invocation on the proxy instance.
      -
      See Also:
      -
      UndeclaredThrowableException
      +
      java.lang.Throwable
    @@ -400,14 +366,6 @@

    equals

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -423,11 +381,6 @@

    hashCode

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    @@ -444,8 +397,6 @@

    toString

    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/reflect/ClassPath.ClassInfo.html b/releases/snapshot-jre/api/docs/com/google/common/reflect/ClassPath.ClassInfo.html index 4dc172cb0fae..1d4f33696b20 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/reflect/ClassPath.ClassInfo.html +++ b/releases/snapshot-jre/api/docs/com/google/common/reflect/ClassPath.ClassInfo.html @@ -207,9 +207,7 @@

    Method Summary

    java.lang.String toString() - -
    Returns a string representation of the object.
    - + 
      @@ -328,29 +326,9 @@

      load

    • toString

      public java.lang.String toString()
      -
      Description copied from class: java.lang.Object
      -
      Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

      - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

      - 
      - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
      Overrides:
      toString in class ClassPath.ResourceInfo
      -
      Returns:
      -
      a string representation of the object.
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/reflect/ClassPath.ResourceInfo.html b/releases/snapshot-jre/api/docs/com/google/common/reflect/ClassPath.ResourceInfo.html index 1288802a82b5..307a263601df 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/reflect/ClassPath.ResourceInfo.html +++ b/releases/snapshot-jre/api/docs/com/google/common/reflect/ClassPath.ResourceInfo.html @@ -186,9 +186,7 @@

    Method Summary

    boolean equals​(java.lang.Object obj) - -
    Indicates whether some other object is "equal to" this one.
    - +  java.lang.String @@ -200,16 +198,12 @@

    Method Summary

    int hashCode() - -
    Returns a hash code value for the object.
    - +  java.lang.String toString() - -
    Returns a string representation of the object.
    - +  java.net.URL @@ -311,43 +305,9 @@

    getResourceName

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -359,56 +319,9 @@

    hashCode

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object obj)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -419,29 +332,9 @@

    equals

  • toString

    public java.lang.String toString()
    -
    Description copied from class: java.lang.Object
    -
    Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

    - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

    - 
    - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/reflect/ImmutableTypeToInstanceMap.html b/releases/snapshot-jre/api/docs/com/google/common/reflect/ImmutableTypeToInstanceMap.html index b139165c8c91..5f77dbb29ba0 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/reflect/ImmutableTypeToInstanceMap.html +++ b/releases/snapshot-jre/api/docs/com/google/common/reflect/ImmutableTypeToInstanceMap.html @@ -196,7 +196,7 @@

    Nested classes/interfaces inherited from class com.google.common.collec

    Nested classes/interfaces inherited from interface java.util.Map

    -java.util.Map.Entry<K,​V> +java.util.Map.Entry<K extends java.lang.Object,​V extends java.lang.Object> @@ -344,12 +344,6 @@

    Method Detail

    of

    public static <B> ImmutableTypeToInstanceMap<B> of()
    Returns an empty type to instance map.
    -
    -
    Type Parameters:
    -
    B - the Map's key type
    -
    Returns:
    -
    an empty Map
    -
    @@ -479,15 +473,6 @@

    put

    put in interface java.util.Map<TypeToken<? extends B>,​B>
    Overrides:
    put in class ForwardingMap<TypeToken<? extends B>,​B>
    -
    Parameters:
    -
    key - key with which the specified value is to be associated
    -
    value - value to be associated with the specified key
    -
    Returns:
    -
    the previous value associated with key, or - null if there was no mapping for key. - (A null return can also indicate that the map - previously associated null with key, - if the implementation supports null values.)
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -510,8 +495,6 @@

    putAll

    putAll in interface java.util.Map<TypeToken<? extends B>,​B>
    Overrides:
    putAll in class ForwardingMap<TypeToken<? extends B>,​B>
    -
    Parameters:
    -
    map - mappings to be stored in this map
    Throws:
    java.lang.UnsupportedOperationException - always
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/reflect/Invokable.html b/releases/snapshot-jre/api/docs/com/google/common/reflect/Invokable.html index acd97f44bb5f..fe071efdae0d 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/reflect/Invokable.html +++ b/releases/snapshot-jre/api/docs/com/google/common/reflect/Invokable.html @@ -210,9 +210,7 @@

    Method Summary

    boolean equals​(java.lang.Object obj) - -
    Indicates whether some other object is "equal to" this one.
    - +  static <T> Invokable<T,​T> @@ -236,32 +234,22 @@

    Method Summary

    <A extends java.lang.annotation.Annotation>
    A     getAnnotation​(java.lang.Class<A> annotationClass) - -
    Returns this element's annotation for the specified type if - such an annotation is present, else null.
    - +  java.lang.annotation.Annotation[] getAnnotations() - -
    Returns annotations that are present on this element.
    - +  java.lang.annotation.Annotation[] getDeclaredAnnotations() - -
    Returns annotations that are directly present on this element.
    - +  java.lang.Class<? super T> getDeclaringClass() - -
    Returns the Class object representing the class or interface - that declares the member or constructor represented by this Member.
    - +  ImmutableList<TypeToken<? extends java.lang.Throwable>> @@ -273,18 +261,12 @@

    Method Summary

    int getModifiers() - -
    Returns the Java language modifiers for the member or - constructor represented by this Member, as an integer.
    - +  java.lang.String getName() - -
    Returns the simple name of the underlying member or constructor - represented by this Member.
    - +  TypeToken<T> @@ -317,9 +299,7 @@

    Method Summary

    int hashCode() - -
    Returns a hash code value for the object.
    - +  R @@ -348,10 +328,7 @@

    Method Summary

    boolean isAnnotationPresent​(java.lang.Class<? extends java.lang.annotation.Annotation> annotationClass) - -
    Returns true if an annotation for the specified type - is present on this element, else false.
    - +  boolean @@ -419,10 +396,7 @@

    Method Summary

    boolean isSynthetic() - -
    Returns true if this member was introduced by - the compiler; returns false otherwise.
    - +  abstract boolean @@ -455,9 +429,7 @@

    Method Summary

    java.lang.String toString() - -
    Returns a string representation of the object.
    - +  boolean @@ -524,25 +496,9 @@

    from

  • isAnnotationPresent

    public final boolean isAnnotationPresent​(java.lang.Class<? extends java.lang.annotation.Annotation> annotationClass)
    -
    Description copied from interface: java.lang.reflect.AnnotatedElement
    -
    Returns true if an annotation for the specified type - is present on this element, else false. This method - is designed primarily for convenient access to marker annotations. - -

    The truth value returned by this method is equivalent to: - getAnnotation(annotationClass) != null - -

    The body of the default method is specified to be the code - above.

    Specified by:
    isAnnotationPresent in interface java.lang.reflect.AnnotatedElement
    -
    Parameters:
    -
    annotationClass - the Class object corresponding to the - annotation type
    -
    Returns:
    -
    true if an annotation for the specified annotation - type is present on this element, else false
    • @@ -554,20 +510,9 @@

    isAnnotationPresent

    getAnnotation

    @CheckForNull
 public final <A extends java.lang.annotation.Annotation> A getAnnotation​(java.lang.Class<A> annotationClass)
    -
    Description copied from interface: java.lang.reflect.AnnotatedElement
    -
    Returns this element's annotation for the specified type if - such an annotation is present, else null.
    Specified by:
    getAnnotation in interface java.lang.reflect.AnnotatedElement
    -
    Type Parameters:
    -
    A - the type of the annotation to query for and return if present
    -
    Parameters:
    -
    annotationClass - the Class object corresponding to the - annotation type
    -
    Returns:
    -
    this element's annotation for the specified annotation type if - present on this element, else null
    @@ -578,19 +523,9 @@

    getAnnotation

  • getAnnotations

    public final java.lang.annotation.Annotation[] getAnnotations()
    -
    Description copied from interface: java.lang.reflect.AnnotatedElement
    -
    Returns annotations that are present on this element. - - If there are no annotations present on this element, the return - value is an array of length 0. - - The caller of this method is free to modify the returned array; it will - have no effect on the arrays returned to other callers.
    Specified by:
    getAnnotations in interface java.lang.reflect.AnnotatedElement
    -
    Returns:
    -
    annotations present on this element
    • @@ -601,20 +536,9 @@

    getAnnotations

  • getDeclaredAnnotations

    public final java.lang.annotation.Annotation[] getDeclaredAnnotations()
    -
    Description copied from interface: java.lang.reflect.AnnotatedElement
    -
    Returns annotations that are directly present on this element. - This method ignores inherited annotations. - - If there are no annotations directly present on this element, - the return value is an array of length 0. - - The caller of this method is free to modify the returned array; it will - have no effect on the arrays returned to other callers.
    Specified by:
    getDeclaredAnnotations in interface java.lang.reflect.AnnotatedElement
    -
    Returns:
    -
    annotations directly present on this element
    • @@ -665,14 +589,9 @@

    isAccessible

  • getName

    public final java.lang.String getName()
    -
    Description copied from interface: java.lang.reflect.Member
    -
    Returns the simple name of the underlying member or constructor - represented by this Member.
    Specified by:
    getName in interface java.lang.reflect.Member
    -
    Returns:
    -
    the simple name of the underlying member
    • @@ -683,18 +602,9 @@

    getName

  • getModifiers

    public final int getModifiers()
    -
    Description copied from interface: java.lang.reflect.Member
    -
    Returns the Java language modifiers for the member or - constructor represented by this Member, as an integer. The - Modifier class should be used to decode the modifiers in - the integer.
    Specified by:
    getModifiers in interface java.lang.reflect.Member
    -
    Returns:
    -
    the Java language modifiers for the underlying member
    -
    See Also:
    -
    Modifier
    • @@ -705,15 +615,9 @@

    getModifiers

  • isSynthetic

    public final boolean isSynthetic()
    -
    Description copied from interface: java.lang.reflect.Member
    -
    Returns true if this member was introduced by - the compiler; returns false otherwise.
    Specified by:
    isSynthetic in interface java.lang.reflect.Member
    -
    Returns:
    -
    true if and only if this member was introduced by - the compiler.
    • @@ -819,56 +723,9 @@

    isSynchronized

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object obj)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -879,43 +736,9 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -926,29 +749,9 @@

    hashCode

  • toString

    public java.lang.String toString()
    -
    Description copied from class: java.lang.Object
    -
    Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

    - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

    - 
    - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    • @@ -1067,15 +870,9 @@

    returning

  • getDeclaringClass

    public final java.lang.Class<? super T> getDeclaringClass()
    -
    Description copied from interface: java.lang.reflect.Member
    -
    Returns the Class object representing the class or interface - that declares the member or constructor represented by this Member.
    Specified by:
    getDeclaringClass in interface java.lang.reflect.Member
    -
    Returns:
    -
    an object representing the declaring class of the - underlying member
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/reflect/MutableTypeToInstanceMap.html b/releases/snapshot-jre/api/docs/com/google/common/reflect/MutableTypeToInstanceMap.html index d708cdce8649..2b2b733a989a 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/reflect/MutableTypeToInstanceMap.html +++ b/releases/snapshot-jre/api/docs/com/google/common/reflect/MutableTypeToInstanceMap.html @@ -184,7 +184,7 @@

    Nested classes/interfaces inherited from class com.google.common.collec

    Nested classes/interfaces inherited from interface java.util.Map

    -java.util.Map.Entry<K,​V> +java.util.Map.Entry<K extends java.lang.Object,​V extends java.lang.Object> @@ -234,9 +234,7 @@

    Method Summary

    java.util.Set<java.util.Map.Entry<TypeToken<? extends B>,​B>> entrySet() - -
    Returns a Set view of the mappings contained in this map.
    - +  <T extends B>
    T     @@ -465,15 +463,6 @@

    put

    put in interface java.util.Map<TypeToken<? extends B>,​B>
    Overrides:
    put in class ForwardingMap<TypeToken<? extends B>,​B>
    -
    Parameters:
    -
    key - key with which the specified value is to be associated
    -
    value - value to be associated with the specified key
    -
    Returns:
    -
    the previous value associated with key, or - null if there was no mapping for key. - (A null return can also indicate that the map - previously associated null with key, - if the implementation supports null values.)
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -496,8 +485,6 @@

    putAll

    putAll in interface java.util.Map<TypeToken<? extends B>,​B>
    Overrides:
    putAll in class ForwardingMap<TypeToken<? extends B>,​B>
    -
    Parameters:
    -
    map - mappings to be stored in this map
    Throws:
    java.lang.UnsupportedOperationException - always
    @@ -510,26 +497,11 @@

    putAll

  • entrySet

    public java.util.Set<java.util.Map.Entry<TypeToken<? extends B>,​B>> entrySet()
    -
    Description copied from interface: java.util.Map
    -
    Returns a Set view of the mappings contained in this map. - The set is backed by the map, so changes to the map are - reflected in the set, and vice-versa. If the map is modified - while an iteration over the set is in progress (except through - the iterator's own remove operation, or through the - setValue operation on a map entry returned by the - iterator) the results of the iteration are undefined. The set - supports element removal, which removes the corresponding - mapping from the map, via the Iterator.remove, - Set.remove, removeAll, retainAll and - clear operations. It does not support the - add or addAll operations.
    Specified by:
    entrySet in interface java.util.Map<TypeToken<? extends B>,​B>
    Overrides:
    entrySet in class ForwardingMap<TypeToken<? extends B>,​B>
    -
    Returns:
    -
    a set view of the mappings contained in this map
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/reflect/Parameter.html b/releases/snapshot-jre/api/docs/com/google/common/reflect/Parameter.html index 6b1c0ccdfb8a..74026d308460 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/reflect/Parameter.html +++ b/releases/snapshot-jre/api/docs/com/google/common/reflect/Parameter.html @@ -174,9 +174,7 @@

    Method Summary

    boolean equals​(java.lang.Object obj) - -
    Indicates whether some other object is "equal to" this one.
    - +  java.lang.reflect.AnnotatedType @@ -186,48 +184,32 @@

    Method Summary

    <A extends java.lang.annotation.Annotation>
    A     getAnnotation​(java.lang.Class<A> annotationType) - -
    Returns this element's annotation for the specified type if - such an annotation is present, else null.
    - +  java.lang.annotation.Annotation[] getAnnotations() - -
    Returns annotations that are present on this element.
    - +  <A extends java.lang.annotation.Annotation>
    A[]     getAnnotationsByType​(java.lang.Class<A> annotationType) - -
    Returns annotations that are associated with this element.
    - +  <A extends java.lang.annotation.Annotation>
    A     getDeclaredAnnotation​(java.lang.Class<A> annotationType) - -
    Returns this element's annotation for the specified type if - such an annotation is directly present, else null.
    - +  java.lang.annotation.Annotation[] getDeclaredAnnotations() - -
    Returns annotations that are directly present on this element.
    - +  <A extends java.lang.annotation.Annotation>
    A[]     getDeclaredAnnotationsByType​(java.lang.Class<A> annotationType) - -
    Returns this element's annotation(s) for the specified type if - such annotations are either directly present or - indirectly present.
    - +  Invokable<?,​?> @@ -246,24 +228,17 @@

    Method Summary

    int hashCode() - -
    Returns a hash code value for the object.
    - +  boolean isAnnotationPresent​(java.lang.Class<? extends java.lang.annotation.Annotation> annotationType) - -
    Returns true if an annotation for the specified type - is present on this element, else false.
    - +  java.lang.String toString() - -
    Returns a string representation of the object.
    - + 
      @@ -316,25 +291,9 @@

      getDeclaringInvokable

    • isAnnotationPresent

      public boolean isAnnotationPresent​(java.lang.Class<? extends java.lang.annotation.Annotation> annotationType)
      -
      Description copied from interface: java.lang.reflect.AnnotatedElement
      -
      Returns true if an annotation for the specified type - is present on this element, else false. This method - is designed primarily for convenient access to marker annotations. - -

      The truth value returned by this method is equivalent to: - getAnnotation(annotationClass) != null - -

      The body of the default method is specified to be the code - above.

      Specified by:
      isAnnotationPresent in interface java.lang.reflect.AnnotatedElement
      -
      Parameters:
      -
      annotationType - the Class object corresponding to the - annotation type
      -
      Returns:
      -
      true if an annotation for the specified annotation - type is present on this element, else false
    @@ -346,20 +305,9 @@

    isAnnotationPresent

    getAnnotation

    @CheckForNull
 public <A extends java.lang.annotation.Annotation> A getAnnotation​(java.lang.Class<A> annotationType)
    -
    Description copied from interface: java.lang.reflect.AnnotatedElement
    -
    Returns this element's annotation for the specified type if - such an annotation is present, else null.
    Specified by:
    getAnnotation in interface java.lang.reflect.AnnotatedElement
    -
    Type Parameters:
    -
    A - the type of the annotation to query for and return if present
    -
    Parameters:
    -
    annotationType - the Class object corresponding to the - annotation type
    -
    Returns:
    -
    this element's annotation for the specified annotation type if - present on this element, else null
    @@ -370,19 +318,9 @@

    getAnnotation

  • getAnnotations

    public java.lang.annotation.Annotation[] getAnnotations()
    -
    Description copied from interface: java.lang.reflect.AnnotatedElement
    -
    Returns annotations that are present on this element. - - If there are no annotations present on this element, the return - value is an array of length 0. - - The caller of this method is free to modify the returned array; it will - have no effect on the arrays returned to other callers.
    Specified by:
    getAnnotations in interface java.lang.reflect.AnnotatedElement
    -
    Returns:
    -
    annotations present on this element
    • @@ -393,31 +331,9 @@

    getAnnotations

  • getAnnotationsByType

    public <A extends java.lang.annotation.Annotation> A[] getAnnotationsByType​(java.lang.Class<A> annotationType)
    -
    Description copied from interface: java.lang.reflect.AnnotatedElement
    -
    Returns annotations that are associated with this element. - - If there are no annotations associated with this element, the return - value is an array of length 0. - - The difference between this method and AnnotatedElement.getAnnotation(Class) - is that this method detects if its argument is a repeatable - annotation type (JLS 9.6), and if so, attempts to find one or - more annotations of that type by "looking through" a container - annotation. - - The caller of this method is free to modify the returned array; it will - have no effect on the arrays returned to other callers.
    Specified by:
    getAnnotationsByType in interface java.lang.reflect.AnnotatedElement
    -
    Type Parameters:
    -
    A - the type of the annotation to query for and return if present
    -
    Parameters:
    -
    annotationType - the Class object corresponding to the - annotation type
    -
    Returns:
    -
    all this element's annotations for the specified annotation type if - associated with this element, else an array of length zero
    Since:
    18.0
    @@ -430,20 +346,9 @@

    getAnnotationsByType

  • getDeclaredAnnotations

    public java.lang.annotation.Annotation[] getDeclaredAnnotations()
    -
    Description copied from interface: java.lang.reflect.AnnotatedElement
    -
    Returns annotations that are directly present on this element. - This method ignores inherited annotations. - - If there are no annotations directly present on this element, - the return value is an array of length 0. - - The caller of this method is free to modify the returned array; it will - have no effect on the arrays returned to other callers.
    Specified by:
    getDeclaredAnnotations in interface java.lang.reflect.AnnotatedElement
    -
    Returns:
    -
    annotations directly present on this element
    Since:
    18.0
    @@ -457,23 +362,9 @@

    getDeclaredAnnotations

    getDeclaredAnnotation

    @CheckForNull
 public <A extends java.lang.annotation.Annotation> A getDeclaredAnnotation​(java.lang.Class<A> annotationType)
    -
    Description copied from interface: java.lang.reflect.AnnotatedElement
    -
    Returns this element's annotation for the specified type if - such an annotation is directly present, else null. - - This method ignores inherited annotations. (Returns null if no - annotations are directly present on this element.)
    Specified by:
    getDeclaredAnnotation in interface java.lang.reflect.AnnotatedElement
    -
    Type Parameters:
    -
    A - the type of the annotation to query for and return if directly present
    -
    Parameters:
    -
    annotationType - the Class object corresponding to the - annotation type
    -
    Returns:
    -
    this element's annotation for the specified annotation type if - directly present on this element, else null
    Since:
    18.0
    @@ -486,35 +377,9 @@

    getDeclaredAnnotation

  • getDeclaredAnnotationsByType

    public <A extends java.lang.annotation.Annotation> A[] getDeclaredAnnotationsByType​(java.lang.Class<A> annotationType)
    -
    Description copied from interface: java.lang.reflect.AnnotatedElement
    -
    Returns this element's annotation(s) for the specified type if - such annotations are either directly present or - indirectly present. This method ignores inherited - annotations. - - If there are no specified annotations directly or indirectly - present on this element, the return value is an array of length - 0. - - The difference between this method and AnnotatedElement.getDeclaredAnnotation(Class) is that this method detects if its - argument is a repeatable annotation type (JLS 9.6), and if so, - attempts to find one or more annotations of that type by "looking - through" a container annotation if one is present. - - The caller of this method is free to modify the returned array; it will - have no effect on the arrays returned to other callers.
    Specified by:
    getDeclaredAnnotationsByType in interface java.lang.reflect.AnnotatedElement
    -
    Type Parameters:
    -
    A - the type of the annotation to query for and return - if directly or indirectly present
    -
    Parameters:
    -
    annotationType - the Class object corresponding to the - annotation type
    -
    Returns:
    -
    all this element's annotations for the specified annotation type if - directly or indirectly present on this element, else an array of length zero
    Since:
    18.0
    @@ -541,56 +406,9 @@

    getAnnotatedType

    equals

    public boolean equals​(@CheckForNull
                       java.lang.Object obj)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    obj - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    • @@ -601,43 +419,9 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -648,29 +432,9 @@

    hashCode

  • toString

    public java.lang.String toString()
    -
    Description copied from class: java.lang.Object
    -
    Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

    - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

    - 
    - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/reflect/TypeParameter.html b/releases/snapshot-jre/api/docs/com/google/common/reflect/TypeParameter.html index 586b69a5bb8a..c6a133354680 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/reflect/TypeParameter.html +++ b/releases/snapshot-jre/api/docs/com/google/common/reflect/TypeParameter.html @@ -194,23 +194,17 @@

    Method Summary

    boolean equals​(java.lang.Object o) - -
    Indicates whether some other object is "equal to" this one.
    - +  int hashCode() - -
    Returns a hash code value for the object.
    - +  java.lang.String toString() - -
    Returns a string representation of the object.
    - + 
      @@ -262,43 +256,9 @@

      Method Detail

    • hashCode

      public final int hashCode()
      -
      Description copied from class: java.lang.Object
      -
      Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

      - The general contract of hashCode is: -

        -
      • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
      • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
      • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
      -

      - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

      Overrides:
      hashCode in class java.lang.Object
      -
      Returns:
      -
      a hash code value for this object.
      -
      See Also:
      -
      Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    @@ -310,56 +270,9 @@

    hashCode

    equals

    public final boolean equals​(@CheckForNull
                             java.lang.Object o)
    -
    Description copied from class: java.lang.Object
    -
    Indicates whether some other object is "equal to" this one. -

    - The equals method implements an equivalence relation - on non-null object references: -

      -
    • It is reflexive: for any non-null reference value - x, x.equals(x) should return - true. -
    • It is symmetric: for any non-null reference values - x and y, x.equals(y) - should return true if and only if - y.equals(x) returns true. -
    • It is transitive: for any non-null reference values - x, y, and z, if - x.equals(y) returns true and - y.equals(z) returns true, then - x.equals(z) should return true. -
    • It is consistent: for any non-null reference values - x and y, multiple invocations of - x.equals(y) consistently return true - or consistently return false, provided no - information used in equals comparisons on the - objects is modified. -
    • For any non-null reference value x, - x.equals(null) should return false. -
    -

    - The equals method for class Object implements - the most discriminating possible equivalence relation on objects; - that is, for any non-null reference values x and - y, this method returns true if and only - if x and y refer to the same object - (x == y has the value true). -

    - Note that it is generally necessary to override the hashCode - method whenever this method is overridden, so as to maintain the - general contract for the hashCode method, which states - that equal objects must have equal hash codes.

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    o - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -370,29 +283,9 @@

    equals

  • toString

    public java.lang.String toString()
    -
    Description copied from class: java.lang.Object
    -
    Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

    - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

    - 
    - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/reflect/TypeToInstanceMap.html b/releases/snapshot-jre/api/docs/com/google/common/reflect/TypeToInstanceMap.html index 891235ccb3df..99012421939a 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/reflect/TypeToInstanceMap.html +++ b/releases/snapshot-jre/api/docs/com/google/common/reflect/TypeToInstanceMap.html @@ -178,7 +178,7 @@

    Nested Class Summary

    Nested classes/interfaces inherited from interface java.util.Map

    -java.util.Map.Entry<K,​V> +java.util.Map.Entry<K extends java.lang.Object,​V extends java.lang.Object> diff --git a/releases/snapshot-jre/api/docs/com/google/common/reflect/TypeToken.html b/releases/snapshot-jre/api/docs/com/google/common/reflect/TypeToken.html index 7feda539910f..941e9663299b 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/reflect/TypeToken.html +++ b/releases/snapshot-jre/api/docs/com/google/common/reflect/TypeToken.html @@ -326,9 +326,7 @@

    Method Summary

    int hashCode() - -
    Returns a hash code value for the object.
    - +  boolean @@ -404,9 +402,7 @@

    Method Summary

    java.lang.String toString() - -
    Returns a string representation of the object.
    - +  TypeToken<T> @@ -867,14 +863,6 @@

    equals

    Overrides:
    equals in class java.lang.Object
    -
    Parameters:
    -
    o - the reference object with which to compare.
    -
    Returns:
    -
    true if this object is the same as the obj - argument; false otherwise.
    -
    See Also:
    -
    Object.hashCode(), -HashMap
    @@ -885,43 +873,9 @@

    equals

  • hashCode

    public int hashCode()
    -
    Description copied from class: java.lang.Object
    -
    Returns a hash code value for the object. This method is - supported for the benefit of hash tables such as those provided by - HashMap. -

    - The general contract of hashCode is: -

      -
    • Whenever it is invoked on the same object more than once during - an execution of a Java application, the hashCode method - must consistently return the same integer, provided no information - used in equals comparisons on the object is modified. - This integer need not remain consistent from one execution of an - application to another execution of the same application. -
    • If two objects are equal according to the equals(Object) - method, then calling the hashCode method on each of - the two objects must produce the same integer result. -
    • It is not required that if two objects are unequal - according to the Object.equals(java.lang.Object) - method, then calling the hashCode method on each of the - two objects must produce distinct integer results. However, the - programmer should be aware that producing distinct integer results - for unequal objects may improve the performance of hash tables. -
    -

    - As much as is reasonably practical, the hashCode method defined - by class Object does return distinct integers for - distinct objects. (The hashCode may or may not be implemented - as some function of an object's memory address at some point - in time.)

    Overrides:
    hashCode in class java.lang.Object
    -
    Returns:
    -
    a hash code value for this object.
    -
    See Also:
    -
    Object.equals(java.lang.Object), -System.identityHashCode(java.lang.Object)
    • @@ -932,29 +886,9 @@

    hashCode

  • toString

    public java.lang.String toString()
    -
    Description copied from class: java.lang.Object
    -
    Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

    - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

    - 
    - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/AbstractExecutionThreadService.html b/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/AbstractExecutionThreadService.html index 168cf5f89373..e91139617187 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/AbstractExecutionThreadService.html +++ b/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/AbstractExecutionThreadService.html @@ -341,9 +341,7 @@

    Method Summary

    java.lang.String toString() - -
    Returns a string representation of the object.
    - +  protected void @@ -499,29 +497,9 @@

    executor

  • toString

    public java.lang.String toString()
    -
    Description copied from class: java.lang.Object
    -
    Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

    - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

    - 
    - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/AbstractFuture.html b/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/AbstractFuture.html index 6c4e8c312461..544de96a515d 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/AbstractFuture.html +++ b/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/AbstractFuture.html @@ -227,26 +227,15 @@

    Method Summary

    boolean cancel​(boolean mayInterruptIfRunning) - -
    Attempts to cancel execution of this task.
    - V get() - -
    Waits if necessary for the computation to complete, and then - retrieves its result.
    - V get​(long timeout, java.util.concurrent.TimeUnit unit) - -
    Waits if necessary for at most the given time for the computation - to complete, and then retrieves its result, if available.
    - protected void @@ -258,17 +247,12 @@

    Method Summary

    boolean isCancelled() - -
    Returns true if this task was cancelled before it completed - normally.
    - +  boolean isDone() - -
    Returns true if this task completed.
    - +  protected java.lang.String @@ -305,9 +289,7 @@

    Method Summary

    java.lang.String toString() - -
    Returns a string representation of the object.
    - +  protected java.lang.Throwable @@ -381,26 +363,18 @@

    get

    throws java.lang.InterruptedException, java.util.concurrent.TimeoutException, java.util.concurrent.ExecutionException -
    Waits if necessary for at most the given time for the computation - to complete, and then retrieves its result, if available. +

    The default AbstractFuture implementation throws InterruptedException if the current thread is interrupted during the call, even if the value is already available.

    Specified by:
    get in interface java.util.concurrent.Future<V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    timeout - the maximum time to wait
    -
    unit - the time unit of the timeout argument
    -
    Returns:
    -
    the computed result
    Throws:
    -
    java.util.concurrent.CancellationException - if the computation was cancelled
    -
    java.lang.InterruptedException - if the current thread was interrupted - while waiting
    -
    java.util.concurrent.TimeoutException - if the wait timed out
    -
    java.util.concurrent.ExecutionException - if the computation threw an - exception
    +
    java.util.concurrent.CancellationException
    +
    java.lang.InterruptedException
    +
    java.util.concurrent.TimeoutException
    +
    java.util.concurrent.ExecutionException
    @@ -414,22 +388,17 @@

    get

    public V get() throws java.lang.InterruptedException, java.util.concurrent.ExecutionException -
    Waits if necessary for the computation to complete, and then - retrieves its result. +

    The default AbstractFuture implementation throws InterruptedException if the current thread is interrupted during the call, even if the value is already available.

    Specified by:
    get in interface java.util.concurrent.Future<V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the computed result
    Throws:
    -
    java.util.concurrent.CancellationException - if the computation was cancelled
    -
    java.lang.InterruptedException - if the current thread was interrupted - while waiting
    -
    java.util.concurrent.ExecutionException - if the computation threw an - exception
    +
    java.util.concurrent.CancellationException
    +
    java.lang.InterruptedException
    +
    java.util.concurrent.ExecutionException
    @@ -440,17 +409,9 @@

    get

  • isDone

    public boolean isDone()
    -
    Description copied from interface: java.util.concurrent.Future
    -
    Returns true if this task completed. - - Completion may be due to normal termination, an exception, or - cancellation -- in all of these cases, this method will return - true.
    Specified by:
    isDone in interface java.util.concurrent.Future<V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    true if this task completed
    • @@ -461,14 +422,9 @@

    isDone

  • isCancelled

    public boolean isCancelled()
    -
    Description copied from interface: java.util.concurrent.Future
    -
    Returns true if this task was cancelled before it completed - normally.
    Specified by:
    isCancelled in interface java.util.concurrent.Future<V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    true if this task was cancelled before it completed
    • @@ -480,18 +436,7 @@

    isCancelled

    cancel

    @CanIgnoreReturnValue
 public boolean cancel​(boolean mayInterruptIfRunning)
    -
    Attempts to cancel execution of this task. This attempt will - fail if the task has already completed, has already been cancelled, - or could not be cancelled for some other reason. If successful, - and this task has not started when cancel is called, - this task should never run. If the task has already started, - then the mayInterruptIfRunning parameter determines - whether the thread executing this task should be interrupted in - an attempt to stop the task. - -

    After this method returns, subsequent calls to Future.isDone() will - always return true. Subsequent calls to Future.isCancelled() - will always return true if this method returned true. +

    If a cancellation attempt succeeds on a Future that had previously been set asynchronously, then the cancellation will also be propagated to the delegate Future that was supplied in the setFuture call. @@ -506,14 +451,6 @@

    cancel

    Specified by:
    cancel in interface java.util.concurrent.Future<V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    mayInterruptIfRunning - true if the thread executing this - task should be interrupted; otherwise, in-progress tasks are allowed - to complete
    -
    Returns:
    -
    false if the task could not be cancelled, - typically because it has already completed normally; - true otherwise
    @@ -749,29 +686,9 @@

    tryInternalFastPathGetFailure

  • toString

    public java.lang.String toString()
    -
    Description copied from class: java.lang.Object
    -
    Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

    - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

    - 
    - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/AbstractIdleService.html b/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/AbstractIdleService.html index 5ee6f33c04ac..165ca954091e 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/AbstractIdleService.html +++ b/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/AbstractIdleService.html @@ -334,9 +334,7 @@

    Method Summary

    java.lang.String toString() - -
    Returns a string representation of the object.
    - + 
      @@ -432,29 +430,9 @@

      executor

    • toString

      public java.lang.String toString()
      -
      Description copied from class: java.lang.Object
      -
      Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

      - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

      - 
      - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
      Overrides:
      toString in class java.lang.Object
      -
      Returns:
      -
      a string representation of the object.
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/AbstractListeningExecutorService.html b/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/AbstractListeningExecutorService.html index e0d0ffa05728..32cc8d1759be 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/AbstractListeningExecutorService.html +++ b/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/AbstractListeningExecutorService.html @@ -204,42 +204,28 @@

    Method Summary

    protected <T extends @Nullable java.lang.Object>
    java.util.concurrent.RunnableFuture<T>     newTaskFor​(java.lang.Runnable runnable, T value) - -
    Returns a RunnableFuture for the given runnable and default - value.
    - +  protected <T extends @Nullable java.lang.Object>
    java.util.concurrent.RunnableFuture<T>     newTaskFor​(java.util.concurrent.Callable<T> callable) - -
    Returns a RunnableFuture for the given callable task.
    - +  ListenableFuture<?> submit​(java.lang.Runnable task) - -
    Submits a Runnable task for execution and returns a Future - representing that task.
    - +  <T extends @Nullable java.lang.Object>
    ListenableFuture<T>     submit​(java.lang.Runnable task, T result) - -
    Submits a Runnable task for execution and returns a Future - representing that task.
    - +  <T extends @Nullable java.lang.Object>
    ListenableFuture<T>     submit​(java.util.concurrent.Callable<T> task) - -
    Submits a value-returning task for execution and returns a - Future representing the pending results of the task.
    - + 
      @@ -323,22 +309,9 @@

      newTaskFor

      @CanIgnoreReturnValue
 protected final <T extends @Nullable java.lang.Object> java.util.concurrent.RunnableFuture<T> newTaskFor​(java.lang.Runnable runnable,
                                                                                                          T value)
      -
      Description copied from class: java.util.concurrent.AbstractExecutorService
      -
      Returns a RunnableFuture for the given runnable and default - value.
      Overrides:
      newTaskFor in class java.util.concurrent.AbstractExecutorService
      -
      Type Parameters:
      -
      T - the type of the given value
      -
      Parameters:
      -
      runnable - the runnable task being wrapped
      -
      value - the default value for the returned future
      -
      Returns:
      -
      a RunnableFuture which, when run, will run the - underlying runnable and which, as a Future, will yield - the given value as its result and provide for cancellation of - the underlying task
      Since:
      19.0 (present with return type ListenableFutureTask since 14.0)
      @@ -352,20 +325,9 @@

      newTaskFor

      newTaskFor

      @CanIgnoreReturnValue
 protected final <T extends @Nullable java.lang.Object> java.util.concurrent.RunnableFuture<T> newTaskFor​(java.util.concurrent.Callable<T> callable)
      -
      Description copied from class: java.util.concurrent.AbstractExecutorService
      -
      Returns a RunnableFuture for the given callable task.
      Overrides:
      newTaskFor in class java.util.concurrent.AbstractExecutorService
      -
      Type Parameters:
      -
      T - the type of the callable's result
      -
      Parameters:
      -
      callable - the callable task being wrapped
      -
      Returns:
      -
      a RunnableFuture which, when run, will call the - underlying callable and which, as a Future, will yield - the callable's result as its result and provide for - cancellation of the underlying task
      Since:
      19.0 (present with return type ListenableFutureTask since 14.0)
      @@ -379,10 +341,6 @@

      newTaskFor

      submit

      @CanIgnoreReturnValue
 public ListenableFuture<?> submit​(java.lang.Runnable task)
      -
      Description copied from interface: java.util.concurrent.ExecutorService
      -
      Submits a Runnable task for execution and returns a Future - representing that task. The Future's get method will - return null upon successful completion.
      Specified by:
      submit in interface java.util.concurrent.ExecutorService
      @@ -390,10 +348,8 @@

      submit

      submit in interface ListeningExecutorService
      Overrides:
      submit in class java.util.concurrent.AbstractExecutorService
      -
      Parameters:
      -
      task - the task to submit
      Returns:
      -
      a Future representing pending completion of the task
      +
      a ListenableFuture representing pending completion of the task
    @@ -408,10 +364,6 @@

    submit

    @CanIgnoreReturnValue
 public <T extends @Nullable java.lang.Object> ListenableFuture<T> submit​(java.lang.Runnable task,
                                                                          T result)
    -
    Description copied from interface: java.util.concurrent.ExecutorService
    -
    Submits a Runnable task for execution and returns a Future - representing that task. The Future's get method will - return the given result upon successful completion.
    Specified by:
    submit in interface java.util.concurrent.ExecutorService
    @@ -419,13 +371,8 @@

    submit

    submit in interface ListeningExecutorService
    Overrides:
    submit in class java.util.concurrent.AbstractExecutorService
    -
    Type Parameters:
    -
    T - the type of the result
    -
    Parameters:
    -
    task - the task to submit
    -
    result - the result to return
    Returns:
    -
    a Future representing pending completion of the task
    +
    a ListenableFuture representing pending completion of the task
    @@ -437,21 +384,6 @@

    submit

    submit

    @CanIgnoreReturnValue
 public <T extends @Nullable java.lang.Object> ListenableFuture<T> submit​(java.util.concurrent.Callable<T> task)
    -
    Description copied from interface: java.util.concurrent.ExecutorService
    -
    Submits a value-returning task for execution and returns a - Future representing the pending results of the task. The - Future's get method will return the task's result upon - successful completion. - -

    - If you would like to immediately block waiting - for a task, you can use constructions of the form - result = exec.submit(aCallable).get(); - -

    Note: The Executors class includes a set of methods - that can convert some other common closure-like objects, - for example, PrivilegedAction to - Callable form so they can be submitted.

    Specified by:
    submit in interface java.util.concurrent.ExecutorService
    @@ -459,12 +391,8 @@

    submit

    submit in interface ListeningExecutorService
    Overrides:
    submit in class java.util.concurrent.AbstractExecutorService
    -
    Type Parameters:
    -
    T - the type of the task's result
    -
    Parameters:
    -
    task - the task to submit
    Returns:
    -
    a Future representing pending completion of the task
    +
    a ListenableFuture representing pending completion of the task
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/AbstractScheduledService.html b/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/AbstractScheduledService.html index 86b2bac19311..9f130be922c9 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/AbstractScheduledService.html +++ b/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/AbstractScheduledService.html @@ -419,9 +419,7 @@

    Method Summary

    java.lang.String toString() - -
    Returns a string representation of the object.
    - + 
      @@ -570,29 +568,9 @@

      serviceName

    • toString

      public java.lang.String toString()
      -
      Description copied from class: java.lang.Object
      -
      Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

      - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

      - 
      - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
      Overrides:
      toString in class java.lang.Object
      -
      Returns:
      -
      a string representation of the object.
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/AbstractService.html b/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/AbstractService.html index 924b9d9ec57b..2b26eb25fc0a 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/AbstractService.html +++ b/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/AbstractService.html @@ -348,9 +348,7 @@

    Method Summary

    java.lang.String toString() - -
    Returns a string representation of the object.
    - + 
      @@ -749,29 +747,9 @@

      addListener

    • toString

      public java.lang.String toString()
      -
      Description copied from class: java.lang.Object
      -
      Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

      - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

      - 
      - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
      Overrides:
      toString in class java.lang.Object
      -
      Returns:
      -
      a string representation of the object.
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/AtomicDouble.html b/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/AtomicDouble.html index 04f4a826a25e..5d539a8421cf 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/AtomicDouble.html +++ b/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/AtomicDouble.html @@ -658,9 +658,6 @@

    intValue

    Specified by:
    intValue in class java.lang.Number
    -
    Returns:
    -
    the numeric value represented by this object after conversion - to type int.
    @@ -676,9 +673,6 @@

    longValue

    Specified by:
    longValue in class java.lang.Number
    -
    Returns:
    -
    the numeric value represented by this object after conversion - to type long.
    @@ -694,9 +688,6 @@

    floatValue

    Specified by:
    floatValue in class java.lang.Number
    -
    Returns:
    -
    the numeric value represented by this object after conversion - to type float.
    @@ -711,9 +702,6 @@

    doubleValue

    Specified by:
    doubleValue in class java.lang.Number
    -
    Returns:
    -
    the numeric value represented by this object after conversion - to type double.
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/AtomicLongMap.html b/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/AtomicLongMap.html index c6a0b356ab29..f849caa2746a 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/AtomicLongMap.html +++ b/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/AtomicLongMap.html @@ -363,9 +363,7 @@

    Method Summary

    java.lang.String toString() - -
    Returns a string representation of the object.
    - +  long @@ -745,29 +743,9 @@

    clear

  • toString

    public java.lang.String toString()
    -
    Description copied from class: java.lang.Object
    -
    Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

    - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

    - 
    - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/ClosingFuture.html b/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/ClosingFuture.html index c93c5b2ae0bf..635efbcb86aa 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/ClosingFuture.html +++ b/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/ClosingFuture.html @@ -440,10 +440,7 @@

    Method Summary

    protected void finalize() - -
    Called by the garbage collector on an object when garbage collection - determines that there are no more references to the object.
    - +  FluentFuture<V> @@ -493,9 +490,7 @@

    Method Summary

    java.lang.String toString() - -
    Returns a string representation of the object.
    - +  <U extends @Nullable java.lang.Object>
    ClosingFuture<U>     @@ -1248,29 +1243,9 @@

    cancel

  • toString

    public java.lang.String toString()
    -
    Description copied from class: java.lang.Object
    -
    Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

    - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

    - 
    - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    • @@ -1281,56 +1256,9 @@

    toString

  • finalize

    protected void finalize()
    -
    Description copied from class: java.lang.Object
    -
    Called by the garbage collector on an object when garbage collection - determines that there are no more references to the object. - A subclass overrides the finalize method to dispose of - system resources or to perform other cleanup. -

    - The general contract of finalize is that it is invoked - if and when the Java™ virtual - machine has determined that there is no longer any - means by which this object can be accessed by any thread that has - not yet died, except as a result of an action taken by the - finalization of some other object or class which is ready to be - finalized. The finalize method may take any action, including - making this object available again to other threads; the usual purpose - of finalize, however, is to perform cleanup actions before - the object is irrevocably discarded. For example, the finalize method - for an object that represents an input/output connection might perform - explicit I/O transactions to break the connection before the object is - permanently discarded. -

    - The finalize method of class Object performs no - special action; it simply returns normally. Subclasses of - Object may override this definition. -

    - The Java programming language does not guarantee which thread will - invoke the finalize method for any given object. It is - guaranteed, however, that the thread that invokes finalize will not - be holding any user-visible synchronization locks when finalize is - invoked. If an uncaught exception is thrown by the finalize method, - the exception is ignored and finalization of that object terminates. -

    - After the finalize method has been invoked for an object, no - further action is taken until the Java virtual machine has again - determined that there is no longer any means by which this object can - be accessed by any thread that has not yet died, including possible - actions by other objects or classes which are ready to be finalized, - at which point the object may be discarded. -

    - The finalize method is never invoked more than once by a Java - virtual machine for any given object. -

    - Any exception thrown by the finalize method causes - the finalization of this object to be halted, but is otherwise - ignored.

    Overrides:
    finalize in class java.lang.Object
    -
    See Also:
    -
    WeakReference, -PhantomReference
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/CycleDetectingLockFactory.PotentialDeadlockException.html b/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/CycleDetectingLockFactory.PotentialDeadlockException.html index f49f41d31e87..3665aaa70263 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/CycleDetectingLockFactory.PotentialDeadlockException.html +++ b/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/CycleDetectingLockFactory.PotentialDeadlockException.html @@ -270,9 +270,6 @@

    getMessage

    Overrides:
    getMessage in class java.lang.Throwable
    -
    Returns:
    -
    the detail message string of this Throwable instance - (which may be null).
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/ForwardingBlockingDeque.html b/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/ForwardingBlockingDeque.html index 885d7df5e368..32b2ecdb052d 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/ForwardingBlockingDeque.html +++ b/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/ForwardingBlockingDeque.html @@ -237,142 +237,87 @@

    Method Summary

    int drainTo​(java.util.Collection<? super E> c) - -
    Removes all available elements from this queue and adds them - to the given collection.
    - +  int drainTo​(java.util.Collection<? super E> c, int maxElements) - -
    Removes at most the given number of available elements from - this queue and adds them to the given collection.
    - +  boolean offer​(E e, long timeout, java.util.concurrent.TimeUnit unit) - -
    Inserts the specified element into the queue represented by this deque - (in other words, at the tail of this deque), waiting up to the - specified wait time if necessary for space to become available.
    - +  boolean offerFirst​(E e, long timeout, java.util.concurrent.TimeUnit unit) - -
    Inserts the specified element at the front of this deque, - waiting up to the specified wait time if necessary for space to - become available.
    - +  boolean offerLast​(E e, long timeout, java.util.concurrent.TimeUnit unit) - -
    Inserts the specified element at the end of this deque, - waiting up to the specified wait time if necessary for space to - become available.
    - +  E poll​(long timeout, java.util.concurrent.TimeUnit unit) - -
    Retrieves and removes the head of the queue represented by this deque - (in other words, the first element of this deque), waiting up to the - specified wait time if necessary for an element to become available.
    - +  E pollFirst​(long timeout, java.util.concurrent.TimeUnit unit) - -
    Retrieves and removes the first element of this deque, waiting - up to the specified wait time if necessary for an element to - become available.
    - +  E pollLast​(long timeout, java.util.concurrent.TimeUnit unit) - -
    Retrieves and removes the last element of this deque, waiting - up to the specified wait time if necessary for an element to - become available.
    - +  void put​(E e) - -
    Inserts the specified element into the queue represented by this deque - (in other words, at the tail of this deque), waiting if necessary for - space to become available.
    - +  void putFirst​(E e) - -
    Inserts the specified element at the front of this deque, - waiting if necessary for space to become available.
    - +  void putLast​(E e) - -
    Inserts the specified element at the end of this deque, - waiting if necessary for space to become available.
    - +  int remainingCapacity() - -
    Returns the number of additional elements that this queue can ideally - (in the absence of memory or resource constraints) accept without - blocking, or Integer.MAX_VALUE if there is no intrinsic - limit.
    - +  E take() - -
    Retrieves and removes the head of the queue represented by this deque - (in other words, the first element of this deque), waiting if - necessary until an element becomes available.
    - +  E takeFirst() - -
    Retrieves and removes the first element of this deque, waiting - if necessary until an element becomes available.
    - +  E takeLast() - -
    Retrieves and removes the last element of this deque, waiting - if necessary until an element becomes available.
    - + 
      @@ -499,21 +444,9 @@

      delegate

    • remainingCapacity

      public int remainingCapacity()
      -
      Description copied from interface: java.util.concurrent.BlockingQueue
      -
      Returns the number of additional elements that this queue can ideally - (in the absence of memory or resource constraints) accept without - blocking, or Integer.MAX_VALUE if there is no intrinsic - limit. - -

      Note that you cannot always tell if an attempt to insert - an element will succeed by inspecting remainingCapacity - because it may be the case that another thread is about to - insert or remove an element.

      Specified by:
      remainingCapacity in interface java.util.concurrent.BlockingQueue<E>
      -
      Returns:
      -
      the remaining capacity
    @@ -527,16 +460,11 @@

    remainingCapacity

    putFirst

    public void putFirst​(E e)
               throws java.lang.InterruptedException
    -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Inserts the specified element at the front of this deque, - waiting if necessary for space to become available.
    Specified by:
    putFirst in interface java.util.concurrent.BlockingDeque<E>
    -
    Parameters:
    -
    e - the element to add
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -550,16 +478,11 @@

    putFirst

    putLast

    public void putLast​(E e)
              throws java.lang.InterruptedException
    -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Inserts the specified element at the end of this deque, - waiting if necessary for space to become available.
    Specified by:
    putLast in interface java.util.concurrent.BlockingDeque<E>
    -
    Parameters:
    -
    e - the element to add
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -575,24 +498,11 @@

    offerFirst

    long timeout, java.util.concurrent.TimeUnit unit) throws java.lang.InterruptedException -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Inserts the specified element at the front of this deque, - waiting up to the specified wait time if necessary for space to - become available.
    Specified by:
    offerFirst in interface java.util.concurrent.BlockingDeque<E>
    -
    Parameters:
    -
    e - the element to add
    -
    timeout - how long to wait before giving up, in units of - unit
    -
    unit - a TimeUnit determining how to interpret the - timeout parameter
    -
    Returns:
    -
    true if successful, or false if - the specified waiting time elapses before space is available
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -608,24 +518,11 @@

    offerLast

    long timeout, java.util.concurrent.TimeUnit unit) throws java.lang.InterruptedException -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Inserts the specified element at the end of this deque, - waiting up to the specified wait time if necessary for space to - become available.
    Specified by:
    offerLast in interface java.util.concurrent.BlockingDeque<E>
    -
    Parameters:
    -
    e - the element to add
    -
    timeout - how long to wait before giving up, in units of - unit
    -
    unit - a TimeUnit determining how to interpret the - timeout parameter
    -
    Returns:
    -
    true if successful, or false if - the specified waiting time elapses before space is available
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -637,16 +534,11 @@

    offerLast

    takeFirst

    public E takeFirst()
             throws java.lang.InterruptedException
    -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Retrieves and removes the first element of this deque, waiting - if necessary until an element becomes available.
    Specified by:
    takeFirst in interface java.util.concurrent.BlockingDeque<E>
    -
    Returns:
    -
    the head of this deque
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -658,16 +550,11 @@

    takeFirst

    takeLast

    public E takeLast()
            throws java.lang.InterruptedException
    -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Retrieves and removes the last element of this deque, waiting - if necessary until an element becomes available.
    Specified by:
    takeLast in interface java.util.concurrent.BlockingDeque<E>
    -
    Returns:
    -
    the tail of this deque
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -681,23 +568,11 @@

    pollFirst

    public E pollFirst​(long timeout, java.util.concurrent.TimeUnit unit) throws java.lang.InterruptedException -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Retrieves and removes the first element of this deque, waiting - up to the specified wait time if necessary for an element to - become available.
    Specified by:
    pollFirst in interface java.util.concurrent.BlockingDeque<E>
    -
    Parameters:
    -
    timeout - how long to wait before giving up, in units of - unit
    -
    unit - a TimeUnit determining how to interpret the - timeout parameter
    -
    Returns:
    -
    the head of this deque, or null if the specified - waiting time elapses before an element is available
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -711,23 +586,11 @@

    pollLast

    public E pollLast​(long timeout, java.util.concurrent.TimeUnit unit) throws java.lang.InterruptedException -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Retrieves and removes the last element of this deque, waiting - up to the specified wait time if necessary for an element to - become available.
    Specified by:
    pollLast in interface java.util.concurrent.BlockingDeque<E>
    -
    Parameters:
    -
    timeout - how long to wait before giving up, in units of - unit
    -
    unit - a TimeUnit determining how to interpret the - timeout parameter
    -
    Returns:
    -
    the tail of this deque, or null if the specified - waiting time elapses before an element is available
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -741,21 +604,13 @@

    pollLast

    put

    public void put​(E e)
          throws java.lang.InterruptedException
    -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Inserts the specified element into the queue represented by this deque - (in other words, at the tail of this deque), waiting if necessary for - space to become available. - -

    This method is equivalent to putLast.

    Specified by:
    put in interface java.util.concurrent.BlockingDeque<E>
    Specified by:
    put in interface java.util.concurrent.BlockingQueue<E>
    -
    Parameters:
    -
    e - the element to add
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -771,29 +626,13 @@

    offer

    long timeout, java.util.concurrent.TimeUnit unit) throws java.lang.InterruptedException -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Inserts the specified element into the queue represented by this deque - (in other words, at the tail of this deque), waiting up to the - specified wait time if necessary for space to become available. - -

    This method is equivalent to - offerLast.

    Specified by:
    offer in interface java.util.concurrent.BlockingDeque<E>
    Specified by:
    offer in interface java.util.concurrent.BlockingQueue<E>
    -
    Parameters:
    -
    e - the element to add
    -
    timeout - how long to wait before giving up, in units of - unit
    -
    unit - a TimeUnit determining how to interpret the - timeout parameter
    -
    Returns:
    -
    true if the element was added to this deque, else - false
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -805,21 +644,13 @@

    offer

    take

    public E take()
        throws java.lang.InterruptedException
    -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Retrieves and removes the head of the queue represented by this deque - (in other words, the first element of this deque), waiting if - necessary until an element becomes available. - -

    This method is equivalent to takeFirst.

    Specified by:
    take in interface java.util.concurrent.BlockingDeque<E>
    Specified by:
    take in interface java.util.concurrent.BlockingQueue<E>
    -
    Returns:
    -
    the head of this deque
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -833,28 +664,13 @@

    poll

    public E poll​(long timeout, java.util.concurrent.TimeUnit unit) throws java.lang.InterruptedException -
    Description copied from interface: java.util.concurrent.BlockingDeque
    -
    Retrieves and removes the head of the queue represented by this deque - (in other words, the first element of this deque), waiting up to the - specified wait time if necessary for an element to become available. - -

    This method is equivalent to - pollFirst.

    Specified by:
    poll in interface java.util.concurrent.BlockingDeque<E>
    Specified by:
    poll in interface java.util.concurrent.BlockingQueue<E>
    -
    Parameters:
    -
    timeout - how long to wait before giving up, in units of - unit
    -
    unit - a TimeUnit determining how to interpret the - timeout parameter
    -
    Returns:
    -
    the head of this deque, or null if the - specified waiting time elapses before an element is available
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -865,24 +681,9 @@

    poll

  • drainTo

    public int drainTo​(java.util.Collection<? super E> c)
    -
    Description copied from interface: java.util.concurrent.BlockingQueue
    -
    Removes all available elements from this queue and adds them - to the given collection. This operation may be more - efficient than repeatedly polling this queue. A failure - encountered while attempting to add elements to - collection c may result in elements being in neither, - either or both collections when the associated exception is - thrown. Attempts to drain a queue to itself result in - IllegalArgumentException. Further, the behavior of - this operation is undefined if the specified collection is - modified while the operation is in progress.
    Specified by:
    drainTo in interface java.util.concurrent.BlockingQueue<E>
    -
    Parameters:
    -
    c - the collection to transfer elements into
    -
    Returns:
    -
    the number of elements transferred
    • @@ -894,24 +695,9 @@

    drainTo

    drainTo

    public int drainTo​(java.util.Collection<? super E> c,
                    int maxElements)
    -
    Description copied from interface: java.util.concurrent.BlockingQueue
    -
    Removes at most the given number of available elements from - this queue and adds them to the given collection. A failure - encountered while attempting to add elements to - collection c may result in elements being in neither, - either or both collections when the associated exception is - thrown. Attempts to drain a queue to itself result in - IllegalArgumentException. Further, the behavior of - this operation is undefined if the specified collection is - modified while the operation is in progress.
    Specified by:
    drainTo in interface java.util.concurrent.BlockingQueue<E>
    -
    Parameters:
    -
    c - the collection to transfer elements into
    -
    maxElements - the maximum number of elements to transfer
    -
    Returns:
    -
    the number of elements transferred
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/ForwardingBlockingQueue.html b/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/ForwardingBlockingQueue.html index 643df700edd5..2e60d7f2515f 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/ForwardingBlockingQueue.html +++ b/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/ForwardingBlockingQueue.html @@ -228,64 +228,41 @@

    Method Summary

    int drainTo​(java.util.Collection<? super E> c) - -
    Removes all available elements from this queue and adds them - to the given collection.
    - +  int drainTo​(java.util.Collection<? super E> c, int maxElements) - -
    Removes at most the given number of available elements from - this queue and adds them to the given collection.
    - +  boolean offer​(E e, long timeout, java.util.concurrent.TimeUnit unit) - -
    Inserts the specified element into this queue, waiting up to the - specified wait time if necessary for space to become available.
    - +  E poll​(long timeout, java.util.concurrent.TimeUnit unit) - -
    Retrieves and removes the head of this queue, waiting up to the - specified wait time if necessary for an element to become available.
    - +  void put​(E e) - -
    Inserts the specified element into this queue, waiting if necessary - for space to become available.
    - +  int remainingCapacity() - -
    Returns the number of additional elements that this queue can ideally - (in the absence of memory or resource constraints) accept without - blocking, or Integer.MAX_VALUE if there is no intrinsic - limit.
    - +  E take() - -
    Retrieves and removes the head of this queue, waiting if necessary - until an element becomes available.
    - + 
      @@ -407,24 +384,9 @@

      drainTo

      @CanIgnoreReturnValue
 public int drainTo​(java.util.Collection<? super E> c,
                    int maxElements)
      -
      Description copied from interface: java.util.concurrent.BlockingQueue
      -
      Removes at most the given number of available elements from - this queue and adds them to the given collection. A failure - encountered while attempting to add elements to - collection c may result in elements being in neither, - either or both collections when the associated exception is - thrown. Attempts to drain a queue to itself result in - IllegalArgumentException. Further, the behavior of - this operation is undefined if the specified collection is - modified while the operation is in progress.
      Specified by:
      drainTo in interface java.util.concurrent.BlockingQueue<E>
      -
      Parameters:
      -
      c - the collection to transfer elements into
      -
      maxElements - the maximum number of elements to transfer
      -
      Returns:
      -
      the number of elements transferred
    @@ -436,24 +398,9 @@

    drainTo

    drainTo

    @CanIgnoreReturnValue
 public int drainTo​(java.util.Collection<? super E> c)
    -
    Description copied from interface: java.util.concurrent.BlockingQueue
    -
    Removes all available elements from this queue and adds them - to the given collection. This operation may be more - efficient than repeatedly polling this queue. A failure - encountered while attempting to add elements to - collection c may result in elements being in neither, - either or both collections when the associated exception is - thrown. Attempts to drain a queue to itself result in - IllegalArgumentException. Further, the behavior of - this operation is undefined if the specified collection is - modified while the operation is in progress.
    Specified by:
    drainTo in interface java.util.concurrent.BlockingQueue<E>
    -
    Parameters:
    -
    c - the collection to transfer elements into
    -
    Returns:
    -
    the number of elements transferred
    @@ -470,23 +417,11 @@

    offer

    long timeout, java.util.concurrent.TimeUnit unit) throws java.lang.InterruptedException -
    Description copied from interface: java.util.concurrent.BlockingQueue
    -
    Inserts the specified element into this queue, waiting up to the - specified wait time if necessary for space to become available.
    Specified by:
    offer in interface java.util.concurrent.BlockingQueue<E>
    -
    Parameters:
    -
    e - the element to add
    -
    timeout - how long to wait before giving up, in units of - unit
    -
    unit - a TimeUnit determining how to interpret the - timeout parameter
    -
    Returns:
    -
    true if successful, or false if - the specified waiting time elapses before space is available
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -501,22 +436,11 @@

    poll

    public E poll​(long timeout, java.util.concurrent.TimeUnit unit) throws java.lang.InterruptedException -
    Description copied from interface: java.util.concurrent.BlockingQueue
    -
    Retrieves and removes the head of this queue, waiting up to the - specified wait time if necessary for an element to become available.
    Specified by:
    poll in interface java.util.concurrent.BlockingQueue<E>
    -
    Parameters:
    -
    timeout - how long to wait before giving up, in units of - unit
    -
    unit - a TimeUnit determining how to interpret the - timeout parameter
    -
    Returns:
    -
    the head of this queue, or null if the - specified waiting time elapses before an element is available
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -530,16 +454,11 @@

    poll

    put

    public void put​(E e)
          throws java.lang.InterruptedException
    -
    Description copied from interface: java.util.concurrent.BlockingQueue
    -
    Inserts the specified element into this queue, waiting if necessary - for space to become available.
    Specified by:
    put in interface java.util.concurrent.BlockingQueue<E>
    -
    Parameters:
    -
    e - the element to add
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    @@ -550,21 +469,9 @@

    put

  • remainingCapacity

    public int remainingCapacity()
    -
    Description copied from interface: java.util.concurrent.BlockingQueue
    -
    Returns the number of additional elements that this queue can ideally - (in the absence of memory or resource constraints) accept without - blocking, or Integer.MAX_VALUE if there is no intrinsic - limit. - -

    Note that you cannot always tell if an attempt to insert - an element will succeed by inspecting remainingCapacity - because it may be the case that another thread is about to - insert or remove an element.

    Specified by:
    remainingCapacity in interface java.util.concurrent.BlockingQueue<E>
    -
    Returns:
    -
    the remaining capacity
    • @@ -577,16 +484,11 @@

    take

    @CanIgnoreReturnValue
 public E take()
        throws java.lang.InterruptedException
    -
    Description copied from interface: java.util.concurrent.BlockingQueue
    -
    Retrieves and removes the head of this queue, waiting if necessary - until an element becomes available.
    Specified by:
    take in interface java.util.concurrent.BlockingQueue<E>
    -
    Returns:
    -
    the head of this queue
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    +
    java.lang.InterruptedException
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/ForwardingExecutorService.html b/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/ForwardingExecutorService.html index efa15b77def1..33d9114dc34d 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/ForwardingExecutorService.html +++ b/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/ForwardingExecutorService.html @@ -207,11 +207,7 @@

    Method Summary

    boolean awaitTermination​(long timeout, java.util.concurrent.TimeUnit unit) - -
    Blocks until all tasks have completed execution after a shutdown - request, or the timeout occurs, or the current thread is - interrupted, whichever happens first.
    - +  protected abstract java.util.concurrent.ExecutorService @@ -223,104 +219,67 @@

    Method Summary

    void execute​(java.lang.Runnable command) - -
    Executes the given command at some time in the future.
    - +  <T extends @Nullable java.lang.Object>
    java.util.List<java.util.concurrent.Future<T>>     invokeAll​(java.util.Collection<? extends java.util.concurrent.Callable<T>> tasks) - -
    Executes the given tasks, returning a list of Futures holding - their status and results when all complete.
    - +  <T extends @Nullable java.lang.Object>
    java.util.List<java.util.concurrent.Future<T>>     invokeAll​(java.util.Collection<? extends java.util.concurrent.Callable<T>> tasks, long timeout, java.util.concurrent.TimeUnit unit) - -
    Executes the given tasks, returning a list of Futures holding - their status and results - when all complete or the timeout expires, whichever happens first.
    - +  <T extends @Nullable java.lang.Object>
    T     invokeAny​(java.util.Collection<? extends java.util.concurrent.Callable<T>> tasks) - -
    Executes the given tasks, returning the result - of one that has completed successfully (i.e., without throwing - an exception), if any do.
    - +  <T extends @Nullable java.lang.Object>
    T     invokeAny​(java.util.Collection<? extends java.util.concurrent.Callable<T>> tasks, long timeout, java.util.concurrent.TimeUnit unit) - -
    Executes the given tasks, returning the result - of one that has completed successfully (i.e., without throwing - an exception), if any do before the given timeout elapses.
    - +  boolean isShutdown() - -
    Returns true if this executor has been shut down.
    - +  boolean isTerminated() - -
    Returns true if all tasks have completed following shut down.
    - +  void shutdown() - -
    Initiates an orderly shutdown in which previously submitted - tasks are executed, but no new tasks will be accepted.
    - +  java.util.List<java.lang.Runnable> shutdownNow() - -
    Attempts to stop all actively executing tasks, halts the - processing of waiting tasks, and returns a list of the tasks - that were awaiting execution.
    - +  java.util.concurrent.Future<?> submit​(java.lang.Runnable task) - -
    Submits a Runnable task for execution and returns a Future - representing that task.
    - +  <T extends @Nullable java.lang.Object>
    java.util.concurrent.Future<T>     submit​(java.lang.Runnable task, T result) - -
    Submits a Runnable task for execution and returns a Future - representing that task.
    - +  <T extends @Nullable java.lang.Object>
    java.util.concurrent.Future<T>     submit​(java.util.concurrent.Callable<T> task) - -
    Submits a value-returning task for execution and returns a - Future representing the pending results of the task.
    - + 
      @@ -401,21 +360,11 @@

      awaitTermination

      public boolean awaitTermination​(long timeout, java.util.concurrent.TimeUnit unit) throws java.lang.InterruptedException -
      Description copied from interface: java.util.concurrent.ExecutorService
      -
      Blocks until all tasks have completed execution after a shutdown - request, or the timeout occurs, or the current thread is - interrupted, whichever happens first.
      Specified by:
      awaitTermination in interface java.util.concurrent.ExecutorService
      -
      Parameters:
      -
      timeout - the maximum time to wait
      -
      unit - the time unit of the timeout argument
      -
      Returns:
      -
      true if this executor terminated and - false if the timeout elapsed before termination
      Throws:
      -
      java.lang.InterruptedException - if interrupted while waiting
      +
      java.lang.InterruptedException
    @@ -427,29 +376,11 @@

    awaitTermination

    invokeAll

    public <T extends @Nullable java.lang.Object> java.util.List<java.util.concurrent.Future<T>> invokeAll​(java.util.Collection<? extends java.util.concurrent.Callable<T>> tasks)
                                                                                                 throws java.lang.InterruptedException
    -
    Description copied from interface: java.util.concurrent.ExecutorService
    -
    Executes the given tasks, returning a list of Futures holding - their status and results when all complete. - Future.isDone() is true for each - element of the returned list. - Note that a completed task could have - terminated either normally or by throwing an exception. - The results of this method are undefined if the given - collection is modified while this operation is in progress.
    Specified by:
    invokeAll in interface java.util.concurrent.ExecutorService
    -
    Type Parameters:
    -
    T - the type of the values returned from the tasks
    -
    Parameters:
    -
    tasks - the collection of tasks
    -
    Returns:
    -
    a list of Futures representing the tasks, in the same - sequential order as produced by the iterator for the - given task list, each of which has completed
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting, in - which case unfinished tasks are cancelled
    +
    java.lang.InterruptedException
    @@ -463,35 +394,11 @@

    invokeAll

    long timeout, java.util.concurrent.TimeUnit unit) throws java.lang.InterruptedException -
    Description copied from interface: java.util.concurrent.ExecutorService
    -
    Executes the given tasks, returning a list of Futures holding - their status and results - when all complete or the timeout expires, whichever happens first. - Future.isDone() is true for each - element of the returned list. - Upon return, tasks that have not completed are cancelled. - Note that a completed task could have - terminated either normally or by throwing an exception. - The results of this method are undefined if the given - collection is modified while this operation is in progress.
    Specified by:
    invokeAll in interface java.util.concurrent.ExecutorService
    -
    Type Parameters:
    -
    T - the type of the values returned from the tasks
    -
    Parameters:
    -
    tasks - the collection of tasks
    -
    timeout - the maximum time to wait
    -
    unit - the time unit of the timeout argument
    -
    Returns:
    -
    a list of Futures representing the tasks, in the same - sequential order as produced by the iterator for the - given task list. If the operation did not time out, - each task will have completed. If it did time out, some - of these tasks will not have completed.
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting, in - which case unfinished tasks are cancelled
    +
    java.lang.InterruptedException
    @@ -504,25 +411,12 @@

    invokeAny

    public <T extends @Nullable java.lang.Object> T invokeAny​(java.util.Collection<? extends java.util.concurrent.Callable<T>> tasks)
                                                    throws java.lang.InterruptedException,
                                                           java.util.concurrent.ExecutionException
    -
    Description copied from interface: java.util.concurrent.ExecutorService
    -
    Executes the given tasks, returning the result - of one that has completed successfully (i.e., without throwing - an exception), if any do. Upon normal or exceptional return, - tasks that have not completed are cancelled. - The results of this method are undefined if the given - collection is modified while this operation is in progress.
    Specified by:
    invokeAny in interface java.util.concurrent.ExecutorService
    -
    Type Parameters:
    -
    T - the type of the values returned from the tasks
    -
    Parameters:
    -
    tasks - the collection of tasks
    -
    Returns:
    -
    the result returned by one of the tasks
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    -
    java.util.concurrent.ExecutionException - if no task successfully completes
    +
    java.lang.InterruptedException
    +
    java.util.concurrent.ExecutionException
    @@ -538,30 +432,13 @@

    invokeAny

    throws java.lang.InterruptedException, java.util.concurrent.ExecutionException, java.util.concurrent.TimeoutException -
    Description copied from interface: java.util.concurrent.ExecutorService
    -
    Executes the given tasks, returning the result - of one that has completed successfully (i.e., without throwing - an exception), if any do before the given timeout elapses. - Upon normal or exceptional return, tasks that have not - completed are cancelled. - The results of this method are undefined if the given - collection is modified while this operation is in progress.
    Specified by:
    invokeAny in interface java.util.concurrent.ExecutorService
    -
    Type Parameters:
    -
    T - the type of the values returned from the tasks
    -
    Parameters:
    -
    tasks - the collection of tasks
    -
    timeout - the maximum time to wait
    -
    unit - the time unit of the timeout argument
    -
    Returns:
    -
    the result returned by one of the tasks
    Throws:
    -
    java.lang.InterruptedException - if interrupted while waiting
    -
    java.util.concurrent.ExecutionException - if no task successfully completes
    -
    java.util.concurrent.TimeoutException - if the given timeout elapses before - any task successfully completes
    +
    java.lang.InterruptedException
    +
    java.util.concurrent.ExecutionException
    +
    java.util.concurrent.TimeoutException
    @@ -572,13 +449,9 @@

    invokeAny

  • isShutdown

    public boolean isShutdown()
    -
    Description copied from interface: java.util.concurrent.ExecutorService
    -
    Returns true if this executor has been shut down.
    Specified by:
    isShutdown in interface java.util.concurrent.ExecutorService
    -
    Returns:
    -
    true if this executor has been shut down
    • @@ -589,15 +462,9 @@

    isShutdown

  • isTerminated

    public boolean isTerminated()
    -
    Description copied from interface: java.util.concurrent.ExecutorService
    -
    Returns true if all tasks have completed following shut down. - Note that isTerminated is never true unless - either shutdown or shutdownNow was called first.
    Specified by:
    isTerminated in interface java.util.concurrent.ExecutorService
    -
    Returns:
    -
    true if all tasks have completed following shut down
    • @@ -608,14 +475,6 @@

    isTerminated

  • shutdown

    public void shutdown()
    -
    Description copied from interface: java.util.concurrent.ExecutorService
    -
    Initiates an orderly shutdown in which previously submitted - tasks are executed, but no new tasks will be accepted. - Invocation has no additional effect if already shut down. - -

    This method does not wait for previously submitted tasks to - complete execution. Use awaitTermination - to do that.

    Specified by:
    shutdown in interface java.util.concurrent.ExecutorService
    @@ -630,24 +489,9 @@

    shutdown

    shutdownNow

    @CanIgnoreReturnValue
 public java.util.List<java.lang.Runnable> shutdownNow()
    -
    Description copied from interface: java.util.concurrent.ExecutorService
    -
    Attempts to stop all actively executing tasks, halts the - processing of waiting tasks, and returns a list of the tasks - that were awaiting execution. - -

    This method does not wait for actively executing tasks to - terminate. Use awaitTermination to - do that. - -

    There are no guarantees beyond best-effort attempts to stop - processing actively executing tasks. For example, typical - implementations will cancel via Thread.interrupt(), so any - task that fails to respond to interrupts may never terminate.

    Specified by:
    shutdownNow in interface java.util.concurrent.ExecutorService
    -
    Returns:
    -
    list of tasks that never commenced execution
    • @@ -658,15 +502,9 @@

    shutdownNow

  • execute

    public void execute​(java.lang.Runnable command)
    -
    Description copied from interface: java.util.concurrent.Executor
    -
    Executes the given command at some time in the future. The command - may execute in a new thread, in a pooled thread, or in the calling - thread, at the discretion of the Executor implementation.
    Specified by:
    execute in interface java.util.concurrent.Executor
    -
    Parameters:
    -
    command - the runnable task
    • @@ -677,30 +515,9 @@

    execute

  • submit

    public <T extends @Nullable java.lang.Object> java.util.concurrent.Future<T> submit​(java.util.concurrent.Callable<T> task)
    -
    Description copied from interface: java.util.concurrent.ExecutorService
    -
    Submits a value-returning task for execution and returns a - Future representing the pending results of the task. The - Future's get method will return the task's result upon - successful completion. - -

    - If you would like to immediately block waiting - for a task, you can use constructions of the form - result = exec.submit(aCallable).get(); - -

    Note: The Executors class includes a set of methods - that can convert some other common closure-like objects, - for example, PrivilegedAction to - Callable form so they can be submitted.

    Specified by:
    submit in interface java.util.concurrent.ExecutorService
    -
    Type Parameters:
    -
    T - the type of the task's result
    -
    Parameters:
    -
    task - the task to submit
    -
    Returns:
    -
    a Future representing pending completion of the task
    • @@ -711,17 +528,9 @@

    submit

  • submit

    public java.util.concurrent.Future<?> submit​(java.lang.Runnable task)
    -
    Description copied from interface: java.util.concurrent.ExecutorService
    -
    Submits a Runnable task for execution and returns a Future - representing that task. The Future's get method will - return null upon successful completion.
    Specified by:
    submit in interface java.util.concurrent.ExecutorService
    -
    Parameters:
    -
    task - the task to submit
    -
    Returns:
    -
    a Future representing pending completion of the task
    • @@ -735,20 +544,9 @@

    submit

    submit

    public <T extends @Nullable java.lang.Object> java.util.concurrent.Future<T> submit​(java.lang.Runnable task,
                                                                                     T result)
    -
    Description copied from interface: java.util.concurrent.ExecutorService
    -
    Submits a Runnable task for execution and returns a Future - representing that task. The Future's get method will - return the given result upon successful completion.
    Specified by:
    submit in interface java.util.concurrent.ExecutorService
    -
    Type Parameters:
    -
    T - the type of the result
    -
    Parameters:
    -
    task - the task to submit
    -
    result - the result to return
    -
    Returns:
    -
    a Future representing pending completion of the task
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/ForwardingFuture.html b/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/ForwardingFuture.html index e01ce9f1979b..89ef2d9a7246 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/ForwardingFuture.html +++ b/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/ForwardingFuture.html @@ -233,9 +233,7 @@

    Method Summary

    boolean cancel​(boolean mayInterruptIfRunning) - -
    Attempts to cancel execution of this task.
    - +  protected abstract java.util.concurrent.Future<? extends V> @@ -247,34 +245,23 @@

    Method Summary

    V get() - -
    Waits if necessary for the computation to complete, and then - retrieves its result.
    - +  V get​(long timeout, java.util.concurrent.TimeUnit unit) - -
    Waits if necessary for at most the given time for the computation - to complete, and then retrieves its result, if available.
    - +  boolean isCancelled() - -
    Returns true if this task was cancelled before it completed - normally.
    - +  boolean isDone() - -
    Returns true if this task completed.
    - + 
      @@ -353,30 +340,9 @@

      delegate

      cancel

      @CanIgnoreReturnValue
 public boolean cancel​(boolean mayInterruptIfRunning)
      -
      Description copied from interface: java.util.concurrent.Future
      -
      Attempts to cancel execution of this task. This attempt will - fail if the task has already completed, has already been cancelled, - or could not be cancelled for some other reason. If successful, - and this task has not started when cancel is called, - this task should never run. If the task has already started, - then the mayInterruptIfRunning parameter determines - whether the thread executing this task should be interrupted in - an attempt to stop the task. - -

      After this method returns, subsequent calls to Future.isDone() will - always return true. Subsequent calls to Future.isCancelled() - will always return true if this method returned true.

      Specified by:
      cancel in interface java.util.concurrent.Future<V extends @Nullable java.lang.Object>
      -
      Parameters:
      -
      mayInterruptIfRunning - true if the thread executing this - task should be interrupted; otherwise, in-progress tasks are allowed - to complete
      -
      Returns:
      -
      false if the task could not be cancelled, - typically because it has already completed normally; - true otherwise
    @@ -387,14 +353,9 @@

    cancel

  • isCancelled

    public boolean isCancelled()
    -
    Description copied from interface: java.util.concurrent.Future
    -
    Returns true if this task was cancelled before it completed - normally.
    Specified by:
    isCancelled in interface java.util.concurrent.Future<V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    true if this task was cancelled before it completed
    • @@ -405,17 +366,9 @@

    isCancelled

  • isDone

    public boolean isDone()
    -
    Description copied from interface: java.util.concurrent.Future
    -
    Returns true if this task completed. - - Completion may be due to normal termination, an exception, or - cancellation -- in all of these cases, this method will return - true.
    Specified by:
    isDone in interface java.util.concurrent.Future<V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    true if this task completed
    • @@ -429,19 +382,12 @@

    get

    public V get() throws java.lang.InterruptedException, java.util.concurrent.ExecutionException -
    Description copied from interface: java.util.concurrent.Future
    -
    Waits if necessary for the computation to complete, and then - retrieves its result.
    Specified by:
    get in interface java.util.concurrent.Future<V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the computed result
    Throws:
    -
    java.lang.InterruptedException - if the current thread was interrupted - while waiting
    -
    java.util.concurrent.ExecutionException - if the computation threw an - exception
    +
    java.lang.InterruptedException
    +
    java.util.concurrent.ExecutionException
    @@ -457,23 +403,13 @@

    get

    throws java.lang.InterruptedException, java.util.concurrent.ExecutionException, java.util.concurrent.TimeoutException -
    Description copied from interface: java.util.concurrent.Future
    -
    Waits if necessary for at most the given time for the computation - to complete, and then retrieves its result, if available.
    Specified by:
    get in interface java.util.concurrent.Future<V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    timeout - the maximum time to wait
    -
    unit - the time unit of the timeout argument
    -
    Returns:
    -
    the computed result
    Throws:
    -
    java.lang.InterruptedException - if the current thread was interrupted - while waiting
    -
    java.util.concurrent.ExecutionException - if the computation threw an - exception
    -
    java.util.concurrent.TimeoutException - if the wait timed out
    +
    java.lang.InterruptedException
    +
    java.util.concurrent.ExecutionException
    +
    java.util.concurrent.TimeoutException
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/ForwardingListeningExecutorService.html b/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/ForwardingListeningExecutorService.html index 45ce9f27203f..d8306eaf979d 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/ForwardingListeningExecutorService.html +++ b/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/ForwardingListeningExecutorService.html @@ -214,27 +214,18 @@

    Method Summary

    ListenableFuture<?> submit​(java.lang.Runnable task) - -
    Submits a Runnable task for execution and returns a Future - representing that task.
    - +  <T extends @Nullable java.lang.Object>
    ListenableFuture<T>     submit​(java.lang.Runnable task, T result) - -
    Submits a Runnable task for execution and returns a Future - representing that task.
    - +  <T extends @Nullable java.lang.Object>
    ListenableFuture<T>     submit​(java.util.concurrent.Callable<T> task) - -
    Submits a value-returning task for execution and returns a - Future representing the pending results of the task.
    - + 
      @@ -340,21 +331,6 @@

      delegate

    • submit

      public <T extends @Nullable java.lang.Object> ListenableFuture<T> submit​(java.util.concurrent.Callable<T> task)
      -
      Description copied from interface: java.util.concurrent.ExecutorService
      -
      Submits a value-returning task for execution and returns a - Future representing the pending results of the task. The - Future's get method will return the task's result upon - successful completion. - -

      - If you would like to immediately block waiting - for a task, you can use constructions of the form - result = exec.submit(aCallable).get(); - -

      Note: The Executors class includes a set of methods - that can convert some other common closure-like objects, - for example, PrivilegedAction to - Callable form so they can be submitted.

      Specified by:
      submit in interface java.util.concurrent.ExecutorService
      @@ -362,12 +338,8 @@

      submit

      submit in interface ListeningExecutorService
      Overrides:
      submit in class ForwardingExecutorService
      -
      Type Parameters:
      -
      T - the type of the task's result
      -
      Parameters:
      -
      task - the task to submit
      Returns:
      -
      a Future representing pending completion of the task
      +
      a ListenableFuture representing pending completion of the task
    @@ -378,10 +350,6 @@

    submit

  • submit

    public ListenableFuture<?> submit​(java.lang.Runnable task)
    -
    Description copied from interface: java.util.concurrent.ExecutorService
    -
    Submits a Runnable task for execution and returns a Future - representing that task. The Future's get method will - return null upon successful completion.
    Specified by:
    submit in interface java.util.concurrent.ExecutorService
    @@ -389,10 +357,8 @@

    submit

    submit in interface ListeningExecutorService
    Overrides:
    submit in class ForwardingExecutorService
    -
    Parameters:
    -
    task - the task to submit
    Returns:
    -
    a Future representing pending completion of the task
    +
    a ListenableFuture representing pending completion of the task
    • @@ -406,10 +372,6 @@

    submit

    submit

    public <T extends @Nullable java.lang.Object> ListenableFuture<T> submit​(java.lang.Runnable task,
                                                                          T result)
    -
    Description copied from interface: java.util.concurrent.ExecutorService
    -
    Submits a Runnable task for execution and returns a Future - representing that task. The Future's get method will - return the given result upon successful completion.
    Specified by:
    submit in interface java.util.concurrent.ExecutorService
    @@ -417,13 +379,8 @@

    submit

    submit in interface ListeningExecutorService
    Overrides:
    submit in class ForwardingExecutorService
    -
    Type Parameters:
    -
    T - the type of the result
    -
    Parameters:
    -
    task - the task to submit
    -
    result - the result to return
    Returns:
    -
    a Future representing pending completion of the task
    +
    a ListenableFuture representing pending completion of the task
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/ListenableFutureTask.html b/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/ListenableFutureTask.html index 18bb85b1e0cd..d9e710975824 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/ListenableFutureTask.html +++ b/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/ListenableFutureTask.html @@ -212,10 +212,7 @@

    Method Summary

    V get​(long timeout, java.util.concurrent.TimeUnit unit) - -
    Waits if necessary for at most the given time for the computation - to complete, and then retrieves its result, if available.
    - + 
      @@ -348,25 +345,15 @@

      get

      throws java.util.concurrent.TimeoutException, java.lang.InterruptedException, java.util.concurrent.ExecutionException -
      Description copied from interface: java.util.concurrent.Future
      -
      Waits if necessary for at most the given time for the computation - to complete, and then retrieves its result, if available.
      Specified by:
      get in interface java.util.concurrent.Future<V extends @Nullable java.lang.Object>
      Overrides:
      get in class java.util.concurrent.FutureTask<V extends @Nullable java.lang.Object>
      -
      Parameters:
      -
      timeout - the maximum time to wait
      -
      unit - the time unit of the timeout argument
      -
      Returns:
      -
      the computed result
      Throws:
      -
      java.util.concurrent.TimeoutException - if the wait timed out
      -
      java.lang.InterruptedException - if the current thread was interrupted - while waiting
      -
      java.util.concurrent.ExecutionException - if the computation threw an - exception
      +
      java.util.concurrent.TimeoutException
      +
      java.lang.InterruptedException
      +
      java.util.concurrent.ExecutionException
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/ListeningExecutorService.html b/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/ListeningExecutorService.html index 76c2f00e2f66..20ce9dacbd99 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/ListeningExecutorService.html +++ b/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/ListeningExecutorService.html @@ -171,46 +171,28 @@

    Method Summary

    <T extends @Nullable java.lang.Object>
    java.util.List<java.util.concurrent.Future<T>>     invokeAll​(java.util.Collection<? extends java.util.concurrent.Callable<T>> tasks) - -
    Executes the given tasks, returning a list of Futures holding - their status and results when all complete.
    - <T extends @Nullable java.lang.Object>
    java.util.List<java.util.concurrent.Future<T>>     invokeAll​(java.util.Collection<? extends java.util.concurrent.Callable<T>> tasks, long timeout, java.util.concurrent.TimeUnit unit) - -
    Executes the given tasks, returning a list of Futures holding - their status and results - when all complete or the timeout expires, whichever happens first.
    - ListenableFuture<?> submit​(java.lang.Runnable task) - -
    Submits a Runnable task for execution and returns a Future - representing that task.
    - +  <T extends @Nullable java.lang.Object>
    ListenableFuture<T>     submit​(java.lang.Runnable task, T result) - -
    Submits a Runnable task for execution and returns a Future - representing that task.
    - +  <T extends @Nullable java.lang.Object>
    ListenableFuture<T>     submit​(java.util.concurrent.Callable<T> task) - -
    Submits a value-returning task for execution and returns a - Future representing the pending results of the task.
    - + 
      @@ -250,33 +232,13 @@

      Method Detail

    • submit

      <T extends @Nullable java.lang.Object> ListenableFuture<T> submit​(java.util.concurrent.Callable<T> task)
      -
      Description copied from interface: java.util.concurrent.ExecutorService
      -
      Submits a value-returning task for execution and returns a - Future representing the pending results of the task. The - Future's get method will return the task's result upon - successful completion. - -

      - If you would like to immediately block waiting - for a task, you can use constructions of the form - result = exec.submit(aCallable).get(); - -

      Note: The Executors class includes a set of methods - that can convert some other common closure-like objects, - for example, PrivilegedAction to - Callable form so they can be submitted.

      Specified by:
      submit in interface java.util.concurrent.ExecutorService
      -
      Type Parameters:
      -
      T - the type of the task's result
      -
      Parameters:
      -
      task - the task to submit
      Returns:
      a ListenableFuture representing pending completion of the task
      Throws:
      -
      java.util.concurrent.RejectedExecutionException - if the task cannot be - scheduled for execution
      +
      java.util.concurrent.RejectedExecutionException
    @@ -287,20 +249,13 @@

    submit

  • submit

    ListenableFuture<?> submit​(java.lang.Runnable task)
    -
    Description copied from interface: java.util.concurrent.ExecutorService
    -
    Submits a Runnable task for execution and returns a Future - representing that task. The Future's get method will - return null upon successful completion.
    Specified by:
    submit in interface java.util.concurrent.ExecutorService
    -
    Parameters:
    -
    task - the task to submit
    Returns:
    a ListenableFuture representing pending completion of the task
    Throws:
    -
    java.util.concurrent.RejectedExecutionException - if the task cannot be - scheduled for execution
    +
    java.util.concurrent.RejectedExecutionException
    • @@ -314,23 +269,13 @@

    submit

    submit

    <T extends @Nullable java.lang.Object> ListenableFuture<T> submit​(java.lang.Runnable task,
                                                                   T result)
    -
    Description copied from interface: java.util.concurrent.ExecutorService
    -
    Submits a Runnable task for execution and returns a Future - representing that task. The Future's get method will - return the given result upon successful completion.
    Specified by:
    submit in interface java.util.concurrent.ExecutorService
    -
    Type Parameters:
    -
    T - the type of the result
    -
    Parameters:
    -
    task - the task to submit
    -
    result - the result to return
    Returns:
    a ListenableFuture representing pending completion of the task
    Throws:
    -
    java.util.concurrent.RejectedExecutionException - if the task cannot be - scheduled for execution
    +
    java.util.concurrent.RejectedExecutionException
    @@ -342,14 +287,7 @@

    submit

    invokeAll

    <T extends @Nullable java.lang.Object> java.util.List<java.util.concurrent.Future<T>> invokeAll​(java.util.Collection<? extends java.util.concurrent.Callable<T>> tasks)
                                                                                          throws java.lang.InterruptedException
    -
    Executes the given tasks, returning a list of Futures holding - their status and results when all complete. - Future.isDone() is true for each - element of the returned list. - Note that a completed task could have - terminated either normally or by throwing an exception. - The results of this method are undefined if the given - collection is modified while this operation is in progress. +

    All elements in the returned list must be ListenableFuture instances. The easiest way to obtain a List<ListenableFuture<T>> from this method is an unchecked (but safe) @@ -362,20 +300,14 @@

    invokeAll

    Specified by:
    invokeAll in interface java.util.concurrent.ExecutorService
    -
    Type Parameters:
    -
    T - the type of the values returned from the tasks
    -
    Parameters:
    -
    tasks - the collection of tasks
    Returns:
    A list of ListenableFuture instances representing the tasks, in the same sequential order as produced by the iterator for the given task list, each of which has completed.
    Throws:
    -
    java.util.concurrent.RejectedExecutionException - if any task cannot be - scheduled for execution
    +
    java.util.concurrent.RejectedExecutionException
    java.lang.NullPointerException - if any task is null
    -
    java.lang.InterruptedException - if interrupted while waiting, in - which case unfinished tasks are cancelled
    +
    java.lang.InterruptedException
    @@ -389,16 +321,7 @@

    invokeAll

    long timeout, java.util.concurrent.TimeUnit unit) throws java.lang.InterruptedException -
    Executes the given tasks, returning a list of Futures holding - their status and results - when all complete or the timeout expires, whichever happens first. - Future.isDone() is true for each - element of the returned list. - Upon return, tasks that have not completed are cancelled. - Note that a completed task could have - terminated either normally or by throwing an exception. - The results of this method are undefined if the given - collection is modified while this operation is in progress. +

    All elements in the returned list must be ListenableFuture instances. The easiest way to obtain a List<ListenableFuture<T>> from this method is an unchecked (but safe) @@ -411,23 +334,15 @@

    invokeAll

    Specified by:
    invokeAll in interface java.util.concurrent.ExecutorService
    -
    Type Parameters:
    -
    T - the type of the values returned from the tasks
    -
    Parameters:
    -
    tasks - the collection of tasks
    -
    timeout - the maximum time to wait
    -
    unit - the time unit of the timeout argument
    Returns:
    a list of ListenableFuture instances representing the tasks, in the same sequential order as produced by the iterator for the given task list. If the operation did not time out, each task will have completed. If it did time out, some of these tasks will not have completed.
    Throws:
    -
    java.util.concurrent.RejectedExecutionException - if any task cannot be scheduled - for execution
    +
    java.util.concurrent.RejectedExecutionException
    java.lang.NullPointerException - if any task is null
    -
    java.lang.InterruptedException - if interrupted while waiting, in - which case unfinished tasks are cancelled
    +
    java.lang.InterruptedException
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/ListeningScheduledExecutorService.html b/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/ListeningScheduledExecutorService.html index 100539ff4976..971edcaa1fb3 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/ListeningScheduledExecutorService.html +++ b/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/ListeningScheduledExecutorService.html @@ -164,9 +164,7 @@

    Method Summary

    schedule​(java.lang.Runnable command, long delay, java.util.concurrent.TimeUnit unit) - -
    Submits a one-shot task that becomes enabled after the given delay.
    - +  default ListenableScheduledFuture<?> @@ -181,10 +179,7 @@

    Method Summary

    schedule​(java.util.concurrent.Callable<V> callable, long delay, java.util.concurrent.TimeUnit unit) - -
    Submits a value-returning one-shot task that becomes enabled - after the given delay.
    - +  default <V extends @Nullable java.lang.Object>
    ListenableScheduledFuture<V>     @@ -200,13 +195,7 @@

    Method Summary

    long initialDelay, long period, java.util.concurrent.TimeUnit unit) - -
    Submits a periodic action that becomes enabled first after the - given initial delay, and subsequently with the given period; - that is, executions will commence after - initialDelay, then initialDelay + period, then - initialDelay + 2 * period, and so on.
    - +  default ListenableScheduledFuture<?> @@ -223,12 +212,7 @@

    Method Summary

    long initialDelay, long delay, java.util.concurrent.TimeUnit unit) - -
    Submits a periodic action that becomes enabled first after the - given initial delay, and subsequently with the given delay - between the termination of one execution and the commencement of - the next.
    - +  default ListenableScheduledFuture<?> @@ -286,19 +270,9 @@

    schedule

    ListenableScheduledFuture<?> schedule​(java.lang.Runnable command,
                                       long delay,
                                       java.util.concurrent.TimeUnit unit)
    -
    Description copied from interface: java.util.concurrent.ScheduledExecutorService
    -
    Submits a one-shot task that becomes enabled after the given delay.
    Specified by:
    schedule in interface java.util.concurrent.ScheduledExecutorService
    -
    Parameters:
    -
    command - the task to execute
    -
    delay - the time from now to delay execution
    -
    unit - the time unit of the delay parameter
    -
    Returns:
    -
    a ScheduledFuture representing pending completion of - the task and whose get() method will return - null upon completion
    Since:
    15.0 (previously returned ScheduledFuture)
    @@ -328,20 +302,9 @@

    schedule

    <V extends @Nullable java.lang.Object> ListenableScheduledFuture<V> schedule​(java.util.concurrent.Callable<V> callable,
                                                                              long delay,
                                                                              java.util.concurrent.TimeUnit unit)
    -
    Description copied from interface: java.util.concurrent.ScheduledExecutorService
    -
    Submits a value-returning one-shot task that becomes enabled - after the given delay.
    Specified by:
    schedule in interface java.util.concurrent.ScheduledExecutorService
    -
    Type Parameters:
    -
    V - the type of the callable's result
    -
    Parameters:
    -
    callable - the function to execute
    -
    delay - the time from now to delay execution
    -
    unit - the time unit of the delay parameter
    -
    Returns:
    -
    a ScheduledFuture that can be used to extract result or cancel
    Since:
    15.0 (previously returned ScheduledFuture)
    @@ -372,43 +335,9 @@

    scheduleAtFixedRate

    long initialDelay, long period, java.util.concurrent.TimeUnit unit) -
    Description copied from interface: java.util.concurrent.ScheduledExecutorService
    -
    Submits a periodic action that becomes enabled first after the - given initial delay, and subsequently with the given period; - that is, executions will commence after - initialDelay, then initialDelay + period, then - initialDelay + 2 * period, and so on. - -

    The sequence of task executions continues indefinitely until - one of the following exceptional completions occur: -

      -
    • The task is explicitly cancelled - via the returned future. -
    • The executor terminates, also resulting in task cancellation. -
    • An execution of the task throws an exception. In this case - calling get on the returned future will throw - ExecutionException, holding the exception as its cause. -
    - Subsequent executions are suppressed. Subsequent calls to - isDone() on the returned future will - return true. - -

    If any execution of this task takes longer than its period, then - subsequent executions may start late, but will not concurrently - execute.

    Specified by:
    scheduleAtFixedRate in interface java.util.concurrent.ScheduledExecutorService
    -
    Parameters:
    -
    command - the task to execute
    -
    initialDelay - the time to delay first execution
    -
    period - the period between successive executions
    -
    unit - the time unit of the initialDelay and period parameters
    -
    Returns:
    -
    a ScheduledFuture representing pending completion of - the series of repeated tasks. The future's get() method will never return normally, - and will throw an exception upon task cancellation or - abnormal termination of a task execution.
    Since:
    15.0 (previously returned ScheduledFuture)
    @@ -440,39 +369,9 @@

    scheduleWithFixedDelay

    long initialDelay, long delay, java.util.concurrent.TimeUnit unit) -
    Description copied from interface: java.util.concurrent.ScheduledExecutorService
    -
    Submits a periodic action that becomes enabled first after the - given initial delay, and subsequently with the given delay - between the termination of one execution and the commencement of - the next. - -

    The sequence of task executions continues indefinitely until - one of the following exceptional completions occur: -

      -
    • The task is explicitly cancelled - via the returned future. -
    • The executor terminates, also resulting in task cancellation. -
    • An execution of the task throws an exception. In this case - calling get on the returned future will throw - ExecutionException, holding the exception as its cause. -
    - Subsequent executions are suppressed. Subsequent calls to - isDone() on the returned future will - return true.
    Specified by:
    scheduleWithFixedDelay in interface java.util.concurrent.ScheduledExecutorService
    -
    Parameters:
    -
    command - the task to execute
    -
    initialDelay - the time to delay first execution
    -
    delay - the delay between the termination of one - execution and the commencement of the next
    -
    unit - the time unit of the initialDelay and delay parameters
    -
    Returns:
    -
    a ScheduledFuture representing pending completion of - the series of repeated tasks. The future's get() method will never return normally, - and will throw an exception upon task cancellation or - abnormal termination of a task execution.
    Since:
    15.0 (previously returned ScheduledFuture)
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/RateLimiter.html b/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/RateLimiter.html index 5c3b1be2cd18..53bb4f9e23d5 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/RateLimiter.html +++ b/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/RateLimiter.html @@ -280,9 +280,7 @@

    Method Summary

    java.lang.String toString() - -
    Returns a string representation of the object.
    - +  boolean @@ -687,29 +685,9 @@

    tryAcquire

  • toString

    public java.lang.String toString()
    -
    Description copied from class: java.lang.Object
    -
    Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

    - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

    - 
    - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
    Overrides:
    toString in class java.lang.Object
    -
    Returns:
    -
    a string representation of the object.
    • diff --git a/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/ServiceManager.html b/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/ServiceManager.html index 0daf324c4548..0a9e23f1b4d4 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/ServiceManager.html +++ b/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/ServiceManager.html @@ -359,9 +359,7 @@

    Method Summary

    java.lang.String toString() - -
    Returns a string representation of the object.
    - + 
      @@ -666,29 +664,9 @@

      startupDurations

    • toString

      public java.lang.String toString()
      -
      Description copied from class: java.lang.Object
      -
      Returns a string representation of the object. In general, the - toString method returns a string that - "textually represents" this object. The result should - be a concise but informative representation that is easy for a - person to read. - It is recommended that all subclasses override this method. -

      - The toString method for class Object - returns a string consisting of the name of the class of which the - object is an instance, the at-sign character `@', and - the unsigned hexadecimal representation of the hash code of the - object. In other words, this method returns a string equal to the - value of: -

      - 
      - getClass().getName() + '@' + Integer.toHexString(hashCode())
-
      Overrides:
      toString in class java.lang.Object
      -
      Returns:
      -
      a string representation of the object.
    diff --git a/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/SettableFuture.html b/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/SettableFuture.html index 984b67162a04..aa678614ff44 100644 --- a/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/SettableFuture.html +++ b/releases/snapshot-jre/api/docs/com/google/common/util/concurrent/SettableFuture.html @@ -193,9 +193,6 @@

    Method Summary

    boolean cancel​(boolean mayInterruptIfRunning) - -
    Attempts to cancel execution of this task.
    - static <V extends @Nullable java.lang.Object>
    SettableFuture<V>     @@ -207,34 +204,21 @@

    Method Summary

    V get() - -
    Waits if necessary for the computation to complete, and then - retrieves its result.
    - V get​(long timeout, java.util.concurrent.TimeUnit unit) - -
    Waits if necessary for at most the given time for the computation - to complete, and then retrieves its result, if available.
    - boolean isCancelled() - -
    Returns true if this task was cancelled before it completed - normally.
    - +  boolean isDone() - -
    Returns true if this task completed.
    - +  boolean @@ -415,8 +399,7 @@

    get

    throws java.lang.InterruptedException, java.util.concurrent.ExecutionException
    Description copied from class: AbstractFuture
    -
    Waits if necessary for the computation to complete, and then - retrieves its result. +

    The default AbstractFuture implementation throws InterruptedException if the current thread is interrupted during the call, even if the value is already available.

    @@ -425,13 +408,9 @@

    get

    get in interface java.util.concurrent.Future<V extends @Nullable java.lang.Object>
    Overrides:
    get in class AbstractFuture<V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    the computed result
    Throws:
    -
    java.lang.InterruptedException - if the current thread was interrupted - while waiting
    -
    java.util.concurrent.ExecutionException - if the computation threw an - exception
    +
    java.lang.InterruptedException
    +
    java.util.concurrent.ExecutionException
    @@ -448,8 +427,7 @@

    get

    java.util.concurrent.ExecutionException, java.util.concurrent.TimeoutException
    Description copied from class: AbstractFuture
    -
    Waits if necessary for at most the given time for the computation - to complete, and then retrieves its result, if available. +

    The default AbstractFuture implementation throws InterruptedException if the current thread is interrupted during the call, even if the value is already available.

    @@ -458,17 +436,10 @@

    get

    get in interface java.util.concurrent.Future<V extends @Nullable java.lang.Object>
    Overrides:
    get in class AbstractFuture<V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    timeout - the maximum time to wait
    -
    unit - the time unit of the timeout argument
    -
    Returns:
    -
    the computed result
    Throws:
    -
    java.lang.InterruptedException - if the current thread was interrupted - while waiting
    -
    java.util.concurrent.ExecutionException - if the computation threw an - exception
    -
    java.util.concurrent.TimeoutException - if the wait timed out
    +
    java.lang.InterruptedException
    +
    java.util.concurrent.ExecutionException
    +
    java.util.concurrent.TimeoutException
    @@ -479,19 +450,11 @@

    get

  • isDone

    public final boolean isDone()
    -
    Description copied from interface: java.util.concurrent.Future
    -
    Returns true if this task completed. - - Completion may be due to normal termination, an exception, or - cancellation -- in all of these cases, this method will return - true.
    Specified by:
    isDone in interface java.util.concurrent.Future<V extends @Nullable java.lang.Object>
    Overrides:
    isDone in class AbstractFuture<V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    true if this task completed
    • @@ -502,16 +465,11 @@

    isDone

  • isCancelled

    public final boolean isCancelled()
    -
    Description copied from interface: java.util.concurrent.Future
    -
    Returns true if this task was cancelled before it completed - normally.
    Specified by:
    isCancelled in interface java.util.concurrent.Future<V extends @Nullable java.lang.Object>
    Overrides:
    isCancelled in class AbstractFuture<V extends @Nullable java.lang.Object>
    -
    Returns:
    -
    true if this task was cancelled before it completed
    • @@ -567,18 +525,7 @@

    cancel

    @CanIgnoreReturnValue
 public final boolean cancel​(boolean mayInterruptIfRunning)
    Description copied from class: AbstractFuture
    -
    Attempts to cancel execution of this task. This attempt will - fail if the task has already completed, has already been cancelled, - or could not be cancelled for some other reason. If successful, - and this task has not started when cancel is called, - this task should never run. If the task has already started, - then the mayInterruptIfRunning parameter determines - whether the thread executing this task should be interrupted in - an attempt to stop the task. - -

    After this method returns, subsequent calls to Future.isDone() will - always return true. Subsequent calls to Future.isCancelled() - will always return true if this method returned true. +

    If a cancellation attempt succeeds on a Future that had previously been set asynchronously, then the cancellation will also be propagated to the delegate Future that was supplied in the setFuture call. @@ -595,14 +542,6 @@

    cancel

    cancel in interface java.util.concurrent.Future<V extends @Nullable java.lang.Object>
    Overrides:
    cancel in class AbstractFuture<V extends @Nullable java.lang.Object>
    -
    Parameters:
    -
    mayInterruptIfRunning - true if the thread executing this - task should be interrupted; otherwise, in-progress tasks are allowed - to complete
    -
    Returns:
    -
    false if the task could not be cancelled, - typically because it has already completed normally; - true otherwise
    diff --git a/releases/snapshot-jre/api/docs/index-all.html b/releases/snapshot-jre/api/docs/index-all.html index a1083e2a787f..7a520a540458 100644 --- a/releases/snapshot-jre/api/docs/index-all.html +++ b/releases/snapshot-jre/api/docs/index-all.html @@ -2672,9 +2672,6 @@

    C

    is to be disregarded.
    cancel(boolean) - Method in class com.google.common.util.concurrent.AbstractFuture
    -
    -
    Attempts to cancel execution of this task.
    -
    cancel(boolean) - Method in class com.google.common.util.concurrent.ClosingFuture
    Attempts to cancel execution of this step.
    @@ -6457,9 +6454,6 @@

    E

    Compares the specified object with this multimap for equality.
    equals(Object) - Method in interface com.google.common.collect.Multiset.Entry
    -
    -
    Indicates whether some other object is "equal to" this one.
    -
    equals(Object) - Method in interface com.google.common.collect.Multiset
    Compares the specified object with this multiset for equality.
    @@ -6528,13 +6522,7 @@

    E

    representation to this hash code.
    equals(Object) - Method in class com.google.common.math.PairedStats
    -
    -
    Indicates whether some other object is "equal to" this one.
    -
    equals(Object) - Method in class com.google.common.math.Stats
    -
    -
    Indicates whether some other object is "equal to" this one.
    -
    equals(Object) - Method in class com.google.common.net.HostAndPort
     
    equals(Object) - Method in class com.google.common.net.HostSpecifier
    @@ -7425,11 +7413,6 @@

    F

    forEach(Consumer<? super E>) - Method in class com.google.common.collect.ImmutableList
     
    forEach(Consumer<? super E>) - Method in interface com.google.common.collect.Multiset
    -
    -
    Performs the given action for each element of the Iterable - until all elements have been processed or the action throws an - exception.
    -
    forEach(DoubleConsumer) - Method in class com.google.common.primitives.ImmutableDoubleArray
    Invokes consumer for each value contained in this array, in order.
    @@ -8155,10 +8138,6 @@

    G

    Retrieves an instance of the appropriate type.
    get() - Method in class com.google.common.util.concurrent.AbstractFuture
    -
    -
    Waits if necessary for the computation to complete, and then - retrieves its result.
    -
    get() - Method in class com.google.common.util.concurrent.AtomicDouble
    Gets the current value.
    @@ -8193,10 +8172,6 @@

    G

    Gets the current value at position i.
    get(long, TimeUnit) - Method in class com.google.common.util.concurrent.AbstractFuture
    -
    -
    Waits if necessary for at most the given time for the computation - to complete, and then retrieves its result, if available.
    -
    get(long, TimeUnit) - Method in class com.google.common.util.concurrent.ForwardingFuture
     
    get(long, TimeUnit) - Method in class com.google.common.util.concurrent.ListenableFutureTask
    @@ -9103,9 +9078,6 @@

    H

    Returns the hash code for this multimap.
    hashCode() - Method in interface com.google.common.collect.Multiset.Entry
    -
    -
    Returns a hash code value for the object.
    -
    hashCode() - Method in interface com.google.common.collect.Multiset
    Returns the hash code for this multiset.
    @@ -9173,13 +9145,7 @@

    H

    hashCode() - Method in class com.google.common.math.PairedStats
    -
    -
    Returns a hash code value for the object.
    -
    hashCode() - Method in class com.google.common.math.Stats
    -
    -
    Returns a hash code value for the object.
    -
    hashCode() - Method in class com.google.common.net.HostAndPort
     
    hashCode() - Method in class com.google.common.net.HostSpecifier
    @@ -9428,10 +9394,6 @@

    H

    headSet(E) - Method in class com.google.common.collect.ForwardingSortedSet
     
    headSet(E) - Method in class com.google.common.collect.ImmutableSortedSet
    -
    -
    Returns a view of the portion of this set whose elements are - strictly less than toElement.
    -
    headSet(E, boolean) - Method in class com.google.common.collect.ForwardingNavigableSet
     
    headSet(E, boolean) - Method in class com.google.common.collect.ImmutableSortedSet
    @@ -10323,8 +10285,17 @@

    I

    invoke(Object, Method, Object[]) - Method in class com.google.common.reflect.AbstractInvocationHandler
    -
    Processes a method invocation on a proxy instance and returns - the result.
    +
    + + + proxy.hashCode() delegates to AbstractInvocationHandler.hashCode() + proxy.toString() delegates to AbstractInvocationHandler.toString() + proxy.equals(argument) returns true if: + + proxy and argument are of the same type + and AbstractInvocationHandler.equals(java.lang.Object) returns true for the InvocationHandler of argument + + other method calls are dispatched to AbstractInvocationHandler.handleInvocation(java.lang.Object, java.lang.reflect.Method, java.lang.Object[]).
    invoke(T, Object...) - Method in class com.google.common.reflect.Invokable
    @@ -10335,18 +10306,9 @@

    I

    invokeAll(Collection<? extends Callable<T>>) - Method in class com.google.common.util.concurrent.ForwardingExecutorService
     
    invokeAll(Collection<? extends Callable<T>>) - Method in interface com.google.common.util.concurrent.ListeningExecutorService
    -
    -
    Executes the given tasks, returning a list of Futures holding - their status and results when all complete.
    -
    invokeAll(Collection<? extends Callable<T>>, long, TimeUnit) - Method in class com.google.common.util.concurrent.ForwardingExecutorService
     
    invokeAll(Collection<? extends Callable<T>>, long, TimeUnit) - Method in interface com.google.common.util.concurrent.ListeningExecutorService
    -
    -
    Executes the given tasks, returning a list of Futures holding - their status and results - when all complete or the timeout expires, whichever happens first.
    -
    invokeAny(Collection<? extends Callable<T>>) - Method in class com.google.common.util.concurrent.ForwardingExecutorService
     
    invokeAny(Collection<? extends Callable<T>>, long, TimeUnit) - Method in class com.google.common.util.concurrent.ForwardingExecutorService
    @@ -10826,17 +10788,11 @@

    I

    order.
    iterator() - Method in interface com.google.common.collect.Multiset
    -
    -
    Returns an iterator over the elements in this collection.
    -
    iterator() - Method in class com.google.common.collect.Sets.SetView
    Scope the return type to UnmodifiableIterator to ensure this is an unmodifiable view.
    iterator() - Method in interface com.google.common.collect.SortedMultiset
    -
    -
    Returns an iterator over the elements in this collection.
    -
    iterator() - Method in class com.google.common.collect.TreeMultiset
     
    iterator() - Method in class com.google.common.graph.EndpointPair
    @@ -13009,9 +12965,6 @@

    N

    next() - Method in class com.google.common.collect.ForwardingIterator
     
    next() - Method in interface com.google.common.collect.PeekingIterator
    -
    -
    Returns the next element in the iteration.
    -
    next(C) - Method in class com.google.common.collect.DiscreteDomain
    Returns the unique least value of type C that is greater than value, or @@ -14753,10 +14706,6 @@

    P

    put(K, V) - Method in class com.google.common.cache.ForwardingCache
     
    put(K, V) - Method in interface com.google.common.collect.BiMap
    -
    -
    Associates the specified value with the specified key in this map - (optional operation).
    -
    put(K, V) - Method in class com.google.common.collect.EnumHashBiMap
     
    put(K, V) - Method in class com.google.common.collect.ForwardingMap
    @@ -14949,10 +14898,6 @@

    P

    putAll(Map<? extends K, ? extends V>) - Method in class com.google.common.cache.ForwardingCache
     
    putAll(Map<? extends K, ? extends V>) - Method in interface com.google.common.collect.BiMap
    -
    -
    Copies all of the mappings from the specified map to this map - (optional operation).
    -
    putAll(Map<? extends K, ? extends V>) - Method in class com.google.common.collect.ForwardingMap
     
    putAll(Map<? extends K, ? extends V>) - Method in class com.google.common.collect.ImmutableBiMap.Builder
    @@ -15638,10 +15583,6 @@

    R

    remove() - Method in class com.google.common.collect.ForwardingQueue
     
    remove() - Method in interface com.google.common.collect.PeekingIterator
    -
    -
    Removes from the underlying collection the last element returned - by this iterator (optional operation).
    -
    remove() - Method in class com.google.common.collect.UnmodifiableIterator
    Deprecated. @@ -15851,10 +15792,6 @@

    R

    removeAll(Collection<?>) - Method in interface com.google.common.collect.Multiset
    -
    -
    Removes all of this collection's elements that are also contained in the - specified collection (optional operation).
    -
    removeAll(Collection<?>) - Method in class com.google.common.collect.Sets.SetView
    Deprecated. @@ -16119,10 +16056,6 @@

    R

    retainAll(Collection<?>) - Method in interface com.google.common.collect.Multiset
    -
    -
    Retains only the elements in this collection that are contained in the - specified collection (optional operation).
    -
    retainAll(Collection<?>) - Method in class com.google.common.collect.Sets.SetView
    Deprecated. @@ -17186,7 +17119,7 @@

    S

     
    size() - Method in class com.google.common.collect.ConcurrentHashMultiset
    -
    Returns the number of elements in this collection.
    +
    Returns the total number of all occurrences of all elements in this multiset.
    size() - Method in class com.google.common.collect.EnumMultiset
     
    @@ -18445,11 +18378,6 @@

    S

    subSet(E, E) - Method in class com.google.common.collect.ForwardingSortedSet
     
    subSet(E, E) - Method in class com.google.common.collect.ImmutableSortedSet
    -
    -
    Returns a view of the portion of this set whose elements range - from fromElement, inclusive, to toElement, - exclusive.
    -
    subSet(NavigableSet<K>, Range<K>) - Static method in class com.google.common.collect.Sets
    Returns a view of the portion of set whose elements are contained by range.
    @@ -18647,10 +18575,6 @@

    T

    tailSet(E) - Method in class com.google.common.collect.ForwardingSortedSet
     
    tailSet(E) - Method in class com.google.common.collect.ImmutableSortedSet
    -
    -
    Returns a view of the portion of this set whose elements are - greater than or equal to fromElement.
    -
    tailSet(E, boolean) - Method in class com.google.common.collect.ForwardingNavigableSet
     
    tailSet(E, boolean) - Method in class com.google.common.collect.ImmutableSortedSet
    @@ -19222,9 +19146,6 @@

    T

    Returns the canonical string representation of this entry, defined as follows.
    toString() - Method in interface com.google.common.collect.Multiset
    -
    -
    Returns a string representation of the object.
    -
    toString() - Method in class com.google.common.collect.Range
    Returns a string representation of this range, such as "[3..5)" (other examples are @@ -20419,9 +20340,6 @@

    V

    Returns an unmodifiable collection of all values, which may contain duplicates.
    values() - Method in interface com.google.common.collect.BiMap
    -
    -
    Returns a Collection view of the values contained in this map.
    -
    values() - Static method in enum com.google.common.collect.BoundType
    Returns an array containing the constants of this enum type, in diff --git a/releases/snapshot-jre/api/docs/member-search-index.zip b/releases/snapshot-jre/api/docs/member-search-index.zip index c9936be037e4bc478ecc94a76bc87ac6e7a927f2..2d61d1bfabaf150a717d2aa8f1dcab7f9d165add 100644 GIT binary patch delta 32 mcmbQ&$vm%p!9?CC%pmHE9{_A|2~Ge2 delta 28 hcmX@abcl&Jz?+#xgn@&DgW>JA{E56zm_gJRKLBw+3E%(# diff --git a/releases/snapshot-jre/api/docs/type-search-index.zip b/releases/snapshot-jre/api/docs/type-search-index.zip index 07553a1aa2c6e341f6bc29a72a12f64426a453b4..cc487cede432e62f430bc2654bd1bd27ccfe49c2 100644 GIT binary patch delta 30 kcmbO(HC>7~z?+#xgn@&DgW+>p!A9OaJj_6P@);g)0CuAZ4*&oF delta 30 kcmbO(HC>7~z?+#xgn@&DgW>JA{EfVOc$k6o