org.apache.hc.core5.util

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

Method Summary

Modifier and Type	Method and Description
static byte	castAsByte(int c) Casts character to byte filtering non-visible and non-ASCII characters before conversion.
static boolean	containsBlanks(CharSequence s) Tests whether a CharSequence contains any whitespace.
static boolean	isAllASCII(CharSequence s) Determines whether the given CharSequence contains only ASCII characters.
static boolean	isBlank(CharSequence s) Checks if a CharSequence is empty (""), null or whitespace only.
static boolean	isEmpty(CharSequence s) Tests whether the parameter is null or of zero length.
static int	length(CharSequence cs) Gets a CharSequence length or 0 if the CharSequence is null.
static String	toHexString(byte[] bytes) Returns a hexadecimal string with lowercase letters, representing the values of the bytes.
static String	toLowerCase(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

Method Detail

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)

Returns a hexadecimal string with lowercase letters, representing the values of the bytes.

Parameters:

bytes - whose hex string should be created

Returns:

hex string for the bytes

Since:

5.0

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