org.nutz.lang

类 Strings

java.lang.Object

org.nutz.lang.Strings

public class Strings
extends java.lang.Object

字符串操作的帮助函数

构造器概要

构造器

限定符	构造器和说明
protected	Strings()

方法概要

限定符和类型	方法和说明
static java.lang.String	alignLeft(java.lang.Object o, int width, char c) 在字符串右侧填充一定数量的特殊字符
static java.lang.String	alignRight(java.lang.Object o, int width, char c) 在字符串左侧填充一定数量的特殊字符
static java.lang.String	brief(java.lang.String str, int len) 将给定字符串，变成 "xxx...xxx" 形式的字符串
static java.lang.String	capitalize(java.lang.CharSequence s) 已过时。 推荐使用 upperFirst(CharSequence)
static java.lang.String	changeCharset(java.lang.CharSequence cs, java.nio.charset.Charset newCharset) 改变字符编码集
static int	charLength(java.lang.CharSequence str) 计算字符串的字符长度(全角算2, 半角算1)
static java.lang.String	cutLeft(java.lang.String s, int width, char c) 保证字符串为一固定长度。
static java.lang.String	cutRight(java.lang.String s, int width, char c) 保证字符串为一固定长度。
static java.lang.String	dup(char c, int num) 复制字符
static java.lang.String	dup(java.lang.CharSequence cs, int num) 复制字符串
static boolean	endsWithChar(java.lang.String s, char c) 判断字符串是否以特殊字符结尾
static boolean	equals(java.lang.String s1, java.lang.String s2) 检查两个字符串是否相等.
static boolean	equalsIgnoreCase(java.lang.String s1, java.lang.String s2) 检查两个字符串的忽略大小写后是否相等.
static java.lang.String	escapeHtml(java.lang.CharSequence cs) 将一个字符串出现的HMTL元素进行转义，比如 escapeHtml("<script>alert("hello world");</script>") => "&lt;script&gt;alert(&quot;hello world&quot;);&lt;/script&gt;" 转义字符对应如下 & => &amp; < => &lt; >=> &gt; ' => &#x27; " => &quot;
static java.lang.String	evalEscape(java.lang.String str) 将字符串根据转移字符转移
static java.lang.String	fillBinary(int d, int width) 将一个整数转换成最小长度为某一固定数值的二进制形式字符串
static java.lang.String	fillDigit(int d, int width) 将一个整数转换成最小长度为某一固定数值的十进制形式字符串
static java.lang.String	fillHex(int d, int width) 将一个整数转换成最小长度为某一固定数值的十六进制形式字符串
static java.lang.String	formatSizeForReadBy1000(long size)
static java.lang.String	formatSizeForReadBy1024(long size)
static byte[]	getBytesUTF8(java.lang.CharSequence cs) 使用 UTF-8 编码将字符串编码为 byte 序列，并将结果存储到新的 byte 数组
static int	hex2num(java.lang.String hex) 十六进制字符串转换为数字
static boolean	isBlank(java.lang.CharSequence cs) 如果此字符串为 null 或者全为空白字符，则返回 true
static boolean	isChineseCharacter(char c) 是中文字符吗?
static boolean	isEmail(java.lang.CharSequence input) 检查一个字符串是否为合法的电子邮件地址
static boolean	isEmpty(java.lang.CharSequence cs) 如果此字符串为 null 或者为空串（""），则返回 true
static boolean	isFullWidthCharacter(char c) 判断字符是否为全角字符
static boolean	isFullWidthString(java.lang.CharSequence str) 判断是否是全角字符串(所有字符都是全角)
static boolean	isHalfWidthString(java.lang.CharSequence str) 判断是否是半角字符串(所有字符都是半角)
static boolean	isin(java.lang.String[] ss, java.lang.String s) 判断一个字符串数组是否包括某一字符串
static boolean	isNotBlank(java.lang.CharSequence cs)
static boolean	isQuoteBy(java.lang.CharSequence cs, char lc, char rc) 测试此字符串是否被指定的左字符和右字符所包裹
static boolean	isQuoteBy(java.lang.String str, java.lang.String l, java.lang.String r) 测试此字符串是否被指定的左字符串和右字符串所包裹
static boolean	isQuoteByIgnoreBlank(java.lang.CharSequence cs, char lc, char rc) 测试此字符串是否被指定的左字符和右字符所包裹；如果该字符串左右两边有空白的时候，会首先忽略这些空白
static <T> java.lang.String	join(java.lang.String sp, T... array) 使用给定的分隔符, 将一个数组拼接成字符串
static <T> java.lang.String	join2(java.lang.String sp, T[] array) 使用给定的分隔符, 将一个数组拼接成字符串
static java.lang.String	lowerFirst(java.lang.CharSequence s) 将字符串首字母小写
static java.lang.String	lowerWord(java.lang.CharSequence cs, char c) 将一个字符串由驼峰式命名变成分割符分隔单词 lowerWord("helloWorld", '-') => "hello-world"
static int	maxLength(java.util.Collection<? extends java.lang.CharSequence> coll) 获得一个字符串集合中，最长串的长度
static <T extends java.lang.CharSequence> int	maxLength(T[] array) 获得一个字符串数组中，最长串的长度
static java.lang.String	num2hex(int n) 将数字转为十六进制字符串, 默认要使用2个字符(暂时没考虑负数)
static java.lang.String	removeFirst(java.lang.CharSequence str) 截去第一个字符 比如: removeFirst("12345") => 2345 removeFirst("A") => ""
static java.lang.String	removeFirst(java.lang.String str, char c) 如果str中第一个字符和 c一致,则删除,否则返回 str 比如: removeFirst("12345",1) => "2345" removeFirst("ABC",'B') => "ABC" removeFirst("A",'B') => "A" removeFirst("A",'A') => ""
static java.lang.String	safeToString(java.lang.Object obj, java.lang.String dft)
static java.lang.String	sBlank(java.lang.Object obj) 对指定对象进行 toString 操作；如果该对象为 null ，则返回空串（""）
static java.lang.String	sBlank(java.lang.Object obj, java.lang.String def) 对指定对象进行 toString 操作；如果该对象为 null 或者 toString 方法为空串（""），则返回默认值
static java.lang.String	sNull(java.lang.Object obj) 对指定对象进行 toString 操作；如果该对象为 null ，则返回空串（""）
static java.lang.String	sNull(java.lang.Object obj, java.lang.String def) 对指定对象进行 toString 操作；如果该对象为 null ，则返回默认值
static java.lang.String[]	split(java.lang.String str, boolean keepQuote, boolean keepBlank, char... seps) 将字符串按照某个或几个分隔符拆分。
static java.lang.String[]	split(java.lang.String str, boolean keepQuote, char... seps)
static java.lang.String[]	splitIgnoreBlank(java.lang.String s) 将字符串按半角逗号，拆分成数组，空元素将被忽略
static java.lang.String[]	splitIgnoreBlank(java.lang.String s, java.lang.String regex) 根据一个正则式，将字符串拆分成数组，空元素将被忽略
static boolean	startsWithChar(java.lang.String s, char c) 判断字符串是否以特殊字符开头
static java.lang.String	toBinary(int d, int width) 将一个整数转换成固定长度的二进制形式字符串
static java.lang.String	toDigit(int d, int width) 将一个整数转换成固定长度的十进制形式字符串
static char	toHalfWidthCharacter(char c) 转换成半角字符
static java.lang.String	toHalfWidthString(java.lang.CharSequence str) 转换为半角字符串
static java.lang.String	toHex(int d, int width) 将一个整数转换成固定长度的十六进制形式字符串
static java.lang.String	trim(java.lang.CharSequence cs) 去掉字符串前后空白字符。
static java.lang.String	trimLeft(java.lang.CharSequence cs)
static java.lang.String	trimRight(java.lang.CharSequence cs)
static java.lang.String	upperFirst(java.lang.CharSequence s) 将字符串首字母大写
static java.lang.String	upperWord(java.lang.CharSequence cs, char c) 将一个字符串某一个字符后面的字母变成大写，比如 upperWord("hello-world", '-') => "helloWorld"

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

Strings

protected Strings()

方法详细资料

isChineseCharacter

public static boolean isChineseCharacter(char c)

是中文字符吗?

参数:

c - 待判定字符

返回:

判断结果

isFullWidthCharacter

public static boolean isFullWidthCharacter(char c)

判断字符是否为全角字符

参数:

c - 字符

返回:

判断结果

toHalfWidthCharacter

public static char toHalfWidthCharacter(char c)

转换成半角字符

参数:

c - 待转换字符

返回:

转换后的字符

toHalfWidthString

public static java.lang.String toHalfWidthString(java.lang.CharSequence str)

转换为半角字符串

参数:

str - 待转换字符串

返回:

转换后的字符串

isFullWidthString

public static boolean isFullWidthString(java.lang.CharSequence str)

判断是否是全角字符串(所有字符都是全角)

参数:

str - 被判断的字符串

返回:

判断结果

isHalfWidthString

public static boolean isHalfWidthString(java.lang.CharSequence str)

判断是否是半角字符串(所有字符都是半角)

参数:

str - 被判断的字符串

返回:

判断结果

charLength

public static int charLength(java.lang.CharSequence str)

计算字符串的字符长度(全角算2, 半角算1)

参数:

str - 被计算的字符串

返回:

字符串的字符长度

dup

public static java.lang.String dup(java.lang.CharSequence cs,
                                   int num)

复制字符串

参数:

cs - 字符串

num - 数量

返回:

新字符串

dup

public static java.lang.String dup(char c,
                                   int num)

复制字符

参数:

c - 字符

num - 数量

返回:

新字符串

capitalize

public static java.lang.String capitalize(java.lang.CharSequence s)

已过时。 推荐使用 upperFirst(CharSequence)

将字符串首字母大写

参数:

s - 字符串

返回:

首字母大写后的新字符串

lowerFirst

public static java.lang.String lowerFirst(java.lang.CharSequence s)

将字符串首字母小写

参数:

s - 字符串

返回:

首字母小写后的新字符串

upperFirst

public static java.lang.String upperFirst(java.lang.CharSequence s)

将字符串首字母大写

参数:

s - 字符串

返回:

首字母大写后的新字符串

equalsIgnoreCase

public static boolean equalsIgnoreCase(java.lang.String s1,
                                       java.lang.String s2)

检查两个字符串的忽略大小写后是否相等.

参数:

s1 - 字符串A

s2 - 字符串B

返回:

true 如果两个字符串忽略大小写后相等,且两个字符串均不为null

equals

public static boolean equals(java.lang.String s1,
                             java.lang.String s2)

检查两个字符串是否相等.

参数:

s1 - 字符串A

s2 - 字符串B

返回:

true 如果两个字符串相等,且两个字符串均不为null

startsWithChar

public static boolean startsWithChar(java.lang.String s,
                                     char c)

判断字符串是否以特殊字符开头

参数:

s - 字符串

c - 特殊字符

返回:

是否以特殊字符开头

endsWithChar

public static boolean endsWithChar(java.lang.String s,
                                   char c)

判断字符串是否以特殊字符结尾

参数:

s - 字符串

c - 特殊字符

返回:

是否以特殊字符结尾

isEmpty

public static boolean isEmpty(java.lang.CharSequence cs)

如果此字符串为 null 或者为空串（""），则返回 true

参数:

cs - 字符串

返回:

如果此字符串为 null 或者为空，则返回 true

isBlank

public static boolean isBlank(java.lang.CharSequence cs)

如果此字符串为 null 或者全为空白字符，则返回 true

参数:

cs - 字符串

返回:

如果此字符串为 null 或者全为空白字符，则返回 true

isNotBlank

public static boolean isNotBlank(java.lang.CharSequence cs)

trim

public static java.lang.String trim(java.lang.CharSequence cs)

去掉字符串前后空白字符。空白字符的定义由Character.isWhitespace来判断

参数:

cs - 字符串

返回:

去掉了前后空白字符的新字符串

trimLeft

public static java.lang.String trimLeft(java.lang.CharSequence cs)

trimRight

public static java.lang.String trimRight(java.lang.CharSequence cs)

brief

public static java.lang.String brief(java.lang.String str,
                                     int len)

将给定字符串，变成 "xxx...xxx" 形式的字符串

参数:

str - 字符串

len - 最大长度

返回:

紧凑的字符串

splitIgnoreBlank

public static java.lang.String[] splitIgnoreBlank(java.lang.String s)

将字符串按半角逗号，拆分成数组，空元素将被忽略

参数:

s - 字符串

返回:

字符串数组

splitIgnoreBlank

public static java.lang.String[] splitIgnoreBlank(java.lang.String s,
                                                  java.lang.String regex)

根据一个正则式，将字符串拆分成数组，空元素将被忽略

参数:

s - 字符串

regex - 正则式

返回:

字符串数组

fillDigit

public static java.lang.String fillDigit(int d,
                                         int width)

将一个整数转换成最小长度为某一固定数值的十进制形式字符串

参数:

d - 整数

width - 宽度

返回:

新字符串

fillHex

public static java.lang.String fillHex(int d,
                                       int width)

将一个整数转换成最小长度为某一固定数值的十六进制形式字符串

参数:

d - 整数

width - 宽度

返回:

新字符串

fillBinary

public static java.lang.String fillBinary(int d,
                                          int width)

将一个整数转换成最小长度为某一固定数值的二进制形式字符串

参数:

d - 整数

width - 宽度

返回:

新字符串

toDigit

public static java.lang.String toDigit(int d,
                                       int width)

将一个整数转换成固定长度的十进制形式字符串

参数:

d - 整数

width - 宽度

返回:

新字符串

toHex

public static java.lang.String toHex(int d,
                                     int width)

将一个整数转换成固定长度的十六进制形式字符串

参数:

d - 整数

width - 宽度

返回:

新字符串

toBinary

public static java.lang.String toBinary(int d,
                                        int width)

将一个整数转换成固定长度的二进制形式字符串

参数:

d - 整数

width - 宽度

返回:

新字符串

cutRight

public static java.lang.String cutRight(java.lang.String s,
                                        int width,
                                        char c)

保证字符串为一固定长度。超过长度，切除右侧字符，否则右侧填补字符。

参数:

s - 字符串

width - 长度

c - 补字符

返回:

修饰后的字符串

cutLeft

public static java.lang.String cutLeft(java.lang.String s,
                                       int width,
                                       char c)

保证字符串为一固定长度。超过长度，切除左侧字符，否则左侧填补字符。

参数:

s - 字符串

width - 长度

c - 补字符

返回:

修饰后的字符串

alignRight

public static java.lang.String alignRight(java.lang.Object o,
                                          int width,
                                          char c)

在字符串左侧填充一定数量的特殊字符

参数:

o - 可被 toString 的对象

width - 字符数量

c - 字符

返回:

新字符串

alignLeft

public static java.lang.String alignLeft(java.lang.Object o,
                                         int width,
                                         char c)

在字符串右侧填充一定数量的特殊字符

参数:

o - 可被 toString 的对象

width - 字符数量

c - 字符

返回:

新字符串

isQuoteByIgnoreBlank

public static boolean isQuoteByIgnoreBlank(java.lang.CharSequence cs,
                                           char lc,
                                           char rc)

测试此字符串是否被指定的左字符和右字符所包裹；如果该字符串左右两边有空白的时候，会首先忽略这些空白

参数:

cs - 字符串

lc - 左字符

rc - 右字符

返回:

字符串是被左字符和右字符包裹

isQuoteBy

public static boolean isQuoteBy(java.lang.CharSequence cs,
                                char lc,
                                char rc)

测试此字符串是否被指定的左字符和右字符所包裹

参数:

cs - 字符串

lc - 左字符

rc - 右字符

返回:

字符串是被左字符和右字符包裹

isQuoteBy

public static boolean isQuoteBy(java.lang.String str,
                                java.lang.String l,
                                java.lang.String r)

测试此字符串是否被指定的左字符串和右字符串所包裹

参数:

str - 字符串

l - 左字符串

r - 右字符串

返回:

字符串是被左字符串和右字符串包裹

maxLength

public static int maxLength(java.util.Collection<? extends java.lang.CharSequence> coll)

获得一个字符串集合中，最长串的长度

参数:

coll - 字符串集合

返回:

最大长度

maxLength

public static <T extends java.lang.CharSequence> int maxLength(T[] array)

获得一个字符串数组中，最长串的长度

参数:

array - 字符串数组

返回:

最大长度

sNull

public static java.lang.String sNull(java.lang.Object obj)

对指定对象进行 toString 操作；如果该对象为 null ，则返回空串（""）

参数:

obj - 指定的对象

返回:

对指定对象进行 toString 操作；如果该对象为 null ，则返回空串（""）

sNull

public static java.lang.String sNull(java.lang.Object obj,
                                     java.lang.String def)

对指定对象进行 toString 操作；如果该对象为 null ，则返回默认值

参数:

obj - 指定的对象

def - 默认值

返回:

对指定对象进行 toString 操作；如果该对象为 null ，则返回默认值

sBlank

public static java.lang.String sBlank(java.lang.Object obj)

对指定对象进行 toString 操作；如果该对象为 null ，则返回空串（""）

参数:

obj - 指定的对象

返回:

对指定对象进行 toString 操作；如果该对象为 null ，则返回空串（""）

sBlank

public static java.lang.String sBlank(java.lang.Object obj,
                                      java.lang.String def)

对指定对象进行 toString 操作；如果该对象为 null 或者 toString 方法为空串（""），则返回默认值

参数:

obj - 指定的对象

def - 默认值

返回:

对指定对象进行 toString 操作；如果该对象为 null 或者 toString 方法为空串（""），则返回默认值

removeFirst

public static java.lang.String removeFirst(java.lang.CharSequence str)

截去第一个字符

比如:

• removeFirst("12345") => 2345
• removeFirst("A") => ""

参数:

str - 字符串

返回:

新字符串

removeFirst

public static java.lang.String removeFirst(java.lang.String str,
                                           char c)

如果str中第一个字符和 c一致,则删除,否则返回 str

比如:

• removeFirst("12345",1) => "2345"
• removeFirst("ABC",'B') => "ABC"
• removeFirst("A",'B') => "A"
• removeFirst("A",'A') => ""

参数:

str - 字符串

c - 第一个个要被截取的字符

返回:

新字符串

isin

public static boolean isin(java.lang.String[] ss,
                           java.lang.String s)

判断一个字符串数组是否包括某一字符串

参数:

ss - 字符串数组

s - 字符串

返回:

是否包含

isEmail

public static final boolean isEmail(java.lang.CharSequence input)

检查一个字符串是否为合法的电子邮件地址

参数:

input - 需要检查的字符串

返回:

true 如果是有效的邮箱地址

lowerWord

public static java.lang.String lowerWord(java.lang.CharSequence cs,
                                         char c)

将一个字符串由驼峰式命名变成分割符分隔单词

  lowerWord("helloWorld", '-') => "hello-world"
 

参数:

cs - 字符串

c - 分隔符

返回:

转换后字符串

upperWord

public static java.lang.String upperWord(java.lang.CharSequence cs,
                                         char c)

将一个字符串某一个字符后面的字母变成大写，比如

  upperWord("hello-world", '-') => "helloWorld"
 

参数:

cs - 字符串

c - 分隔符

返回:

转换后字符串

escapeHtml

public static java.lang.String escapeHtml(java.lang.CharSequence cs)

将一个字符串出现的HMTL元素进行转义，比如

  escapeHtml("<script>alert("hello world");</script>") => "&lt;script&gt;alert(&quot;hello world&quot;);&lt;/script&gt;"
 

转义字符对应如下

• & => &
• < => &lt;
• >=> &gt;
• ' => &#x27;
• " => &quot;

参数:

cs - 字符串

返回:

转换后字符串

getBytesUTF8

public static byte[] getBytesUTF8(java.lang.CharSequence cs)

使用 UTF-8 编码将字符串编码为 byte 序列，并将结果存储到新的 byte 数组

参数:

cs - 字符串

返回:

UTF-8编码后的 byte 数组

num2hex

public static java.lang.String num2hex(int n)

将数字转为十六进制字符串, 默认要使用2个字符(暂时没考虑负数)

参数:

n - 数字

返回:

十六进制字符串

hex2num

public static int hex2num(java.lang.String hex)

十六进制字符串转换为数字

参数:

hex - 十六进制字符串

返回:

十进制数字

join2

public static <T> java.lang.String join2(java.lang.String sp,
                                         T[] array)

使用给定的分隔符, 将一个数组拼接成字符串

参数:

sp - 分隔符

array - 要拼接的数组

返回:

拼接好的字符串

join

public static <T> java.lang.String join(java.lang.String sp,
                                        T... array)

使用给定的分隔符, 将一个数组拼接成字符串

参数:

sp - 分隔符

array - 要拼接的数组

返回:

拼接好的字符串

formatSizeForReadBy1024

public static java.lang.String formatSizeForReadBy1024(long size)

另请参阅:

_formatSizeForRead(long, double)

formatSizeForReadBy1000

public static java.lang.String formatSizeForReadBy1000(long size)

另请参阅:

_formatSizeForRead(long, double)

changeCharset

public static java.lang.String changeCharset(java.lang.CharSequence cs,
                                             java.nio.charset.Charset newCharset)

改变字符编码集

参数:

cs - 原字符串

newCharset - 指定的新编码集

返回:

新字符集编码的字符串

evalEscape

public static java.lang.String evalEscape(java.lang.String str)

将字符串根据转移字符转移

参数:

str - 字符串

返回:

转移后的字符串

split

public static java.lang.String[] split(java.lang.String str,
                                       boolean keepQuote,
                                       char... seps)

另请参阅:

split(String, boolean, boolean, char...)

split

public static java.lang.String[] split(java.lang.String str,
                                       boolean keepQuote,
                                       boolean keepBlank,
                                       char... seps)

将字符串按照某个或几个分隔符拆分。 其中，遇到字符串 "..." 或者 '...' 并不拆分

参数:

str - 要被拆分的字符串

keepQuote - 是否保持引号

seps - 分隔符

返回:

拆分后的数组

safeToString

public static java.lang.String safeToString(java.lang.Object obj,
                                            java.lang.String dft)