cn.wensiqun.asmsupport.core.utils.lang

类 StringUtils

java.lang.Object

cn.wensiqun.asmsupport.core.utils.lang.StringUtils

public class StringUtils
extends Object

作者:

wensiqun at 163.com(Joe Wen)

字段概要

字段

限定符和类型	字段和说明
static String	EMPTY The empty String "".
static int	INDEX_NOT_FOUND Represents a failed index search.

构造器概要

构造器

构造器和说明
StringUtils()

方法概要

方法

限定符和类型	方法和说明
static String	appendIfBlank(String str, int len, char chr)
static boolean	equals(CharSequence cs1, CharSequence cs2) Compares two CharSequences, returning true if they represent equal sequences of characters.
static Integer[]	findAllIndexes(String str, String searchStr) Get all indexes
static boolean	isBlank(CharSequence cs) Checks if a CharSequence is whitespace, empty ("") or null.
static boolean	isEmpty(CharSequence cs) Checks if a CharSequence is empty ("") or null.
static boolean	isNotBlank(CharSequence cs) Checks if a CharSequence is not empty (""), not null and not whitespace only.
static boolean	regionMatches(CharSequence cs, boolean ignoreCase, int thisStart, CharSequence substring, int start, int length)
static String	replace(String text, String searchString, String replacement) Replaces all occurrences of a String within another String.
static String	replace(String text, String searchString, String replacement, int max) Replaces a String with another String inside a larger String, for the first max values of the search String.
static String[]	split(String str, char separatorChar) Splits the provided text into an array, separator specified.
static String	upperCase(String str, int start, int end)

从类继承的方法 java.lang.Object

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

字段详细资料

EMPTY

public static final String EMPTY

The empty String "".

从以下版本开始:

2.0

另请参阅:

常量字段值

INDEX_NOT_FOUND

public static final int INDEX_NOT_FOUND

Represents a failed index search.

从以下版本开始:

2.1

另请参阅:

常量字段值

构造器详细资料

StringUtils

public StringUtils()

方法详细资料

findAllIndexes

public static Integer[] findAllIndexes(String str,
                       String searchStr)

Get all indexes

参数:

str -

searchStr -

返回:

upperCase

public static String upperCase(String str,
               int start,
               int end)

参数:

str -

start -

end -

返回:

appendIfBlank

public static String appendIfBlank(String str,
                   int len,
                   char chr)

参数:

str -

len -

chr -

返回:

equals

public static boolean equals(CharSequence cs1,
             CharSequence cs2)

Compares two CharSequences, returning true if they represent equal sequences of characters.

nulls are handled without exceptions. Two null references are considered to be equal. The comparison is case sensitive.

 StringUtils.equals(null, null)   = true
 StringUtils.equals(null, "abc")  = false
 StringUtils.equals("abc", null)  = false
 StringUtils.equals("abc", "abc") = true
 StringUtils.equals("abc", "ABC") = false
 

参数:

cs1 - the first CharSequence, may be null

cs2 - the second CharSequence, may be null

返回:

true if the CharSequences are equal (case-sensitive), or both null

从以下版本开始:

3.0 Changed signature from equals(String, String) to equals(CharSequence, CharSequence)

另请参阅:

Object.equals(Object)

regionMatches

public static boolean regionMatches(CharSequence cs,
                    boolean ignoreCase,
                    int thisStart,
                    CharSequence substring,
                    int start,
                    int length)

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().

参数:

cs - the CharSequence to check, may be null

返回:

true if the CharSequence is empty or null

从以下版本开始:

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

isBlank

public static boolean isBlank(CharSequence cs)

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

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

参数:

cs - the CharSequence to check, may be null

返回:

true if the CharSequence is null, empty or whitespace

从以下版本开始:

2.0, 3.0 Changed signature from isBlank(String) to isBlank(CharSequence)

isNotBlank

public static boolean isNotBlank(CharSequence cs)

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

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

参数:

cs - the CharSequence to check, may be null

返回:

true if the CharSequence is not empty and not null and not whitespace

从以下版本开始:

2.0, 3.0 Changed signature from isNotBlank(String) to isNotBlank(CharSequence)

replace

public static String replace(String text,
             String searchString,
             String replacement)

Replaces all occurrences of a String within another String.

A null reference passed to this method is a no-op.

 StringUtils.replace(null, *, *)        = null
 StringUtils.replace("", *, *)          = ""
 StringUtils.replace("any", null, *)    = "any"
 StringUtils.replace("any", *, null)    = "any"
 StringUtils.replace("any", "", *)      = "any"
 StringUtils.replace("aba", "a", null)  = "aba"
 StringUtils.replace("aba", "a", "")    = "b"
 StringUtils.replace("aba", "a", "z")   = "zbz"
 

参数:

text - text to search and replace in, may be null

searchString - the String to search for, may be null

replacement - the String to replace it with, may be null

返回:

the text with any replacements processed, null if null String input

另请参阅:

replace(String text, String searchString, String replacement, int max)

replace

public static String replace(String text,
             String searchString,
             String replacement,
             int max)

Replaces a String with another String inside a larger String, for the first max values of the search String.

A null reference passed to this method is a no-op.

 StringUtils.replace(null, *, *, *)         = null
 StringUtils.replace("", *, *, *)           = ""
 StringUtils.replace("any", null, *, *)     = "any"
 StringUtils.replace("any", *, null, *)     = "any"
 StringUtils.replace("any", "", *, *)       = "any"
 StringUtils.replace("any", *, *, 0)        = "any"
 StringUtils.replace("abaa", "a", null, -1) = "abaa"
 StringUtils.replace("abaa", "a", "", -1)   = "b"
 StringUtils.replace("abaa", "a", "z", 0)   = "abaa"
 StringUtils.replace("abaa", "a", "z", 1)   = "zbaa"
 StringUtils.replace("abaa", "a", "z", 2)   = "zbza"
 StringUtils.replace("abaa", "a", "z", -1)  = "zbzz"
 

参数:

text - text to search and replace in, may be null

searchString - the String to search for, may be null

replacement - the String to replace it with, may be null

max - maximum number of values to replace, or -1 if no maximum

返回:

the text with any replacements processed, null if null String input

split

public static String[] split(String str,
             char separatorChar)

Splits the provided text into an array, separator specified. This is an alternative to using StringTokenizer.

The separator is not included in the returned String array. Adjacent separators are treated as one separator. For more control over the split use the StrTokenizer class.

A null input String returns null.

 StringUtils.split(null, *)         = null
 StringUtils.split("", *)           = []
 StringUtils.split("a.b.c", '.')    = ["a", "b", "c"]
 StringUtils.split("a..b.c", '.')   = ["a", "b", "c"]
 StringUtils.split("a:b:c", '.')    = ["a:b:c"]
 StringUtils.split("a b c", ' ')    = ["a", "b", "c"]
 

参数:

str - the String to parse, may be null

separatorChar - the character used as the delimiter

返回:

an array of parsed Strings, null if null String input

从以下版本开始:

2.0