com.cronutils.utils

Class StringUtils

java.lang.Object

com.cronutils.utils.StringUtils

public class StringUtils
extends Object

Operations on String that are null safe.

• IsEmpty - checks if a String contains text
• IndexOfAny - index-of any of a set of Strings

The StringUtils class defines certain words related to String handling.

• null - null
• empty - a zero-length string ("")
• space - the space character (' ', char 32)
• whitespace - the characters defined by Character.isWhitespace(char)
• trim - the characters <= 32 as in String.trim()

StringUtils handles null input Strings quietly. That is to say that a null input will return null. Where a boolean or int is being returned details vary by method.

A side effect of the null handling is that a NullPointerException should be considered a bug in StringUtils.

Methods in this class give sample code to explain their operation. The symbol * is used to indicate any input including null.

#ThreadSafe#

Since:

1.0

Version:

$Id: StringUtils.java 1648067 2014-12-27 16:45:42Z britter $

See Also:

String

Field Summary

Fields

Modifier and Type	Field and Description
static String	EMPTY The empty String "".

Method Summary

Modifier and Type	Method and Description
static boolean	containsAny(CharSequence cs, char... searchChars) Checks if the CharSequence contains any character in the given.
static boolean	isEmpty(CharSequence cs) Checks if a CharSequence is empty ("") or null.

Methods inherited from class java.lang.Object

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

Field Detail

EMPTY

public static final String EMPTY

The empty String "".

Since:

2.0

See Also:

Constant Field Values

Method Detail

isEmpty

public static boolean isEmpty(CharSequence cs)

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

 StringUtils.isEmpty(null)      = true
 StringUtils.isEmpty("")        = true
 StringUtils.isEmpty(" ")       = false
 StringUtils.isEmpty("bob")     = false
 StringUtils.isEmpty("  bob  ") = false
 

NOTE: This method changed in Lang version 2.0. It no longer trims the CharSequence. That functionality is available in isBlank().

Parameters:

cs - the CharSequence to check, may be null

Returns:

true if the CharSequence is empty or null

Since:

3.0 Changed signature from isEmpty(String) to isEmpty(CharSequence)

containsAny

public static boolean containsAny(CharSequence cs,
                                  char... searchChars)

Checks if the CharSequence contains any character in the given. set of characters.

A null CharSequence will return false. A null or zero length search array will return false.

 StringUtils.containsAny(null, *)                = false
 StringUtils.containsAny("", *)                  = false
 StringUtils.containsAny(*, null)                = false
 StringUtils.containsAny(*, [])                  = false
 StringUtils.containsAny("zzabyycdxx",['z','a']) = true
 StringUtils.containsAny("zzabyycdxx",['b','y']) = true
 StringUtils.containsAny("aba", ['z'])           = false
 

Parameters:

cs - the CharSequence to check, may be null

searchChars - the chars to search for, may be null

Returns:

the true if any of the chars are found, false if no match or null input

Since:

2.4, 3.0 Changed signature from containsAny(String, char[]) to containsAny(CharSequence, char...)