com.gargoylesoftware.base.util
Class StringUtil

java.lang.Object
  com.gargoylesoftware.base.util.StringUtil

public class StringUtil
extends java.lang.Object

A collection of utility methods dealing with strings

Version:

$Revision: 1.5 $

Author:

Mike Bowler

Constructor Summary

private

StringUtil()

Method Summary

private static void	assertNotNull(java.lang.String fieldName, java.lang.Object object)
static java.lang.String	expandTabs(java.lang.String inputString, int numberOfSpaces) Expand each tab character into the specified numbers of spaces.
static java.lang.String	join(byte[] array, java.lang.String separator) Create a string based on all the objects in the array separated by the separator string.
static java.lang.String	join(java.util.Collection collection, java.lang.String separator) Create a string based on all the objects in the collection separated by the separator string.
static java.lang.String	join(double[] array, java.lang.String separator) Create a string based on all the objects in the array separated by the separator string.
static java.lang.String	join(float[] array, java.lang.String separator) Create a string based on all the objects in the array separated by the separator string.
static java.lang.String	join(int[] array, java.lang.String separator) Create a string based on all the objects in the array separated by the separator string.
static java.lang.String	join(long[] array, java.lang.String separator) Create a string based on all the objects in the array separated by the separator string.
static java.lang.String	join(java.lang.Object[] array, java.lang.String separator) Create a string based on all the objects in the array separated by the separator string.
private static java.lang.String	joinArray(java.lang.Object array, java.lang.String separator) Create a string based on all the objects in the array separated by the separator string.
static java.lang.String	nCopies(int copyCount, char charToCopy) Return a string containing the specified number of charToCopy
static java.lang.String	replace(java.lang.String sourceString, java.lang.String match, java.lang.String replace) Perform text substitutions in the source string
static java.lang.String[]	split(java.lang.String line, java.lang.String separator) Split the specified line into strings, spliting at each instance of separator.
static java.lang.String[]	splitAtFirst(java.lang.String line, java.lang.String separator) Split the specified line into two strings, spliting at the first instance of separator.

Methods inherited from class java.lang.Object

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

Constructor Detail

StringUtil

private StringUtil()

Method Detail

expandTabs

public static java.lang.String expandTabs(java.lang.String inputString,
                                          int numberOfSpaces)

Expand each tab character into the specified numbers of spaces.

Parameters:

inputString - The string to be expanded.

numberOfSpaces - The number of space characters to be used for each substitution.

Returns:

The new string with expanded tabs.

nCopies

public static java.lang.String nCopies(int copyCount,
                                       char charToCopy)

Return a string containing the specified number of charToCopy

Parameters:

copyCount - The number of times to copy the character.

charToCopy - The character that will be copied.

Returns:

The new string.

joinArray

private static java.lang.String joinArray(java.lang.Object array,
                                          java.lang.String separator)

Create a string based on all the objects in the array separated by the separator string.

Parameters:

array - The items that will be concatenated together

separator - The separator string.

Returns:

The new concatenated string.

join

public static java.lang.String join(int[] array,
                                    java.lang.String separator)

Create a string based on all the objects in the array separated by the separator string.

Parameters:

array - The items that will be concatenated together

separator - The separator string.

Returns:

The new concatenated string.

join

public static java.lang.String join(long[] array,
                                    java.lang.String separator)

Create a string based on all the objects in the array separated by the separator string.

Parameters:

array - The items that will be concatenated together

separator - The separator string.

Returns:

The new concatenated string.

join

public static java.lang.String join(float[] array,
                                    java.lang.String separator)

Create a string based on all the objects in the array separated by the separator string.

Parameters:

array - The items that will be concatenated together

separator - The separator string.

Returns:

The new concatenated string.

join

public static java.lang.String join(double[] array,
                                    java.lang.String separator)

Create a string based on all the objects in the array separated by the separator string.

Parameters:

array - The items that will be concatenated together

separator - The separator string.

Returns:

The new concatenated string.

join

public static java.lang.String join(byte[] array,
                                    java.lang.String separator)

Create a string based on all the objects in the array separated by the separator string.

Parameters:

array - The items that will be concatenated together

separator - The separator string.

Returns:

The new concatenated string.

join

public static java.lang.String join(java.lang.Object[] array,
                                    java.lang.String separator)

Create a string based on all the objects in the array separated by the separator string.

Parameters:

array - The items that will be concatenated together

separator - The separator string.

Returns:

The new concatenated string.

join

public static java.lang.String join(java.util.Collection collection,
                                    java.lang.String separator)

Create a string based on all the objects in the collection separated by the separator string.

Parameters:

separator - The separator string.

collection - The collection containing the objects to join

Returns:

The new concatenated string.

splitAtFirst

public static java.lang.String[] splitAtFirst(java.lang.String line,
                                              java.lang.String separator)

Split the specified line into two strings, spliting at the first instance of separator.

Parameters:

line - The line to be split.

separator - The separator that will be used to split the string.

Returns:

An array containing the two strings.

split

public static java.lang.String[] split(java.lang.String line,
                                       java.lang.String separator)

Split the specified line into strings, spliting at each instance of separator.

Parameters:

line - The line to be split.

separator - The separator that will be used to split the string.

Returns:

An array containing the strings

replace

public static java.lang.String replace(java.lang.String sourceString,
                                       java.lang.String match,
                                       java.lang.String replace)

Perform text substitutions in the source string

Parameters:

sourceString - The original string

match - The string to replace

replace - The new content to replace with

Returns:

A new string with all the substitutions done

assertNotNull

private static void assertNotNull(java.lang.String fieldName,
                                  java.lang.Object object)