CharUtil (hutool 5.8.33 API)

java.lang.Object
- cn.hutool.core.util.CharUtil

All Implemented Interfaces:

CharPool
```
public class CharUtil
extends Object
implements CharPool
```
字符工具类
部分工具来自于Apache Commons系列

Since:

4.0.1

Author:

looly

Field Summary
- Fields inherited from interface cn.hutool.core.text.CharPool
  AMP, AT, BACKSLASH, BRACKET_END, BRACKET_START, COLON, COMMA, CR, DASHED, DELIM_END, DELIM_START, DOT, DOUBLE_QUOTES, LF, SINGLE_QUOTE, SLASH, SPACE, TAB, UNDERLINE

Constructor Summary

Constructors
Constructor and Description

CharUtil()

Constructors
Constructor and Description
`CharUtil()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static int`	`digit16(int b)` 获取给定字符的16进制数值
`static boolean`	`equals(char c1, char c2, boolean caseInsensitive)` 比较两个字符是否相同
`static int`	`getType(int c)` 获取字符类型
`static boolean`	`isAscii(char ch)` 是否为ASCII字符，ASCII字符位于0~127之间 CharUtil.isAscii('a') = true CharUtil.isAscii('A') = true CharUtil.isAscii('3') = true CharUtil.isAscii('-') = true CharUtil.isAscii('\n') = true CharUtil.isAscii('©') = false
`static boolean`	`isAsciiControl(char ch)` 是否为ASCII控制符（不可见字符），控制符位于0~31和127 CharUtil.isAsciiControl('a') = false CharUtil.isAsciiControl('A') = false CharUtil.isAsciiControl('3') = false CharUtil.isAsciiControl('-') = false CharUtil.isAsciiControl('\n') = true CharUtil.isAsciiControl('©') = false
`static boolean`	`isAsciiPrintable(char ch)` 是否为可见ASCII字符，可见字符位于32~126之间 CharUtil.isAsciiPrintable('a') = true CharUtil.isAsciiPrintable('A') = true CharUtil.isAsciiPrintable('3') = true CharUtil.isAsciiPrintable('-') = true CharUtil.isAsciiPrintable('\n') = false CharUtil.isAsciiPrintable('©') = false
`static boolean`	`isBlankChar(char c)` 是否空白符空白符包括空格、制表符、全角空格和不间断空格
`static boolean`	`isBlankChar(int c)` 是否空白符空白符包括空格、制表符、全角空格和不间断空格
`static boolean`	`isChar(Object value)` 给定对象对应的类是否为字符类，字符类包括： Character.class char.class
`static boolean`	`isCharClass(Class<?> clazz)` 给定类名是否为字符类，字符类包括： Character.class char.class
`static boolean`	`isEmoji(char c)` 判断是否为emoji表情符
`static boolean`	`isFileSeparator(char c)` 是否为Windows或者Linux（Unix）文件分隔符 Windows平台下分隔符为\，Linux（Unix）为/
`static boolean`	`isHexChar(char c)` 是否为16进制规范的字符，判断是否为如下字符 1. 0~9 2. a~f 4.
`static boolean`	`isLetter(char ch)` 判断是否为字母（包括大写字母和小写字母）字母包括A~Z和a~z CharUtil.isLetter('a') = true CharUtil.isLetter('A') = true CharUtil.isLetter('3') = false CharUtil.isLetter('-') = false CharUtil.isLetter('\n') = false CharUtil.isLetter('©') = false
`static boolean`	`isLetterLower(char ch)` 检查字符是否为小写字母，小写字母指a~z CharUtil.isLetterLower('a') = true CharUtil.isLetterLower('A') = false CharUtil.isLetterLower('3') = false CharUtil.isLetterLower('-') = false CharUtil.isLetterLower('\n') = false CharUtil.isLetterLower('©') = false
`static boolean`	`isLetterOrNumber(char ch)` 是否为字母或数字，包括A~Z、a~z、0~9 CharUtil.isLetterOrNumber('a') = true CharUtil.isLetterOrNumber('A') = true CharUtil.isLetterOrNumber('3') = true CharUtil.isLetterOrNumber('-') = false CharUtil.isLetterOrNumber('\n') = false CharUtil.isLetterOrNumber('©') = false
`static boolean`	`isLetterUpper(char ch)` 判断是否为大写字母，大写字母包括A~Z CharUtil.isLetterUpper('a') = false CharUtil.isLetterUpper('A') = true CharUtil.isLetterUpper('3') = false CharUtil.isLetterUpper('-') = false CharUtil.isLetterUpper('\n') = false CharUtil.isLetterUpper('©') = false
`static boolean`	`isNumber(char ch)` 检查是否为数字字符，数字字符指0~9 CharUtil.isNumber('a') = false CharUtil.isNumber('A') = false CharUtil.isNumber('3') = true CharUtil.isNumber('-') = false CharUtil.isNumber('\n') = false CharUtil.isNumber('©') = false
`static char`	`toCloseByNumber(int number)` 将[1-20]数字转换为带圈的字符： 1 -》 '①' 12 -》 '⑫' 20 -》 '⑳' 也称作：封闭式字符，英文：Enclosed Alphanumerics
`static char`	`toCloseChar(char c)` 将字母、数字转换为带圈的字符： '1' -》 '①' 'A' -》 'Ⓐ' 'a' -》 'ⓐ' 获取带圈数字 /封闭式字母数字，从1-20,超过1-20报错
`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
  - CharUtil
```
public CharUtil()
```
- Method Detail
  - isAscii
```
public static boolean isAscii(char ch)
```
    是否为ASCII字符，ASCII字符位于0~127之间
```
   CharUtil.isAscii('a')  = true
   CharUtil.isAscii('A')  = true
   CharUtil.isAscii('3')  = true
   CharUtil.isAscii('-')  = true
   CharUtil.isAscii('\n') = true
   CharUtil.isAscii('©') = false
 
```
    Parameters:
    
    ch - 被检查的字符处
    
    Returns:
    
    true表示为ASCII字符，ASCII字符位于0~127之间
  - isAsciiPrintable
```
public static boolean isAsciiPrintable(char ch)
```
    是否为可见ASCII字符，可见字符位于32~126之间
```
   CharUtil.isAsciiPrintable('a')  = true
   CharUtil.isAsciiPrintable('A')  = true
   CharUtil.isAsciiPrintable('3')  = true
   CharUtil.isAsciiPrintable('-')  = true
   CharUtil.isAsciiPrintable('\n') = false
   CharUtil.isAsciiPrintable('©') = false
 
```
    Parameters:
    
    ch - 被检查的字符处
    
    Returns:
    
    true表示为ASCII可见字符，可见字符位于32~126之间
  - isAsciiControl
```
public static boolean isAsciiControl(char ch)
```
    是否为ASCII控制符（不可见字符），控制符位于0~31和127
```
   CharUtil.isAsciiControl('a')  = false
   CharUtil.isAsciiControl('A')  = false
   CharUtil.isAsciiControl('3')  = false
   CharUtil.isAsciiControl('-')  = false
   CharUtil.isAsciiControl('\n') = true
   CharUtil.isAsciiControl('©') = false
 
```
    Parameters:
    
    ch - 被检查的字符
    
    Returns:
    
    true表示为控制符，控制符位于0~31和127
  - isLetter
```
public static boolean isLetter(char ch)
```
    判断是否为字母（包括大写字母和小写字母）
    字母包括A~Z和a~z
```
   CharUtil.isLetter('a')  = true
   CharUtil.isLetter('A')  = true
   CharUtil.isLetter('3')  = false
   CharUtil.isLetter('-')  = false
   CharUtil.isLetter('\n') = false
   CharUtil.isLetter('©') = false
 
```
    Parameters:
    
    ch - 被检查的字符
    
    Returns:
    
    true表示为字母（包括大写字母和小写字母）字母包括A~Z和a~z
  - isLetterUpper
```
public static boolean isLetterUpper(char ch)
```
    判断是否为大写字母，大写字母包括A~Z
```
   CharUtil.isLetterUpper('a')  = false
   CharUtil.isLetterUpper('A')  = true
   CharUtil.isLetterUpper('3')  = false
   CharUtil.isLetterUpper('-')  = false
   CharUtil.isLetterUpper('\n') = false
   CharUtil.isLetterUpper('©') = false
 
```
    Parameters:
    
    ch - 被检查的字符
    
    Returns:
    
    true表示为大写字母，大写字母包括A~Z
  - isLetterLower
```
public static boolean isLetterLower(char ch)
```
    检查字符是否为小写字母，小写字母指a~z
```
   CharUtil.isLetterLower('a')  = true
   CharUtil.isLetterLower('A')  = false
   CharUtil.isLetterLower('3')  = false
   CharUtil.isLetterLower('-')  = false
   CharUtil.isLetterLower('\n') = false
   CharUtil.isLetterLower('©') = false
 
```
    Parameters:
    
    ch - 被检查的字符
    
    Returns:
    
    true表示为小写字母，小写字母指a~z
  - isNumber
```
public static boolean isNumber(char ch)
```
    检查是否为数字字符，数字字符指0~9
```
   CharUtil.isNumber('a')  = false
   CharUtil.isNumber('A')  = false
   CharUtil.isNumber('3')  = true
   CharUtil.isNumber('-')  = false
   CharUtil.isNumber('\n') = false
   CharUtil.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
```
   CharUtil.isLetterOrNumber('a')  = true
   CharUtil.isLetterOrNumber('A')  = true
   CharUtil.isLetterOrNumber('3')  = true
   CharUtil.isLetterOrNumber('-')  = false
   CharUtil.isLetterOrNumber('\n') = false
   CharUtil.isLetterOrNumber('©') = false
 
```
    Parameters:
    
    ch - 被检查的字符
    
    Returns:
    
    true表示为字母或数字，包括A~Z、a~z、0~9
  - toString
```
public static String toString(char c)
```
    字符转为字符串
    如果为ASCII字符，使用缓存
    
    Parameters:
    
    c - 字符
    
    Returns:
    
    字符串
    
    See Also:
    
    ASCIIStrCache.toString(char)
  - 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
  - isFileSeparator
```
public static boolean isFileSeparator(char c)
```
    是否为Windows或者Linux（Unix）文件分隔符
    Windows平台下分隔符为\，Linux（Unix）为/
    
    Parameters:
    
    c - 字符
    
    Returns:
    
    是否为Windows或者Linux（Unix）文件分隔符
    
    Since:
    
    4.1.11
  - equals
```
public static boolean equals(char c1,
                             char c2,
                             boolean caseInsensitive)
```
    比较两个字符是否相同
    
    Parameters:
    
    c1 - 字符1
    
    c2 - 字符2
    
    caseInsensitive - 是否忽略大小写
    
    Returns:
    
    是否相同
    
    Since:
    
    4.0.3
  - getType
```
public static int getType(int c)
```
    获取字符类型
    
    Parameters:
    
    c - 字符
    
    Returns:
    
    字符类型
    
    Since:
    
    5.2.3
  - digit16
```
public static int digit16(int b)
```
    获取给定字符的16进制数值
    
    Parameters:
    
    b - 字符
    
    Returns:
    
    16进制字符
    
    Since:
    
    5.3.1
  - toCloseChar
```
public static char toCloseChar(char c)
```
    将字母、数字转换为带圈的字符：
```
     '1' -》 '①'
     'A' -》 'Ⓐ'
     'a' -》 'ⓐ'
 
```
    获取带圈数字 /封闭式字母数字，从1-20,超过1-20报错
    Parameters:
    
    c - 被转换的字符，如果字符不支持转换，返回原字符
    
    Returns:
    
    转换后的字符
    
    Since:
    
    5.6.2
    
    See Also:
    
    Unicode_symbols, Alphanumerics
  - toCloseByNumber
```
public static char toCloseByNumber(int number)
```
    将[1-20]数字转换为带圈的字符：
```
     1 -》 '①'
     12 -》 '⑫'
     20 -》 '⑳'
 
```
    也称作：封闭式字符，英文：Enclosed Alphanumerics
    Parameters:
    
    number - 被转换的数字
    
    Returns:
    
    转换后的字符
    
    Since:
    
    5.6.2
    
    See Also:
    
    维基百科wikipedia-Unicode_symbols, 维基百科wikipedia-Unicode字符列表, coolsymbol, 百度百科特殊字符

Class CharUtil

Field Summary

Fields inherited from interface cn.hutool.core.text.CharPool

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

CharUtil

Method Detail

isAscii

isAsciiPrintable

isAsciiControl

isLetter

isLetterUpper

isLetterLower

isNumber

isHexChar

isLetterOrNumber

toString

isCharClass

isChar

isBlankChar

isBlankChar

isEmoji

isFileSeparator

equals

getType

digit16

toCloseChar

toCloseByNumber