CharUtils (bus-core 3.0.0 API)

java.lang.Object
- org.aoju.bus.core.utils.CharUtils

```
public class CharUtils
extends Object
```
字符工具类
部分工具来自于Apache

Since:

JDK 1.8

Version:

3.0.0

Author:

Kimi Liu

Constructor Summary

Constructors
Constructor and Description

CharUtils()

Constructors
Constructor and Description
`CharUtils()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static int`	`compare(char x, char y)` 对两个`char`值进行数值比较
`static boolean`	`equals(char c1, char c2, boolean ignoreCase)` 比较两个字符是否相同
`static boolean`	`isAscii(char ch)` 是否为ASCII字符，ASCII字符位于0~127之间
`static boolean`	`isAsciiControl(char ch)` 是否为ASCII控制符（不可见字符），控制符位于0~31和127
`static boolean`	`isAsciiPrintable(char ch)` 是否为可见ASCII字符，可见字符位于32~126之间
`static boolean`	`isBlankChar(char c)` 是否空白符空白符包括空格、制表符、全角空格和不间断空格
`static boolean`	`isBlankChar(int c)` 是否空白符空白符包括空格、制表符、全角空格和不间断空格
`static boolean`	`isChar(Object value)` 给定对象对应的类是否为字符类，字符类包括：
`static boolean`	`isCharClass(Class<?> clazz)` 给定类名是否为字符类，字符类包括：
`static boolean`	`isEmoji(char c)` 判断是否为emoji表情符
`static boolean`	`isFileSeparator(char c)` 是否为Windows或者Linux（Unix）文件分隔符 Windows平台下分隔符为\，Linux（Unix）为/
`static boolean`	`isHexChar(char c)` 是否为16进制规范的字符，判断是否为如下字符
`static boolean`	`isLetter(char ch)` 判断是否为字母（包括大写字母和小写字母）字母包括A~Z和a~z
`static boolean`	`isLetterLower(char ch)` 检查字符是否为小写字母，小写字母指a~z
`static boolean`	`isLetterOrNumber(char ch)` 是否为字符或数字，包括A~Z、a~z、0~9
`static boolean`	`isLetterUpper(char ch)` 判断是否为大写字母，大写字母包括A~Z
`static boolean`	`isNumber(char ch)` 检查是否为数字字符，数字字符指0~9
`static String`	`toString(char c)` 字符转为字符串如果为ASCII字符，使用缓存

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail
- CharUtils
```
public CharUtils()
```

Method Detail

isAscii

public static boolean isAscii(char ch)

是否为ASCII字符，ASCII字符位于0~127之间

   CharUtils.isAscii('a')  = true
   CharUtils.isAscii('A')  = true
   CharUtils.isAscii('3')  = true
   CharUtils.isAscii('-')  = true
   CharUtils.isAscii('\n') = true
   CharUtils.isAscii('©') = false

Parameters:: ch - 被检查的字符处
Returns:: true表示为ASCII字符，ASCII字符位于0~127之间

isAsciiPrintable

public static boolean isAsciiPrintable(char ch)

是否为可见ASCII字符，可见字符位于32~126之间

   CharUtils.isAsciiPrintable('a')  = true
   CharUtils.isAsciiPrintable('A')  = true
   CharUtils.isAsciiPrintable('3')  = true
   CharUtils.isAsciiPrintable('-')  = true
   CharUtils.isAsciiPrintable('\n') = false
   CharUtils.isAsciiPrintable('©') = false

Parameters:: ch - 被检查的字符处
Returns:: true表示为ASCII可见字符，可见字符位于32~126之间

isAsciiControl

public static boolean isAsciiControl(char ch)

是否为ASCII控制符（不可见字符），控制符位于0~31和127

   CharUtils.isAsciiControl('a')  = false
   CharUtils.isAsciiControl('A')  = false
   CharUtils.isAsciiControl('3')  = false
   CharUtils.isAsciiControl('-')  = false
   CharUtils.isAsciiControl('\n') = true
   CharUtils.isAsciiControl('©') = false

Parameters:: ch - 被检查的字符
Returns:: true表示为控制符，控制符位于0~31和127

isLetter

public static boolean isLetter(char ch)

判断是否为字母（包括大写字母和小写字母）
字母包括A~Z和a~z

   CharUtils.isLetter('a')  = true
   CharUtils.isLetter('A')  = true
   CharUtils.isLetter('3')  = false
   CharUtils.isLetter('-')  = false
   CharUtils.isLetter('\n') = false
   CharUtils.isLetter('©') = false

Parameters:: ch - 被检查的字符
Returns:: true表示为字母（包括大写字母和小写字母）字母包括A~Z和a~z

isLetterUpper

public static boolean isLetterUpper(char ch)

判断是否为大写字母，大写字母包括A~Z

   CharUtils.isLetterUpper('a')  = false
   CharUtils.isLetterUpper('A')  = true
   CharUtils.isLetterUpper('3')  = false
   CharUtils.isLetterUpper('-')  = false
   CharUtils.isLetterUpper('\n') = false
   CharUtils.isLetterUpper('©') = false

Parameters:: ch - 被检查的字符
Returns:: true表示为大写字母，大写字母包括A~Z

isLetterLower

public static boolean isLetterLower(char ch)

检查字符是否为小写字母，小写字母指a~z

   CharUtils.isLetterLower('a')  = true
   CharUtils.isLetterLower('A')  = false
   CharUtils.isLetterLower('3')  = false
   CharUtils.isLetterLower('-')  = false
   CharUtils.isLetterLower('\n') = false
   CharUtils.isLetterLower('©') = false

Parameters:: ch - 被检查的字符
Returns:: true表示为小写字母，小写字母指a~z

isNumber

public static boolean isNumber(char ch)

检查是否为数字字符，数字字符指0~9

   CharUtils.isNumber('a')  = false
   CharUtils.isNumber('A')  = false
   CharUtils.isNumber('3')  = true
   CharUtils.isNumber('-')  = false
   CharUtils.isNumber('\n') = false
   CharUtils.isNumber('©') = false

Parameters:: ch - 被检查的字符
Returns:: true表示为数字字符，数字字符指0~9

isHexChar
```
public static boolean isHexChar(char c)
```
是否为16进制规范的字符，判断是否为如下字符
```
 1. 0~9
 2. a~f
 4. A~F
 
```
Parameters:

c - 字符

Returns:

是否为16进制规范的字符

Since:

4.1.5

isLetterOrNumber

public static boolean isLetterOrNumber(char ch)

是否为字符或数字，包括A~Z、a~z、0~9

   CharUtils.isLetterOrNumber('a')  = true
   CharUtils.isLetterOrNumber('A')  = true
   CharUtils.isLetterOrNumber('3')  = true
   CharUtils.isLetterOrNumber('-')  = false
   CharUtils.isLetterOrNumber('\n') = false
   CharUtils.isLetterOrNumber('©') = false

Parameters:: ch - 被检查的字符
Returns:: true表示为字符或数字，包括A~Z、a~z、0~9

isCharClass
```
public static boolean isCharClass(Class<?> clazz)
```
给定类名是否为字符类，字符类包括：
```
 Character.class
 char.class
 
```
Parameters:

clazz - 被检查的类

Returns:

true表示为字符类

isChar
```
public static boolean isChar(Object value)
```
给定对象对应的类是否为字符类，字符类包括：
```
 Character.class
 char.class
 
```
Parameters:

value - 被检查的对象

Returns:

true表示为字符类

isBlankChar
```
public static boolean isBlankChar(char c)
```
是否空白符
空白符包括空格、制表符、全角空格和不间断空格

Parameters:

c - 字符

Returns:

是否空白符

Since:

4.0.10

See Also:

Character.isWhitespace(int), Character.isSpaceChar(int)

isBlankChar
```
public static boolean isBlankChar(int c)
```
是否空白符
空白符包括空格、制表符、全角空格和不间断空格

Parameters:

c - 字符

Returns:

是否空白符

Since:

4.0.10

See Also:

Character.isWhitespace(int), Character.isSpaceChar(int)

isEmoji
```
public static boolean isEmoji(char c)
```
判断是否为emoji表情符

Parameters:

c - 字符

Returns:

是否为emoji

Since:

4.0.8

equals
```
public static boolean equals(char c1,
                             char c2,
                             boolean ignoreCase)
```
比较两个字符是否相同

Parameters:

c1 - 字符1

c2 - 字符2

ignoreCase - 是否忽略大小写

Returns:

是否相同

Since:

4.0.3

toString
```
public static String toString(char c)
```
字符转为字符串
如果为ASCII字符，使用缓存

Parameters:

c - 字符

Returns:

字符串

isFileSeparator
```
public static boolean isFileSeparator(char c)
```
是否为Windows或者Linux（Unix）文件分隔符
Windows平台下分隔符为\，Linux（Unix）为/

Parameters:

c - 字符

Returns:

是否为Windows或者Linux（Unix）文件分隔符

Since:

4.1.11

compare
```
public static int compare(char x,
                          char y)
```
对两个char值进行数值比较

Parameters:

x - char

y - char 如果x == y返回值0; 如果x < y值小于0;和如果x > y

Returns:

the int

Class CharUtils

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

CharUtils

Method Detail

isAscii

isAsciiPrintable

isAsciiControl

isLetter

isLetterUpper

isLetterLower

isNumber

isHexChar

isLetterOrNumber

isCharClass

isChar

isBlankChar

isBlankChar

isEmoji

equals

toString

isFileSeparator

compare