StringUtils (Utilities for Java SE 0.9.2 API)

java.lang.Object
- be.atbash.util.StringUtils

```
public final class StringUtils
extends Object
```
Simple utility class for String operations useful across the framework. Taken from Apache Shiro.

Field Summary

Fields
Modifier and Type	Field and Description
`static char`	`DEFAULT_DELIMITER_CHAR` Constant representing the default delimiter character (comma), equal to `','`
`static char`	`DEFAULT_QUOTE_CHAR` Constant representing the default quote character (double quote), equal to '"'
`static String`	`EMPTY_STRING` Constant representing the empty string, equal to ""

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static String`	`clean(String in)` Returns a 'cleaned' representation of the specified argument.
`static int`	`countOccurrences(String haystack, char needle)` Count the number of occurrences of a char in the String.
`static boolean`	`hasLength(String str)` Check that the given String is neither `null` nor of length 0.
`static boolean`	`hasText(String str)` Check whether the given String has actual text.
`static boolean`	`isEmpty(char[] value)` Check whether the given char array has actual text.
`static boolean`	`isEmpty(String value)` Check whether the given String has actual text.
`static String[]`	`split(String aLine)` Splits the specified delimited String into tokens, supporting quoted tokens so that quoted strings themselves won't be tokenized.
`static String[]`	`split(String aLine, char delimiter)` Splits the specified delimited String into tokens, supporting quoted tokens so that quoted strings themselves won't be tokenized.
`static String[]`	`split(String aLine, char delimiter, char quoteChar)` Splits the specified delimited String into tokens, supporting quoted tokens so that quoted strings themselves won't be tokenized.
`static String[]`	`split(String aLine, char delimiter, char beginQuoteChar, char endQuoteChar)` Splits the specified delimited String into tokens, supporting quoted tokens so that quoted strings themselves won't be tokenized.
`static String[]`	`split(String aLine, char delimiter, char beginQuoteChar, char endQuoteChar, boolean retainQuotes, boolean trimTokens)` Splits the specified delimited String into tokens, supporting quoted tokens so that quoted strings themselves won't be tokenized.
`static boolean`	`startsWithIgnoreCase(String str, String prefix)` Test if the given String starts with the specified prefix, ignoring upper/lower case.
`static String`	`toDelimitedString(Object[] array)` Returns the specified array as a comma-delimited (',') string.
`static String`	`toDelimitedString(String delimiter, Collection<?> collection)` Returns the collection's contents as a string, with each element delimited by the specified `delimiter` argument.
`static String`	`toDelimitedString(String separator, Iterator<?> iterator)` Joins the elements of the provided `Iterator` into a single String containing the provided elements.
`static String`	`toDelimitedString(String delimiter, Object... array)` Returns the array's contents as a string, with each element delimited by the specified `delimiter` argument.
`static String[]`	`tokenizeToStringArray(String str, String delimiters)` Tokenize the given String into a String array via a StringTokenizer.
`static String[]`	`tokenizeToStringArray(String str, String delimiters, boolean trimTokens, boolean ignoreEmptyTokens)` Tokenize the given String into a String array via a StringTokenizer.
`static String[]`	`toStringArray(Collection<String> collection)` Copy the given Collection into a String array.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - EMPTY_STRING
```
public static final String EMPTY_STRING
```
    Constant representing the empty string, equal to ""
    
    See Also:
    
    Constant Field Values
  - DEFAULT_DELIMITER_CHAR
```
public static final char DEFAULT_DELIMITER_CHAR
```
    Constant representing the default delimiter character (comma), equal to ','
    
    See Also:
    
    Constant Field Values
  - DEFAULT_QUOTE_CHAR
```
public static final char DEFAULT_QUOTE_CHAR
```
    Constant representing the default quote character (double quote), equal to '"'
    
    See Also:
    
    Constant Field Values
- Method Detail
  - hasText
```
public static boolean hasText(String str)
```
    Check whether the given String has actual text. More specifically, returns true if the string not null, its length is greater than 0, and it contains at least one non-whitespace character.
    StringUtils.hasText(null) == false StringUtils.hasText("") == false StringUtils.hasText(" ") == false StringUtils.hasText("12345") == true StringUtils.hasText(" 12345 ") == true
    
    Parameters:
    
    str - the String to check (may be null)
    
    Returns:
    
    true if the String is not null, its length is greater than 0, and it does not contain whitespace only
    
    See Also:
    
    Character.isWhitespace(char)
  - isEmpty
```
public static boolean isEmpty(String value)
```
    Check whether the given String has actual text. More specifically, returns true if the string is null or its length is equal to 0, and it contains no non-whitespace character.
    StringUtils.hasText(null) == true StringUtils.hasText("") == true StringUtils.hasText(" ") == true StringUtils.hasText("12345") == false StringUtils.hasText(" 12345 ") == false
    
    Parameters:
    
    value - the String to check (may be null)
    
    Returns:
    
    true if the String is null or its length is equal to 0, or it does contain whitespace only
    
    See Also:
    
    Character.isWhitespace(char)
  - isEmpty
```
public static boolean isEmpty(char[] value)
```
    Check whether the given char array has actual text. More specifically, returns true if the array is null or its length is equal to 0, and it contains no non-whitespace character.
    
    Parameters:
    
    value - the String to check (may be null)
    
    Returns:
    
    true if the Array is null or its length is equal to 0, or it does contain whitespace only
    
    See Also:
    
    Character.isWhitespace(char)
  - hasLength
```
public static boolean hasLength(String str)
```
    Check that the given String is neither null nor of length 0. Note: Will return true for a String that purely consists of whitespace.
    StringUtils.hasLength(null) == false StringUtils.hasLength("") == false StringUtils.hasLength(" ") == true StringUtils.hasLength("Hello") == true
    
    Parameters:
    
    str - the String to check (may be null)
    
    Returns:
    
    true if the String is not null and has length
    
    See Also:
    
    hasText(String)
  - startsWithIgnoreCase
```
public static boolean startsWithIgnoreCase(String str,
                                           String prefix)
```
    Test if the given String starts with the specified prefix, ignoring upper/lower case.
    
    Parameters:
    
    str - the String to check
    
    prefix - the prefix to look for
    
    Returns:
    
    true starts with the specified prefix (ignoring case), false if it does not.
    
    See Also:
    
    String.startsWith(java.lang.String, int)
  - clean
```
public static String clean(String in)
```
    Returns a 'cleaned' representation of the specified argument. 'Cleaned' is defined as the following:
    1. If the specified String is null, return null
    2. If not null, trim() it.
    3. If the trimmed string is equal to the empty String (i.e. ""), return null
    4. If the trimmed string is not the empty string, return the trimmed version
    Therefore this method always ensures that any given string has trimmed text, and if it doesn't, null is returned.
    Parameters:
    
    in - the input String to clean.
    
    Returns:
    
    a populated-but-trimmed String or null otherwise
  - toDelimitedString
```
public static String toDelimitedString(Object[] array)
```
    Returns the specified array as a comma-delimited (',') string.
    
    Parameters:
    
    array - the array whose contents will be converted to a string.
    
    Returns:
    
    the array's contents as a comma-delimited (',') string.
  - toDelimitedString
```
public static String toDelimitedString(String delimiter,
                                       Object... array)
```
    Returns the array's contents as a string, with each element delimited by the specified delimiter argument. Useful for toString() implementations and log messages.
    
    Parameters:
    
    delimiter - the delimiter to use between each element
    
    array - the array whose contents will be converted to a string
    
    Returns:
    
    a single string, delimited by the specified delimiter.
  - toDelimitedString
```
public static String toDelimitedString(String delimiter,
                                       Collection<?> collection)
```
    Returns the collection's contents as a string, with each element delimited by the specified delimiter argument. Useful for toString() implementations and log messages.
    
    Parameters:
    
    delimiter - the delimiter to use between each element
    
    collection - the collection whose contents will be converted to a string
    
    Returns:
    
    a single string, delimited by the specified delimiter.
  - toDelimitedString
```
public static String toDelimitedString(String separator,
                                       Iterator<?> iterator)
```
    Joins the elements of the provided Iterator into a single String containing the provided elements.
    
    No delimiter is added before or after the list. A null separator is the same as an empty String ("").
    
    Copied from Commons Lang, version 3 (r1138702).
    
    Parameters:
    
    iterator - the Iterator of values to join together, may be null
    
    separator - the separator character to use, null treated as ""
    
    Returns:
    
    the joined String, null if null iterator input
  - tokenizeToStringArray
```
public static String[] tokenizeToStringArray(String str,
                                             String delimiters)
```
    Tokenize the given String into a String array via a StringTokenizer. Trims tokens and omits empty tokens.
    The given delimiters string is supposed to consist of any number of delimiter characters. Each of those characters can be used to separate tokens. A delimiter is always a single character;
    
    Parameters:
    
    str - the String to tokenize
    
    delimiters - the delimiter characters, assembled as String (each of those characters is individually considered as delimiter).
    
    Returns:
    
    an array of the tokens
    
    See Also:
    
    StringTokenizer, String.trim()
  - tokenizeToStringArray
```
public static String[] tokenizeToStringArray(String str,
                                             String delimiters,
                                             boolean trimTokens,
                                             boolean ignoreEmptyTokens)
```
    Tokenize the given String into a String array via a StringTokenizer.
    The given delimiters string is supposed to consist of any number of delimiter characters. Each of those characters can be used to separate tokens. A delimiter is always a single character;
    
    Parameters:
    
    str - the String to tokenize
    
    delimiters - the delimiter characters, assembled as String (each of those characters is individually considered as delimiter)
    
    trimTokens - trim the tokens via String's trim
    
    ignoreEmptyTokens - omit empty tokens from the result array (only applies to tokens that are empty after trimming; StringTokenizer will not consider subsequent delimiters as token in the first place).
    
    Returns:
    
    an array of the tokens (null if the input String was null)
    
    See Also:
    
    StringTokenizer, String.trim()
  - toStringArray
```
public static String[] toStringArray(Collection<String> collection)
```
    Copy the given Collection into a String array.
    
    Parameters:
    
    collection - the Collection to copy
    
    Returns:
    
    the String array (null if the passed-in Collection was null)
  - split
```
public static String[] split(String aLine)
```
    Splits the specified delimited String into tokens, supporting quoted tokens so that quoted strings themselves won't be tokenized. This method uses , as delimiter , " as quote, removes the quotes from the result and trims the values.
    
    Parameters:
    
    aLine - the String to parse
    
    Returns:
    
    the tokens discovered from parsing the given delimited aline.
  - split
```
public static String[] split(String aLine,
                             char delimiter)
```
    Splits the specified delimited String into tokens, supporting quoted tokens so that quoted strings themselves won't be tokenized. This method uses " as quote, removes the quotes from the result and trims the values.
    
    Parameters:
    
    aLine - the String to parse
    
    delimiter - the delimiter by which the line argument is to be split
    
    Returns:
    
    the tokens discovered from parsing the given delimited aline.
  - split
```
public static String[] split(String aLine,
                             char delimiter,
                             char quoteChar)
```
    Splits the specified delimited String into tokens, supporting quoted tokens so that quoted strings themselves won't be tokenized. This method uses the same start as end quote, removes the quotes from the result and trims the values.
    
    Parameters:
    
    aLine - the String to parse
    
    delimiter - the delimiter by which the line argument is to be split
    
    quoteChar - the character signifying the quoted text (start and end) (so the quoted text will not be split)
    
    Returns:
    
    the tokens discovered from parsing the given delimited aline.
  - split
```
public static String[] split(String aLine,
                             char delimiter,
                             char beginQuoteChar,
                             char endQuoteChar)
```
    Splits the specified delimited String into tokens, supporting quoted tokens so that quoted strings themselves won't be tokenized. This method removes the quotes from the result and trims the values.
    
    Parameters:
    
    aLine - the String to parse
    
    delimiter - the delimiter by which the line argument is to be split
    
    beginQuoteChar - the character signifying the start of quoted text (so the quoted text will not be split)
    
    endQuoteChar - the character signifying the end of quoted text
    
    Returns:
    
    the tokens discovered from parsing the given delimited aline.
  - split
```
public static String[] split(String aLine,
                             char delimiter,
                             char beginQuoteChar,
                             char endQuoteChar,
                             boolean retainQuotes,
                             boolean trimTokens)
```
    Splits the specified delimited String into tokens, supporting quoted tokens so that quoted strings themselves won't be tokenized.
    This method's implementation is very loosely based (with significant modifications) on Glen Smith's open-source CSVReader.java file.
    That file is Apache 2.0 licensed as well, making Glen's code a great starting point for us to modify to our needs.
    
    Parameters:
    
    aLine - the String to parse
    
    delimiter - the delimiter by which the line argument is to be split
    
    beginQuoteChar - the character signifying the start of quoted text (so the quoted text will not be split)
    
    endQuoteChar - the character signifying the end of quoted text
    
    retainQuotes - if the quotes themselves should be retained when constructing the corresponding token
    
    trimTokens - if leading and trailing whitespace should be trimmed from discovered tokens.
    
    Returns:
    
    the tokens discovered from parsing the given delimited aline.
  - countOccurrences
```
public static int countOccurrences(String haystack,
                                   char needle)
```
    Count the number of occurrences of a char in the String. When null is passed to String to search, it returns 0.
    
    Parameters:
    
    haystack - The String we like to search
    
    needle - the character to search for.
    
    Returns:
    
    The number of occurrences found.

Class StringUtils

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

EMPTY_STRING

DEFAULT_DELIMITER_CHAR

DEFAULT_QUOTE_CHAR

Method Detail

hasText

isEmpty

isEmpty

hasLength

startsWithIgnoreCase

clean

toDelimitedString

toDelimitedString

toDelimitedString

toDelimitedString

tokenizeToStringArray

tokenizeToStringArray

toStringArray

split

split

split

split

split

countOccurrences