TString (Voovan-码云(gitee.com))

java.lang.Object
- org.voovan.tools.TString

```
public class TString
extends Object
```
String 工具类

Author:

helyho
Voovan Framework80797d4b533dc83bb73457eb5194d13a45779258eaf3a2c07f041a98b329f79d. WebSite: https://github.com/helyho/Voovan Licence: Apache v2 License

Field Summary

Fields
Modifier and Type	Field and Description
`static char[]`	`chars`
`static String`	`TOKEN_EMPTY`
`static String`	`TOKEN_EMPTY_REGEX`
`static String`	`TOKEN_PREFIX`
`static String`	`TOKEN_PREFIX_REGEX`
`static String`	`TOKEN_SUFFIX`
`static String`	`TOKEN_SUFFIX_REGEX`
`static Map<Character,Integer>`	`unChars`

Constructor Summary

Constructors
Constructor and Description

TString()

Constructors
Constructor and Description
`TString()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static String`	`assembly(Object... items)` 字符串快捷拼装方法
`static String`	`camelToUnderline(String param)` 驼峰命名转下划线命名
`static String`	`convertEscapeChar(String source)` 将系统转义字符,转义成可在字符串表达的转义字符例如:将字符串中的 \" 转转成 \\\"
`static Matcher`	`doRegex(String source, String regex)` 执行正则运算
`static Matcher`	`doRegex(String source, String regex, Integer flags)` 执行正则运算
`static String`	`fastReplaceAll(String source, String regex, String replacement)` 快速字符串替换算法默认正在 flag = 0, quoteReplacement = true
`static String`	`fastReplaceAll(String source, String regex, String replacement, boolean quoteReplacement)` 快速字符串替换算法默认正在 flag = 0
`static String`	`fastReplaceAll(String source, String regex, String replacement, Integer flags, boolean quoteReplacement)` 快速字符串替换算法
`static String`	`fastReplaceFirst(String source, String regex, String replacement)` 快速字符串替换算法默认正在 flag = 0, quoteReplacement = true
`static String`	`fastReplaceFirst(String source, String regex, String replacement, boolean quoteReplacement)` 快速字符串替换算法默认正在 flag = 0
`static String`	`fastReplaceFirst(String source, String regex, String replacement, Integer flags, boolean quoteReplacement)` 快速字符串替换算法
`static String`	`formatBytes(long byteCount)` 格式化计算机字节单位的存储容量为文本
`static String`	`formatNumber(long value, String unit)` 按数学技术格式化数字为文本
`static String`	`fromUnicode(String source)` Unicode 转字符串
`static String`	`generateId()` 快速生成短ID
`static String`	`generateId(Object obj)` 快速生成短ID
`static String`	`generateId(Object obj, String sign)` 快速生成短ID
`static String`	`generateShortUUID()` 生成短 UUID
`static String`	`indent(String source, int indentCount)` 缩进字符串
`static String`	`insert(String source, int position, String value)` 在字符串中插入字符
`static boolean`	`isBoolean(String booleanString)` 判断是否是布尔值
`static boolean`	`isDecimal(String decimalString)` 判断是否是浮点数
`static boolean`	`isInteger(String integerString)` 判断是否是整形数
`static boolean`	`isNullOrEmpty(String source)` 判断字符串空指针或者内容为空
`static boolean`	`isNumber(String numberString, int radix)` 判断是否是指定进制的数字字符串
`static String`	`leftPad(String source, int len, char c)` 左补齐
`static int`	`maxLineLength(String source)` 获取字符串中最长一行的长度
`static String`	`oneTokenReplace(String source, String tokenName, String tokenValue)` 按照标识符进行替换 tokenName 为 null 则使用 {} 进行替换如果为 tokenName 为数字可以不在标识中填写数字标识,会自动按照标识的先后顺序进行替换
`static String`	`radixBigConvert(BigDecimal n_num, int n_radix)`
`static BigDecimal`	`radixBigUnConvert(String str, int n_radix)`
`static String`	`radixConvert(long num, int radix)`
`static long`	`radixUnConvert(String str, int radix)`
`static String`	`readLine(String str, int beginIndex)` 从指定位置读取一行字符串
`static int`	`regexMatch(String source, String regex)` 正则匹配
`static int`	`regexMatch(String source, String regex, Integer flags)` 正则匹配
`static String`	`removePrefix(String source)` 移除字符串前缀
`static String`	`removeSuffix(String source)` 移除字符串后缀
`static String`	`replaceFirst(String source, String mark, String replacement)` 替换第一个标志字符串
`static String`	`replaceLast(String source, String mark, String replacement)` 替换最后一个标志字符串
`static int`	`retract(String source)` 获取字符串的缩进
`static String`	`reverse(String source)` 翻转字符串输入1234 输出4321
`static String`	`rightPad(String source, int len, char c)` 右补齐
`static String[]`	`searchByRegex(String source, String regex)` 正则表达式查找匹配的被提取出来做数组
`static String[]`	`searchByRegex(String source, String regex, Integer flags)` 正则表达式查找匹配的被提取出来做数组
`static void`	`setChars(char[] argChars)`
`static String[]`	`split(String source, String regex)` 根据分割符把字符串分割成一个数组
`static byte[]`	`toAsciiBytes(String str)` 将字符串转化成 Ascii 的 byte[]
`static String`	`toAsciiString(byte[] bytes, int offset, int length)` byte 转字符串
`static String`	`tokenReplace(String source, List<Object> list)` 按照标识符 Map 进行替换
`static String`	`tokenReplace(String source, Map<String,?> tokens)` 按照标识符 Map 进行替换
`static String`	`tokenReplace(String source, Object... args)` 按位置格式化字符串 TString.tokenReplace("aaaa{1}bbbb{2}cccc{3}", "1","2","3") 或者TString.tokenReplace("aaaa{}bbbb{}cccc{}", "1","2","3") 输出aaaa1bbbb2cccc3
`static <T> T`	`toObject(String value, Type type)` 字符串转换为 Java 基本类型
`static <T> T`	`toObject(String value, Type type, boolean ignoreCase)` 字符串转换为 Java 基本类型
`static String`	`toUnicode(String source)` 字符串转 Unicode
`static String`	`trimEndLF(String source)` 移除字符串尾部的换行符
`static String`	`unConvertEscapeChar(String source)` 将可在字符串中表达的转义字符,转义成系统转义字符例如:将字符串中的 \\\" 转转成 \"
`static String`	`underlineToCamel(String param)` 下划线命名转驼峰命名
`static String`	`upperCaseHead(String source)` 单词首字母大写

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

- Field Detail
  - TOKEN_PREFIX
```
public static String TOKEN_PREFIX
```
  - TOKEN_SUFFIX
```
public static String TOKEN_SUFFIX
```
  - TOKEN_EMPTY
```
public static String TOKEN_EMPTY
```
  - TOKEN_PREFIX_REGEX
```
public static String TOKEN_PREFIX_REGEX
```
  - TOKEN_SUFFIX_REGEX
```
public static String TOKEN_SUFFIX_REGEX
```
  - TOKEN_EMPTY_REGEX
```
public static String TOKEN_EMPTY_REGEX
```
  - chars
```
public static char[] chars
```
  - unChars
```
public static Map<Character,Integer> unChars
```
- Constructor Detail
  - TString
```
public TString()
```
- Method Detail
  - upperCaseHead
```
public static String upperCaseHead(String source)
```
    单词首字母大写
    
    Parameters:
    
    source - 字符串
    
    Returns:
    
    首字母大写后的字符串
  - removePrefix
```
public static String removePrefix(String source)
```
    移除字符串前缀
    
    Parameters:
    
    source - 目标字符串
    
    Returns:
    
    移除第一个字节后的字符串
  - removeSuffix
```
public static String removeSuffix(String source)
```
    移除字符串后缀
    
    Parameters:
    
    source - 目标字符串
    
    Returns:
    
    移除最后一个字节后的字符串
  - leftPad
```
public static String leftPad(String source,
                             int len,
                             char c)
```
    左补齐
    
    Parameters:
    
    source - 目标字符串
    
    len - 补齐后字符串的长度
    
    c - 用于补齐的字符串
    
    Returns:
    
    补齐后的字符串
  - rightPad
```
public static String rightPad(String source,
                              int len,
                              char c)
```
    右补齐
    
    Parameters:
    
    source - 目标字符串
    
    len - 补齐后字符串的长度
    
    c - 用于补齐的字符串
    
    Returns:
    
    补齐后的字符串
  - isNumber
```
public static boolean isNumber(String numberString,
                               int radix)
```
    判断是否是指定进制的数字字符串
    
    Parameters:
    
    numberString - 目标字符串
    
    radix - 进制
    
    Returns:
    
    是否是指定进制的数字字符串
  - isInteger
```
public static boolean isInteger(String integerString)
```
    判断是否是整形数
    
    Parameters:
    
    integerString - 数字字符串
    
    Returns:
    
    是否是整形数
  - isDecimal
```
public static boolean isDecimal(String decimalString)
```
    判断是否是浮点数
    
    Parameters:
    
    decimalString - 浮点数字符串
    
    Returns:
    
    是否是浮点数
  - isBoolean
```
public static boolean isBoolean(String booleanString)
```
    判断是否是布尔值
    
    Parameters:
    
    booleanString - 布尔值字符串
    
    Returns:
    
    是否是布尔值
  - doRegex
```
public static Matcher doRegex(String source,
                              String regex)
```
    执行正则运算
    
    Parameters:
    
    source - 目标字符串
    
    regex - 正则表达式
    
    Returns:
    
    Matcher对象
  - doRegex
```
public static Matcher doRegex(String source,
                              String regex,
                              Integer flags)
```
    执行正则运算
    
    Parameters:
    
    source - 目标字符串
    
    regex - 正则表达式
    
    flags - 正则匹配标记 CASE_INSENSITIVE, MULTILINE, DOTALL, UNICODE_CASE, CANON_EQ, UNIX_LINES, LITERAL, UNICODE_CHARACTER_CLASS, COMMENTS
    
    Returns:
    
    Matcher对象
  - searchByRegex
```
public static String[] searchByRegex(String source,
                                     String regex)
```
    正则表达式查找匹配的被提取出来做数组
    
    Parameters:
    
    source - 目标字符串
    
    regex - 正则表达式
    
    Returns:
    
    匹配的字符串数组
  - searchByRegex
```
public static String[] searchByRegex(String source,
                                     String regex,
                                     Integer flags)
```
    正则表达式查找匹配的被提取出来做数组
    
    Parameters:
    
    source - 目标字符串
    
    regex - 正则表达式
    
    flags - 正则匹配标记 CASE_INSENSITIVE, MULTILINE, DOTALL, UNICODE_CASE, CANON_EQ, UNIX_LINES, LITERAL, UNICODE_CHARACTER_CLASS, COMMENTS
    
    Returns:
    
    匹配的字符串数组
  - regexMatch
```
public static int regexMatch(String source,
                             String regex)
```
    正则匹配
    
    Parameters:
    
    source - 目标字符串
    
    regex - 正则表达式
    
    Returns:
    
    正则搜索后得到的匹配数量
  - regexMatch
```
public static int regexMatch(String source,
                             String regex,
                             Integer flags)
```
    正则匹配
    
    Parameters:
    
    source - 目标字符串
    
    regex - 正则表达式
    
    flags - 正则匹配标记 CASE_INSENSITIVE, MULTILINE, DOTALL, UNICODE_CASE, CANON_EQ, UNIX_LINES, LITERAL, UNICODE_CHARACTER_CLASS, COMMENTS
    
    Returns:
    
    正则搜索后得到的匹配数量
  - fastReplaceAll
```
public static String fastReplaceAll(String source,
                                    String regex,
                                    String replacement)
```
    快速字符串替换算法默认正在 flag = 0, quoteReplacement = true
    
    Parameters:
    
    source - 源字符串
    
    regex - 正则字符串
    
    replacement - 替换字符串
    
    Returns:
    
    替换后的字符串
  - fastReplaceAll
```
public static String fastReplaceAll(String source,
                                    String regex,
                                    String replacement,
                                    boolean quoteReplacement)
```
    快速字符串替换算法默认正在 flag = 0
    
    Parameters:
    
    source - 源字符串
    
    regex - 正则字符串
    
    replacement - 替换字符串
    
    quoteReplacement - 对 replacement 是否进行转移
    
    Returns:
    
    替换后的字符串
  - fastReplaceAll
```
public static String fastReplaceAll(String source,
                                    String regex,
                                    String replacement,
                                    Integer flags,
                                    boolean quoteReplacement)
```
    快速字符串替换算法
    
    Parameters:
    
    source - 源字符串
    
    regex - 正则字符串
    
    replacement - 替换字符串
    
    flags - 正则匹配标记 CASE_INSENSITIVE, MULTILINE, DOTALL, UNICODE_CASE, CANON_EQ, UNIX_LINES, LITERAL, UNICODE_CHARACTER_CLASS, COMMENTS
    
    quoteReplacement - 对 replacement 是否进行转移
    
    Returns:
    
    替换后的字符串
  - fastReplaceFirst
```
public static String fastReplaceFirst(String source,
                                      String regex,
                                      String replacement)
```
    快速字符串替换算法默认正在 flag = 0, quoteReplacement = true
    
    Parameters:
    
    source - 源字符串
    
    regex - 正则字符串
    
    replacement - 替换字符串
    
    Returns:
    
    替换后的字符串
  - fastReplaceFirst
```
public static String fastReplaceFirst(String source,
                                      String regex,
                                      String replacement,
                                      boolean quoteReplacement)
```
    快速字符串替换算法默认正在 flag = 0
    
    Parameters:
    
    source - 源字符串
    
    regex - 正则字符串
    
    replacement - 替换字符串
    
    quoteReplacement - 对 replacement 是否进行转移
    
    Returns:
    
    替换后的字符串
  - fastReplaceFirst
```
public static String fastReplaceFirst(String source,
                                      String regex,
                                      String replacement,
                                      Integer flags,
                                      boolean quoteReplacement)
```
    快速字符串替换算法
    
    Parameters:
    
    source - 源字符串
    
    regex - 正则字符串
    
    replacement - 替换字符串
    
    flags - 正则匹配标记 CASE_INSENSITIVE, MULTILINE, DOTALL, UNICODE_CASE, CANON_EQ, UNIX_LINES, LITERAL, UNICODE_CHARACTER_CLASS, COMMENTS
    
    quoteReplacement - 对 replacement 是否进行转移
    
    Returns:
    
    替换后的字符串
  - isNullOrEmpty
```
public static boolean isNullOrEmpty(String source)
```
    判断字符串空指针或者内容为空
    
    Parameters:
    
    source - 字符串
    
    Returns:
    
    是否是空指针或者内容为空
  - tokenReplace
```
public static String tokenReplace(String source,
                                  Map<String,?> tokens)
```
    按照标识符 Map 进行替换
    
    Parameters:
    
    source - 源字符串,标识符使用"{标识}"进行包裹,这些标识符将会被替换
    
    tokens - 标识符 Map, 包含匹配字符串和替换字符串
    
    Returns:
    
    替换后的字符串
  - tokenReplace
```
public static String tokenReplace(String source,
                                  List<Object> list)
```
    按照标识符 Map 进行替换
    
    Parameters:
    
    source - 源字符串,标识符使用"{标识}"进行包裹,这些标识符将会被替换
    
    list - 数据 List 集合
    
    Returns:
    
    替换后的字符串
  - tokenReplace
```
public static String tokenReplace(String source,
                                  Object... args)
```
    按位置格式化字符串 TString.tokenReplace("aaaa{1}bbbb{2}cccc{3}", "1","2","3") 或者TString.tokenReplace("aaaa{}bbbb{}cccc{}", "1","2","3") 输出aaaa1bbbb2cccc3
    
    Parameters:
    
    source - 字符串
    
    args - 多个参数
    
    Returns:
    
    格式化后的字符串
  - oneTokenReplace
```
public static String oneTokenReplace(String source,
                                     String tokenName,
                                     String tokenValue)
```
    按照标识符进行替换 tokenName 为 null 则使用 {} 进行替换如果为 tokenName 为数字可以不在标识中填写数字标识,会自动按照标识的先后顺序进行替换
    
    Parameters:
    
    source - 源字符串,标识符使用"{标识}"进行包裹
    
    tokenName - 标识符
    
    tokenValue - 标志符值
    
    Returns:
    
    替换后的字符串
  - replaceFirst
```
public static String replaceFirst(String source,
                                  String mark,
                                  String replacement)
```
    替换第一个标志字符串
    
    Parameters:
    
    source - 字符串
    
    mark - 标志字符
    
    replacement - 替换字符
    
    Returns:
    
    替换后的结果
  - replaceLast
```
public static String replaceLast(String source,
                                 String mark,
                                 String replacement)
```
    替换最后一个标志字符串
    
    Parameters:
    
    source - 字符串
    
    mark - 标志字符
    
    replacement - 替换字符
    
    Returns:
    
    替换后的结果
  - indent
```
public static String indent(String source,
                            int indentCount)
```
    缩进字符串
    
    Parameters:
    
    source - 待缩进的字符串
    
    indentCount - 缩进数(空格的数目)
    
    Returns:
    
    缩进后的字符串
  - reverse
```
public static String reverse(String source)
```
    翻转字符串输入1234 输出4321
    
    Parameters:
    
    source - 字符串
    
    Returns:
    
    翻转后的字符串
  - convertEscapeChar
```
public static String convertEscapeChar(String source)
```
    将系统转义字符,转义成可在字符串表达的转义字符例如:将字符串中的 \" 转转成 \\\"
    
    Parameters:
    
    source - 源字符串
    
    Returns:
    
    转换后的字符串
  - unConvertEscapeChar
```
public static String unConvertEscapeChar(String source)
```
    将可在字符串中表达的转义字符,转义成系统转义字符例如:将字符串中的 \\\" 转转成 \"
    
    Parameters:
    
    source - 源字符串
    
    Returns:
    
    转换后的字符串
  - toUnicode
```
public static String toUnicode(String source)
```
    字符串转 Unicode
    
    Parameters:
    
    source - 字符串
    
    Returns:
    
    unicode 字符串
  - fromUnicode
```
public static String fromUnicode(String source)
```
    Unicode 转字符串
    
    Parameters:
    
    source - unicode 字符串
    
    Returns:
    
    string 字符串
  - toObject
```
public static <T> T toObject(String value,
                             Type type,
                             boolean ignoreCase)
```
    字符串转换为 Java 基本类型
    
    Type Parameters:
    
    T - 范型
    
    Parameters:
    
    value - 字符串字面值
    
    type - Type类型
    
    ignoreCase - 是否在字段匹配时忽略大小写
    
    Returns:
    
    基本类型对象
  - toObject
```
public static <T> T toObject(String value,
                             Type type)
```
    字符串转换为 Java 基本类型
    
    Type Parameters:
    
    T - 范型
    
    Parameters:
    
    value - 字符串字面值
    
    type - Type类型
    
    Returns:
    
    基本类型对象
  - setChars
```
public static void setChars(char[] argChars)
```
  - radixConvert
```
public static String radixConvert(long num,
                                  int radix)
```
  - radixUnConvert
```
public static long radixUnConvert(String str,
                                  int radix)
```
  - radixBigConvert
```
public static String radixBigConvert(BigDecimal n_num,
                                     int n_radix)
```
  - radixBigUnConvert
```
public static BigDecimal radixBigUnConvert(String str,
                                           int n_radix)
```
  - generateShortUUID
```
public static String generateShortUUID()
```
    生成短 UUID
    
    Returns:
    
    生成的短 UUID
  - generateId
```
public static String generateId()
```
    快速生成短ID
    
    Returns:
    
    快速生成短的ID
  - generateId
```
public static String generateId(Object obj)
```
    快速生成短ID
    
    Parameters:
    
    obj - 生成 id 的对象
    
    Returns:
    
    快速生成短的ID
  - generateId
```
public static String generateId(Object obj,
                                String sign)
```
    快速生成短ID
    
    Parameters:
    
    obj - 生成 id 的对象
    
    sign - 生成 ID 的标记
    
    Returns:
    
    快速生成短的ID
  - maxLineLength
```
public static int maxLineLength(String source)
```
    获取字符串中最长一行的长度
    
    Parameters:
    
    source - unicode 字符串
    
    Returns:
    
    最长一行的长度
  - split
```
public static String[] split(String source,
                             String regex)
```
    根据分割符把字符串分割成一个数组
    
    Parameters:
    
    source - 源字符串
    
    regex - 正则分割符
    
    Returns:
    
    字符串数组
  - insert
```
public static String insert(String source,
                            int position,
                            String value)
```
    在字符串中插入字符
    
    Parameters:
    
    source - 源字符串
    
    position - 插入位置, 从 1 开始
    
    value - 插入的字符串
    
    Returns:
    
    插入后的字符串数据
  - trimEndLF
```
public static String trimEndLF(String source)
```
    移除字符串尾部的换行符
    
    Parameters:
    
    source - 源字符串
    
    Returns:
    
    处理后的字符串
  - retract
```
public static int retract(String source)
```
    获取字符串的缩进
    
    Parameters:
    
    source - 源字符串
    
    Returns:
    
    缩进
  - camelToUnderline
```
public static String camelToUnderline(String param)
```
    驼峰命名转下划线命名
    
    Parameters:
    
    param - 驼峰命名字符串
    
    Returns:
    
    下划线命名字符串
  - underlineToCamel
```
public static String underlineToCamel(String param)
```
    下划线命名转驼峰命名
    
    Parameters:
    
    param - 下划线命名字符串
    
    Returns:
    
    驼峰命名字符串
  - assembly
```
public static String assembly(Object... items)
```
    字符串快捷拼装方法
    
    Parameters:
    
    items - 需要拼装的字符串
    
    Returns:
    
    拼装后的字符串
  - toAsciiBytes
```
public static byte[] toAsciiBytes(String str)
```
    将字符串转化成 Ascii 的 byte[]
    
    Parameters:
    
    str - 需要转换的字符串
    
    Returns:
    
    转换后的字节队列
  - toAsciiString
```
public static String toAsciiString(byte[] bytes,
                                   int offset,
                                   int length)
```
    byte 转字符串
    
    Parameters:
    
    bytes - 字节数据
    
    offset - 字节数据偏移量
    
    length - 长度
    
    Returns:
    
    转换后的字符串
  - readLine
```
public static String readLine(String str,
                              int beginIndex)
```
    从指定位置读取一行字符串
    
    Parameters:
    
    str - 读取的字符串
    
    beginIndex - 起始位置
    
    Returns:
    
    读取的一行字符串, null 读取到结尾
  - formatBytes
```
public static String formatBytes(long byteCount)
```
    格式化计算机字节单位的存储容量为文本
    
    Parameters:
    
    byteCount - 字节数
    
    Returns:
    
    格式化后的字符串
  - formatNumber
```
public static String formatNumber(long value,
                                  String unit)
```
    按数学技术格式化数字为文本
    
    Parameters:
    
    value - 数量
    
    unit - 单位(K,M,G,T,P,E)
    
    Returns:
    
    格式化后的字符串

Class TString

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

TOKEN_PREFIX

TOKEN_SUFFIX

TOKEN_EMPTY

TOKEN_PREFIX_REGEX

TOKEN_SUFFIX_REGEX

TOKEN_EMPTY_REGEX

chars

unChars

Constructor Detail

TString

Method Detail

upperCaseHead

removePrefix

removeSuffix

leftPad

rightPad

isNumber

isInteger

isDecimal

isBoolean

doRegex

doRegex

searchByRegex

searchByRegex

regexMatch

regexMatch

fastReplaceAll

fastReplaceAll

fastReplaceAll

fastReplaceFirst

fastReplaceFirst

fastReplaceFirst

isNullOrEmpty

tokenReplace

tokenReplace

tokenReplace

oneTokenReplace

replaceFirst

replaceLast

indent

reverse

convertEscapeChar

unConvertEscapeChar

toUnicode

fromUnicode

toObject

toObject

setChars

radixConvert

radixUnConvert

radixBigConvert

radixBigUnConvert

generateShortUUID

generateId

generateId

generateId

maxLineLength

split

insert

trimEndLF

retract

camelToUnderline

underlineToCamel

assembly

toAsciiBytes

toAsciiString

readLine

formatBytes

formatNumber