Package org.apache.hc.core5.util

Class TextUtils

  • public final class TextUtils
extends java.lang.Object
    Tests and converts Strings and CharSequence.
    Since:
    4.3

    • Field Summary

      Fields 
      Modifier and Type Field Description
      private static char[] HEX_CHARS
      Returns a hexadecimal string with lowercase letters, representing the values of the bytes.

    • Constructor Summary

      Constructors 
      Modifier Constructor Description
      private TextUtils()  

    • Method Summary

      All Methods Static Methods Concrete Methods 
      Modifier and Type Method Description
      static byte castAsByte​(int c)
      Casts character to byte filtering non-visible and non-ASCII characters before conversion.
      static boolean containsBlanks​(java.lang.CharSequence s)
      Tests whether a CharSequence contains any whitespace.
      static boolean isAllASCII​(java.lang.CharSequence s)
      Determines whether the given CharSequence contains only ASCII characters.
      static boolean isBlank​(java.lang.CharSequence s)
      Checks if a CharSequence is empty (""), null or whitespace only.
      static boolean isEmpty​(java.lang.CharSequence s)
      Tests whether the parameter is null or of zero length.
      static int length​(java.lang.CharSequence cs)
      Gets a CharSequence length or 0 if the CharSequence is null.
      static java.lang.String toHexString​(byte[] bytes)  
      static java.lang.String toLowerCase​(java.lang.String s)
      Converts a String to its lower case representation using Locale.ROOT.

      • Methods inherited from class java.lang.Object

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

    • Field Detail

      • HEX_CHARS

        private static final char[] HEX_CHARS
        Returns a hexadecimal string with lowercase letters, representing the values of the bytes.
        Since:
        5.0

    • Constructor Detail

      • TextUtils

        private TextUtils()

    • Method Detail

      • isEmpty

        public static boolean isEmpty​(java.lang.CharSequence s)
        Tests whether the parameter is null or of zero length.
        Parameters:
        s - The CharSequence to test.
        Returns:
        whether the parameter is null or of zero length.

      • isBlank

        public static boolean isBlank​(java.lang.CharSequence s)

        Checks if a CharSequence is empty (""), null or whitespace only.

        Whitespace is defined by Character.isWhitespace(char).

         TextUtils.isBlank(null)      = true
 TextUtils.isBlank("")        = true
 TextUtils.isBlank(" ")       = true
 TextUtils.isBlank("abg")     = false
 TextUtils.isBlank("  abg  ") = false
        Parameters:
        s - the CharSequence to check, may be null
        Returns:
        true if the CharSequence is null, empty or whitespace only

      • length

        public static int length​(java.lang.CharSequence cs)
        Gets a CharSequence length or 0 if the CharSequence is null.
        Parameters:
        cs - a CharSequence or null
        Returns:
        CharSequence length or 0 if the CharSequence is null.
        Since:
        5.1

      • containsBlanks

        public static boolean containsBlanks​(java.lang.CharSequence s)
        Tests whether a CharSequence contains any whitespace.
        Parameters:
        s - The CharSequence to test.
        Returns:
        whether a CharSequence contains any whitespace.
        Since:
        4.4

      • toHexString

        public static java.lang.String toHexString​(byte[] bytes)

      • toLowerCase

        public static java.lang.String toLowerCase​(java.lang.String s)
        Converts a String to its lower case representation using Locale.ROOT.
        Parameters:
        s - The String to convert
        Returns:
        The converted String.
        Since:
        5.2

      • isAllASCII

        public static boolean isAllASCII​(java.lang.CharSequence s)
        Determines whether the given CharSequence contains only ASCII characters.
        Parameters:
        s - the CharSequence to check
        Returns:
        true if the CharSequence contains only ASCII characters, false otherwise
        Throws:
        java.lang.IllegalArgumentException - if the input CharSequence is null
        Since:
        5.3

      • castAsByte

        @Internal
public static byte castAsByte​(int c)
        Casts character to byte filtering non-visible and non-ASCII characters before conversion.
        Parameters:
        c - The character to cast.
        Returns:
        The given character or '?'.
        Since:
        5.2