Java org.apache.commons.lang3 StringUtils fields, constructors, methods, implement or subclass

StringUtils instances should NOT be constructed in standard programming.

Abbreviates a String using ellipses.

Abbreviates a String using ellipses.

Abbreviates a String to the length passed, replacing the middle characters with the supplied replacement String.

This abbreviation only occurs if the following criteria is met:

• Neither the String for abbreviation nor the replacement String are null or empty
• The length to truncate to is less than the length of the supplied String
• The length to truncate to is greater than 0
• The abbreviated String will have enough room for the length supplied replacement String and the first and last characters of the supplied String for abbreviation

Otherwise, the returned String will be the same as the supplied String for abbreviation.

Capitalizes a String changing the first letter to title case as per Character#toTitleCase(char) .

Centers a String in a larger String of size size .

Centers a String in a larger String of size size .

Centers a String in a larger String of size size using the space character (' ').

If the size is less than the String length, the String is returned.

Removes separator from the end of str if it's there, otherwise leave it alone.

NOTE: This method changed in version 2.0.

Removes one newline from end of a String if it's there, otherwise leave it alone.

Remove the last character from a String.

If the String ends in \r\n , then remove both of them.

 StringUtils.chop(null)          = null StringUtils.chop("")            = "" StringUtils.chop("abc \r")      = "abc " StringUtils.chop("abc\n")       = "abc" StringUtils.chop("abc\r\n")     = "abc" StringUtils.chop("abc")         = "ab" StringUtils.chop("abc\nabc")    = "abc\nab" StringUtils.chop("a")           = "" StringUtils.chop("\r")          = "" StringUtils.chop("\n")          = "" StringUtils.chop("\r\n")        = "" 

Checks if CharSequence contains a search character, handling null .

Checks if CharSequence contains a search CharSequence, handling null .

Checks if the CharSequence contains any character in the given set of characters.

A null CharSequence will return false .

Checks if the CharSequence contains any character in the given set of characters.

Checks if the CharSequence contains any of the CharSequences in the given array.

A null CharSequence will return false .

Checks if CharSequence contains a search CharSequence irrespective of case, handling null .

Checks that the CharSequence does not contain certain characters.

A null CharSequence will return true .

Checks that the CharSequence does not contain certain characters.

A null CharSequence will return true .

Checks if the CharSequence contains only certain characters.

A null CharSequence will return false .

Checks if the CharSequence contains only certain characters.

A null CharSequence will return false .

Counts how many times the substring appears in the larger string.

A null or empty ("") String input returns 0 .

 StringUtils.countMatches(null, *)       = 0 StringUtils.countMatches("", *)         = 0 StringUtils.countMatches("abba", null)  = 0 StringUtils.countMatches("abba", "")    = 0 StringUtils.countMatches("abba", "a")   = 2 StringUtils.countMatches("abba", "ab")  = 1 StringUtils.countMatches("abba", "xxx") = 0 

Counts how many times the char appears in the given string.

A null or empty ("") String input returns 0 .

 StringUtils.countMatches(null, *)       = 0 StringUtils.countMatches("", *)         = 0 StringUtils.countMatches("abba", 0)  = 0 StringUtils.countMatches("abba", 'a')   = 2 StringUtils.countMatches("abba", 'b')  = 2 StringUtils.countMatches("abba", 'x') = 0 

Returns either the passed in CharSequence, or if the CharSequence is whitespace, empty ("") or null , the value of defaultStr .

 StringUtils.defaultIfBlank(null, "NULL")  = "NULL" StringUtils.defaultIfBlank("", "NULL")    = "NULL" StringUtils.defaultIfBlank(" ", "NULL")   = "NULL" StringUtils.defaultIfBlank("bat", "NULL") = "bat" StringUtils.defaultIfBlank("", null)      = null 

Returns either the passed in CharSequence, or if the CharSequence is empty or null , the value of defaultStr .

 StringUtils.defaultIfEmpty(null, "NULL")  = "NULL" StringUtils.defaultIfEmpty("", "NULL")    = "NULL" StringUtils.defaultIfEmpty(" ", "NULL")   = " " StringUtils.defaultIfEmpty("bat", "NULL") = "bat" StringUtils.defaultIfEmpty("", null)      = null 

Returns either the passed in String, or if the String is null , an empty String ("").

 StringUtils.defaultString(null)  = "" StringUtils.defaultString("")    = "" StringUtils.defaultString("bat") = "bat" 

Returns either the passed in String, or if the String is null , the value of defaultStr .

 StringUtils.defaultString(null, "NULL")  = "NULL" StringUtils.defaultString("", "NULL")    = "" StringUtils.defaultString("bat", "NULL") = "bat" 

Deletes all whitespaces from a String as defined by Character#isWhitespace(char) .

 StringUtils.deleteWhitespace(null)         = null StringUtils.deleteWhitespace("")           = "" StringUtils.deleteWhitespace("abc")        = "abc" StringUtils.deleteWhitespace("   ab  c  ") = "abc" 

Compares two Strings, and returns the portion where they differ.

Check if a CharSequence ends with a specified suffix.

null s are handled without exceptions.

Check if a CharSequence ends with any of an array of specified strings.

 StringUtils.endsWithAny(null, null)      = false StringUtils.endsWithAny(null, new String[] {"abc"})  = false StringUtils.endsWithAny("abcxyz", null)     = false StringUtils.endsWithAny("abcxyz", new String[] {""}) = true StringUtils.endsWithAny("abcxyz", new String[] {"xyz"}) = true StringUtils.endsWithAny("abcxyz", new String[] {null, "xyz", "abc"}) = true 

Case insensitive check if a CharSequence ends with a specified suffix.

null s are handled without exceptions.

Compares two CharSequences, returning true if they represent equal sequences of characters.

null s are handled without exceptions.

Compares two CharSequences, returning true if they represent equal sequences of characters, ignoring case.

null s are handled without exceptions.

Compares all Strings in an array and returns the initial sequence of characters that is common to all of them.

For example, getCommonPrefix(new String[] {"i am a machine", "i am a robot"}) -> "i am a "

 StringUtils.getCommonPrefix(null) = "" StringUtils.getCommonPrefix(new String[] {}) = "" StringUtils.getCommonPrefix(new String[] {"abc"}) = "abc" StringUtils.getCommonPrefix(new String[] {null, null}) = "" StringUtils.getCommonPrefix(new String[] {"", ""}) = "" StringUtils.getCommonPrefix(new String[] {"", null}) = "" StringUtils.getCommonPrefix(new String[] {"abc", null, null}) = "" StringUtils.getCommonPrefix(new String[] {null, null, "abc"}) = "" StringUtils.getCommonPrefix(new String[] {"", "abc"}) = "" StringUtils.getCommonPrefix(new String[] {"abc", ""}) = "" StringUtils.getCommonPrefix(new String[] {"abc", "abc"}) = "abc" StringUtils.getCommonPrefix(new String[] {"abc", "a"}) = "a" StringUtils.getCommonPrefix(new String[] {"ab", "abxyz"}) = "ab" StringUtils.getCommonPrefix(new String[] {"abcde", "abxyz"}) = "ab" StringUtils.getCommonPrefix(new String[] {"abcde", "xyz"}) = "" StringUtils.getCommonPrefix(new String[] {"xyz", "abcde"}) = "" StringUtils.getCommonPrefix(new String[] {"i am a machine", "i am a robot"}) = "i am a " 

Find the Fuzzy Distance which indicates the similarity score between two Strings.

This string matching algorithm is similar to the algorithms of editors such as Sublime Text, TextMate, Atom and others.

Find the Jaro Winkler Distance which indicates the similarity score between two Strings.

The Jaro measure is the weighted sum of percentage of matched characters from each file and transposed characters.

Find the Levenshtein distance between two Strings.

This is the number of changes needed to change one String into another, where each change is a single character modification (deletion, insertion or substitution).

The previous implementation of the Levenshtein distance algorithm was from http://www.merriampark.com/ld.htm

Chas Emerick has written an implementation in Java, which avoids an OutOfMemoryError which can occur when my Java implementation is used with very large strings.
This implementation of the Levenshtein distance algorithm is from http://www.merriampark.com/ldjava.htm

 StringUtils.getLevenshteinDistance(null, *)             = IllegalArgumentException StringUtils.getLevenshteinDistance(*, null)             = IllegalArgumentException StringUtils.getLevenshteinDistance("","")               = 0 StringUtils.getLevenshteinDistance("","a")              = 1 StringUtils.getLevenshteinDistance("aaapppp", "")       = 7 StringUtils.getLevenshteinDistance("frog", "fog")       = 1 StringUtils.getLevenshteinDistance("fly", "ant")        = 3 StringUtils.getLevenshteinDistance("elephant", "hippo") = 7 StringUtils.getLevenshteinDistance("hippo", "elephant") = 7 StringUtils.getLevenshteinDistance("hippo", "zzzzzzzz") = 8 StringUtils.getLevenshteinDistance("hello", "hallo")    = 1 

Find the Levenshtein distance between two Strings if it's less than or equal to a given threshold.

This is the number of changes needed to change one String into another, where each change is a single character modification (deletion, insertion or substitution).

This implementation follows from Algorithms on Strings, Trees and Sequences by Dan Gusfield and Chas Emerick's implementation of the Levenshtein distance algorithm from http://www.merriampark.com/ld.htm

 StringUtils.getLevenshteinDistance(null, *, *)             = IllegalArgumentException StringUtils.getLevenshteinDistance(*, null, *)             = IllegalArgumentException StringUtils.getLevenshteinDistance(*, *, -1)               = IllegalArgumentException StringUtils.getLevenshteinDistance("","", 0)               = 0 StringUtils.getLevenshteinDistance("aaapppp", "", 8)       = 7 StringUtils.getLevenshteinDistance("aaapppp", "", 7)       = 7 StringUtils.getLevenshteinDistance("aaapppp", "", 6))      = -1 StringUtils.getLevenshteinDistance("elephant", "hippo", 7) = 7 StringUtils.getLevenshteinDistance("elephant", "hippo", 6) = -1 StringUtils.getLevenshteinDistance("hippo", "elephant", 7) = 7 StringUtils.getLevenshteinDistance("hippo", "elephant", 6) = -1 

Finds the first index within a CharSequence, handling null .

Finds the first index within a CharSequence, handling null .

Finds the first index within a CharSequence from a start position, handling null .

Finds the first index within a CharSequence, handling null .

Search a CharSequence to find the first index of any character in the given set of characters.

A null String will return -1 .

Search a CharSequence to find the first index of any character in the given set of characters.

A null String will return -1 .

Find the first index of any of a set of potential substrings.

A null CharSequence will return -1 .

Searches a CharSequence to find the first index of any character not in the given set of characters.

A null CharSequence will return -1 .

Search a CharSequence to find the first index of any character not in the given set of characters.

A null CharSequence will return -1 .

Compares two CharSequences, and returns the index at which the CharSequences begin to differ.

For example, indexOfDifference("i am a machine", "i am a robot") -> 7

 StringUtils.indexOfDifference(null, null) = -1 StringUtils.indexOfDifference("", "") = -1 StringUtils.indexOfDifference("", "abc") = 0 StringUtils.indexOfDifference("abc", "") = 0 StringUtils.indexOfDifference("abc", "abc") = -1 StringUtils.indexOfDifference("ab", "abxyz") = 2 StringUtils.indexOfDifference("abcde", "abxyz") = 2 StringUtils.indexOfDifference("abcde", "xyz") = 0 

Case in-sensitive find of the first index within a CharSequence.

A null CharSequence will return -1 .

Case in-sensitive find of the first index within a CharSequence from the specified position.

A null CharSequence will return -1 .

Checks if the CharSequence contains only lowercase characters.

null will return false .

Checks if the CharSequence contains only uppercase characters.

null will return false .

Checks if the CharSequence contains only Unicode letters.

null will return false .

Checks if the CharSequence contains only Unicode letters or digits.

null will return false .

Checks if the CharSequence contains only Unicode letters, digits or space ( ' ' ).

null will return false .

Checks if the CharSequence contains only Unicode letters and space (' ').

null will return false An empty CharSequence (length()=0) will return true .

 StringUtils.isAlphaSpace(null)   = false StringUtils.isAlphaSpace("")     = true StringUtils.isAlphaSpace("  ")   = true StringUtils.isAlphaSpace("abc")  = true StringUtils.isAlphaSpace("ab c") = true StringUtils.isAlphaSpace("ab2c") = false StringUtils.isAlphaSpace("ab-c") = false 

Checks if any one of the CharSequences are blank ("") or null and not whitespace only..

 StringUtils.isAnyBlank(null)             = true StringUtils.isAnyBlank(null, "foo")      = true StringUtils.isAnyBlank(null, null)       = true StringUtils.isAnyBlank("", "bar")        = true StringUtils.isAnyBlank("bob", "")        = true StringUtils.isAnyBlank("  bob  ", null)  = true StringUtils.isAnyBlank(" ", "bar")       = true StringUtils.isAnyBlank("foo", "bar")     = false 

Checks if any one of the CharSequences are empty ("") or null.

 StringUtils.isAnyEmpty(null)             = true StringUtils.isAnyEmpty(null, "foo")      = true StringUtils.isAnyEmpty("", "bar")        = true StringUtils.isAnyEmpty("bob", "")        = true StringUtils.isAnyEmpty("  bob  ", null)  = true StringUtils.isAnyEmpty(" ", "bar")       = false StringUtils.isAnyEmpty("foo", "bar")     = false 

Checks if the CharSequence contains only ASCII printable characters.

null will return false .

Checks if a CharSequence is whitespace, empty ("") or null.

 StringUtils.isBlank(null)      = true StringUtils.isBlank("")        = true StringUtils.isBlank(" ")       = true StringUtils.isBlank("bob")     = false StringUtils.isBlank("  bob  ") = false 

Checks if a CharSequence is empty ("") or null.

 StringUtils.isEmpty(null)      = true StringUtils.isEmpty("")        = true StringUtils.isEmpty(" ")       = false StringUtils.isEmpty("bob")     = false StringUtils.isEmpty("  bob  ") = false 

NOTE: This method changed in Lang version 2.0.

Checks if none of the CharSequences are blank ("") or null and whitespace only..

 StringUtils.isNoneBlank(null)             = false StringUtils.isNoneBlank(null, "foo")      = false StringUtils.isNoneBlank(null, null)       = false StringUtils.isNoneBlank("", "bar")        = false StringUtils.isNoneBlank("bob", "")        = false StringUtils.isNoneBlank("  bob  ", null)  = false StringUtils.isNoneBlank(" ", "bar")       = false StringUtils.isNoneBlank("foo", "bar")     = true 

Checks if none of the CharSequences are empty ("") or null.

 StringUtils.isNoneEmpty(null)             = false StringUtils.isNoneEmpty(null, "foo")      = false StringUtils.isNoneEmpty("", "bar")        = false StringUtils.isNoneEmpty("bob", "")        = false StringUtils.isNoneEmpty("  bob  ", null)  = false StringUtils.isNoneEmpty(" ", "bar")       = true StringUtils.isNoneEmpty("foo", "bar")     = true 

Checks if a CharSequence is not empty (""), not null and not whitespace only.

 StringUtils.isNotBlank(null)      = false StringUtils.isNotBlank("")        = false StringUtils.isNotBlank(" ")       = false StringUtils.isNotBlank("bob")     = true StringUtils.isNotBlank("  bob  ") = true 

Checks if a CharSequence is not empty ("") and not null.

 StringUtils.isNotEmpty(null)      = false StringUtils.isNotEmpty("")        = false StringUtils.isNotEmpty(" ")       = true StringUtils.isNotEmpty("bob")     = true StringUtils.isNotEmpty("  bob  ") = true 

Checks if the CharSequence contains only Unicode digits.

Checks if the CharSequence contains only Unicode digits or space ( ' ' ).

Checks if the CharSequence contains only whitespace.

null will return false .

Joins the elements of the provided array into a single String containing the provided list of elements.

No delimiter is added before or after the list.

Joins the elements of the provided array into a single String containing the provided list of elements.

Joins the elements of the provided array into a single String containing the provided list of elements.

Joins the elements of the provided array into a single String containing the provided list of elements.

Joins the elements of the provided array into a single String containing the provided list of elements.

Joins the elements of the provided array into a single String containing the provided list of elements.

Joins the elements of the provided array into a single String containing the provided list of elements.

Joins the elements of the provided array into a single String containing the provided list of elements.

Joins the elements of the provided array into a single String containing the provided list of elements.

No delimiter is added before or after the list.

Joins the elements of the provided Iterator into a single String containing the provided elements.

No delimiter is added before or after the list.

Joins the elements of the provided Iterator into a single String containing the provided elements.

No delimiter is added before or after the list.

Joins the elements of the provided Iterable into a single String containing the provided elements.

No delimiter is added before or after the list.

Joins the elements of the provided Iterable into a single String containing the provided elements.

No delimiter is added before or after the list.

Joins the elements of the provided array into a single String containing the provided list of elements.

No delimiter is added before or after the list.

Joins the elements of the provided array into a single String containing the provided list of elements.

Joins the elements of the provided array into a single String containing the provided list of elements.

Joins the elements of the provided array into a single String containing the provided list of elements.

Joins the elements of the provided array into a single String containing the provided list of elements.

Joins the elements of the provided array into a single String containing the provided list of elements.

Joins the elements of the provided array into a single String containing the provided list of elements.

Joins the elements of the provided array into a single String containing the provided list of elements.

Joins the elements of the provided array into a single String containing the provided list of elements.

No delimiter is added before or after the list.

Joins the elements of the provided array into a single String containing the provided list of elements.

No separator is added to the joined String.

Finds the last index within a CharSequence, handling null .

Finds the last index within a CharSequence, handling null .

Finds the last index within a CharSequence from a start position, handling null .

Finds the last index within a CharSequence, handling null .

Case in-sensitive find of the last index within a CharSequence.

A null CharSequence will return -1 .

Finds the n-th last index within a String, handling null .

Gets the leftmost len characters of a String.

If len characters are not available, or the String is null , the String will be returned without an exception.

Left pad a String with a specified character.

Pad to a size of size .

 StringUtils.leftPad(null, *, *)     = null StringUtils.leftPad("", 3, 'z')     = "zzz" StringUtils.leftPad("bat", 3, 'z')  = "bat" StringUtils.leftPad("bat", 5, 'z')  = "zzbat" StringUtils.leftPad("bat", 1, 'z')  = "bat" StringUtils.leftPad("bat", -1, 'z') = "bat" 

Left pad a String with a specified String.

Pad to a size of size .

 StringUtils.leftPad(null, *, *)      = null StringUtils.leftPad("", 3, "z")      = "zzz" StringUtils.leftPad("bat", 3, "yz")  = "bat" StringUtils.leftPad("bat", 5, "yz")  = "yzbat" StringUtils.leftPad("bat", 8, "yz")  = "yzyzybat" StringUtils.leftPad("bat", 1, "yz")  = "bat" StringUtils.leftPad("bat", -1, "yz") = "bat" StringUtils.leftPad("bat", 5, null)  = "  bat" StringUtils.leftPad("bat", 5, "")    = "  bat" 

Left pad a String with spaces (' ').

The String is padded to the size of size .

 StringUtils.leftPad(null, *)   = null StringUtils.leftPad("", 3)     = "   " StringUtils.leftPad("bat", 3)  = "bat" StringUtils.leftPad("bat", 5)  = "  bat" StringUtils.leftPad("bat", 1)  = "bat" StringUtils.leftPad("bat", -1) = "bat" 

Converts a String to lower case as per String#toLowerCase() .

A null input String returns null .

 StringUtils.lowerCase(null)  = null StringUtils.lowerCase("")    = "" StringUtils.lowerCase("aBc") = "abc" 

Note: As described in the documentation for String#toLowerCase() , the result of this method is affected by the current locale.

Converts a String to lower case as per String#toLowerCase(Locale) .

A null input String returns null .

 StringUtils.lowerCase(null, Locale.ENGLISH)  = null StringUtils.lowerCase("", Locale.ENGLISH)    = "" StringUtils.lowerCase("aBc", Locale.ENGLISH) = "abc" 

Gets len characters from the middle of a String.

If len characters are not available, the remainder of the String will be returned without an exception.

Similar to http://www.w3.org/TR/xpath/#function-normalize -space

The function returns the argument string with whitespace normalized by using #trim(String) to remove leading and trailing whitespace and then replacing sequences of whitespace characters by a single space.

Finds the n-th index within a CharSequence, handling null .

Overlays part of a String with another String.

A null string input returns null .

Removes all occurrences of a substring from within the source string.

A null source string will return null .

Removes all occurrences of a character from within the source string.

A null source string will return null .

Removes a substring only if it is at the end of a source string, otherwise returns the source string.

A null source string will return null .

Case insensitive removal of a substring if it is at the end of a source string, otherwise returns the source string.

A null source string will return null .

Removes a substring only if it is at the beginning of a source string, otherwise returns the source string.

A null source string will return null .

Case insensitive removal of a substring if it is at the beginning of a source string, otherwise returns the source string.

A null source string will return null .

Repeat a String repeat times to form a new String.

 StringUtils.repeat(null, 2) = null StringUtils.repeat("", 0)   = "" StringUtils.repeat("", 2)   = "" StringUtils.repeat("a", 3)  = "aaa" StringUtils.repeat("ab", 2) = "abab" StringUtils.repeat("a", -2) = "" 

Returns padding using the specified delimiter repeated to a given length.

 StringUtils.repeat('e', 0)  = "" StringUtils.repeat('e', 3)  = "eee" StringUtils.repeat('e', -2) = "" 

Note: this method doesn't not support padding with Unicode Supplementary Characters as they require a pair of char s to be represented.

Repeat a String repeat times to form a new String, with a String separator injected each time.

Replaces all occurrences of a String within another String.

A null reference passed to this method is a no-op.

 StringUtils.replace(null, *, *)        = null StringUtils.replace("", *, *)          = "" StringUtils.replace("any", null, *)    = "any" StringUtils.replace("any", *, null)    = "any" StringUtils.replace("any", "", *)      = "any" StringUtils.replace("aba", "a", null)  = "aba" StringUtils.replace("aba", "a", "")    = "b" StringUtils.replace("aba", "a", "z")   = "zbz" 

Replaces a String with another String inside a larger String, for the first max values of the search String.

A null reference passed to this method is a no-op.

 StringUtils.replace(null, *, *, *)         = null StringUtils.replace("", *, *, *)           = "" StringUtils.replace("any", null, *, *)     = "any" StringUtils.replace("any", *, null, *)     = "any" StringUtils.replace("any", "", *, *)       = "any" StringUtils.replace("any", *, *, 0)        = "any" StringUtils.replace("abaa", "a", null, -1) = "abaa" StringUtils.replace("abaa", "a", "", -1)   = "b" StringUtils.replace("abaa", "a", "z", 0)   = "abaa" StringUtils.replace("abaa", "a", "z", 1)   = "zbaa" StringUtils.replace("abaa", "a", "z", 2)   = "zbza" StringUtils.replace("abaa", "a", "z", -1)  = "zbzz" 

Replaces all occurrences of a character in a String with another.

Replaces multiple characters in a String in one go.

Replaces all occurrences of Strings within another String.

Replaces all occurrences of Strings within another String.

Replaces a String with another String inside a larger String, once.

A null reference passed to this method is a no-op.

 StringUtils.replaceOnce(null, *, *)        = null StringUtils.replaceOnce("", *, *)          = "" StringUtils.replaceOnce("any", null, *)    = "any" StringUtils.replaceOnce("any", *, null)    = "any" StringUtils.replaceOnce("any", "", *)      = "any" StringUtils.replaceOnce("aba", "a", null)  = "aba" StringUtils.replaceOnce("aba", "a", "")    = "ba" StringUtils.replaceOnce("aba", "a", "z")   = "zba" 

Reverses a String as per StringBuilder#reverse() .

A null String returns null .

 StringUtils.reverse(null)  = null StringUtils.reverse("")    = "" StringUtils.reverse("bat") = "tab" 

Reverses a String that is delimited by a specific character.

The Strings between the delimiters are not reversed.

Gets the rightmost len characters of a String.

If len characters are not available, or the String is null , the String will be returned without an an exception.

Right pad a String with a specified character.

The String is padded to the size of size .

 StringUtils.rightPad(null, *, *)     = null StringUtils.rightPad("", 3, 'z')     = "zzz" StringUtils.rightPad("bat", 3, 'z')  = "bat" StringUtils.rightPad("bat", 5, 'z')  = "batzz" StringUtils.rightPad("bat", 1, 'z')  = "bat" StringUtils.rightPad("bat", -1, 'z') = "bat" 

Right pad a String with a specified String.

The String is padded to the size of size .

 StringUtils.rightPad(null, *, *)      = null StringUtils.rightPad("", 3, "z")      = "zzz" StringUtils.rightPad("bat", 3, "yz")  = "bat" StringUtils.rightPad("bat", 5, "yz")  = "batyz" StringUtils.rightPad("bat", 8, "yz")  = "batyzyzy" StringUtils.rightPad("bat", 1, "yz")  = "bat" StringUtils.rightPad("bat", -1, "yz") = "bat" StringUtils.rightPad("bat", 5, null)  = "bat  " StringUtils.rightPad("bat", 5, "")    = "bat  " 

Right pad a String with spaces (' ').

The String is padded to the size of size .

 StringUtils.rightPad(null, *)   = null StringUtils.rightPad("", 3)     = "   " StringUtils.rightPad("bat", 3)  = "bat" StringUtils.rightPad("bat", 5)  = "bat  " StringUtils.rightPad("bat", 1)  = "bat" StringUtils.rightPad("bat", -1) = "bat" 

Splits the provided text into an array, separator specified.

Splits the provided text into an array, separators specified.

Splits the provided text into an array, using whitespace as the separator.

Splits the provided text into an array with a maximum length, separators specified.

The separator is not included in the returned String array.

Splits a String by Character type as returned by java.lang.Character.getType(char) .

Splits a String by Character type as returned by java.lang.Character.getType(char) .

Splits the provided text into an array, separator string specified.

The separator(s) will not be included in the returned String array.

Splits the provided text into an array, separator string specified.

Splits the provided text into an array, separator string specified.

Splits the provided text into an array, separator string specified.

Splits the provided text into an array, separator specified, preserving all tokens, including empty tokens created by adjacent separators.

Splits the provided text into an array, separators specified, preserving all tokens, including empty tokens created by adjacent separators.

Splits the provided text into an array with a maximum length, separators specified, preserving all tokens, including empty tokens created by adjacent separators.

The separator is not included in the returned String array.

Splits the provided text into an array, using whitespace as the separator, preserving all tokens, including empty tokens created by adjacent separators.

Check if a CharSequence starts with a specified prefix.

null s are handled without exceptions.

Check if a CharSequence starts with any of an array of specified strings.

 StringUtils.startsWithAny(null, null)      = false StringUtils.startsWithAny(null, new String[] {"abc"})  = false StringUtils.startsWithAny("abcxyz", null)     = false StringUtils.startsWithAny("abcxyz", new String[] {""}) = false StringUtils.startsWithAny("abcxyz", new String[] {"abc"}) = true StringUtils.startsWithAny("abcxyz", new String[] {null, "xyz", "abc"}) = true 

Case insensitive check if a CharSequence starts with a specified prefix.

null s are handled without exceptions.

Strips whitespace from the start and end of a String.

This is similar to #trim(String) but removes whitespace.

Strips any of a set of characters from the start and end of a String.

Removes diacritics (~= accents) from a string.

Strips whitespace from the start and end of every String in an array.

Strips any of a set of characters from the start and end of every String in an array.

Whitespace is defined by Character#isWhitespace(char) .

A new array is returned each time, except for length zero.

Strips any of a set of characters from the end of a String.

A null input String returns null .

Strips any of a set of characters from the start of a String.

A null input String returns null .

Strips whitespace from the start and end of a String returning an empty String if null input.

This is similar to #trimToEmpty(String) but removes whitespace.

Strips whitespace from the start and end of a String returning null if the String is empty ("") after the strip.

This is similar to #trimToNull(String) but removes whitespace.

Gets a substring from the specified String avoiding exceptions.

A negative start position can be used to start n characters from the end of the String.

A null String will return null .

Gets a substring from the specified String avoiding exceptions.

A negative start position can be used to start/end n characters from the end of the String.

The returned substring starts with the character in the start position and ends before the end position.

Gets the substring after the first occurrence of a separator.

Gets the substring after the last occurrence of a separator.

Gets the substring before the first occurrence of a separator.

Gets the substring before the last occurrence of a separator.

Gets the String that is nested in between two Strings.

Gets the String that is nested in between two instances of the same String.

A null input String returns null .

Searches a String for substrings delimited by a start and end tag, returning all matching substrings in an array.

A null input String returns null .

Swaps the case of a String changing upper and title case to lower case, and lower case to upper case.

• Upper case character converts to Lower case
• Title case character converts to Lower case
• Lower case character converts to Upper case

For a word based algorithm, see org.apache.commons.lang3.text.WordUtils#swapCase(String) .

Removes control characters (char <= 32) from both ends of this String, handling null by returning null .

The String is trimmed using String#trim() .

Removes control characters (char <= 32) from both ends of this String returning an empty String ("") if the String is empty ("") after the trim or if it is null .

Removes control characters (char <= 32) from both ends of this String returning null if the String is empty ("") after the trim or if it is null .

Uncapitalizes a String, changing the first letter to lower case as per Character#toLowerCase(char) .

Converts a String to upper case as per String#toUpperCase() .

A null input String returns null .

 StringUtils.upperCase(null)  = null StringUtils.upperCase("")    = "" StringUtils.upperCase("aBc") = "ABC" 

Note: As described in the documentation for String#toUpperCase() , the result of this method is affected by the current locale.

Converts a String to upper case as per String#toUpperCase(Locale) .

A null input String returns null .

 StringUtils.upperCase(null, Locale.ENGLISH)  = null StringUtils.upperCase("", Locale.ENGLISH)    = "" StringUtils.upperCase("aBc", Locale.ENGLISH) = "ABC" 

Wraps a string with a char.

Wraps a String with another String.