Class TextUtils

java.lang.Object
org.apache.hc.core5.util.TextUtils

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

    • 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 Details

    • TextUtils

      private TextUtils()
  • Method Details

    • isEmpty

      public static boolean isEmpty(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(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(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(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 String toHexString(byte[] bytes)
    • toLowerCase

      public static String toLowerCase(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(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:
      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