com.oracle.graal.compiler.common.util

Class Util

java.lang.Object

com.oracle.graal.compiler.common.util.Util

public class Util
extends Object

The Util class contains a motley collection of utility methods used throughout the compiler.

Field Summary

Fields

Modifier and Type	Field and Description
static int	PRINTING_LINE_WIDTH
static char	SECTION_CHARACTER
static char	SEPERATOR_CHARACTER
static char	SUB_SECTION_CHARACTER

Constructor Summary

Constructors

Constructor and Description
Util()

Method Summary

Modifier and Type	Method and Description
static <T> void	atPutGrow(List<T> list, int pos, T x, T filler) Sets the element at a given position of a list and ensures that this position exists.
static void	breakpoint()
static Integer[]	createSortedPermutation(int size, Comparator<Integer> comparator) Creates an array of integers of length "size", in which each number from 0 to (size - 1) occurs exactly once.
static void	guarantee(boolean b, String string)
static int	hash1(int hash, Object x) Utility method to combine a base hash with the identity hash of one or more objects.
static int	hash2(int hash, Object x, Object y) Utility method to combine a base hash with the identity hash of one or more objects.
static int	hash3(int hash, Object x, Object y, Object z) Utility method to combine a base hash with the identity hash of one or more objects.
static int	hash4(int hash, Object x, Object y, Object z, Object w) Utility method to combine a base hash with the identity hash of one or more objects.
static boolean	is32bit(long x)
static boolean	isByte(int x) Determines if a given int value is the range of signed byte values.
static boolean	isByte(long l) Determines if a given long value is the range of signed byte values.
static boolean	isInt(long l) Determines if a given long value is the range of signed int values.
static boolean	isShiftCount(int x)
static boolean	isShort(int x) Determines if a given int value is the range of signed short values.
static boolean	isUByte(int x) Determines if a given int value is the range of unsigned byte values.
static boolean	isUByte(long x) Determines if a given long value is the range of unsigned byte values.
static boolean	isUInt(long x) Determines if a given long value is the range of unsigned int values.
static void	printBytes(long address, byte[] array, int bytesPerLine) Prints entries in a byte array as space separated hex values to TTY.
static void	printBytes(long address, byte[] array, int offset, int length, int bytesPerLine) Prints entries in a byte array as space separated hex values to TTY.
static void	printSection(String name, char sectionCharacter)
static <T> boolean	replaceInList(T a, T b, List<T> list)
static int	roundUp(int number, int mod)
static int	safeToInt(long l)
static short	safeToShort(int v)
static <T> T	uncheckedCast(Class<T> type, Object object) Statically cast an object to an arbitrary Object type.
static <T> T	uncheckedCast(Object object) Statically cast an object to an arbitrary Object type.
static void	warning(String string)

Methods inherited from class java.lang.Object

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

Field Detail

PRINTING_LINE_WIDTH

public static final int PRINTING_LINE_WIDTH

See Also:

Constant Field Values

SECTION_CHARACTER

public static final char SECTION_CHARACTER

See Also:

Constant Field Values

SUB_SECTION_CHARACTER

public static final char SUB_SECTION_CHARACTER

See Also:

Constant Field Values

SEPERATOR_CHARACTER

public static final char SEPERATOR_CHARACTER

See Also:

Constant Field Values

Constructor Detail

Util

public Util()

Method Detail

replaceInList

public static <T> boolean replaceInList(T a,
                                        T b,
                                        List<T> list)

uncheckedCast

public static <T> T uncheckedCast(Class<T> type,
                                  Object object)

Statically cast an object to an arbitrary Object type. Dynamically checked.

uncheckedCast

public static <T> T uncheckedCast(Object object)

Statically cast an object to an arbitrary Object type. Dynamically checked.

hash1

public static int hash1(int hash,
                        Object x)

Utility method to combine a base hash with the identity hash of one or more objects.

Parameters:

hash - the base hash

x - the object to add to the hash

Returns:

the combined hash

hash2

public static int hash2(int hash,
                        Object x,
                        Object y)

Utility method to combine a base hash with the identity hash of one or more objects.

Parameters:

hash - the base hash

x - the first object to add to the hash

y - the second object to add to the hash

Returns:

the combined hash

hash3

public static int hash3(int hash,
                        Object x,
                        Object y,
                        Object z)

Utility method to combine a base hash with the identity hash of one or more objects.

Parameters:

hash - the base hash

x - the first object to add to the hash

y - the second object to add to the hash

z - the third object to add to the hash

Returns:

the combined hash

hash4

public static int hash4(int hash,
                        Object x,
                        Object y,
                        Object z,
                        Object w)

Utility method to combine a base hash with the identity hash of one or more objects.

Parameters:

hash - the base hash

x - the first object to add to the hash

y - the second object to add to the hash

z - the third object to add to the hash

w - the fourth object to add to the hash

Returns:

the combined hash

atPutGrow

public static <T> void atPutGrow(List<T> list,
                                 int pos,
                                 T x,
                                 T filler)

Sets the element at a given position of a list and ensures that this position exists. If the list is current shorter than the position, intermediate positions are filled with a given value.

Parameters:

list - the list to put the element into

pos - the position at which to insert the element

x - the element that should be inserted

filler - the filler element that is used for the intermediate positions in case the list is shorter than pos

breakpoint

public static void breakpoint()

guarantee

public static void guarantee(boolean b,
                             String string)

warning

public static void warning(String string)

safeToInt

public static int safeToInt(long l)

roundUp

public static int roundUp(int number,
                          int mod)

printSection

public static void printSection(String name,
                                char sectionCharacter)

printBytes

public static void printBytes(long address,
                              byte[] array,
                              int bytesPerLine)

Prints entries in a byte array as space separated hex values to TTY.

Parameters:

address - an address at which the bytes are located. This is used to print an address prefix per line of output.

array - the array containing all the bytes to print

bytesPerLine - the number of values to print per line of output

printBytes

public static void printBytes(long address,
                              byte[] array,
                              int offset,
                              int length,
                              int bytesPerLine)

Prints entries in a byte array as space separated hex values to TTY.

Parameters:

address - an address at which the bytes are located. This is used to print an address prefix per line of output.

array - the array containing the bytes to print

offset - the offset in array of the values to print

length - the number of values from array print

bytesPerLine - the number of values to print per line of output

isShiftCount

public static boolean isShiftCount(int x)

isUByte

public static boolean isUByte(int x)

Determines if a given int value is the range of unsigned byte values.

isByte

public static boolean isByte(int x)

Determines if a given int value is the range of signed byte values.

isUByte

public static boolean isUByte(long x)

Determines if a given long value is the range of unsigned byte values.

isByte

public static boolean isByte(long l)

Determines if a given long value is the range of signed byte values.

isUInt

public static boolean isUInt(long x)

Determines if a given long value is the range of unsigned int values.

isInt

public static boolean isInt(long l)

Determines if a given long value is the range of signed int values.

isShort

public static boolean isShort(int x)

Determines if a given int value is the range of signed short values.

is32bit

public static boolean is32bit(long x)

safeToShort

public static short safeToShort(int v)

createSortedPermutation

public static Integer[] createSortedPermutation(int size,
                                                Comparator<Integer> comparator)

Creates an array of integers of length "size", in which each number from 0 to (size - 1) occurs exactly once. The integers are sorted using the given comparator. This can be used to create a sorting for arrays that cannot be modified directly.

Parameters:

size - The size of the range to be sorted.

comparator - A comparator that is used to compare indexes.

Returns:

An array of integers that contains each number from 0 to (size - 1) exactly once, sorted using the comparator.