org.databene.commons
Class StringUtil

java.lang.Object
  org.databene.commons.StringUtil

public final class StringUtil
extends java.lang.Object

Provides String related utility operations.

Created: 05.07.2006 22:45:12

Author:

Volker Bergmann

Constructor Summary

StringUtil()

Method Summary

static java.lang.StringBuilder	appendLeftAligned(java.lang.StringBuilder builder, java.lang.String text, int columns)
static java.lang.String	capitalize(java.lang.String text) Makes the first character of a String uppercase.
static boolean	contains(java.lang.String s, char c)
static boolean	containsIgnoreCase(java.lang.String searchedWord, java.util.Collection<java.lang.String> words)
static boolean	containsIgnoreCase(java.lang.String searchedWord, java.lang.String[] words)
static int	countChars(java.lang.String s, char c)
static java.lang.String	emptyToNull(java.lang.String s)
static boolean	endsWithIgnoreCase(java.lang.String text, java.lang.String suffix)
static boolean	equalsIgnoreCase(java.lang.String s1, java.lang.String s2)
static java.lang.String	escape(java.lang.String text)
static java.lang.String	escape(java.lang.String text, boolean escapeSingleQuotes, boolean escapeDoubleQuotes)
static void	fill(char[] chars, int fromIndex, int toIndex, char c)
static char[]	getChars(int srcBegin, int srcEnd, java.lang.String text, char[] chars, int dstBegin)
static char[]	getChars(java.lang.String s)
static char[]	getChars(java.lang.StringBuilder builder)
static char[]	increment(char[] chars, int index)
static java.lang.String	increment(java.lang.String text)
static int	indexOfIgnoreCase(java.lang.String searched, java.lang.String... candidates)
static boolean	isEmpty(java.lang.CharSequence s) Tells if a String is null or isEmpty.
static boolean	isWhitespace(char c) interprets an nbsp as space character
static java.lang.String	joinWithSeparator(char separator, java.lang.String... parts)
static char	lastChar(java.lang.String word)
static java.lang.String	lastToken(java.lang.String name, char separator) Returns the last token of a list in string representation.
static java.lang.String	lineSeparator() Returns the platform dependent line separator
static java.lang.String	normalize(java.lang.String s)
static java.lang.String	normalizeLineSeparators(java.lang.String text, java.lang.String lineSeparator)
static java.lang.String	normalizeName(java.lang.String name)
static java.lang.String	normalizeSpace(java.lang.String s)
static java.lang.String	nullToEmpty(java.lang.String text)
static java.lang.String	padLeft(java.lang.String text, int length, char c)
static java.lang.String	padRight(java.lang.String text, int length, char c)
static java.lang.String	padString(char c, int length)
static java.lang.String	remove(java.lang.String s, java.lang.String chars)
static java.lang.String	removeSection(java.lang.String text, java.lang.String beginMark, java.lang.String endMark)
static java.lang.String	replaceTokens(java.lang.String src, java.lang.String token, java.lang.String... values)
static java.lang.String[]	splitAroundSeparator(java.lang.String path, int sepIndex)
static java.lang.String[]	splitOnFirstSeparator(java.lang.String path, char separator)
static java.lang.String[]	splitOnLastSeparator(java.lang.String path, char separator)
static boolean	startsWithIgnoreCase(java.lang.String text, java.lang.String prefix)
static java.lang.String	suffix(java.lang.String name, char separator) Returns the suffix of a String.
static java.lang.String[]	toArray(java.util.List<java.lang.String> list)
static java.lang.String[][]	toArrayArray(java.util.List<java.util.List<java.lang.String>> list)
static java.lang.String[]	tokenize(java.lang.String text, char separator) Splits a list's String representaion into tokens.
static java.lang.String[]	toLowerCase(java.lang.String[] src)
static java.lang.String	trim(java.lang.String s) Trims a String by removing white spaces (including nbsp) from left and right.
static java.lang.Object	trim(java.lang.String source, char padChar)
static java.lang.String[]	trimAll(java.lang.String[] array) Trims all String in the array.
static java.lang.String	trimEnd(java.lang.String s)
static java.lang.String	trimLeft(java.lang.String source, char padChar)
static java.lang.String	trimRight(java.lang.String source, char padChar)
static java.lang.String	uncapitalize(java.lang.String text) Makes the first character of a String lowercase.
static java.lang.String	unescape(java.lang.String text)

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

isEmpty

public static boolean isEmpty(java.lang.CharSequence s)

Tells if a String is null or isEmpty.

Parameters:

s - the string argument to check

Returns:

true if the String is null or isEmpty, otherwise false.

suffix

public static java.lang.String suffix(java.lang.String name,
                                      char separator)

Returns the suffix of a String. If the last character is a separator, or if no separator was found, the string is assumed to have no suffix.

Parameters:

name - the String to check

separator - the character that separates name from suffix

Returns:

a suffix if one exists, else null.

lastToken

public static java.lang.String lastToken(java.lang.String name,
                                         char separator)

Returns the last token of a list in string representation. If the string does not contain the separator, the string itself is the token. If the string ends with a separator, the token is null.

Parameters:

name -

separator - the character that separates the tokens

Returns:

the last token

tokenize

public static java.lang.String[] tokenize(java.lang.String text,
                                          char separator)

Splits a list's String representaion into tokens.

Parameters:

text - the String representation of a list.

separator - the character used to separate tokens

Returns:

an array of tokens.

normalize

public static java.lang.String normalize(java.lang.String s)

appendLeftAligned

public static java.lang.StringBuilder appendLeftAligned(java.lang.StringBuilder builder,
                                                        java.lang.String text,
                                                        int columns)

increment

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

increment

public static char[] increment(char[] chars,
                               int index)

isWhitespace

public static boolean isWhitespace(char c)

interprets an nbsp as space character

trim

public static java.lang.String trim(java.lang.String s)

Trims a String by removing white spaces (including nbsp) from left and right.

trimAll

public static java.lang.String[] trimAll(java.lang.String[] array)

Trims all String in the array.

Parameters:

array - an array of the Strings to trim

Since:

0.2.05

lineSeparator

public static java.lang.String lineSeparator()

Returns the platform dependent line separator

contains

public static boolean contains(java.lang.String s,
                               char c)

remove

public static java.lang.String remove(java.lang.String s,
                                      java.lang.String chars)

nullToEmpty

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

normalizeSpace

public static java.lang.String normalizeSpace(java.lang.String s)

trimEnd

public static java.lang.String trimEnd(java.lang.String s)

countChars

public static int countChars(java.lang.String s,
                             char c)

toArray

public static java.lang.String[] toArray(java.util.List<java.lang.String> list)

toArrayArray

public static java.lang.String[][] toArrayArray(java.util.List<java.util.List<java.lang.String>> list)

padLeft

public static java.lang.String padLeft(java.lang.String text,
                                       int length,
                                       char c)

padRight

public static java.lang.String padRight(java.lang.String text,
                                        int length,
                                        char c)

fill

public static void fill(char[] chars,
                        int fromIndex,
                        int toIndex,
                        char c)

getChars

public static char[] getChars(int srcBegin,
                              int srcEnd,
                              java.lang.String text,
                              char[] chars,
                              int dstBegin)

getChars

public static char[] getChars(java.lang.String s)

getChars

public static char[] getChars(java.lang.StringBuilder builder)

padString

public static java.lang.String padString(char c,
                                         int length)

trimRight

public static java.lang.String trimRight(java.lang.String source,
                                         char padChar)

trimLeft

public static java.lang.String trimLeft(java.lang.String source,
                                        char padChar)

trim

public static java.lang.Object trim(java.lang.String source,
                                    char padChar)

toLowerCase

public static java.lang.String[] toLowerCase(java.lang.String[] src)

indexOfIgnoreCase

public static int indexOfIgnoreCase(java.lang.String searched,
                                    java.lang.String... candidates)

lastChar

public static char lastChar(java.lang.String word)

capitalize

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

Makes the first character of a String uppercase.

Parameters:

text - the text to convert

Returns:

a text that starts with a uppercase letter

uncapitalize

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

Makes the first character of a String lowercase.

Parameters:

text - the text to convert

Returns:

a text that starts with a lowercase letter

Since:

0.2.04

splitOnFirstSeparator

public static java.lang.String[] splitOnFirstSeparator(java.lang.String path,
                                                       char separator)

splitOnLastSeparator

public static java.lang.String[] splitOnLastSeparator(java.lang.String path,
                                                      char separator)

splitAroundSeparator

public static java.lang.String[] splitAroundSeparator(java.lang.String path,
                                                      int sepIndex)

joinWithSeparator

public static java.lang.String joinWithSeparator(char separator,
                                                 java.lang.String... parts)

equalsIgnoreCase

public static boolean equalsIgnoreCase(java.lang.String s1,
                                       java.lang.String s2)

containsIgnoreCase

public static boolean containsIgnoreCase(java.lang.String searchedWord,
                                         java.util.Collection<java.lang.String> words)

containsIgnoreCase

public static boolean containsIgnoreCase(java.lang.String searchedWord,
                                         java.lang.String[] words)

startsWithIgnoreCase

public static boolean startsWithIgnoreCase(java.lang.String text,
                                           java.lang.String prefix)

endsWithIgnoreCase

public static boolean endsWithIgnoreCase(java.lang.String text,
                                         java.lang.String suffix)

normalizeName

public static java.lang.String normalizeName(java.lang.String name)

escape

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

escape

public static java.lang.String escape(java.lang.String text,
                                      boolean escapeSingleQuotes,
                                      boolean escapeDoubleQuotes)

unescape

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

replaceTokens

public static java.lang.String replaceTokens(java.lang.String src,
                                             java.lang.String token,
                                             java.lang.String... values)

emptyToNull

public static java.lang.String emptyToNull(java.lang.String s)

removeSection

public static java.lang.String removeSection(java.lang.String text,
                                             java.lang.String beginMark,
                                             java.lang.String endMark)

normalizeLineSeparators

public static java.lang.String normalizeLineSeparators(java.lang.String text,
                                                       java.lang.String lineSeparator)