plume

Class Intern

java.lang.Object

plume.Intern

Deprecated.

use org.plumelib.util.Intern

@Deprecated
public final class Intern
extends java.lang.Object

Utilities for interning objects. Interning is also known as canonicalization or hash-consing: it returns a single representative object that Object.equals(java.lang.Object) the object, and the client discards the argument and uses the result instead. Since only one object exists for every set of equal objects, space usage is reduced. Time may also be reduced, since it is possible to use == instead of .equals() for comparisons.

Java builds in interning for Strings, but not for other objects. The methods in this class extend interning to all Java objects.

Method Summary

Modifier and Type	Method and Description
static java.util.Iterator<double[]>	doubleArrays() Deprecated.
static java.util.Iterator<java.lang.Double>	doubles() Deprecated.
static java.util.Iterator<int[]>	intArrays() Deprecated.
static java.util.Iterator<java.lang.Integer>	integers() Deprecated.
static double	intern(double d) Deprecated. Interns a double A no-op.
static java.lang.Double	intern(java.lang.Double a) Deprecated. Intern (canonicalize) a Double.
static double[]	intern(double[] a) Deprecated. Intern (canonicalize) a double[].
static int[]	intern(int[] a) Deprecated. Intern (canonicalize) an int[].
static java.lang.Integer	intern(java.lang.Integer a) Deprecated. Intern (canonicalize) an Integer.
static long	intern(long l) Deprecated. Interns a long.
static java.lang.Long	intern(java.lang.Long a) Deprecated. Intern (canonicalize) a Long.
static long[]	intern(long[] a) Deprecated. Intern (canonicalize) a long[].
static java.lang.Object	intern(java.lang.Object a) Deprecated. Convenince method to intern an Object when we don't know its runtime type.
static java.lang.Object[]	intern(java.lang.Object[] a) Deprecated. Intern (canonicalize) an Object[].
static java.lang.String	intern(java.lang.String a) Deprecated. Interns a String.
static java.lang.String[]	intern(java.lang.String[] a) Deprecated. Intern (canonicalize) an String[].
static java.lang.Double	internedDouble(double d) Deprecated. Returns an interned Double with value i.
static java.lang.Double	internedDouble(java.lang.String s) Deprecated. Returns an interned Double with value parsed from the string.
static java.lang.Integer	internedInteger(int i) Deprecated. Returns an interned Integer with value i.
static java.lang.Integer	internedInteger(java.lang.String s) Deprecated. Returns an interned Integer with value parsed from the string.
static java.lang.Long	internedLong(long i) Deprecated. Returns an interned Long with value i.
static java.lang.Long	internedLong(java.lang.String s) Deprecated. Returns an interned Long with value parsed from the string.
static java.lang.String[]	internStrings(java.lang.String[] a) Deprecated. Replace each element of the array by its interned version.
static double[]	internSubsequence(double[] seq, int start, int end) Deprecated.
static int[]	internSubsequence(int[] seq, int start, int end) Deprecated. Return an interned subsequence of seq from start (inclusive) to end (exclusive).
static long[]	internSubsequence(long[] seq, int start, int end) Deprecated.
static java.lang.Object[]	internSubsequence(java.lang.Object[] seq, int start, int end) Deprecated.
static java.lang.String[]	internSubsequence(java.lang.String[] seq, int start, int end) Deprecated.
static boolean	isInterned(java.lang.Object value) Deprecated. Return true if the argument is interned (is canonical among all objects equal to itself).
static java.util.Iterator<long[]>	longArrays() Deprecated.
static java.util.Iterator<java.lang.Long>	longs() Deprecated.
static int	numDoubleArrays() Deprecated.
static int	numDoubles() Deprecated.
static int	numIntArrays() Deprecated.
static int	numIntegers() Deprecated.
static int	numLongArrays() Deprecated.
static int	numLongs() Deprecated.
static int	numObjectArrays() Deprecated.
static int	numStringArrays() Deprecated.
static java.util.Iterator<java.lang.Object[]>	objectArrays() Deprecated.
static java.util.Iterator<java.lang.String[]>	stringArrays() Deprecated.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

internStrings

public static java.lang.String[] internStrings(java.lang.String[] a)

Deprecated.

Replace each element of the array by its interned version. Side-effects the array, but also returns it.

Parameters:

a - the array whose elements to intern in place

Returns:

an interned version of a

See Also:

String.intern()

isInterned

public static boolean isInterned(java.lang.Object value)

Deprecated.

Return true if the argument is interned (is canonical among all objects equal to itself).

Parameters:

value - the value to test for interning

Returns:

true iff value is interned

numIntegers

public static int numIntegers()

Deprecated.

numLongs

public static int numLongs()

Deprecated.

numIntArrays

public static int numIntArrays()

Deprecated.

numLongArrays

public static int numLongArrays()

Deprecated.

numDoubles

public static int numDoubles()

Deprecated.

numDoubleArrays

public static int numDoubleArrays()

Deprecated.

numStringArrays

public static int numStringArrays()

Deprecated.

numObjectArrays

public static int numObjectArrays()

Deprecated.

integers

public static java.util.Iterator<java.lang.Integer> integers()

Deprecated.

longs

public static java.util.Iterator<java.lang.Long> longs()

Deprecated.

intArrays

public static java.util.Iterator<int[]> intArrays()

Deprecated.

longArrays

public static java.util.Iterator<long[]> longArrays()

Deprecated.

doubles

public static java.util.Iterator<java.lang.Double> doubles()

Deprecated.

doubleArrays

public static java.util.Iterator<double[]> doubleArrays()

Deprecated.

stringArrays

public static java.util.Iterator<java.lang.String[]> stringArrays()

Deprecated.

objectArrays

public static java.util.Iterator<java.lang.Object[]> objectArrays()

Deprecated.

intern

public static java.lang.String intern(java.lang.String a)

Deprecated.

Interns a String. Delegates to the builtin String.intern() method, but handles null.

Parameters:

a - the string to intern; may be null

Returns:

an interned version of the argument, or null if the argument was null

intern

public static long intern(long l)

Deprecated.

Interns a long. A no-op. Provided for completeness.

Parameters:

l - the long to intern

Returns:

an interned version of the argument

intern

public static double intern(double d)

Deprecated.

Interns a double A no-op. Provided for completeness.

Parameters:

d - the double to intern

Returns:

an interned version of the argument

intern

public static java.lang.Integer intern(java.lang.Integer a)

Deprecated.

Intern (canonicalize) an Integer. Return a canonical representation for the Integer.

Parameters:

a - an Integer to canonicalize

Returns:

a canonical representation for the Integer

internedInteger

public static java.lang.Integer internedInteger(int i)

Deprecated.

Returns an interned Integer with value i.

Parameters:

i - the value to intern

Returns:

an interned Integer with value i

internedInteger

public static java.lang.Integer internedInteger(java.lang.String s)

Deprecated.

Returns an interned Integer with value parsed from the string.

Parameters:

s - the string to parse

Returns:

an interned Integer parsed from s

intern

public static java.lang.Long intern(java.lang.Long a)

Deprecated.

Intern (canonicalize) a Long. Return a canonical representation for the Long.

Parameters:

a - the value to intern

Returns:

a canonical representation for the Long

internedLong

public static java.lang.Long internedLong(long i)

Deprecated.

Returns an interned Long with value i.

Parameters:

i - the value to intern

Returns:

an interned Integer with value i

internedLong

public static java.lang.Long internedLong(java.lang.String s)

Deprecated.

Returns an interned Long with value parsed from the string.

Parameters:

s - the string to parse

Returns:

an interned Long parsed from s

intern

public static int[] intern(int[] a)

Deprecated.

Intern (canonicalize) an int[]. Return a canonical representation for the int[] array. Arrays are compared according to their elements.

Parameters:

a - the array to canonicalize

Returns:

a canonical representation for the int[] array

intern

public static long[] intern(long[] a)

Deprecated.

Intern (canonicalize) a long[]. Return a canonical representation for the long[] array. Arrays are compared according to their elements.

Parameters:

a - the array to canonicalize

Returns:

a canonical representation for the long[] array

intern

public static java.lang.Double intern(java.lang.Double a)

Deprecated.

Intern (canonicalize) a Double. Return a canonical representation for the Double.

Parameters:

a - the Double to canonicalize

Returns:

a canonical representation for the Double

internedDouble

public static java.lang.Double internedDouble(double d)

Deprecated.

Returns an interned Double with value i.

Parameters:

d - the value to intern

Returns:

an interned Double with value d

internedDouble

public static java.lang.Double internedDouble(java.lang.String s)

Deprecated.

Returns an interned Double with value parsed from the string.

Parameters:

s - the string to parse

Returns:

an interned Double parsed from s

intern

public static double[] intern(double[] a)

Deprecated.

Intern (canonicalize) a double[]. Return a canonical representation for the double[] array. Arrays are compared according to their elements.

Parameters:

a - the array to canonicalize

Returns:

a canonical representation for the double[] array

intern

public static java.lang.String[] intern(java.lang.String[] a)

Deprecated.

Intern (canonicalize) an String[]. Return a canonical representation for the String[] array. Arrays are compared according to their elements' equals() methods.

Parameters:

a - the array to canonicalize. Its elements should already be interned.

Returns:

a canonical representation for the String[] array

intern

public static java.lang.Object[] intern(java.lang.Object[] a)

Deprecated.

Intern (canonicalize) an Object[]. Return a canonical representation for the Object[] array. Arrays are compared according to their elements. The elements should themselves already be interned; they are compared using their equals() methods.

Parameters:

a - the array to canonicalize

Returns:

a canonical representation for the Object[] array

intern

public static java.lang.Object intern(java.lang.Object a)

Deprecated.

Convenince method to intern an Object when we don't know its runtime type. Its runtime type must be one of the types for which we have an intern() method, else an exception is thrown. If the argument is an array, its elements should themselves be interned.

Parameters:

a - an Object to canonicalize

Returns:

a canonical version of a

internSubsequence

public static int[] internSubsequence(int[] seq,
                                      int start,
                                      int end)

Deprecated.

Return an interned subsequence of seq from start (inclusive) to end (exclusive). The argument seq should already be interned.

The result is the same as computing the subsequence and then interning it, but this method is more efficient: if the subsequence is already interned, it avoids computing the subsequence.

For example, since derived variables in Daikon compute the subsequence many times, this shortcut saves quite a bit of computation. It saves even more when there may be many derived variables that are non-canonical, since they are guaranteed to be ==.

Parameters:

seq - the interned sequence whose subsequence should be computed and interned

start - the index of the start of the subsequence to compute and intern

end - the index of the end of the subsequence to compute and intern

Returns:

a subsequence of seq from start to end that is interned

internSubsequence

public static long[] internSubsequence(long[] seq,
                                       int start,
                                       int end)

Deprecated.

Parameters:

seq - the interned sequence whose subsequence should be computed and interned

start - the index of the start of the subsequence to compute and intern

end - the index of the end of the subsequence to compute and intern

Returns:

a subsequence of seq from start to end that is interned

See Also:

internSubsequence(int[], int, int)

internSubsequence

public static double[] internSubsequence(double[] seq,
                                         int start,
                                         int end)

Deprecated.

Parameters:

seq - the interned sequence whose subsequence should be computed and interned

start - the index of the start of the subsequence to compute and intern

end - the index of the end of the subsequence to compute and intern

Returns:

a subsequence of seq from start to end that is interned

See Also:

internSubsequence(int[], int, int)

internSubsequence

public static java.lang.Object[] internSubsequence(java.lang.Object[] seq,
                                                   int start,
                                                   int end)

Deprecated.

Parameters:

seq - the interned sequence whose subsequence should be computed and interned

start - the index of the start of the subsequence to compute and intern

end - the index of the end of the subsequence to compute and intern

Returns:

a subsequence of seq from start to end that is interned

See Also:

internSubsequence(int[], int, int)

internSubsequence

public static java.lang.String[] internSubsequence(java.lang.String[] seq,
                                                   int start,
                                                   int end)

Deprecated.

Parameters:

seq - the interned sequence whose subsequence should be computed and interned

start - the index of the start of the subsequence to compute and intern

end - the index of the end of the subsequence to compute and intern

Returns:

a subsequence of seq from start to end that is interned

See Also:

internSubsequence(int[], int, int)