com.github.croesch.micro_debug.commons
Class Utils

java.lang.Object
  com.github.croesch.micro_debug.commons.Utils

public final class Utils
extends java.lang.Object

Class with utility methods.

Since:

Date: Nov 23, 2011

Author:

croesch

Method Summary

static int	bytesToInt(byte b0, byte b1, byte b2, byte b3) Assembles the given bytes to one integer.
static void	checkMagicNumber(java.io.InputStream in, int magic) Reads the first four bytes of the given InputStream and throws an exception if they aren't equal to the expected magic number.
static java.lang.String	getLineSeparator() Returns the line separator that is default for this system.
static int	getNextHigherValue(int start, int... values) Giving a start value this iterates over all the other given values and returns the minimum of them that is higher than the given start value.
static boolean	isNullOrEmpty(java.lang.String str) Returns whether the given String is null or empty.
static boolean	isOneValueMinusOne(int[] values) Returns whether one of the given numbers is equal to -1.
static void	logThrownThrowable(java.lang.Throwable t) Logs that the given Throwable has been thrown.
static java.lang.String	toBinaryString(int number) Returns the binary string representation of the integer argument. For example: 6 → 0000 0000 0000 0000 0000 0000 0000 0110
static java.lang.String	toHexString(int number) Returns a string representation of the integer argument as an unsigned integer in base 16. For example: 100 → 0x64
static java.lang.String	toString(java.lang.Object obj) Returns the Object.toString() representation of the given object or an empty String if the object is null.

Methods inherited from class java.lang.Object

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

Method Detail

isOneValueMinusOne

public static boolean isOneValueMinusOne(int[] values)

Returns whether one of the given numbers is equal to -1.

Parameters:

values - the numbers to check if any is equal to -1.

Returns:

true, if at least one of the given values is equal to -1.

Since:

Date: Nov 13, 2011

checkMagicNumber

public static void checkMagicNumber(java.io.InputStream in,
                                    int magic)
                             throws FileFormatException,
                                    java.lang.IllegalArgumentException

Reads the first four bytes of the given InputStream and throws an exception if they aren't equal to the expected magic number.

Parameters:

in - the stream to read the bytes from

magic - the magic number

Throws:

java.lang.IllegalArgumentException - if the given stream is null.

FileFormatException - if:

• the stream doesn't contain four bytes
• the four bytes are not equal to the given magic number
• an IOException occurs

Since:

Date: Nov 19, 2011

bytesToInt

public static int bytesToInt(byte b0,
                             byte b1,
                             byte b2,
                             byte b3)

Assembles the given bytes to one integer.

Parameters:

b0 - the most significant byte

b1 - the second most significant byte

b2 - the second least significant byte

b3 - the least significant byte

Returns:

an integer, assembled by the four bytes

Since:

Date: Nov 23, 2011

logThrownThrowable

public static void logThrownThrowable(java.lang.Throwable t)

Logs that the given Throwable has been thrown.

Parameters:

t - the thrown Throwable to log

Since:

Date: Dec 2, 2011

toHexString

@NotNull
public static java.lang.String toHexString(int number)

Returns a string representation of the integer argument as an unsigned integer in base 16.

For example: 100 → 0x64

Parameters:

number - the number to represent as hexadecimal string

Returns:

the string representation of the given number in upper case and with leading 0x

Since:

Date: Jan 14, 2012

toBinaryString

@NotNull
public static java.lang.String toBinaryString(int number)

Returns the binary string representation of the integer argument.

For example: 6 → 0000 0000 0000 0000 0000 0000 0000 0110

Parameters:

number - the number to represent as binary string

Returns:

the string representation of the given number

Since:

Date: Mar 14, 2012

getNextHigherValue

public static int getNextHigherValue(int start,
                                     int... values)

Giving a start value this iterates over all the other given values and returns the minimum of them that is higher than the given start value. So to say the next higher value seen from the starting point.

Parameters:

start - the number to start from

values - the other numbers to iterate over and to search for the next higher value

Returns:

the next higher value than the start number
or Integer.MAX_VALUE if no value is higher than the given start number.

Since:

Date: Jan 22, 2012

getLineSeparator

@NotNull
public static java.lang.String getLineSeparator()

Returns the line separator that is default for this system.

Returns:

String that represents the line separator

Since:

Date: Jan 24, 2012

toString

@Nullable
public static java.lang.String toString(java.lang.Object obj)

Returns the Object.toString() representation of the given object or an empty String if the object is null.

Parameters:

obj - the object

Returns:

the String representation of the object or an empty String if the Object is null.

Since:

Date: Mar 3, 2012

isNullOrEmpty

public static boolean isNullOrEmpty(java.lang.String str)

Returns whether the given String is null or empty. A String containing only whitespaces is also considered to be empty.

Parameters:

str - the String to check if it's null or empty.

Returns:

true if the given String is either null or empty,
false otherwise

Since:

Date: Mar 9, 2012