StringUtils (icu.easyj :: easyj-core 0.2.4 API)

java.lang.Object
- icu.easyj.core.util.StringUtils

public abstract class StringUtils
extends Object

字符串工具类

作者:: wangliang181230

字段概要

字段
限定符和类型字段和说明

static byte CASE_DIFF
大小写字符的差值

字段
限定符和类型	字段和说明
`static byte`	`CASE_DIFF` 大小写字符的差值

构造器概要

构造器
构造器和说明

StringUtils()

构造器
构造器和说明
`StringUtils()`

方法概要

所有方法静态方法具体方法
限定符和类型	方法和说明
`static int`	`chineseLength(CharSequence cs)` 计算字符串长度，中文计2个字符
`static boolean`	`contains(char[] chars, char targetChar)` 判断字符数组是否包含目标字符
`static boolean`	`contains(CharSequence str, char targetChar)` 判断字符串是否包含目标字符
`static int`	`count(char[] chars, char targetChar)` 统计字符数组中包含的目标字符数量
`static int`	`count(String str, char targetChar)` 统计字符串中包含的目标字符数量
`static <T extends CharSequence> T`	`defaultIfBlank(T cs, Supplier<T> defaultValueSupplier)` 如果为空白字符串，则执行supplier生成新的值
`static <T extends CharSequence> T`	`defaultIfBlank(T cs, T defaultValue)` 如果为空白字符串，则取默认值
`static <T extends CharSequence> T`	`defaultIfEmpty(T cs, Supplier<T> defaultValueSupplier)` 如果为空字符串，则执行supplier生成新的值
`static <T extends CharSequence> T`	`defaultIfEmpty(T cs, T defaultValue)` 如果为空字符串，则取默认值
`static boolean`	`equals(CharSequence cs1, CharSequence cs2)` 判断字符串是否相等
`static String`	`findNotBlankOne(String... strArr)` 查找一个不为null或空白字符串的字符串
`static String`	`findNotEmptyOne(String... strArr)` 查找一个不为null或空字符串的字符串
`static byte`	`getCoder(CharSequence str)` 获取String的coder属性值
`static Object`	`getValue(CharSequence str)` 获取String的value属性值部分场景下，我们获取字符串的char数组，只是为了校验字符串，并没有任何修改、删除操作。
`static boolean`	`isAll(String str, char targetChar)` 判断是否全部由指定字符组成的字符串
`static boolean`	`isAllZero(String str)` 判断是否全部由数字 '0' 组成的字符串
`static boolean`	`isBlank(CharSequence cs)` 字符串是否为空白
`static boolean`	`isChinese(char c)` 判断是否为中文字符
`static boolean`	`isEmpty(CharSequence cs)` 字符串是否为空
`static boolean`	`isNotBlank(CharSequence cs)` 字符串是否不为空白
`static boolean`	`isNotEmpty(CharSequence cs)` 字符串是否不为空
`static String`	`join(char c, char separator, int n)` 生成 N个源字符由分隔符隔开而组成的字符串格式如：?
`static String`	`joinWithSpace(char c, char separator, int n)` 生成 N个源字符由分隔符隔开而组成的字符串格式如：?
`static String`	`remove(String str, char toBeRemovedChar)` 从字符串中移除对应的字符
`static char[]`	`toCharArray(CharSequence str)` 获取字符数组
`static String`	`toString(Object obj)` 将对象转换为字符串
`static String`	`trim(String str, char cutChar)` 裁剪掉两边的某个字符或空字符
`static String`	`trimEnd(String str, char cutChar)` 裁剪掉两边的某个字符或空字符
`static String`	`trimStart(String str, char cutChar)` 裁剪掉两边的某个字符或空字符

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细资料
  - CASE_DIFF
```
public static final byte CASE_DIFF
```
    大小写字符的差值
    
    另请参阅:
    
    常量字段值
- 构造器详细资料
  - StringUtils
```
public StringUtils()
```
- 方法详细资料
  - getValue
```
public static Object getValue(@NonNull
                              CharSequence str)
```
    获取String的value属性值
    部分场景下，我们获取字符串的char数组，只是为了校验字符串，并没有任何修改、删除操作。
    但由于 String.toCharArray() 方法会复制一次字符数组，导致无谓的性能损耗。
    所以，开发了此方法用于提升性能。
    
    参数:
    
    str - 字符串
    
    返回:
    
    java8返回char[]、java9及以上返回byte[]
    
    抛出:
    
    IllegalArgumentException - str为空时，抛出该异常
    
    另请参阅:
    
    String.toCharArray()
  - getCoder
```
public static byte getCoder(@NonNull
                            CharSequence str)
```
    获取String的coder属性值
    
    参数:
    
    str - 字符串
    
    返回:
    
    字符编码的标识符（值域：0=LATIN1 | 1=UTF16）
    
    抛出:
    
    IllegalArgumentException - str为空时，抛出该异常
  - isEmpty
```
public static boolean isEmpty(CharSequence cs)
```
    字符串是否为空
    
    参数:
    
    cs - 字符串
    
    返回:
    
    是否为空
  - isNotEmpty
```
public static boolean isNotEmpty(CharSequence cs)
```
    字符串是否不为空
    
    参数:
    
    cs - 字符串
    
    返回:
    
    是否不为空
  - isBlank
```
public static boolean isBlank(CharSequence cs)
```
    字符串是否为空白
    
    参数:
    
    cs - 字符串
    
    返回:
    
    是否为空白
  - isNotBlank
```
public static boolean isNotBlank(CharSequence cs)
```
    字符串是否不为空白
    
    参数:
    
    cs - 字符串
    
    返回:
    
    是否不为空白
  - isAll
```
public static boolean isAll(String str,
                            char targetChar)
```
    判断是否全部由指定字符组成的字符串
    
    参数:
    
    str - 字符串
    
    targetChar - 指定字符
    
    返回:
    
    true=全为0、false=为null或不全为0
  - isAllZero
```
public static boolean isAllZero(String str)
```
    判断是否全部由数字 '0' 组成的字符串
    
    参数:
    
    str - 字符串
    
    返回:
    
    true=全为0、false=为null或不全为0
  - contains
```
public static boolean contains(CharSequence str,
                               char targetChar)
```
    判断字符串是否包含目标字符
    
    参数:
    
    str - 字符串
    
    targetChar - 目标字符
    
    返回:
    
    true=包含 | false=不包含
  - contains
```
public static boolean contains(char[] chars,
                               char targetChar)
```
    判断字符数组是否包含目标字符
    
    参数:
    
    chars - 字符数组
    
    targetChar - 目标字符
    
    返回:
    
    true=包含 | false=不包含
  - equals
```
public static boolean equals(CharSequence cs1,
                             CharSequence cs2)
```
    判断字符串是否相等
    
    参数:
    
    cs1 - 字符串1
    
    cs2 - 字符串2
    
    返回:
    
    是否相等
  - defaultIfEmpty
```
public static <T extends CharSequence> T defaultIfEmpty(T cs,
                                                        T defaultValue)
```
    如果为空字符串，则取默认值
    
    类型参数:
    
    T - 字符串类型
    
    参数:
    
    cs - 字符串
    
    defaultValue - 默认值
    
    返回:
    
    字符串或默认值
  - defaultIfEmpty
```
public static <T extends CharSequence> T defaultIfEmpty(T cs,
                                                        Supplier<T> defaultValueSupplier)
```
    如果为空字符串，则执行supplier生成新的值
    
    类型参数:
    
    T - 字符串类型
    
    参数:
    
    cs - 字符串
    
    defaultValueSupplier - 默认值提供者
    
    返回:
    
    入参字符串或生成的默认值
  - defaultIfBlank
```
public static <T extends CharSequence> T defaultIfBlank(T cs,
                                                        T defaultValue)
```
    如果为空白字符串，则取默认值
    
    类型参数:
    
    T - 字符串类型
    
    参数:
    
    cs - 字符串
    
    defaultValue - 默认值
    
    返回:
    
    字符串或默认值
  - defaultIfBlank
```
public static <T extends CharSequence> T defaultIfBlank(T cs,
                                                        Supplier<T> defaultValueSupplier)
```
    如果为空白字符串，则执行supplier生成新的值
    
    类型参数:
    
    T - 字符串类型
    
    参数:
    
    cs - 字符串
    
    defaultValueSupplier - 默认值提供者
    
    返回:
    
    入参字符串或生成的默认值
  - isChinese
```
public static boolean isChinese(char c)
```
    判断是否为中文字符
    
    参数:
    
    c - 字符
    
    返回:
    
    是否为中文字符
  - chineseLength
```
public static int chineseLength(CharSequence cs)
```
    计算字符串长度，中文计2个字符
    
    参数:
    
    cs - 字符串
    
    返回:
    
    strLength 字符串
  - findNotEmptyOne
```
@Nullable
public static String findNotEmptyOne(String... strArr)
```
    查找一个不为null或空字符串的字符串
    
    参数:
    
    strArr - 字符串数组
    
    返回:
    
    返回找到的字符串或 null
  - findNotBlankOne
```
@Nullable
public static String findNotBlankOne(String... strArr)
```
    查找一个不为null或空白字符串的字符串
    
    参数:
    
    strArr - 字符串数组
    
    返回:
    
    返回找到的字符串或 null
  - count
```
public static int count(@NonNull
                        String str,
                        char targetChar)
```
    统计字符串中包含的目标字符数量
    
    参数:
    
    str - 字符串
    
    targetChar - 需统计的字符
    
    返回:
    
    字符数量
  - count
```
public static int count(@NonNull
                        char[] chars,
                        char targetChar)
```
    统计字符数组中包含的目标字符数量
    
    参数:
    
    chars - 字符数组
    
    targetChar - 需统计的字符
    
    返回:
    
    字符数量
  - remove
```
public static String remove(@NonNull
                            String str,
                            char toBeRemovedChar)
```
    从字符串中移除对应的字符
    
    参数:
    
    str - 字符串
    
    toBeRemovedChar - 需移除字符
    
    返回:
    
    新的字符串
  - trim
```
public static String trim(@NonNull
                          String str,
                          char cutChar)
```
    裁剪掉两边的某个字符或空字符
    
    参数:
    
    str - 字符串
    
    cutChar - 需裁剪掉的字符
    
    返回:
    
    裁剪后的字符串
  - trimStart
```
public static String trimStart(@NonNull
                               String str,
                               char cutChar)
```
    裁剪掉两边的某个字符或空字符
    
    参数:
    
    str - 字符串
    
    cutChar - 需裁剪掉的字符
    
    返回:
    
    裁剪后的字符串
  - trimEnd
```
public static String trimEnd(@NonNull
                             String str,
                             char cutChar)
```
    裁剪掉两边的某个字符或空字符
    
    参数:
    
    str - 字符串
    
    cutChar - 需裁剪掉的字符
    
    返回:
    
    裁剪后的字符串
  - join
```
public static String join(char c,
                          char separator,
                          int n)
```
    生成 N个源字符由分隔符隔开而组成的字符串
    格式如：?,?,?,?（不带空格）
    
    参数:
    
    c - 源字符
    
    separator - 分隔符
    
    n - 源字符数量
    
    返回:
    
    生成的字符串
    
    抛出:
    
    IllegalArgumentException - n小于0
    
    另请参阅:
    
    带空格的方法
  - joinWithSpace
```
public static String joinWithSpace(char c,
                                   char separator,
                                   int n)
```
    生成 N个源字符由分隔符隔开而组成的字符串
    格式如：?, ?, ?, ?（带空格）
    
    参数:
    
    c - 源字符
    
    separator - 分隔符
    
    n - 源字符数量
    
    返回:
    
    生成的字符串
    
    抛出:
    
    IllegalArgumentException - n小于0
    
    另请参阅:
    
    不带空格的方法
  - toCharArray
```
public static char[] toCharArray(@NonNull
                                 CharSequence str)
```
    获取字符数组
    
    参数:
    
    str - 字符串
    
    返回:
    
    字符数组
  - toString
```
@NonNull
public static String toString(Object obj)
```
    将对象转换为字符串
    
    参数:
    
    obj - 任意类型的对象
    
    返回:
    
    str 转换后的字符串

类 StringUtils

字段概要

构造器概要

方法概要

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

字段详细资料

CASE_DIFF

构造器详细资料

StringUtils

方法详细资料

getValue

getCoder

isEmpty

isNotEmpty

isBlank

isNotBlank

isAll

isAllZero

contains

contains

equals

defaultIfEmpty

defaultIfEmpty

defaultIfBlank

defaultIfBlank

isChinese

chineseLength

findNotEmptyOne

findNotBlankOne

count

count

remove

trim

trimStart

trimEnd

join

joinWithSpace

toCharArray

toString