info.bioinfweb.commons.text

Class StringUtils

java.lang.Object

info.bioinfweb.commons.text.StringUtils

public class StringUtils
extends java.lang.Object

Provides general methods to use with character sequences.

Author:

Ben Stöver

Field Summary

Fields

Modifier and Type	Field and Description
static java.text.NumberFormat	DOUBLE_FORMAT
static java.text.NumberFormat	INTEGER_FORMAT

Constructor Summary

Constructors

Constructor and Description
StringUtils()

Method Summary

Modifier and Type	Method and Description
static java.util.List<java.lang.String>	charSequenceToStringList(java.lang.CharSequence sequence) Converts the specified character sequence to a list strings, where each character of the sequence is represented as a single string object.
static java.lang.String	concatWithOperator(java.lang.String leftPart, java.lang.String rightPart, java.lang.String operator) Concatenates two expressions with an operator if both are not empty.
static java.lang.String	concatWithOperator(java.lang.String leftPart, java.lang.String rightPart, java.lang.String operator, java.lang.String leftBracket, java.lang.String rightBracket) Concatenates two expressions with an operator if both are not empty.
static boolean	containsWhitespace(java.lang.CharSequence sequence) Tests if the specified character sequence does not contain any whitespace.
static java.lang.String	convertCamelCase(java.lang.String text, java.lang.String separator) Converts a camel case keyword to a string with the specified separator where all characters are in lower case.
static java.lang.CharSequence	cutEnd(java.lang.CharSequence sequence, int length) Cuts off the specified number of characters from the end of the specified character sequence.
static java.lang.String	cutEnd(java.lang.String sequence, int length) Cuts off the specified number of characters from the end of the specified string.
static boolean	endsWith(java.lang.CharSequence sequence, char terminalSymbol) Tests whether a character sequence ends with a specified character.
static java.lang.String	firstCharToLowerCase(java.lang.String text)
static java.lang.String	firstCharToUpperCase(java.lang.String text)
static int	indexOfWhiteSpace(java.lang.CharSequence sequence) Returns the first index of any whitespace character.
static int	indexOfWhiteSpace(java.lang.CharSequence sequence, int fromIndex) Returns the first index of any whitespace character.
static java.lang.String	invert(java.lang.CharSequence s)
static boolean	isNewLineChar(char c) Checks if the specified character is a new line character
static char	lastChar(java.lang.CharSequence sequence) Returns the last character of the specified sequence.
static void	renameRepeatedEntries(java.util.List<java.lang.String> list)
static void	renameRepeatedEntries(java.lang.String[] array)
static java.lang.String	repeat(java.lang.CharSequence element, int count)

Methods inherited from class java.lang.Object

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

Field Detail

DOUBLE_FORMAT

public static final java.text.NumberFormat DOUBLE_FORMAT

INTEGER_FORMAT

public static final java.text.NumberFormat INTEGER_FORMAT

Constructor Detail

StringUtils

public StringUtils()

Method Detail

invert

public static java.lang.String invert(java.lang.CharSequence s)

repeat

public static java.lang.String repeat(java.lang.CharSequence element,
                                      int count)

renameRepeatedEntries

public static void renameRepeatedEntries(java.lang.String[] array)

renameRepeatedEntries

public static void renameRepeatedEntries(java.util.List<java.lang.String> list)

concatWithOperator

public static java.lang.String concatWithOperator(java.lang.String leftPart,
                                                  java.lang.String rightPart,
                                                  java.lang.String operator,
                                                  java.lang.String leftBracket,
                                                  java.lang.String rightBracket)

Concatenates two expressions with an operator if both are not empty.

Example:

• concatWithOperator("A", "B", " + ", "(", ")") would return "(A + B)".
• concatWithOperator("A", "", " + ", "(", ")") would return "A".

Parameters:

leftPart - the left expression

rightPart - the right expression

operator - the operator (including white spaces if necessary)

leftBracket - the left bracket to be used (e.g. "{")

rightBracket - the right bracket to be used (e.g. "}")

Returns:

the concatenated expression

concatWithOperator

public static java.lang.String concatWithOperator(java.lang.String leftPart,
                                                  java.lang.String rightPart,
                                                  java.lang.String operator)

Concatenates two expressions with an operator if both are not empty.

Parameters:

leftPart - the left expression

rightPart - the right expression

operator - the operator (including white spaces if necessary)

Returns:

the concatenated expression

See Also:

concatWithOperator(String, String, String, String, String)

firstCharToLowerCase

public static java.lang.String firstCharToLowerCase(java.lang.String text)

firstCharToUpperCase

public static java.lang.String firstCharToUpperCase(java.lang.String text)

convertCamelCase

public static java.lang.String convertCamelCase(java.lang.String text,
                                                java.lang.String separator)

Converts a camel case keyword to a string with the specified separator where all characters are in lower case.

Example: anExampleKeyword would be converted to an-example-keyword and A to a.

Parameters:

text - the string to be converted

separator - the separator to be inserted

Returns:

the converted keyword string

isNewLineChar

public static boolean isNewLineChar(char c)

Checks if the specified character is a new line character

Parameters:

c - the character to be tested

Returns:

true if c is either '\n' or '\r', false otherwise.

indexOfWhiteSpace

public static int indexOfWhiteSpace(java.lang.CharSequence sequence)

Returns the first index of any whitespace character.

Parameters:

sequence - the character sequence to be searched

Returns:

the index of the first white space character (as defined by Character.isWhitespace(char)) or -1 if the sequence does not contain any whitespace

indexOfWhiteSpace

public static int indexOfWhiteSpace(java.lang.CharSequence sequence,
                                    int fromIndex)

Returns the first index of any whitespace character.

Parameters:

sequence - the character sequence to be searched

fromIndex - the index to start the search

Returns:

the index of the first white space character (as defined by Character.isWhitespace(char)) at or after fromIndex or -1 if the sequence does not contain any whitespace behind that position

containsWhitespace

public static boolean containsWhitespace(java.lang.CharSequence sequence)

Tests if the specified character sequence does not contain any whitespace.

Note this method will return false, if an empty sequence ("") is specified.

Parameters:

sequence - the character sequence to be tested

Returns:

true if the sequence contains no whitespace or false otherwise

Throws:

java.lang.NullPointerException - if sequence is null

endsWith

public static boolean endsWith(java.lang.CharSequence sequence,
                               char terminalSymbol)

Tests whether a character sequence ends with a specified character.

Parameters:

sequence - the sequence to be tested

terminalSymbol - the expected last character of the sequence

Returns:

true if the sequence is at least one character long and last character is equal to terminalSymbol, false otherwise.

cutEnd

public static java.lang.CharSequence cutEnd(java.lang.CharSequence sequence,
                                            int length)

Cuts off the specified number of characters from the end of the specified character sequence.

If length is higher than the length of sequence an empty string is returned.

Parameters:

sequence - the character sequence to be cut

length - the number of characters to be removed from the end

Returns:

the shorter sequence

cutEnd

public static java.lang.String cutEnd(java.lang.String sequence,
                                      int length)

Cuts off the specified number of characters from the end of the specified string.

If length is higher than the length of sequence an empty string is returned.

Parameters:

sequence - the string to be cut

length - the number of characters to be removed from the end

Returns:

the shorter string

lastChar

public static char lastChar(java.lang.CharSequence sequence)

Returns the last character of the specified sequence.

Parameters:

sequence - the character sequence to extract the last character from

Returns:

the last character of the sequence

Throws:

java.lang.IllegalArgumentException - if sequence is not at least one character long

charSequenceToStringList

public static java.util.List<java.lang.String> charSequenceToStringList(java.lang.CharSequence sequence)

Converts the specified character sequence to a list strings, where each character of the sequence is represented as a single string object.

Parameters:

sequence - the sequence to be converted

Returns:

the resulting list of strings

Since:

2.0.0