Package org.apache.tools.ant.util
Class StringUtils
java.lang.Object
org.apache.tools.ant.util.StringUtils
A set of helper methods related to string manipulation.
-
Field Summary
-
Method Summary
Modifier and TypeMethodDescriptionstatic boolean
endsWith
(StringBuffer buffer, String suffix) Checks that a string buffer ends up with a given string.static String
Convenient method to retrieve the full stacktrace from a given exception.static String
join
(Object[] array, CharSequence separator) Joins the string representation of the elements of an array to a joined string with a given separator.static String
join
(Collection<?> collection, CharSequence separator) Joins the string representation of the elements of a collection to a joined string with a given separator.Splits up a string into a list of lines.static long
parseHumanSizes
(String humanSize) Takes a human readable size representation eg 10K a long value.static String
removePrefix
(String string, String prefix) Removes the prefix from a given string, if the string contains that prefix.static String
removeSuffix
(String string, String suffix) Removes the suffix from a given string, if the string contains that suffix.static String
Deprecated.static String
resolveBackSlash
(String input) xml does not do "c" like interpretation of strings.Splits up a string where elements are separated by a specific character and return all elements.static String
trimToNull
(String inputString)
-
Field Details
-
LINE_SEP
-
-
Method Details
-
lineSplit
-
split
-
replace
Deprecated.Replace occurrences into a string.- Parameters:
data
- the string to replace occurrences intofrom
- the occurrence to replace.to
- the occurrence to be used as a replacement.- Returns:
- the new string with replaced occurrences.
-
getStackTrace
-
endsWith
Checks that a string buffer ends up with a given string. It may sound trivial with the existing JDK API but the various implementation among JDKs can make those methods extremely resource intensive and perform poorly due to massive memory allocation and copying. See- Parameters:
buffer
- the buffer to perform the check onsuffix
- the suffix- Returns:
true
if the character sequence represented by the argument is a suffix of the character sequence represented by the StringBuffer object;false
otherwise. Note that the result will betrue
if the argument is the empty string.
-
resolveBackSlash
xml does not do "c" like interpretation of strings. i.e. \n\r\t etc. this method processes \n, \r, \t, \f, \\ also subs \s -> " \n\r\t\f" a trailing '\' will be ignored- Parameters:
input
- raw string with possible embedded '\'s- Returns:
- converted string
- Since:
- Ant 1.7
-
parseHumanSizes
Takes a human readable size representation eg 10K a long value. Doesn't support 1.1K or other rational values.- Parameters:
humanSize
- the amount as a human readable string.- Returns:
- a long value representation
- Throws:
Exception
- if there is a problem.- Since:
- Ant 1.7
-
removeSuffix
-
removePrefix
-
join
Joins the string representation of the elements of a collection to a joined string with a given separator.- Parameters:
collection
- Collection of the data to be joined (may be null)separator
- Separator between elements (may be null)- Returns:
- the joined string
-
join
Joins the string representation of the elements of an array to a joined string with a given separator.- Parameters:
array
- Array of the data to be joined (may be null)separator
- Separator between elements (may be null)- Returns:
- the joined string
-
trimToNull
-
String.replace(CharSequence, CharSequence)
now.