Package org.junit.platform.commons.util

Class StringUtils

java.lang.Object

org.junit.platform.commons.util.StringUtils

@API(status=INTERNAL,
     since="1.0")
public final class StringUtils
extends Object

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 Type	Method	Description
static boolean	containsIsoControlCharacter(String str)	Determine if the supplied String contains any ISO control characters.
static boolean	containsWhitespace(String str)	Determine if the supplied String contains any whitespace characters.
static boolean	doesNotContainIsoControlCharacter(String str)	Determine if the supplied String does not contain any ISO control characters.
static boolean	doesNotContainWhitespace(String str)	Determine if the supplied String does not contain any whitespace characters.
static boolean	isBlank(String str)	Determine if the supplied String is blank (i.e., null or consisting only of whitespace characters).
static boolean	isNotBlank(String str)	Determine if the supplied String is not blank.
static String	nullSafeToString(Object obj)	Convert the supplied Object to a String using the following algorithm.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

isBlank

public static boolean isBlank(String str)

Determine if the supplied String is blank (i.e., null or consisting only of whitespace characters).

Parameters:

str - the string to check; may be null

Returns:

true if the string is blank

See Also:

isNotBlank(String)

isNotBlank

public static boolean isNotBlank(String str)

Determine if the supplied String is not blank.

Parameters:

str - the string to check; may be null

Returns:

true if the string is not blank

See Also:

isBlank(String)

containsWhitespace

public static boolean containsWhitespace(String str)

Determine if the supplied String contains any whitespace characters.

Parameters:

str - the string to check; may be null

Returns:

true if the string contains whitespace

See Also:

containsIsoControlCharacter(String), Character.isWhitespace(int)

doesNotContainWhitespace

public static boolean doesNotContainWhitespace(String str)

Determine if the supplied String does not contain any whitespace characters.

Parameters:

str - the string to check; may be null

Returns:

true if the string does not contain whitespace

See Also:

containsWhitespace(String), containsIsoControlCharacter(String), Character.isWhitespace(int)

containsIsoControlCharacter

public static boolean containsIsoControlCharacter(String str)

Determine if the supplied String contains any ISO control characters.

Parameters:

str - the string to check; may be null

Returns:

true if the string contains an ISO control character

See Also:

containsWhitespace(String), Character.isISOControl(int)

doesNotContainIsoControlCharacter

public static boolean doesNotContainIsoControlCharacter(String str)

Determine if the supplied String does not contain any ISO control characters.

Parameters:

str - the string to check; may be null

Returns:

true if the string does not contain an ISO control character

See Also:

containsIsoControlCharacter(String), containsWhitespace(String), Character.isISOControl(int)

nullSafeToString

public static String nullSafeToString(Object obj)

Convert the supplied Object to a String 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, the result of invoking toString() on the object will be returned.
• If any of the above results in an exception, the String returned by this method will be generated 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 be null

Returns:

a String representation of the supplied object; never null

See Also:

Arrays.deepToString(Object[]), ClassUtils.nullSafeToString(Class...)