public class Strings extends Object
| Modifier and Type | Field and Description |
|---|---|
static String |
ELLIPSIS_STRING
The correct ellipsis string.
|
static String |
NO_ELLIPSIS_STRING
A string with three dots that should is often meant
to be the ellipsis string "?" or character '?'.
|
| Modifier | Constructor and Description |
|---|---|
protected |
Strings() |
| Modifier and Type | Method and Description |
|---|---|
static String |
abbreviateCenter(String str,
int maxLength)
Abbreviates the given string if it exceeds the given maximum length
by replacing its center part with an ellipsis ('…').
|
static String |
get(String str,
Object... args)
If no arguments are provided, the plain String is returned.
|
static boolean |
isBlank(String str)
Checks if the given string is whitespace, empty ("") or
null. |
static boolean |
isEmpty(String str)
Checks if the given string is empty ("") or
null. |
static boolean |
isNotBlank(String str)
Checks if the given string is not empty (""),
not
null and not whitespace only. |
static boolean |
isNotEmpty(String str)
Checks if the given string is not empty ("")
and not
null. |
static boolean |
isTrimmed(String str)
Checks if the given string is
null, empty (""),
or the first and last characters are not whitespace. |
static boolean |
startsWithIgnoreCase(String str,
String prefix)
Checks if
str starts with the given prefix ignoring cases. |
public static final String NO_ELLIPSIS_STRING
ELLIPSIS_STRING,
Constant Field Valuespublic static final String ELLIPSIS_STRING
NO_ELLIPSIS_STRING,
Constant Field Valuespublic static boolean isBlank(String str)
null.
Strings.isBlank(null) == true
Strings.isBlank("") == true
Strings.isBlank(" ") == true
Strings.isBlank(" abc") == false
Strings.isBlank("abc ") == false
Strings.isBlank(" abc ") == false
str - the string to check, may be nulltrue if the string is whitespace, empty
or nullisEmpty(String)public static boolean isNotBlank(String str)
null and not whitespace only.
Strings.isNotBlank(null) == false
Strings.isNotBlank("") == false
Strings.isNotBlank(" ") == false
Strings.isNotBlank(" abc") == true
Strings.isNotBlank("abc ") == true
Strings.isNotBlank(" abc ") == true
str - the string to check, may be nulltrue if the string is not empty
and not null and not whitespace onlyisEmpty(String)public static boolean isEmpty(String str)
null.
Strings.isEmpty(null) == true
Strings.isEmpty("") == true
Strings.isEmpty(" ") == false
Strings.isEmpty("Hi ") == false
str - the string to check, may be nulltrue if the string is empty or nullisBlank(String)public static boolean isNotEmpty(String str)
null.
Strings.isNotEmpty(null) == false
Strings.isNotEmpty("") == false
Strings.isNotEmpty(" ") == true
Strings.isNotEmpty("Hi") == true
Strings.isNotEmpty("Hi ") == true
str - the string to check, may be nulltrue if the string is not empty and not nullisBlank(String)public static boolean isTrimmed(String str)
null, empty (""),
or the first and last characters are not whitespace.
Strings.isTrimmed(null) == true
Strings.isTrimmed("") == true
Strings.isTrimmed(" ") == false
Strings.isTrimmed("Hi") == true
Strings.isTrimmed("Hi ") == false
Strings.isTrimmed(" Hi") == false
str - the string to check, may be nulltrue if the string is null, empty,
or the first and last characters are not whitespace.public static boolean startsWithIgnoreCase(String str, String prefix)
str starts with the given prefix ignoring cases.
null is handled safely; if both arguments are null, true
is returned, false otherwise.
Strings.startsWithIgnoreCase(null, null) == true
Strings.startsWithIgnoreCase("a", null) == false
Strings.startsWithIgnoreCase(null, "a") == false
Strings.startsWithIgnoreCase("", "") == true
Strings.startsWithIgnoreCase(" ", "") == true
Strings.startsWithIgnoreCase("John", "J") == true
Strings.startsWithIgnoreCase("John", "Jo") == true
Strings.startsWithIgnoreCase("John", "Joh") == true
Strings.startsWithIgnoreCase("John", "joh") == true
Strings.startsWithIgnoreCase("john", "Joh") == true
Strings.startsWithIgnoreCase("john", "joh") == true
Strings.startsWithIgnoreCase("John", "John") == true
Strings.startsWithIgnoreCase("John", "john") == true
Strings.startsWithIgnoreCase("John", "Jonny") == false
str - the test string to check, may be nullprefix - the prefix to check for, may be nulltrue, if the string starts with the prefix, ignoring cases,
false otherwiseString.startsWith(java.lang.String)public static String abbreviateCenter(String str, int maxLength)
null or shorter than the limit,
it is returned as is.
Strings.abbreviateCenter(null, 3) == null
Strings.abbreviateCenter("", 3) == ""
Strings.abbreviateCenter(" ", 3) == " "
Strings.abbreviateCenter("a", 3) == "a"
Strings.abbreviateCenter("ab", 3) == "ab"
Strings.abbreviateCenter("abc", 3) == "abc"
Strings.abbreviateCenter("abcd", 3) == "a…d"
Strings.abbreviateCenter("abcde", 3) == "a…e"
Strings.abbreviateCenter("abcde", 4) == "ab…e"
Strings.abbreviateCenter("abcdef", 4) == "ab…f"
Strings.abbreviateCenter("abcdefg", 5) == "ab…fg"
str - the source stringmaxLength - the maximum length of the result stringstr if its length is less than or equal to maxLength,
an abbreviated string with length maxLength where
the center is replaced by an ellipsispublic static String get(String str, Object... args)
String.format
with the given arguments.
Strings.get(null) == null
Strings.get("") == ""
Strings.get(" ") == " "
Strings.get("hello") == "hello"
Strings.get("a %s c", "b") == "a b c"
Strings.get("%1$s %2$s %3$s", "a", "b", "c") == "a b c"
args - optional format arguments forwarded to String#formatString.format(String, Object...)Copyright © 2009-2014 JGoodies Software GmbH. All Rights Reserved.