info.aduna.text

Class StringUtil

java.lang.Object

info.aduna.text.StringUtil

public class StringUtil
extends Object

Constructor Summary

Constructors

Constructor and Description
StringUtil()

Method Summary

Methods

Modifier and Type	Method and Description
static void	appendN(char c, int n, StringBuilder sb) Appends the specified character n times to the supplied StringBuilder.
static String	concat(String... strings) Concatenate a number of Strings.
static String[]	decodeArray(String encodedArray) Decodes a String generated by encodeArray.
static String	deriveInitialText(String text) Derives the initial text from the supplied text.
static String	encodeArray(String[] array) Encodes an array of Strings into a single String than can be decoded to the original array using the corresponding decode method.
static String	getAllAfter(String string, char separatorChar) Returns all text occurring after the specified separator character, or the entire string when the seperator char does not occur.
static String	getAllBefore(String string, char separatorChar) Returns all text occurring before the specified separator character, or the entire string when the seperator char does not occur.
static String	gsub(String olds, String news, String text) Substitute String "old" by String "new" in String "text" everywhere.
static boolean	isGarbageText(String text) Titles shorter than MIN_TITLE_LENGTH and long titles that don't contain a single space character are considered to be garbage.
static String	trimDoubleQuotes(String text) Removes the double quote from the start and end of the supplied string if it starts and ends with this character.

Methods inherited from class java.lang.Object

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

Constructor Detail

StringUtil

public StringUtil()

Method Detail

gsub

public static String gsub(String olds,
          String news,
          String text)

Substitute String "old" by String "new" in String "text" everywhere. This is static util function that I could not place anywhere more appropriate. The name of this function is from the good-old awk time.

Parameters:

olds - The String to be substituted.

news - The String is the new content.

text - The String in which the substitution is done.

Returns:

The result String containing the substitutions; if no substitutions were made, the result is 'text'.

getAllAfter

public static String getAllAfter(String string,
                 char separatorChar)

Returns all text occurring after the specified separator character, or the entire string when the seperator char does not occur.

Parameters:

string - The string of which the substring needs to be determined.

separatorChar - The character to look for.

Returns:

All text occurring after the separator character, or the entire string when the character does not occur.

getAllBefore

public static String getAllBefore(String string,
                  char separatorChar)

Returns all text occurring before the specified separator character, or the entire string when the seperator char does not occur.

Parameters:

string - The string of which the substring needs to be determined.

separatorChar - The character to look for.

Returns:

All text occurring before the separator character, or the entire string when the character does not occur.

encodeArray

public static String encodeArray(String[] array)

Encodes an array of Strings into a single String than can be decoded to the original array using the corresponding decode method. Useful for e.g. storing an array of Strings as a single entry in a Preferences node.

decodeArray

public static String[] decodeArray(String encodedArray)

Decodes a String generated by encodeArray.

deriveInitialText

public static String deriveInitialText(String text)

Derives the initial text from the supplied text. The returned text excludes whitespace and other special characters and is useful for display purposes (e.g. previews).

isGarbageText

public static boolean isGarbageText(String text)

Titles shorter than MIN_TITLE_LENGTH and long titles that don't contain a single space character are considered to be garbage.

appendN

public static void appendN(char c,
           int n,
           StringBuilder sb)

Appends the specified character n times to the supplied StringBuilder.

Parameters:

c - The character to append.

n - The number of times the character should be appended.

sb - The StringBuilder to append the character(s) to.

trimDoubleQuotes

public static String trimDoubleQuotes(String text)

Removes the double quote from the start and end of the supplied string if it starts and ends with this character. This method does not create a new string if text doesn't start and end with double quotes, the text object itself is returned in that case.

Parameters:

text - The string to remove the double quotes from.

Returns:

The trimmed string, or a reference to text if it did not start and end with double quotes.

concat

public static String concat(String... strings)

Concatenate a number of Strings. This implementation uses a StringBuilder.

Parameters:

strings - the String to concatenate

Returns:

a String that is the results of concatenating the input strings.