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 null
true
if the string is whitespace, empty
or null
isEmpty(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 null
true
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 null
true
if the string is empty or null
isBlank(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 null
true
if the string is not empty and not null
isBlank(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 null
true
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#format
String.format(String, Object...)
Copyright © 2014 JGoodies Software GmbH. All rights reserved.