Class StringUtils



  • @API(status=INTERNAL,
         since="1.0")
    public final class StringUtils
    extends java.lang.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

      All Methods Static Methods Concrete Methods 
      Modifier and Type Method Description
      static boolean containsIsoControlCharacter​(java.lang.String str)
      Determine if the supplied String contains any ISO control characters.
      static boolean containsWhitespace​(java.lang.String str)
      Determine if the supplied String contains any whitespace characters.
      static boolean doesNotContainIsoControlCharacter​(java.lang.String str)
      Determine if the supplied String does not contain any ISO control characters.
      static boolean doesNotContainWhitespace​(java.lang.String str)
      Determine if the supplied String does not contain any whitespace characters.
      static boolean isBlank​(java.lang.String str)
      Determine if the supplied String is blank (i.e., null or consisting only of whitespace characters).
      static boolean isNotBlank​(java.lang.String str)
      Determine if the supplied String is not blank.
      static java.lang.String nullSafeToString​(java.lang.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​(java.lang.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​(java.lang.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​(java.lang.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​(java.lang.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​(java.lang.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​(java.lang.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 java.lang.String nullSafeToString​(java.lang.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.
        Parameters:
        obj - the object to convert to a String; may be null
        Returns:
        a String representation of the supplied object
        See Also:
        Arrays.deepToString(Object[]), ClassUtils.nullSafeToString(Class...)