jsimple.util

Class StringUtils

java.lang.Object

jsimple.util.StringUtils

public class StringUtils
extends java.lang.Object

Since:

10/23/12 12:23 AM

Constructor Summary

Constructors

Constructor and Description
StringUtils()

Method Summary

Modifier and Type	Method and Description
static boolean	isNullOrEmpty(java.lang.String string)
static ArrayList<java.lang.String>	split(java.lang.String string, char delimiter) Splits this string using the supplied character as the delimiter.
static ArrayList<java.lang.String>	split(java.lang.String string, char delimiter, int max) Splits this string using the supplied character as the delimiter, returning at most max items.
static ArrayList<java.lang.String>	split(java.lang.String string, Pattern delimiter) Splits this string using the supplied pattern as the delimiter.
static ArrayList<java.lang.String>	split(java.lang.String string, Pattern delimiter, int max) Splits this string using the supplied pattern as the delimiter.
static byte	toByteFromHexCharacter(char hexCharacter) Convert a hex character to it's equivalent byte.
static byte[]	toBytesFromHexString(java.lang.String hexString) Convert a hexadecimal string to a byte array.
static java.lang.String	toHexStringFromBytes(byte[] bytes) Convert a byte array to a hexadecimal string.
static byte[]	toLatin1BytesFromString(java.lang.String string) Convert a string, assumed to contain only Latin1 (aka 8859-1 aka Windows 1252) characters, to a byte array.
static java.lang.String	toStringFromLatin1Bytes(byte[] bytes) Convert a byte array, assumed to be a Latin1 (aka 8859-1 aka Windows 1252) encoded string, to a regular Java string.
static java.lang.String	toStringFromLatin1Bytes(ByteArrayRange byteArrayRange) Convert a ByteArrayRange, assumed to be a Latin1 (aka 8859-1 aka Windows 1252) encoded string, to a regular Java string.

Methods inherited from class java.lang.Object

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

Constructor Detail

StringUtils

public StringUtils()

Method Detail

isNullOrEmpty

public static boolean isNullOrEmpty(@Nullable
                                    java.lang.String string)

toHexStringFromBytes

public static java.lang.String toHexStringFromBytes(byte[] bytes)

Convert a byte array to a hexadecimal string. Leading zeros are of course preserved. Hex letters are upper case.

Parameters:

bytes - byte array

Returns:

hexadecimal string

toBytesFromHexString

public static byte[] toBytesFromHexString(java.lang.String hexString)

Convert a hexadecimal string to a byte array. An exception is thrown if the string contains any non-hex characters. A-F and a-f (both upper & lower case) are allowed for input.

Parameters:

hexString - hex string, containing only 0-9, A-F, or a-f

Returns:

byte array

toByteFromHexCharacter

public static byte toByteFromHexCharacter(char hexCharacter)

Convert a hex character to it's equivalent byte. Similar to standard Java's Character.digit. If character isn't a valid hex character, an exception is thrown.

Parameters:

hexCharacter - hex character (0-9, A-F, or a-f)

Returns:

number equivalent (0-15)

toStringFromLatin1Bytes

public static java.lang.String toStringFromLatin1Bytes(byte[] bytes)

Convert a byte array, assumed to be a Latin1 (aka 8859-1 aka Windows 1252) encoded string, to a regular Java string. Latin1 is the first 256 characters of Unicode, so this conversion is just a straight pass through, turning bytes in chars. Note that ASCII is a subset of Latin1.

Parameters:

bytes - byte array

Returns:

resulting string

toStringFromLatin1Bytes

public static java.lang.String toStringFromLatin1Bytes(ByteArrayRange byteArrayRange)

Convert a ByteArrayRange, assumed to be a Latin1 (aka 8859-1 aka Windows 1252) encoded string, to a regular Java string. Latin1 is the first 256 characters of Unicode, so this conversion is just a straight pass through, turning bytes in chars. Note that ASCII is a subset of Latin1.

Parameters:

byteArrayRange - byte array data

Returns:

resulting string

toLatin1BytesFromString

public static byte[] toLatin1BytesFromString(java.lang.String string)

Convert a string, assumed to contain only Latin1 (aka 8859-1 aka Windows 1252) characters, to a byte array. The byte array is encoded one byte per character--just a straight pass through from the Unicode, dropping the high byte (which should be zero) of each character. If any non-Latin1 characters are in the string an exception is thrown. This method is an efficient way to only ASCII text as a byte array, since ASCII is a subset of Latin1.

Parameters:

string - input string, which should contain only Latin1 characters

Returns:

resulting byte array

split

public static ArrayList<java.lang.String> split(java.lang.String string,
                                                Pattern delimiter)

Splits this string using the supplied pattern as the delimiter. Does the same thing as split(string, delimiter, 0).

Parameters:

string - string to split

delimiter - the pattern used to delimit substrings

Returns:

a list of Strings created by separating the via matches of the pattern

split

public static ArrayList<java.lang.String> split(java.lang.String string,
                                                Pattern delimiter,
                                                int max)

Splits this string using the supplied pattern as the delimiter. In typical cases, the delimiter pattern is character or literal string, but it can be arbitrarily complex.

The parameter max controls how many times the pattern is applied, by specifying the max number of items in the returned list. If the limit is reached, the last item returned includes the remainder of the string. Specify 0 for no limit.

Parameters:

string - string to split

delimiter - the pattern used to delimit substrings

max - the max number of entries in the resulting array; if 0 then unlimited

Returns:

a list of Strings created by separating the via matches of the pattern

split

public static ArrayList<java.lang.String> split(java.lang.String string,
                                                char delimiter)

Splits this string using the supplied character as the delimiter.

Parameters:

string - string to split

delimiter - the character used to delimit substrings

Returns:

a list of Strings created by separating the via matches of the character

split

public static ArrayList<java.lang.String> split(java.lang.String string,
                                                char delimiter,
                                                int max)

Splits this string using the supplied character as the delimiter, returning at most max items.

Parameters:

string - string to split

delimiter - the character used to delimit substrings

max - the max number of entries in the resulting array; if 0 then unlimited

Returns:

a list of Strings created by separating the via matches of the character