com.uwyn.rife.tools
Class StringUtils

java.lang.Object
  extended by com.uwyn.rife.tools.StringUtils

public abstract class StringUtils
extends Object

General purpose class containing common String manipulation methods.

Since:
1.0
Version:
$Revision: 3634 $
Author:
Geert Bevin (gbevin[remove] at uwyn dot com)

Nested Class Summary
static class StringUtils.BbcodeOption
           
 
Field Summary
static Pattern BBCODE_BAREURL
           
static Pattern BBCODE_COLOR
           
static Pattern BBCODE_IMG
           
static Pattern BBCODE_QUOTE_LONG
           
static Pattern BBCODE_SIZE
           
static Pattern BBCODE_URL_LONG
           
static Pattern BBCODE_URL_SHORT
           
static Charset CHARSET_US_ASCII
           
static StringUtils.BbcodeOption CONVERT_BARE_URLS
           
static String ENCODING_ISO_8859_1
           
static String ENCODING_ISO_8859_2
           
static String ENCODING_ISO_8859_5
           
static String ENCODING_US_ASCII
           
static String ENCODING_UTF_16
           
static String ENCODING_UTF_16BE
           
static String ENCODING_UTF_16LE
           
static String ENCODING_UTF_8
           
static StringUtils.BbcodeOption NO_FOLLOW_LINKS
           
static StringUtils.BbcodeOption SANITIZE_URL
           
static StringUtils.BbcodeOption SHORTEN_URL
           
 
Constructor Summary
StringUtils()
           
 
Method Summary
static String capitalize(String source)
          Ensure that the first character of the provided string is upper case.
static String convertBbcode(String source)
          Converts a BBCode marked-up text to regular html.
static String convertBbcode(String source, StringUtils.BbcodeOption... options)
          Converts a BBCode marked-up text to regular html.
static String convertTabsToSpaces(String line, int tabWidth)
          Converts all tabs on a line to spaces according to the provided tab width.
static boolean convertToBoolean(String value)
          Converts a String to a boolean value.
static int count(String source, String substring)
          Counts the number of times a substring occures in a provided string in a case-sensitive manner.
static int count(String source, String substring, boolean matchCase)
          Counts the number of times a substring occures in a provided string.
static String decodeHtml(String source)
           
static String decodeUrlValue(String source)
          Decodes a String that has been encoded in a RIFE-specific manner for URL usage..
static boolean doesUrlValueNeedDecoding(String source)
          Checks if a String is encoded in a RIFE-specific manner for URL usage.
static String encodeClassname(String name)
          Transforms a provided String object into a new string, containing only valid characters for a java class name.
static String encodeHtml(String source)
          Transforms a provided String object into a new string, containing only valid Html characters.
static String encodeHtmlDefensive(String source)
          Transforms a provided String object into a new string, containing as much as possible Html characters.
static String encodeLatex(String source)
          Transforms a provided String object into a new string, containing only valid LaTeX characters.
static String encodeRegexp(String source)
          Transforms a provided String object into a literal that can be included into a regular expression Pattern as-is.
static String encodeSql(String source)
          Transforms a provided String object into a new string, containing only valid Sql characters.
static String encodeString(String source)
          Transforms a provided String object into a new string, containing only valid String characters.
static String encodeUnicode(String source)
          Transforms a provided String object into a series of unicode escape codes.
static String encodeUrl(String source)
          Transforms a provided String object into a new string, containing only valid URL characters.
static String encodeUrlValue(String source)
          Transforms a provided String object into a new string, only pure US Ascii strings are preserved and URL encoded in a regular way.
static String encodeXml(String source)
          Transforms a provided String object into a new string, containing only valid XML characters.
static boolean filter(String name, Pattern[] included, Pattern[] excluded)
          Checks if the name filters through a series of including and excluding regular expressions.
static boolean filter(String name, Pattern included, Pattern excluded)
          Checks if the name filters through an including and an excluding regular expression.
static DocumentPosition getDocumentPosition(String document, int characterIndex)
          Calculates the DocumentPosition of a character index in a document.
static Matcher getMatchingRegexp(String value, Collection<Pattern> regexps)
          Matches a collection of regular expressions against a string.
static Matcher getRegexpMatch(Collection<String> values, Pattern regexp)
          Matches a collection of strings against a regular expression.
static int[] indicesOf(String source, String substring)
          Returns an array that contains all the occurances of a substring in a string in the correct order.
static int[] indicesOf(String source, String substring, boolean matchCase)
          Returns an array that contains all the occurances of a substring in a string in the correct order.
static String join(boolean[] array, String seperator)
          Creates a new String object, containing the elements of a supplied array, joined by a given seperator.
static String join(byte[] array, String seperator)
          Creates a new String object, containing the elements of a supplied array, joined by a given seperator.
static String join(char[] array, String seperator)
          Creates a new String object, containing the elements of a supplied array, joined by a given seperator.
static String join(char[] array, String seperator, String delimiter)
          Creates a new String object, containing the elements of a supplied array, joined by a given seperator.
static String join(Collection collection, String seperator)
          Creates a new String object, containing the elements of a supplied Collection of String objects joined by a given seperator.
static String join(double[] array, String seperator)
          Creates a new String object, containing the elements of a supplied array, joined by a given seperator.
static String join(float[] array, String seperator)
          Creates a new String object, containing the elements of a supplied array, joined by a given seperator.
static String join(int[] array, String seperator)
          Creates a new String object, containing the elements of a supplied array, joined by a given seperator.
static String join(long[] array, String seperator)
          Creates a new String object, containing the elements of a supplied array, joined by a given seperator.
static String join(Object[] array, String seperator)
          Creates a new String object, containing the elements of a supplied array, joined by a given seperator.
static String join(Object[] array, String seperator, String delimiter)
          Creates a new String object, containing the elements of a supplied array, joined by a given seperator.
static String join(Object[] array, String seperator, String delimiter, boolean encodeStrings)
          Creates a new String object, containing the elements of a supplied array, joined by a given seperator.
static String join(short[] array, String seperator)
          Creates a new String object, containing the elements of a supplied array, joined by a given seperator.
static String repeat(String source, int count)
          Creates a new string that contains the provided string a number of times.
static String replace(String source, String stringToReplace, String replacementString)
          Searches for a string within a specified string in a case-sensitive manner and replaces every match with another string.
static String replace(String source, String stringToReplace, String replacementString, boolean matchCase)
          Searches for a string within a specified string and replaces every match with another string.
static ArrayList<String> split(String source, String seperator)
          Splits a string into different parts, using a seperator string to detect the seperation boundaries in a case-sensitive manner.
static ArrayList<String> split(String source, String seperator, boolean matchCase)
          Splits a string into different parts, using a seperator string to detect the seperation boundaries.
static String[] splitToArray(String source, String seperator)
          Splits a string into different parts, using a seperator string to detect the seperation boundaries in a case-sensitive manner.
static String[] splitToArray(String source, String seperator, boolean matchCase)
          Splits a string into different parts, using a seperator string to detect the seperation boundaries.
static byte[] splitToByteArray(String source, String seperator)
          Splits a string into bytes, using a seperator string to detect the seperation boundaries in a case-sensitive manner.
static byte[] splitToByteArray(String source, String seperator, boolean matchCase)
          Splits a string into bytes, using a seperator string to detect the seperation boundaries.
static int[] splitToIntArray(String source, String seperator)
          Splits a string into integers, using a seperator string to detect the seperation boundaries in a case-sensitive manner.
static int[] splitToIntArray(String source, String seperator, boolean matchCase)
          Splits a string into integers, using a seperator string to detect the seperation boundaries.
static String stripFromEnd(String source, String stringToStrip)
          Removes all occurances of a string from the end of another string in a case-sensitive manner.
static String stripFromEnd(String source, String stringToStrip, boolean matchCase)
          Removes all occurances of a string from the end of another string.
static String stripFromFront(String source, String stringToStrip)
          Removes all occurances of a string from the front of another string in a case-sensitive manner.
static String stripFromFront(String source, String stringToStrip, boolean matchCase)
          Removes all occurances of a string from the front of another string.
static ArrayList<String> toArrayList(String[] stringArray)
          Creates a new ArrayList, containing the elements of a supplied array of String objects.
static String[] toStringArray(Iterator<String> iterator)
          Creates a new array of String objects, containing the elements of a supplied Iterator.
static String trim(String source)
          Ensures that all whitespace is removed from a String.
static String uncapitalize(String source)
          Ensure that the first character of the provided string lower case.
static String wordWrap(String input, int width, Locale locale)
          Reformats a string where lines that are longer than width are split apart at the earliest wordbreak or at maxLength, whichever is sooner.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

ENCODING_US_ASCII

public static String ENCODING_US_ASCII

ENCODING_ISO_8859_1

public static String ENCODING_ISO_8859_1

ENCODING_ISO_8859_2

public static String ENCODING_ISO_8859_2

ENCODING_ISO_8859_5

public static String ENCODING_ISO_8859_5

ENCODING_UTF_8

public static String ENCODING_UTF_8

ENCODING_UTF_16BE

public static String ENCODING_UTF_16BE

ENCODING_UTF_16LE

public static String ENCODING_UTF_16LE

ENCODING_UTF_16

public static String ENCODING_UTF_16

CHARSET_US_ASCII

public static Charset CHARSET_US_ASCII

SHORTEN_URL

public static final StringUtils.BbcodeOption SHORTEN_URL

SANITIZE_URL

public static final StringUtils.BbcodeOption SANITIZE_URL

CONVERT_BARE_URLS

public static final StringUtils.BbcodeOption CONVERT_BARE_URLS

NO_FOLLOW_LINKS

public static final StringUtils.BbcodeOption NO_FOLLOW_LINKS

BBCODE_COLOR

public static final Pattern BBCODE_COLOR

BBCODE_SIZE

public static final Pattern BBCODE_SIZE

BBCODE_URL_SHORT

public static final Pattern BBCODE_URL_SHORT

BBCODE_URL_LONG

public static final Pattern BBCODE_URL_LONG

BBCODE_IMG

public static final Pattern BBCODE_IMG

BBCODE_QUOTE_LONG

public static final Pattern BBCODE_QUOTE_LONG

BBCODE_BAREURL

public static final Pattern BBCODE_BAREURL
Constructor Detail

StringUtils

public StringUtils()
Method Detail

encodeClassname

public static String encodeClassname(String name)
Transforms a provided String object into a new string, containing only valid characters for a java class name.

Parameters:
name - The string that has to be transformed into a valid class name.
Returns:
The encoded String object.
Since:
1.0
See Also:
encodeUrl(String), encodeHtml(String), encodeXml(String), encodeSql(String), encodeLatex(String), encodeRegexp(String)

encodeUrl

public static String encodeUrl(String source)
Transforms a provided String object into a new string, containing only valid URL characters.

Parameters:
source - The string that has to be transformed into a valid URL string.
Returns:
The encoded String object.
Since:
1.0
See Also:
encodeClassname(String), encodeUrlValue(String), encodeHtml(String), encodeXml(String), encodeSql(String), encodeLatex(String), encodeRegexp(String)

encodeUrlValue

public static String encodeUrlValue(String source)
Transforms a provided String object into a new string, only pure US Ascii strings are preserved and URL encoded in a regular way. Strings with characters from other encodings will be encoded in a RIFE-specific manner to allow international data to passed along the query string.

Parameters:
source - The string that has to be transformed into a valid URL parameter string.
Returns:
The encoded String object.
Since:
1.0
See Also:
decodeUrlValue(String), encodeClassname(String), encodeUrl(String), encodeHtml(String), encodeXml(String), encodeSql(String), encodeLatex(String), encodeRegexp(String)

decodeUrlValue

public static String decodeUrlValue(String source)
Decodes a String that has been encoded in a RIFE-specific manner for URL usage.. Before calling this method, you should first verify if the value needs decoding by using the doesUrlValueNeedDecoding(String) method.

Parameters:
source - the value that has been encoded for URL usage in a RIFE-specific way
Returns:
The decoded String object.
Since:
1.0
See Also:
encodeUrlValue(String), doesUrlValueNeedDecoding(String)

doesUrlValueNeedDecoding

public static boolean doesUrlValueNeedDecoding(String source)
Checks if a String is encoded in a RIFE-specific manner for URL usage.

Parameters:
source - the value that might have been encoded for URL usage in a RIFE-specific way
Returns:
true if the value is encoded in the RIFE-specific format; and

false otherwise

Since:
1.0
See Also:
encodeUrlValue(String), decodeUrlValue(String)

decodeHtml

public static String decodeHtml(String source)
Since:
1.6

encodeHtml

public static String encodeHtml(String source)
Transforms a provided String object into a new string, containing only valid Html characters.

Parameters:
source - The string that has to be transformed into a valid Html string.
Returns:
The encoded String object.
Since:
1.0
See Also:
encodeClassname(String), encodeUrl(String), encodeUrlValue(String), encodeXml(String), encodeSql(String), encodeString(String), encodeLatex(String), encodeRegexp(String)

encodeHtmlDefensive

public static String encodeHtmlDefensive(String source)
Transforms a provided String object into a new string, containing as much as possible Html characters. It is safe to already feed existing Html to this method since &, < and > will not be encoded.

Parameters:
source - The string that has to be transformed into a valid Html string.
Returns:
The encoded String object.
Since:
1.0
See Also:
encodeClassname(String), encodeUrl(String), encodeUrlValue(String), encodeXml(String), encodeSql(String), encodeString(String), encodeLatex(String), encodeRegexp(String)

encodeXml

public static String encodeXml(String source)
Transforms a provided String object into a new string, containing only valid XML characters.

Parameters:
source - The string that has to be transformed into a valid XML string.
Returns:
The encoded String object.
Since:
1.0
See Also:
encodeClassname(String), encodeUrl(String), encodeUrlValue(String), encodeHtml(String), encodeSql(String), encodeString(String), encodeLatex(String), encodeRegexp(String)

encodeString

public static String encodeString(String source)
Transforms a provided String object into a new string, containing only valid String characters.

Parameters:
source - The string that has to be transformed into a valid sequence of String characters.
Returns:
The encoded String object.
Since:
1.0
See Also:
encodeClassname(String), encodeUrl(String), encodeUrlValue(String), encodeHtml(String), encodeXml(String), encodeSql(String), encodeLatex(String), encodeRegexp(String)

encodeUnicode

public static String encodeUnicode(String source)
Transforms a provided String object into a series of unicode escape codes.

Parameters:
source - The string that has to be transformed into a valid sequence of unicode escape codes
Returns:
The encoded String object.
Since:
1.0
See Also:
encodeClassname(String), encodeUrl(String), encodeUrlValue(String), encodeHtml(String), encodeXml(String), encodeSql(String), encodeLatex(String), encodeRegexp(String)

encodeSql

public static String encodeSql(String source)
Transforms a provided String object into a new string, containing only valid Sql characters.

Parameters:
source - The string that has to be transformed into a valid Sql string.
Returns:
The encoded String object.
Since:
1.0
See Also:
encodeClassname(String), encodeUrl(String), encodeUrlValue(String), encodeHtml(String), encodeXml(String), encodeString(String), encodeLatex(String), encodeRegexp(String)

encodeLatex

public static String encodeLatex(String source)
Transforms a provided String object into a new string, containing only valid LaTeX characters.

Parameters:
source - The string that has to be transformed into a valid LaTeX string.
Returns:
The encoded String object.
Since:
1.0
See Also:
encodeClassname(String), encodeUrl(String), encodeUrlValue(String), encodeHtml(String), encodeXml(String), encodeSql(String), encodeString(String), encodeRegexp(String)

encodeRegexp

public static String encodeRegexp(String source)
Transforms a provided String object into a literal that can be included into a regular expression Pattern as-is. None of the regular expression escapes in the string will be functional anymore.

Parameters:
source - The string that has to be escaped as a literal
Returns:
The encoded String object.
Since:
1.3
See Also:
encodeClassname(String), encodeUrl(String), encodeUrlValue(String), encodeHtml(String), encodeXml(String), encodeSql(String), encodeString(String), encodeLatex(String)

count

public static int count(String source,
                        String substring)
Counts the number of times a substring occures in a provided string in a case-sensitive manner.

Parameters:
source - The String object that will be searched in.
substring - The string whose occurances will we counted.
Returns:
An int value containing the number of occurances of the substring.
Since:
1.0

count

public static int count(String source,
                        String substring,
                        boolean matchCase)
Counts the number of times a substring occures in a provided string.

Parameters:
source - The String object that will be searched in.
substring - The string whose occurances will we counted.
matchCase - A boolean indicating if the match is going to be performed in a case-sensitive manner or not.
Returns:
An int value containing the number of occurances of the substring.
Since:
1.0

split

public static ArrayList<String> split(String source,
                                      String seperator)
Splits a string into different parts, using a seperator string to detect the seperation boundaries in a case-sensitive manner. The seperator will not be included in the list of parts.

Parameters:
source - The string that will be split into parts.
seperator - The seperator string that will be used to determine the parts.
Returns:
An ArrayList containing the parts as String objects.
Since:
1.0

split

public static ArrayList<String> split(String source,
                                      String seperator,
                                      boolean matchCase)
Splits a string into different parts, using a seperator string to detect the seperation boundaries. The seperator will not be included in the list of parts.

Parameters:
source - The string that will be split into parts.
seperator - The seperator string that will be used to determine the parts.
matchCase - A boolean indicating if the match is going to be performed in a case-sensitive manner or not.
Returns:
An ArrayList containing the parts as String objects.
Since:
1.0

splitToArray

public static String[] splitToArray(String source,
                                    String seperator)
Splits a string into different parts, using a seperator string to detect the seperation boundaries in a case-sensitive manner. The seperator will not be included in the parts array.

Parameters:
source - The string that will be split into parts.
seperator - The seperator string that will be used to determine the parts.
Returns:
A String[] array containing the seperated parts.
Since:
1.0

splitToArray

public static String[] splitToArray(String source,
                                    String seperator,
                                    boolean matchCase)
Splits a string into different parts, using a seperator string to detect the seperation boundaries. The seperator will not be included in the parts array.

Parameters:
source - The string that will be split into parts.
seperator - The seperator string that will be used to determine the parts.
matchCase - A boolean indicating if the match is going to be performed in a case-sensitive manner or not.
Returns:
A String[] array containing the seperated parts.
Since:
1.0

splitToIntArray

public static int[] splitToIntArray(String source,
                                    String seperator)
Splits a string into integers, using a seperator string to detect the seperation boundaries in a case-sensitive manner. If a part couldn't be converted to an integer, it will be omitted from the resulting array.

Parameters:
source - The string that will be split into integers.
seperator - The seperator string that will be used to determine the parts.
Returns:
An int[] array containing the seperated parts.
Since:
1.0

splitToIntArray

public static int[] splitToIntArray(String source,
                                    String seperator,
                                    boolean matchCase)
Splits a string into integers, using a seperator string to detect the seperation boundaries. If a part couldn't be converted to an integer, it will be omitted from the resulting array.

Parameters:
source - The string that will be split into integers.
seperator - The seperator string that will be used to determine the parts.
matchCase - A boolean indicating if the match is going to be performed in a case-sensitive manner or not.
Returns:
An int[] array containing the seperated parts.
Since:
1.0

splitToByteArray

public static byte[] splitToByteArray(String source,
                                      String seperator)
Splits a string into bytes, using a seperator string to detect the seperation boundaries in a case-sensitive manner. If a part couldn't be converted to a byte, it will be omitted from the resulting array.

Parameters:
source - The string that will be split into bytes.
seperator - The seperator string that will be used to determine the parts.
Returns:
A byte[] array containing the bytes.
Since:
1.0

splitToByteArray

public static byte[] splitToByteArray(String source,
                                      String seperator,
                                      boolean matchCase)
Splits a string into bytes, using a seperator string to detect the seperation boundaries. If a part couldn't be converted to a byte, it will be omitted from the resulting array.

Parameters:
source - The string that will be split into bytes.
seperator - The seperator string that will be used to determine the parts.
matchCase - A boolean indicating if the match is going to be performed in a case-sensitive manner or not.
Returns:
A byte[] array containing the bytes.
Since:
1.0

stripFromFront

public static String stripFromFront(String source,
                                    String stringToStrip)
Removes all occurances of a string from the front of another string in a case-sensitive manner.

Parameters:
source - The string in which the matching will be done.
stringToStrip - The string that will be stripped from the front.
Returns:
A new String containing the stripped result.
Since:
1.0

stripFromFront

public static String stripFromFront(String source,
                                    String stringToStrip,
                                    boolean matchCase)
Removes all occurances of a string from the front of another string.

Parameters:
source - The string in which the matching will be done.
stringToStrip - The string that will be stripped from the front.
matchCase - A boolean indicating if the match is going to be performed in a case-sensitive manner or not.
Returns:
A new String containing the stripping result.
Since:
1.0

stripFromEnd

public static String stripFromEnd(String source,
                                  String stringToStrip)
Removes all occurances of a string from the end of another string in a case-sensitive manner.

Parameters:
source - The string in which the matching will be done.
stringToStrip - The string that will be stripped from the end.
Returns:
A new String containing the stripped result.
Since:
1.0

stripFromEnd

public static String stripFromEnd(String source,
                                  String stringToStrip,
                                  boolean matchCase)
Removes all occurances of a string from the end of another string.

Parameters:
source - The string in which the matching will be done.
stringToStrip - The string that will be stripped from the end.
matchCase - A boolean indicating if the match is going to be performed in a case-sensitive manner or not.
Returns:
A new String containing the stripped result.
Since:
1.0

replace

public static String replace(String source,
                             String stringToReplace,
                             String replacementString)
Searches for a string within a specified string in a case-sensitive manner and replaces every match with another string.

Parameters:
source - The string in which the matching parts will be replaced.
stringToReplace - The string that will be searched for.
replacementString - The string that will replace each matching part.
Returns:
A new String object containing the replacement result.
Since:
1.0

replace

public static String replace(String source,
                             String stringToReplace,
                             String replacementString,
                             boolean matchCase)
Searches for a string within a specified string and replaces every match with another string.

Parameters:
source - The string in which the matching parts will be replaced.
stringToReplace - The string that will be searched for.
replacementString - The string that will replace each matching part.
matchCase - A boolean indicating if the match is going to be performed in a case-sensitive manner or not.
Returns:
A new String object containing the replacement result.
Since:
1.0

repeat

public static String repeat(String source,
                            int count)
Creates a new string that contains the provided string a number of times.

Parameters:
source - The string that will be repeated.
count - The number of times that the string will be repeated.
Returns:
A new String object containing the repeated concatenation result.
Since:
1.0

toStringArray

public static String[] toStringArray(Iterator<String> iterator)
Creates a new array of String objects, containing the elements of a supplied Iterator.

Parameters:
iterator - The iterator containing the elements to create the array with.
Returns:
The new String array.
Since:
1.0

toArrayList

public static ArrayList<String> toArrayList(String[] stringArray)
Creates a new ArrayList, containing the elements of a supplied array of String objects.

Parameters:
stringArray - The array of String objects that have to be converted.
Returns:
The new ArrayList with the elements of the String array.
Since:
1.0

join

public static String join(Collection collection,
                          String seperator)
Creates a new String object, containing the elements of a supplied Collection of String objects joined by a given seperator.

Parameters:
collection - The Collection containing the elements to join.
seperator - The seperator used to join the string elements.
Returns:
A new String with the join result.
Since:
1.0

join

public static String join(Object[] array,
                          String seperator)
Creates a new String object, containing the elements of a supplied array, joined by a given seperator.

Parameters:
array - The object array containing the elements to join.
seperator - The seperator used to join the string elements.
Returns:
A new String with the join result.
Since:
1.0

join

public static String join(Object[] array,
                          String seperator,
                          String delimiter)
Creates a new String object, containing the elements of a supplied array, joined by a given seperator.

Parameters:
array - The object array containing the elements to join.
seperator - The seperator used to join the string elements.
delimiter - The delimiter used to surround the string elements.
Returns:
A new String with the join result.
Since:
1.0

join

public static String join(Object[] array,
                          String seperator,
                          String delimiter,
                          boolean encodeStrings)
Creates a new String object, containing the elements of a supplied array, joined by a given seperator.

Parameters:
array - The object array containing the elements to join.
seperator - The seperator used to join the string elements.
delimiter - The delimiter used to surround the string elements.
encodeStrings - Indicates whether the characters of the string representation of the Array values should be encoded.
Returns:
A new String with the join result.
Since:
1.0

join

public static String join(boolean[] array,
                          String seperator)
Creates a new String object, containing the elements of a supplied array, joined by a given seperator.

Parameters:
array - The boolean array containing the values to join.
seperator - The seperator used to join the string elements.
Returns:
A new String with the join result.
Since:
1.0

join

public static String join(byte[] array,
                          String seperator)
Creates a new String object, containing the elements of a supplied array, joined by a given seperator.

Parameters:
array - The byte array containing the values to join.
seperator - The seperator used to join the string elements.
Returns:
A new String with the join result.
Since:
1.0

join

public static String join(double[] array,
                          String seperator)
Creates a new String object, containing the elements of a supplied array, joined by a given seperator.

Parameters:
array - The double array containing the values to join.
seperator - The seperator used to join the string elements.
Returns:
A new String with the join result.
Since:
1.0

join

public static String join(float[] array,
                          String seperator)
Creates a new String object, containing the elements of a supplied array, joined by a given seperator.

Parameters:
array - The float array containing the values to join.
seperator - The seperator used to join the string elements.
Returns:
A new String with the join result.
Since:
1.0

join

public static String join(int[] array,
                          String seperator)
Creates a new String object, containing the elements of a supplied array, joined by a given seperator.

Parameters:
array - The integer array containing the values to join.
seperator - The seperator used to join the string elements.
Returns:
A new String with the join result.
Since:
1.0

join

public static String join(long[] array,
                          String seperator)
Creates a new String object, containing the elements of a supplied array, joined by a given seperator.

Parameters:
array - The long array containing the values to join.
seperator - The seperator used to join the string elements.
Returns:
A new String with the join result.
Since:
1.0

join

public static String join(short[] array,
                          String seperator)
Creates a new String object, containing the elements of a supplied array, joined by a given seperator.

Parameters:
array - The short array containing the values to join.
seperator - The seperator used to join the string elements.
Returns:
A new String with the join result.
Since:
1.0

join

public static String join(char[] array,
                          String seperator)
Creates a new String object, containing the elements of a supplied array, joined by a given seperator.

Parameters:
array - The char array containing the values to join.
seperator - The seperator used to join the string elements.
Returns:
A new String with the join result.
Since:
1.0

join

public static String join(char[] array,
                          String seperator,
                          String delimiter)
Creates a new String object, containing the elements of a supplied array, joined by a given seperator.

Parameters:
array - The char array containing the values to join.
seperator - The seperator used to join the string elements.
delimiter - The delimiter used to surround the string elements.
Returns:
A new String with the join result.
Since:
1.0

indicesOf

public static int[] indicesOf(String source,
                              String substring)
Returns an array that contains all the occurances of a substring in a string in the correct order. The search will be performed in a case-sensitive manner.

Parameters:
source - The String object that will be searched in.
substring - The string whose occurances will we counted.
Returns:
An int[] array containing the indices of the substring.
Since:
1.0

indicesOf

public static int[] indicesOf(String source,
                              String substring,
                              boolean matchCase)
Returns an array that contains all the occurances of a substring in a string in the correct order.

Parameters:
source - The String object that will be searched in.
substring - The string whose occurances will we counted.
matchCase - A boolean indicating if the match is going to be performed in a case-sensitive manner or not.
Returns:
An int[] array containing the indices of the substring.
Since:
1.0

getMatchingRegexp

public static Matcher getMatchingRegexp(String value,
                                        Collection<Pattern> regexps)
Matches a collection of regular expressions against a string.

Parameters:
value - The String that will be checked.
regexps - The collection of regular expressions against which the match will be performed.
Returns:
The Matcher instance that corresponds to the String that returned a successful match; or

null if no match could be found.

Since:
1.0

getRegexpMatch

public static Matcher getRegexpMatch(Collection<String> values,
                                     Pattern regexp)
Matches a collection of strings against a regular expression.

Parameters:
values - The Collection of String objects that will be checked.
regexp - The regular expression Pattern against which the matches will be performed.
Returns:
The Matcher instance that corresponds to the String that returned a successful match; or

null if no match could be found.

Since:
1.0

filter

public static boolean filter(String name,
                             Pattern included,
                             Pattern excluded)
Checks if the name filters through an including and an excluding regular expression.

Parameters:
name - The String that will be filtered.
included - The regular expressions that needs to succeed
excluded - The regular expressions that needs to fail
Returns:
true if the name filtered through correctly; or

false otherwise.

Since:
1.0

filter

public static boolean filter(String name,
                             Pattern[] included,
                             Pattern[] excluded)
Checks if the name filters through a series of including and excluding regular expressions.

Parameters:
name - The String that will be filtered.
included - An array of regular expressions that need to succeed
excluded - An array of regular expressions that need to fail
Returns:
true if the name filtered through correctly; or

false otherwise.

Since:
1.0

capitalize

public static String capitalize(String source)
Ensure that the first character of the provided string is upper case.

Parameters:
source - The String to capitalize.
Returns:
The capitalized String.
Since:
1.0

uncapitalize

public static String uncapitalize(String source)
Ensure that the first character of the provided string lower case.

Parameters:
source - The String to uncapitalize.
Returns:
The uncapitalized String.
Since:
1.5

convertBbcode

public static String convertBbcode(String source)
Converts a BBCode marked-up text to regular html.

Parameters:
source - The text with BBCode tags.
Returns:
A String with the corresponding HTML code
Since:
1.0

convertBbcode

public static String convertBbcode(String source,
                                   StringUtils.BbcodeOption... options)
Converts a BBCode marked-up text to regular html.

Parameters:
source - The text with BBCode tags.
Returns:
A String with the corresponding HTML code
Since:
1.0

convertToBoolean

public static boolean convertToBoolean(String value)
Converts a String to a boolean value.

Parameters:
value - The String to convert.
Returns:
The corresponding boolean value.
Since:
1.0

convertTabsToSpaces

public static String convertTabsToSpaces(String line,
                                         int tabWidth)
Converts all tabs on a line to spaces according to the provided tab width.

Parameters:
line - The line whose tabs have to be converted.
tabWidth - The tab width.
Returns:
A new String object containing the line with the replaced tabs.
Since:
1.0

trim

public static String trim(String source)
Ensures that all whitespace is removed from a String.

It also works with a null argument.

Parameters:
source - The String to trim.
Returns:
The trimmed String.
Since:
1.0

getDocumentPosition

public static DocumentPosition getDocumentPosition(String document,
                                                   int characterIndex)
Calculates the DocumentPosition of a character index in a document.

Parameters:
document - a String with the document where the position should be looked up in
characterIndex - the index of the character
Returns:
the resulting DocumentPosition instance; or

null if the characterIndex was invalid or if the document was null

Since:
1.0

wordWrap

public static String wordWrap(String input,
                              int width,
                              Locale locale)
Reformats a string where lines that are longer than width are split apart at the earliest wordbreak or at maxLength, whichever is sooner. If the width specified is less than 5 or greater than the input Strings length the string will be returned as is.

Please note that this method can be lossy - trailing spaces on wrapped lines may be trimmed.

Parameters:
input - the String to reformat.
width - the maximum length of any one line.
Returns:
a new String with reformatted as needed.


Copyright © 2001-2007 Uwyn sprl/bvba. All Rights Reserved.