package com.dahuatech.icc.util;
/**
* 字符工具类
* 部分工具来自于Apache Commons系列
*
* @author 232676
* @since 1.0.0 2020-10-24 20:59:11
*/
public class CharUtil {
/** 字符常量：空格符 {@code ' '} */
public static final char SPACE = ' ';
/** 字符常量：制表符 {@code '\t'} */
public static final char TAB = ' ';
/** 字符常量：点 {@code '.'} */
public static final char DOT = '.';
/** 字符常量：斜杠 {@code '/'} */
public static final char SLASH = '/';
/** 字符常量：反斜杠 {@code '\\'} */
public static final char BACKSLASH = '\\';
/** 字符常量：回车符 {@code '\r'} */
public static final char CR = '\r';
/** 字符常量：换行符 {@code '\n'} */
public static final char LF = '\n';
/** 字符常量：减号（连接符） {@code '-'} */
public static final char DASHED = '-';
/** 字符常量：下划线 {@code '_'} */
public static final char UNDERLINE = '_';
/** 字符常量：逗号 {@code ','} */
public static final char COMMA = ',';
/** 字符常量：花括号（左） '{' */
public static final char DELIM_START = '{';
/** 字符常量：花括号（右） '}' */
public static final char DELIM_END = '}';
/** 字符常量：中括号（左） {@code '['} */
public static final char BRACKET_START = '[';
/** 字符常量：中括号（右） {@code ']'} */
public static final char BRACKET_END = ']';
/** 字符常量：双引号 {@code '"'} */
public static final char DOUBLE_QUOTES = '"';
/** 字符常量：单引号 {@code '\''} */
public static final char SINGLE_QUOTE = '\'';
/** 字符常量：与 {@code '&'} */
public static final char AMP = '&';
/** 字符常量：冒号 {@code ':'} */
public static final char COLON = ':';
/** 字符常量：艾特 '@' */
public static final char AT = '@';
/**
* 是否为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
*
*
* @param ch 被检查的字符处
* @return true表示为ASCII字符，ASCII字符位于0~127之间
*/
public static boolean isAscii(char ch) {
return ch < 128;
}
/**
* 是否为可见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
*
*
* @param ch 被检查的字符处
* @return true表示为ASCII可见字符，可见字符位于32~126之间
*/
public static boolean isAsciiPrintable(char ch) {
return ch >= 32 && ch < 127;
}
/**
* 是否为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
*
*
* @param ch 被检查的字符
* @return true表示为控制符，控制符位于0~31和127
*/
public static boolean isAsciiControl(final char ch) {
return ch < 32 || ch == 127;
}
/**
* 判断是否为字母（包括大写字母和小写字母）
* 字母包括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
*
*
* @param ch 被检查的字符
* @return true表示为字母（包括大写字母和小写字母）字母包括A~Z和a~z
*/
public static boolean isLetter(char ch) {
return isLetterUpper(ch) || isLetterLower(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
*
*
* @param ch 被检查的字符
* @return true表示为大写字母，大写字母包括A~Z
*/
public static boolean isLetterUpper(final char ch) {
return ch >= 'A' && ch <= 'Z';
}
/**
* 检查字符是否为小写字母，小写字母指a~z
*
*
* CharUtil.isLetterLower('a') = true
* CharUtil.isLetterLower('A') = false
* CharUtil.isLetterLower('3') = false
* CharUtil.isLetterLower('-') = false
* CharUtil.isLetterLower('\n') = false
* CharUtil.isLetterLower('©') = false
*
*
* @param ch 被检查的字符
* @return true表示为小写字母，小写字母指a~z
*/
public static boolean isLetterLower(final char ch) {
return ch >= 'a' && ch <= 'z';
}
/**
* 检查是否为数字字符，数字字符指0~9
*
*
* CharUtil.isNumber('a') = false
* CharUtil.isNumber('A') = false
* CharUtil.isNumber('3') = true
* CharUtil.isNumber('-') = false
* CharUtil.isNumber('\n') = false
* CharUtil.isNumber('©') = false
*
*
* @param ch 被检查的字符
* @return true表示为数字字符，数字字符指0~9
*/
public static boolean isNumber(char ch) {
return ch >= '0' && ch <= '9';
}
/**
* 是否为16进制规范的字符，判断是否为如下字符
*
*
* 1. 0~9
* 2. a~f
* 4. A~F
*
*
* @param c 字符
* @return 是否为16进制规范的字符
* @since 4.1.5
*/
public static boolean isHexChar(char c) {
return isNumber(c) || (c >= 'a' && c <= 'f') || (c >= 'A' && c <= 'F');
}
/**
* 是否为字母或数字，包括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
*
*
* @param ch 被检查的字符
* @return true表示为字母或数字，包括A~Z、a~z、0~9
*/
public static boolean isLetterOrNumber(final char ch) {
return isLetter(ch) || isNumber(ch);
}
/**
* 字符转为字符串
* 如果为ASCII字符，使用缓存
*
* @param c 字符
* @return 字符串
* @see ASCIIStrCache#toString(char)
*/
public static String toString(char c) {
return ASCIIStrCache.toString(c);
}
/**
* 给定类名是否为字符类，字符类包括：
*
*
* Character.class
* char.class
*
*
* @param clazz 被检查的类
* @return true表示为字符类
*/
public static boolean isCharClass(Class clazz) {
return clazz == Character.class || clazz == char.class;
}
/**
* 给定对象对应的类是否为字符类，字符类包括：
*
*
* Character.class
* char.class
*
*
* @param value 被检查的对象
* @return true表示为字符类
*/
public static boolean isChar(Object value) {
// noinspection ConstantConditions
return value instanceof Character || value.getClass() == char.class;
}
/**
* 是否空白符
* 空白符包括空格、制表符、全角空格和不间断空格
*
* @param c 字符
* @return 是否空白符
* @see Character#isWhitespace(int)
* @see Character#isSpaceChar(int)
* @since 4.0.10
*/
public static boolean isBlankChar(char c) {
return isBlankChar((int) c);
}
/**
* 是否空白符
* 空白符包括空格、制表符、全角空格和不间断空格
*
* @param c 字符
* @return 是否空白符
* @see Character#isWhitespace(int)
* @see Character#isSpaceChar(int)
* @since 4.0.10
*/
public static boolean isBlankChar(int c) {
return Character.isWhitespace(c) || Character.isSpaceChar(c) || c == '\ufeff' || c == '\u202a';
}
/**
* 判断是否为emoji表情符
*
* @param c 字符
* @return 是否为emoji
* @since 4.0.8
*/
public static boolean isEmoji(char c) {
// noinspection ConstantConditions
return false
== ((c == 0x0)
|| //
(c == 0x9)
|| //
(c == 0xA)
|| //
(c == 0xD)
|| //
((c >= 0x20) && (c <= 0xD7FF))
|| //
((c >= 0xE000) && (c <= 0xFFFD))
|| //
((c >= 0x100000) && (c <= 0x10FFFF)));
}
/**
* 是否为Windows或者Linux（Unix）文件分隔符
* Windows平台下分隔符为\，Linux（Unix）为/
*
* @param c 字符
* @return 是否为Windows或者Linux（Unix）文件分隔符
* @since 4.1.11
*/
public static boolean isFileSeparator(char c) {
return SLASH == c || BACKSLASH == c;
}
/**
* 比较两个字符是否相同
*
* @param c1 字符1
* @param c2 字符2
* @param ignoreCase 是否忽略大小写
* @return 是否相同
* @since 4.0.3
*/
public static boolean equals(char c1, char c2, boolean ignoreCase) {
if (ignoreCase) {
return Character.toLowerCase(c1) == Character.toLowerCase(c2);
}
return c1 == c2;
}
/**
* 获取字符类型
*
* @param c 字符
* @return 字符类型
* @since 5.2.3
*/
public static int getType(int c) {
return Character.getType(c);
}
/**
* 获取给定字符的16进制数值
*
* @param b 字符
* @return 16进制字符
* @since 5.3.1
*/
public static int digit16(int b) {
return Character.digit(b, 16);
}
public static class ASCIIStrCache {
private static final int ASCII_LENGTH = 128;
private static final String[] CACHE = new String[ASCII_LENGTH];
static {
for (char c = 0; c < ASCII_LENGTH; c++) {
CACHE[c] = String.valueOf(c);
}
}
/**
* 字符转为字符串
* 如果为ASCII字符，使用缓存
*
* @param c 字符
* @return 字符串
*/
public static String toString(char c) {
return c < ASCII_LENGTH ? CACHE[c] : String.valueOf(c);
}
}
}
