org.apache.tools.ant.util
Class StringUtils
java.lang.Object
org.apache.tools.ant.util.StringUtils
public final class StringUtils
extends java.lang.Object
A set of helper methods related to string manipulation.
static String | LINE_SEP - the line separator for this OS
|
static boolean | endsWith(StringBuffer buffer, String suffix) - Checks that a string buffer ends up with a given string.
|
static String | getStackTrace(Throwable t) - Convenient method to retrieve the full stacktrace from a given exception.
|
static Vector | lineSplit(String data) - 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 | replace(String data, String from, String to) - Replace occurrences into a string.
|
static String | resolveBackSlash(String input) - xml does not do "c" like interpretation of strings.
|
static Vector | split(String data, int ch) - Splits up a string where elements are separated by a specific
character and return all elements.
|
LINE_SEP
public static final String LINE_SEP
the line separator for this OS
endsWith
public static boolean endsWith(StringBuffer buffer,
String suffix)
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
buffer
- the buffer to perform the check onsuffix
- the suffix
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 be true
if the argument is the
empty string.
getStackTrace
public static String getStackTrace(Throwable t)
Convenient method to retrieve the full stacktrace from a given exception.
t
- the exception to get the stacktrace from.
- the stacktrace from the given exception.
lineSplit
public static Vector lineSplit(String data)
Splits up a string into a list of lines. It is equivalent
to split(data, '\n').
data
- the string to split up into lines.
- the list of lines available in the string.
parseHumanSizes
public static long parseHumanSizes(String humanSize)
throws Exception
Takes a human readable size representation eg 10K
a long value. Doesn't support 1.1K or other rational values.
- a long value representation
replace
public static String replace(String data,
String from,
String to)
Replace occurrences into a string.
data
- the string to replace occurrences intofrom
- the occurrence to replace.to
- the occurrence to be used as a replacement.
- the new string with replaced occurrences.
resolveBackSlash
public static String resolveBackSlash(String input)
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
input
- raw string with possible embedded '\'s
split
public static Vector split(String data,
int ch)
Splits up a string where elements are separated by a specific
character and return all elements.
data
- the string to split up.ch
- the separator character.