@Beta @GwtIncompatible public interface Interner<E>
String.intern()
for other immutable types. Common
implementations are available from the Interners
class.Modifier and Type | Method and Description |
---|---|
E |
intern(E sample)
Chooses and returns the representative instance for any of a collection of instances that are
equal to each other.
|
@CanIgnoreReturnValue E intern(E sample)
intern(a).equals(a)
always holds,
and intern(a) == intern(b)
if and only if a.equals(b)
. Note that intern(a)
is permitted to return one instance now and a different instance later if the
original interned instance was garbage-collected.
Warning: do not use with mutable objects.
NullPointerException
- if sample
is nullCopyright © 2010–2019. All rights reserved.