public class StringUtils extends Object
Modifier and Type | Field and Description |
---|---|
static String[] |
EMPTY_STRING_ARRAY
An empty immutable
String array. |
Modifier and Type | Method and Description |
---|---|
static String |
deleteCharAndChangeNextCharToUpperCase(String psWord,
String psReplace)
This method provided a way to delete the given string and change the
following first character to capital letter, this is provided because
Axis 1.x follow the java naming convenation rather then xml naming convention
for there local name.
|
static String |
escapeNumericChar(String str)
write the escaped version of a given string
|
static void |
escapeNumericChar(Writer out,
String str)
write the escaped version of a given string
|
static boolean |
isEmpty(String str)
Checks if a String is empty ("") or null.
|
static String |
makeQNameToMatchLocalName(String str)
This method provides a way to convert the a QName to local name.
|
static String[] |
split(String str,
char separatorChar)
Splits the provided text into an array, separator specified.
|
static boolean |
startsWithIgnoreWhitespaces(String prefix,
String string)
Tests if this string starts with the specified prefix (Ignoring whitespaces)
|
static String |
strip(String str)
Strips whitespace from the start and end of a String.
|
static String |
strip(String str,
String stripChars)
Strips any of a set of characters from the start and end of a String.
|
static String |
stripEnd(String str,
String stripChars)
Strips any of a set of characters from the end of a String.
|
static String |
stripStart(String str,
String stripChars)
Strips any of a set of characters from the start of a String.
|
static String |
unescapeNumericChar(String str)
Unescapes numeric character referencs found in the
String . |
static void |
unescapeNumericChar(Writer out,
String str)
Unescapes numeric character references found in the
String to a
Writer . |
public static final String[] EMPTY_STRING_ARRAY
String
array.public static boolean startsWithIgnoreWhitespaces(String prefix, String string)
prefix
- string
- public static String[] split(String str, char separatorChar)
Splits the provided text into an array, separator specified. This is an alternative to using StringTokenizer.
The separator is not included in the returned String array. Adjacent separators are treated as one separator.
A null
input String returns null
.
StringUtils.split(null, *) = null StringUtils.split("", *) = [] StringUtils.split("a.b.c", '.') = ["a", "b", "c"] StringUtils.split("a..b.c", '.') = ["a", "b", "c"] StringUtils.split("a:b:c", '.') = ["a:b:c"] StringUtils.split("a\tb\nc", null) = ["a", "b", "c"] StringUtils.split("a b c", ' ') = ["a", "b", "c"]
str
- the String to parse, may be nullseparatorChar
- the character used as the delimiter,
null
splits on whitespacenull
if null String inputpublic static boolean isEmpty(String str)
Checks if a String 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. It no longer trims the String. That functionality is available in isBlank().
str
- the String to check, may be nulltrue
if the String is empty or nullpublic static String strip(String str)
Strips whitespace from the start and end of a String.
This removes whitespace. Whitespace is defined by
Character.isWhitespace(char)
.
A null
input String returns null
.
StringUtils.strip(null) = null StringUtils.strip("") = "" StringUtils.strip(" ") = "" StringUtils.strip("abc") = "abc" StringUtils.strip(" abc") = "abc" StringUtils.strip("abc ") = "abc" StringUtils.strip(" abc ") = "abc" StringUtils.strip(" ab c ") = "ab c"
str
- the String to remove whitespace from, may be nullnull
if null String inputpublic static String strip(String str, String stripChars)
Strips any of a set of characters from the start and end of a String.
This is similar to String.trim()
but allows the characters
to be stripped to be controlled.
A null
input String returns null
.
An empty string ("") input returns the empty string.
If the stripChars String is null
, whitespace is
stripped as defined by Character.isWhitespace(char)
.
Alternatively use strip(String)
.
StringUtils.strip(null, *) = null StringUtils.strip("", *) = "" StringUtils.strip("abc", null) = "abc" StringUtils.strip(" abc", null) = "abc" StringUtils.strip("abc ", null) = "abc" StringUtils.strip(" abc ", null) = "abc" StringUtils.strip(" abcyx", "xyz") = " abc"
str
- the String to remove characters from, may be nullstripChars
- the characters to remove, null treated as whitespacenull
if null String inputpublic static String stripStart(String str, String stripChars)
Strips any of a set of characters from the start of a String.
A null
input String returns null
.
An empty string ("") input returns the empty string.
If the stripChars String is null
, whitespace is
stripped as defined by Character.isWhitespace(char)
.
StringUtils.stripStart(null, *) = null StringUtils.stripStart("", *) = "" StringUtils.stripStart("abc", "") = "abc" StringUtils.stripStart("abc", null) = "abc" StringUtils.stripStart(" abc", null) = "abc" StringUtils.stripStart("abc ", null) = "abc " StringUtils.stripStart(" abc ", null) = "abc " StringUtils.stripStart("yxabc ", "xyz") = "abc "
str
- the String to remove characters from, may be nullstripChars
- the characters to remove, null treated as whitespacenull
if null String inputpublic static String stripEnd(String str, String stripChars)
Strips any of a set of characters from the end of a String.
A null
input String returns null
.
An empty string ("") input returns the empty string.
If the stripChars String is null
, whitespace is
stripped as defined by Character.isWhitespace(char)
.
StringUtils.stripEnd(null, *) = null StringUtils.stripEnd("", *) = "" StringUtils.stripEnd("abc", "") = "abc" StringUtils.stripEnd("abc", null) = "abc" StringUtils.stripEnd(" abc", null) = " abc" StringUtils.stripEnd("abc ", null) = "abc" StringUtils.stripEnd(" abc ", null) = " abc" StringUtils.stripEnd(" abcyx", "xyz") = " abc"
str
- the String to remove characters from, may be nullstripChars
- the characters to remove, null treated as whitespacenull
if null String inputpublic static String escapeNumericChar(String str)
str
- string to be encodedString
, null
if null string inputpublic static void escapeNumericChar(Writer out, String str) throws IOException
out
- writer to write this string tostr
- string to be encodedIOException
public static String makeQNameToMatchLocalName(String str)
This method provides a way to convert the a QName to local name. This need to be done is because Axis 1.x follow the java naming convetation for local name rather then xml naming convenation for the local name.
A null
input String returns null
.
makeQNameToMatchLocalName("Foo.bar") = fooBar makeQNameToMatchLocalName("Foo.Bar") = fooBar makeQNameToMatchLocalName("FooBar") = fooBar makeQNameToMatchLocalName("Foobar") = fooBar makeQNameToMatchLocalName("fooBar") = fooBar makeQNameToMatchLocalName("foobar") = foobar makeQNameToMatchLocalName("Foo:bar") = fooBar makeQNameToMatchLocalName("Foo-Bar") = fooBar makeQNameToMatchLocalName("Foo-bar") = fooBar makeQNameToMatchLocalName("Foo_bar") = foo_bar makeQNameToMatchLocalName("Foo_Bar") = foo_Bar makeQNameToMatchLocalName("foo:bar") = fooBar
str
- the String to parse, may be null
null
splits on whitespacepublic static String deleteCharAndChangeNextCharToUpperCase(String psWord, String psReplace)
This method provided a way to delete the given string and change the following first character to capital letter, this is provided because Axis 1.x follow the java naming convenation rather then xml naming convention for there local name.
A null
input String returns null
.
deleteCharAndChangeNextCharToUpperCase("Foo.bar") = fooBar deleteCharAndChangeNextCharToUpperCase("Foo.Bar") = fooBar deleteCharAndChangeNextCharToUpperCase("Foo:bar") = fooBar deleteCharAndChangeNextCharToUpperCase("Foo-Bar") = fooBar deleteCharAndChangeNextCharToUpperCase("Foo-bar") = fooBar deleteCharAndChangeNextCharToUpperCase("Foo_bar") = foo_bar deleteCharAndChangeNextCharToUpperCase("Foo_Bar") = foo_Bar deleteCharAndChangeNextCharToUpperCase("Foo_bar") = foo_bar deleteCharAndChangeNextCharToUpperCase("foo:bar") = fooBar
psWord
- the String to be changed
return null
if null passed.psReplace
- the String that need to be eliminated,
return null or psWord if psWord is not null
if null passed.public static String unescapeNumericChar(String str)
Unescapes numeric character referencs found in the String
.
For example, it will return a unicode string which means the specified numeric character references looks like "ようこそ".
str
- the String
to unescape, may be nullString
, null
if null string inputpublic static void unescapeNumericChar(Writer out, String str) throws IOException
Unescapes numeric character references found in the String
to a
Writer
.
For example, it will return a unicode string which means the specified numeric character references looks like "ようこそ".
A null
string input has no effect.
out
- the Writer
used to output unescaped charactersstr
- the String
to unescape, may be nullIllegalArgumentException
- if the Writer is null
IOException
- if error occurs on underlying WriterCopyright © 2016 WSO2 Inc. All rights reserved.