org.nutz.lang
类 Strings

java.lang.Object
  org.nutz.lang.Strings

public abstract class Strings
extends java.lang.Object

字符串操作的帮助函数

作者：

zozoh(zozohtnt@gmail.com), wendal(wendal1985@gmail.com), mawm(ming300@gmail.com), bonyfish(mc02cxj@gmail.com)

构造方法摘要

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) 将字符串首字母大写
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	fillBinary(int d, int width) 将一个整数转换成最小长度为某一固定数值的二进制形式字符串
static java.lang.String	fillDigit(int d, int width) 将一个整数转换成最小长度为某一固定数值的十进制形式字符串
static java.lang.String	fillHex(int d, int width) 将一个整数转换成最小长度为某一固定数值的十六进制形式字符串
static boolean	isBlank(java.lang.CharSequence cs)
static boolean	isEmail(java.lang.CharSequence input) 检查一个字符串是否为合法的电子邮件地址
static boolean	isEmpty(java.lang.CharSequence cs)
static boolean	isin(java.lang.String[] ss, java.lang.String s) 判断一个字符串数组是否包括某一字符串
static boolean	isQuoteBy(java.lang.CharSequence cs, char lc, char rc)
static boolean	isQuoteByIgnoreBlank(java.lang.CharSequence cs, char lc, char rc)
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	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	sBlank(java.lang.Object obj) 对obj进行toString()操作,如果为空串返回""
static java.lang.String	sBlank(java.lang.Object obj, java.lang.String def) 对obj进行toString()操作,如果为空串返回def中定义的值
static java.lang.String	sNull(java.lang.Object obj) 对obj进行toString()操作,如果为null返回""
static java.lang.String	sNull(java.lang.Object obj, java.lang.String def) 对obj进行toString()操作,如果为null返回def中定义的值
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 java.lang.String	toHex(int d, int width) 将一个整数转换成固定长度的十六进制形式字符串
static java.lang.String	trim(java.lang.CharSequence cs) 去掉字符串前后空白
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

public Strings()

方法详细信息

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)

将字符串首字母大写

参数：

s - 字符串

返回：

首字母大写后的新字符串

lowerFirst

public static java.lang.String lowerFirst(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)

参数：

cs - 字符串

返回：

是不是为空字符串

isBlank

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

参数：

cs - 字符串

返回：

是不是为空白字符串

trim

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

去掉字符串前后空白

参数：

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 - 补字符

返回：

修饰后的字符串

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 - 右字符

返回：

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

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)

对obj进行toString()操作,如果为null返回""

参数：

obj -

返回：

obj.toString()

sNull

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

对obj进行toString()操作,如果为null返回def中定义的值

参数：

obj -

def - 如果obj==null返回的内容

返回：

obj的toString()操作

sBlank

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

对obj进行toString()操作,如果为空串返回""

参数：

obj -

返回：

obj.toString()

sBlank

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

对obj进行toString()操作,如果为空串返回def中定义的值

参数：

obj -

def - 如果obj==null返回的内容

返回：

obj的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 - 字符串

返回：

转换后字符串