jdk.internal.jvmci.code

Class CodeUtil

java.lang.Object

jdk.internal.jvmci.code.CodeUtil

public class CodeUtil
extends Object

Miscellaneous collection of utility methods used by jdk.internal.jvmci.code and its clients.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	CodeUtil.DefaultRefMapFormatter Formats a location present in a register or frame reference map.
static class	CodeUtil.DefaultRegFormatter Formats a location in a register reference map.
static class	CodeUtil.NumberedRefMapFormatter
static interface	CodeUtil.RefMapFormatter

Field Summary

Fields

Modifier and Type	Field and Description
static int	K
static int	M
static String	NEW_LINE

Constructor Summary

Constructors

Constructor and Description
CodeUtil()

Method Summary

Modifier and Type	Method and Description
static StringBuilder	append(StringBuilder sb, BytecodeFrame frame) Appends a formatted frame to a StringBuilder.
static StringBuilder	append(StringBuilder sb, BytecodePosition pos) Appends a formatted code position to a StringBuilder.
static StringBuilder	append(StringBuilder sb, DebugInfo info, CodeUtil.RefMapFormatter formatterArg) Appends a formatted debug info to a StringBuilder.
static long	convert(long value, int inputBits, boolean unsigned) Convert an integer to long.
static CallingConvention	getCallingConvention(CodeCacheProvider codeCache, CallingConvention.Type type, ResolvedJavaMethod method, boolean stackOnly) Create a calling convention from a ResolvedJavaMethod.
static boolean	isEven(int n)
static boolean	isOdd(int n)
static boolean	isPowerOf2(int val) Checks whether the specified integer is a power of two.
static boolean	isPowerOf2(long val) Checks whether the specified long is a power of two.
static int	log2(int val) Computes the log (base 2) of the specified integer, rounding down.
static int	log2(long val) Computes the log (base 2) of the specified long, rounding down.
static long	mask(int bits) Get a bitmask with the low bits bit set and the high 64 - bits bit clear.
static long	maxValue(int bits) Get the maximum value representable in a bits bit signed integer.
static long	minValue(int bits) Get the minimum value representable in a bits bit signed integer.
static long	narrow(long value, int resultBits) Narrow an integer value to a given bit width, and return the result as a signed long.
static long	signExtend(long value, int inputBits) Sign extend an integer.
static String	tabulate(Object[] cells, int cols, int lpad, int rpad) Formats a given table as a string.
static String	tabulateValues(BytecodeFrame frame) Formats the values in a frame as a tabulated string.
static long	zeroExtend(long value, int inputBits) Zero extend an integer.

Methods inherited from class java.lang.Object

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

Field Detail

NEW_LINE

public static final String NEW_LINE

K

public static final int K

See Also:

Constant Field Values

M

public static final int M

See Also:

Constant Field Values

Constructor Detail

CodeUtil

public CodeUtil()

Method Detail

isOdd

public static boolean isOdd(int n)

isEven

public static boolean isEven(int n)

isPowerOf2

public static boolean isPowerOf2(int val)

Checks whether the specified integer is a power of two.

Parameters:

val - the value to check

Returns:

true if the value is a power of two; false otherwise

isPowerOf2

public static boolean isPowerOf2(long val)

Checks whether the specified long is a power of two.

Parameters:

val - the value to check

Returns:

true if the value is a power of two; false otherwise

log2

public static int log2(int val)

Computes the log (base 2) of the specified integer, rounding down. (E.g log2(8) = 3, log2(21) = 4 )

Parameters:

val - the value

Returns:

the log base 2 of the value

log2

public static int log2(long val)

Computes the log (base 2) of the specified long, rounding down. (E.g log2(8) = 3, log2(21) = 4)

Parameters:

val - the value

Returns:

the log base 2 of the value

narrow

public static long narrow(long value,
                          int resultBits)

Narrow an integer value to a given bit width, and return the result as a signed long.

Parameters:

value - the value

resultBits - the result bit width

Returns:

value interpreted as resultBits bit number, encoded as signed long

signExtend

public static long signExtend(long value,
                              int inputBits)

Sign extend an integer.

Parameters:

value - the input value

inputBits - the bit width of the input value

Returns:

a signed long with the same value as the signed inputBits-bit number value

zeroExtend

public static long zeroExtend(long value,
                              int inputBits)

Zero extend an integer.

Parameters:

value - the input value

inputBits - the bit width of the input value

Returns:

an unsigned long with the same value as the unsigned inputBits-bit number value

convert

public static long convert(long value,
                           int inputBits,
                           boolean unsigned)

Convert an integer to long.

Parameters:

value - the input value

inputBits - the bit width of the input value

unsigned - whether the values should be interpreted as signed or unsigned

Returns:

a long with the same value as the inputBits-bit number value

mask

public static long mask(int bits)

Get a bitmask with the low bits bit set and the high 64 - bits bit clear.

minValue

public static long minValue(int bits)

Get the minimum value representable in a bits bit signed integer.

maxValue

public static long maxValue(int bits)

Get the maximum value representable in a bits bit signed integer.

tabulateValues

public static String tabulateValues(BytecodeFrame frame)

Formats the values in a frame as a tabulated string.

Parameters:

frame -

Returns:

the values in frame as a tabulated string

tabulate

public static String tabulate(Object[] cells,
                              int cols,
                              int lpad,
                              int rpad)

Formats a given table as a string. The value of each cell is produced by String.valueOf(Object).

Parameters:

cells - the cells of the table in row-major order

cols - the number of columns per row

lpad - the number of space padding inserted before each formatted cell value

rpad - the number of space padding inserted after each formatted cell value

Returns:

a string with one line per row and each column left-aligned

append

public static StringBuilder append(StringBuilder sb,
                                   BytecodePosition pos)

Appends a formatted code position to a StringBuilder.

Parameters:

sb - the StringBuilder to append to

pos - the code position to format and append to sb

Returns:

the value of sb

append

public static StringBuilder append(StringBuilder sb,
                                   BytecodeFrame frame)

Appends a formatted frame to a StringBuilder.

Parameters:

sb - the StringBuilder to append to

frame - the frame to format and append to sb

Returns:

the value of sb

append

public static StringBuilder append(StringBuilder sb,
                                   DebugInfo info,
                                   CodeUtil.RefMapFormatter formatterArg)

Appends a formatted debug info to a StringBuilder.

Parameters:

sb - the StringBuilder to append to

info - the debug info to format and append to sb

Returns:

the value of sb

getCallingConvention

public static CallingConvention getCallingConvention(CodeCacheProvider codeCache,
                                                     CallingConvention.Type type,
                                                     ResolvedJavaMethod method,
                                                     boolean stackOnly)

Create a calling convention from a ResolvedJavaMethod.