java.lang.Object
org.junit.platform.commons.util.StringUtils
Collection of utilities for working with
Strings
,
CharSequences
, etc.
DISCLAIMER
These utilities are intended solely for usage within the JUnit framework itself. Any usage by external parties is not supported. Use at your own risk!
- Since:
- 1.0
-
Method Summary
Modifier and TypeMethodDescriptionstatic boolean
Determine if the suppliedString
contains any ISO control characters.static boolean
containsWhitespace(String str)
Determine if the suppliedString
contains any whitespace characters.static String
defaultToString(Object obj)
Convert the suppliedObject
to a defaultString
representation using the following algorithm.static boolean
Determine if the suppliedString
does not contain any ISO control characters.static boolean
Determine if the suppliedString
does not contain any whitespace characters.static boolean
Determine if the suppliedString
is blank (i.e.,null
or consisting only of whitespace characters).static boolean
isNotBlank(String str)
static String
nullSafeToString(Object obj)
Convert the suppliedObject
to aString
using the following algorithm.static String
replaceIsoControlCharacters(String str, String replacement)
Replace all ISO control characters in the suppliedString
.static String
replaceWhitespaceCharacters(String str, String replacement)
Replace all whitespace characters in the suppliedString
.
-
Method Details
-
isBlank
Determine if the suppliedString
is blank (i.e.,null
or consisting only of whitespace characters).- Parameters:
str
- the string to check; may benull
- Returns:
true
if the string is blank- See Also:
isNotBlank(String)
-
isNotBlank
- Parameters:
str
- the string to check; may benull
- Returns:
true
if the string is not blank- See Also:
isBlank(String)
-
containsWhitespace
Determine if the suppliedString
contains any whitespace characters.- Parameters:
str
- the string to check; may benull
- Returns:
true
if the string contains whitespace- See Also:
containsIsoControlCharacter(String)
,Character.isWhitespace(int)
-
doesNotContainWhitespace
Determine if the suppliedString
does not contain any whitespace characters.- Parameters:
str
- the string to check; may benull
- Returns:
true
if the string does not contain whitespace- See Also:
containsWhitespace(String)
,containsIsoControlCharacter(String)
,Character.isWhitespace(int)
-
containsIsoControlCharacter
Determine if the suppliedString
contains any ISO control characters.- Parameters:
str
- the string to check; may benull
- Returns:
true
if the string contains an ISO control character- See Also:
containsWhitespace(String)
,Character.isISOControl(int)
-
doesNotContainIsoControlCharacter
Determine if the suppliedString
does not contain any ISO control characters.- Parameters:
str
- the string to check; may benull
- Returns:
true
if the string does not contain an ISO control character- See Also:
containsIsoControlCharacter(String)
,containsWhitespace(String)
,Character.isISOControl(int)
-
nullSafeToString
Convert the suppliedObject
to aString
using the following algorithm.- If the supplied object is
null
, this method returns"null"
. - If the supplied object is a primitive array, the appropriate
Arrays#toString(...)
variant will be used to convert it to a String. - If the supplied object is an object array,
Arrays#deepToString(Object[])
will be used to convert it to a String. - Otherwise,
toString()
will be invoked on the object. If the result is non-null, that result will be returned. If the result isnull
,"null"
will be returned. - If any of the above results in an exception, this method delegates to
defaultToString(Object)
- Parameters:
obj
- the object to convert to a String; may benull
- Returns:
- a String representation of the supplied object; never
null
- See Also:
Arrays.deepToString(Object[])
,ClassUtils.nullSafeToString(Class...)
- If the supplied object is
-
defaultToString
Convert the suppliedObject
to a defaultString
representation using the following algorithm.- If the supplied object is
null
, this method returns"null"
. - Otherwise, the String returned by this method will be generated analogous
to the default implementation of
Object.toString()
by using the supplied object's class name and hash code as follows:obj.getClass().getName() + "@" + Integer.toHexString(System.identityHashCode(obj))
- Parameters:
obj
- the object to convert to a String; may benull
- Returns:
- the default String representation of the supplied object; never
null
- See Also:
nullSafeToString(Object)
,ClassUtils.nullSafeToString(Class...)
- If the supplied object is
-
replaceIsoControlCharacters
@API(status=INTERNAL, since="1.4") public static String replaceIsoControlCharacters(String str, String replacement)Replace all ISO control characters in the suppliedString
.- Parameters:
str
- the string in which to perform the replacement; may benull
replacement
- the replacement string; nevernull
- Returns:
- the supplied string with all control characters replaced, or
null
if the supplied string wasnull
- Since:
- 1.4
-
replaceWhitespaceCharacters
@API(status=INTERNAL, since="1.4") public static String replaceWhitespaceCharacters(String str, String replacement)Replace all whitespace characters in the suppliedString
.- Parameters:
str
- the string in which to perform the replacement; may benull
replacement
- the replacement string; nevernull
- Returns:
- the supplied string with all whitespace characters replaced, or
null
if the supplied string wasnull
- Since:
- 1.4
-