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 Details

    • isBlank

      public static boolean isBlank(@Nullable 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

      public static boolean isNotBlank(@Nullable 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:

    • containsWhitespace

      public static boolean containsWhitespace(@Nullable 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:

    • doesNotContainWhitespace

      public static boolean doesNotContainWhitespace(@Nullable 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:

    • containsIsoControlCharacter

      public static boolean containsIsoControlCharacter(@Nullable 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:

    • doesNotContainIsoControlCharacter

      public static boolean doesNotContainIsoControlCharacter(@Nullable 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:

    • nullSafeToString

      public static String nullSafeToString(@Nullable 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, toString() will be invoked on the object. If the result is non-null, that result will be returned. If the result is null, "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 be null
      Returns:
      a String representation of the supplied object; never null
      See Also:

    • defaultToString

      public static String defaultToString(@Nullable Object obj)
      Convert the supplied Object to a default String 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 be null
      Returns:
      the default String representation of the supplied object; never null
      See Also:

    • replaceIsoControlCharacters

      @API(status=INTERNAL, since="1.4") public static @Nullable String replaceIsoControlCharacters(@Nullable String str, String replacement)
      Replace all ISO control characters in the supplied String.
      Parameters:
      str - the string in which to perform the replacement; may be null
      replacement - the replacement string; never null
      Returns:
      the supplied string with all control characters replaced, or null if the supplied string was null
      Since:
      1.4

    • replaceWhitespaceCharacters

      @API(status=INTERNAL, since="1.4") public static @Nullable String replaceWhitespaceCharacters(@Nullable String str, String replacement)
      Replace all whitespace characters in the supplied String.
      Parameters:
      str - the string in which to perform the replacement; may be null
      replacement - the replacement string; never null
      Returns:
      the supplied string with all whitespace characters replaced, or null if the supplied string was null
      Since:
      1.4

    • splitIntoTwo

      @API(status=INTERNAL, since="1.11") public static StringUtils.TwoPartSplitResult splitIntoTwo(char separator, String value)
      Split the supplied String into up to two parts using the supplied separator character.
      Parameters:
      separator - the separator character
      value - the value to split; never null
      Since:
      1.11

    • splitIntoTwo

      @API(status=INTERNAL, since="1.11") public static StringUtils.TwoPartSplitResult splitIntoTwo(String separator, String value)
      Split the supplied String into up to two parts using the supplied separator string.
      Parameters:
      separator - the separator string; never null
      value - the value to split; never null
      Since:
      1.11