S (Java Tool 1.20.2 API)

java.lang.Object
- org.osgl.util.S

Direct Known Subclasses:

StringNS
```
public class S
extends Object
```
String utilities

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`S._CharRepeater`
`static class`	`S._CountStage`
`static class`	`S._Cut`
`static class`	`S._Ensure`
`static class`	`S._Have`
`static class`	`S._Is`
`static class`	`S._IterableJoiner`
`static class`	`S._Replace`
`static class`	`S._Replace2`
`static class`	`S._ReplaceChar`
`static class`	`S._ReplaceCharStage`
`static class`	`S._ReplaceStage`
`static class`	`S._SplitStage`
`static class`	`S._StringRepeater`
`static class`	`S._StripStage`
`static class`	`S._WrapReplace`
`static class`	`S._WrapStringBuilder`
`static class`	`S.Binary`
`static class`	`S.Buffer` A `S.Buffer` is OSGL’s implementation of JDK’s `StringBuilder` with additional method to track the state of the instance, i.e.
`static class`	`S.F`
`static interface`	`S.List`
`static class`	`S.Pair`
`static class`	`S.Quadruple`
`static class`	`S.Quintuple`
`static class`	`S.T2`
`static class`	`S.T3`
`static class`	`S.T4`
`static class`	`S.T5`
`static class`	`S.Triple`
`static class`	`S.Val`
`static class`	`S.Var`

Field Summary

Fields
Modifier and Type	Field and Description
`static char[]`	`ALPHABETICS` alphabetic characters include both lowercase and uppercase characters
`static char[]`	`ALPHANUMERICS` digits plus alphabetic characters
`static S.Pair`	`ANGLE_BRACKETS` Alias of `DIAMOND`
`static S.Pair`	`BRACES` A pair of braces: `{` and `}`
`static S.Pair`	`BRACKETS` A pair of brackets: `[` and `]`
`static String`	`COMMON_SEP` A commonly used separator: [,;:\s]+
`static S.Pair`	`CURLY_BRACES` Alias of `BRACES`
`static S.Pair`	`DIAMOND` A pair of angle brackets: `<` and `>`
`static char[]`	`DIGITS` digital characters from `0` to `9`
`static S.Pair`	`DOUBLE_ANGLE_QUOTATION_MARK` A pair of double angle quotation mark: `«` (`u00ab`) and `»` (`u00bb`)
`static String`	`DOUBLE_QUOTE` The double quote: `"\""`
`static char`	`DOUBLE_QUOTE_CHAR` The char `"`
`static S.Pair`	`DOUBLE_QUOTES` A pair of double quotes: `"` and `"`
`static String[]`	`EMPTY_ARRAY` An empty string array constant
`static S.List`	`EMPTY_LIST`
`static String`	`FILE_SEP` The `File.separator`
`static char`	`FILE_SEP_CHAR` The `File.separatorChar`
`static String`	`HIDDEN_SEPARATOR` Alias of `HSEP`
`static char`	`HIDDEN_SEPARATOR_CHAR` Alias of `HSEP_CHAR`
`static String`	`HSEP` The invisible separator used by program: “”
`static char`	`HSEP_CHAR` The invisible separator char `''`
`static int`	`IGNORECASE` equal modifier: specify `equal` comparison should ignore leading and after spaces.
`static int`	`IGNORESPACE` equal modifier: specify `equal` comparison should be case insensitive
`static S.Pair`	`PARENTHESES` A pair of parentheses: `(` and `)`
`static String`	`PATH_SEP` The `File.pathSeparator`
`static char`	`PATH_SEP_CHAR` The {@link File#pathSeparatorChar
`static Pattern`	`PATTERN_COMMON_SEP` A precompiled `Pattern` of `COMMON_SEP`
`static S.Pair`	`SHU_MING_HAO` Alias of `书名号`
`static S.Pair`	`SINGLE_ANGLE_QUOTATION_MARK` A pair of single angle quotation mark: `‹` (`u2039`) and `›` (`u203a`)
`static String`	`SINGLE_QUOTE` The single quote: `"'"`
`static char`	`SINGLE_QUOTE_CHAR` The char `'`
`static S.Pair`	`SINGLE_QUOTES` A pair of single quotes: `'` and `'`
`static S.Pair`	`SQUARE_BRACKETS` Alias of `BRACKETS`
`static S.Pair`	`书名号` A pair of 书名号 (ShuMingHao, a Chevron-like symbol): `《` (`u300a`) and `》` (`u300b`)

Method Summary

All Methods Static Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`static String`	`after(String s0, String search)`
`static String`	`after(String s0, String search, boolean first)`
`static String`	`afterFirst(String s0, String search)`
`static String`	`afterLast(String s0, String search)`
`static boolean`	`allBlank(String... sa)` Check if all of the specified string is `blank`
`static boolean`	`allEmpty(String... sa)` Alias of `isAllEmpty(String...)`
`static boolean`	`anyBlank(String... sa)` Check if anyone of the specified string is `blank`
`static boolean`	`anyEmpty(String... sa)` Alias of `isAnyEmpty(String...)`
`static String`	`before(String s0, String search)`
`static String`	`before(String s0, String search, boolean last)`
`static String`	`beforeFirst(String s0, String search)`
`static String`	`beforeLast(String s0, String search)`
`static S.T2`	`binary(Lang.T2<String,String> t2)`
`static S.T2`	`binary(String left, String right)`
`static S.T2`	`binarySplit(String string, char separator)` Split string by separator into two parts and return in a `S.T2` object
`static boolean`	`blank(String s)` Determine if a string is all blank or empty or null
`static S.Buffer`	`buffer()` Returns a `S.Buffer` instance.
`static S.Buffer`	`buffer(boolean o)`
`static S.Buffer`	`buffer(byte o)`
`static S.Buffer`	`buffer(char o)`
`static S.Buffer`	`buffer(char[] ca)`
`static S.Buffer`	`buffer(double o)`
`static S.Buffer`	`buffer(float o)`
`static S.Buffer`	`buffer(int o)`
`static S.Buffer`	`buffer(long o)`
`static S.Buffer`	`buffer(Object o)`
`static S.Buffer`	`buffer(short o)`
`static S.Buffer`	`buffer(String s)`
`static StringBuilder`	`builder()` Returns the ThreadLocal StringBuilder instance with length set to 0
`static StringBuilder`	`builder(boolean o)`
`static StringBuilder`	`builder(byte o)`
`static StringBuilder`	`builder(char o)`
`static StringBuilder`	`builder(double o)`
`static StringBuilder`	`builder(float o)`
`static StringBuilder`	`builder(int o)`
`static StringBuilder`	`builder(long o)`
`static StringBuilder`	`builder(Object o)`
`static StringBuilder`	`builder(short o)`
`static StringBuilder`	`builder(String s)`
`static String`	`camelCase(CharSequence s)`
`static String`	`capFirst(String s)`
`static String`	`center(String s, int length)` Centers a String in a larger String of size size using the space character (‘ ’).
`static String`	`center(String s, int length, char padChar)` Centers a String in a larger String of size size.
`static String`	`concat(Object[] oa)`
`static String`	`concat(Object o1, Object o2)`
`static String`	`concat(Object o1, Object o2, Object o3)`
`static String`	`concat(Object o1, Object o2, Object o3, Object o4)`
`static String`	`concat(Object o1, Object o2, Object o3, Object o4, Object o5)`
`static String`	`concat(Object o1, Object o2, Object o3, Object o4, Object o5, Object... extra)`
`static String`	`concat(String[] sa)`
`static String`	`concat(String s1, String s2)`
`static String`	`concat(String s1, String s2, String s3)`
`static String`	`concat(String s1, String s2, String s3, String s4)`
`static String`	`concat(String s1, String s2, String s3, String s4, String s5)`
`static String`	`concat(String s1, String s2, String s3, String s4, String s5, String... extra)`
`static S._CountStage`	`count(String search)`
`static int`	`count(String s, String search)` Count how many times a search string occurred in the give string
`static int`	`count(String s, String search, boolean overlap)` Count how many times a search string occurred in the give string
`static S._Cut`	`cut(Object object)`
`static String`	`cutOff(String s, int max)`
`static String`	`dashed(CharSequence s)`
`static String`	`decodeBase64(String string)`
`static String`	`decodeBASE64(String str)` Decode Base64 encoded string
`static String`	`dos2unix(String s)`
`static String`	`dotted(CharSequence s)`
`static boolean`	`empty(CharSequence csq)` Check if a `CharSequence` is `null` or empty.
`static boolean`	`empty(String s)` Determine if a string is empty or null
`static String`	`encodeBase64(String str)`
`static String`	`encodeBASE64(String str)` Encode a string using Base64 encoding
`static boolean`	`endsWith(String string, char suffix)`
`static boolean`	`endsWith(String string, String suffix)`
`static S._Ensure`	`ensure(Object object)`
`static String`	`ensureEndsWith(String string, char suffix)`
`static String`	`ensureEndsWith(String string, String suffix)`
`static String`	`ensureStartsWith(String string, char prefix)`
`static String`	`ensureStartsWith(String string, String prefix)`
`static String`	`ensureStrippedOff(String string, Lang.Tuple<String,String> wrapper)`
`static String`	`ensureStrippedOff(String string, String left, String right)`
`static String`	`ensureWrappedWith(String string, Lang.Tuple<String,String> wrapper)`
`static String`	`ensureWrappedWith(String string, String left, String right)`
`static boolean`	`eq(String s1, String s2)` alias of `equal(String, String)`
`static boolean`	`eq(String s1, String s2, int modifier)` Alias of `equal(String, String, int)`
`static boolean`	`equal(int modifier, String... sa)` Check if all strings are equal to each other
`static boolean`	`equal(String s1, String s2)` Return true if 2 strings are equals to each other without ignore space and case sensitive.
`static boolean`	`equal(String s1, String s2, int modifier)` Return true if 2 strings are equals to each other as per rule specified
`static S.List`	`fastSplit(String string, String separator)` Split a string by separator literal and return a list of strings
`static String`	`fileExtension(String fileName)` Get the extension of a filename.
`static String`	`first(String s, int n)` Return the string of first N chars.
`static String`	`fmt(String tmpl)`
`static String`	`fmt(String tmpl, Object... args)` A handy alias for `String.format(String, Object...)`
`static String`	`getCommonSep()`
`static S._Have`	`given(Object o)`
`static S._Have`	`given(String s)`
`static S._Have`	`have(char[] ca)`
`static S._Have`	`have(Object o)`
`static S._Have`	`have(String s)`
`static String`	`hyphenated(CharSequence s)`
`static int`	`indexOf(char[] source, int sourceOffset, int sourceCount, char[] target, int targetOffset, int targetCount, int fromIndex)` Search for strings.
`static S._Is`	`is(Object content)`
`static boolean`	`isAllBlank(String... sa)` Alias of `allBlank(String...)`
`static boolean`	`isAllEmpty(String... sa)` Check if all of the specified string is `empty`
`static boolean`	`isAnyBlank(String... sa)` Alias of `anyBlank(String...)`
`static boolean`	`isAnyEmpty(String... sa)` Check if anyone of the specified string is `empty`
`static boolean`	`isBlank(String s)` alias of `blank(String)`
`static boolean`	`isEmpty(CharSequence csq)` Alias of `empty(CharSequence)`
`static boolean`	`isEmpty(String s)` alias of `empty(String)`
`static boolean`	`isEqual(String s1, String s2)` alias of `eq(String, String)`
`static boolean`	`isEqual(String s1, String s2, int modifier)` Alias of `equal(String, String, int)`
`static boolean`	`isInt(String s)` Check if a string is integer or long
`static boolean`	`isIntOrLong(String s)` Check if a string is integer or long
`static boolean`	`isNotBlank(String s)` Antonym of `blank(String)`
`static boolean`	`isNotEmpty(String s)` alias of `notEmpty(String)`
`static boolean`	`isNumeric(String s)` Check if a string is numeric
`static S._IterableJoiner`	`join(byte[] array)`
`static S._IterableJoiner`	`join(double[] array)`
`static S._IterableJoiner`	`join(float[] array)`
`static S._IterableJoiner`	`join(int[] array)`
`static S._IterableJoiner`	`join(Iterable<?> iterable)`
`static S._IterableJoiner`	`join(long[] array)`
`static S._IterableJoiner`	`join(Object... array)`
`static S._IterableJoiner`	`join(short[] array)`
`static String`	`join(String s, int times)` Join a string for n times
`static String`	`join(String separator, Iterable<?> iterable)` Join a list of object into a string
`static String`	`join(String separator, String... list)` Join an array of strings into a string
`static String`	`join(String separator, String s, int times)` Join a string by separator for n times
`static String`	`join(String separator, String prefix, String suffix, Iterable<?> iterable)` Join a list of object into a string, prefix and suffix will be added if supplied
`static String`	`join(String separator, String prefix, String suffix, Iterable<?> iterable, boolean quoted, boolean separateFixes)` Join a list of object into a string, prefix and suffix will be added if supplied
`static String`	`last(String s, int n)` Return last n chars
`static int`	`len(String s1)`
`static int`	`len(String s1, String... sa)`
`static S.List`	`list()` Returns an empty immutable list
`static S.List`	`list(Iterable<String> iterable)`
`static S.List`	`list(String s)`
`static S.List`	`list(String s1, String s2)`
`static S.List`	`list(String s1, String s2, String... sa)`
`static S.List`	`listOf(String... sa)`
`static String`	`longRandom()` return a random string with 16 to 100 (inclusive) chars.
`static String`	`longUrlSafeRandom()` return a URL safe random string with 16 to 100 (inclusive) chars.
`static String`	`lowerFirst(String s)`
`static String`	`lpad(String s, char c, int number)` Alias of `padLeft(String, char, int)`
`static String`	`lpad(String s, int number)` Alias of `padLeft(String, int)`
`static void`	`main(String[] args)`
`static String`	`maxLength(String s, int max)`
`static String`	`mediumRandom()` return a random string with 6 to 15 (inclusive) chars.
`static String`	`mediumUrlSafeRandom()` return a URL safe random string with 6 to 15 (inclusive) chars.
`static String`	`msgFmt(String template)` Returns the template or `""` if template is `null`
`static String`	`msgFmt(String template, Object... args)` A handy alias for `MessageFormat.format(String, Object...)`
`static boolean`	`neq(String s1, String s2)` Antonym of `equal(String, String)`
`static boolean`	`neq(String s1, String s2, int modifier)` Antonym of `equal(String, String, int)`
`static S.Buffer`	`newBuffer()` Returns an new `S.Buffer` instance
`static S.Buffer`	`newBuffer(byte o)`
`static S.Buffer`	`newBuffer(char o)`
`static S.Buffer`	`newBuffer(double o)`
`static S.Buffer`	`newBuffer(float o)`
`static S.Buffer`	`newBuffer(int o)`
`static S.Buffer`	`newBuffer(long o)`
`static S.Buffer`	`newBuffer(Object o)`
`static S.Buffer`	`newBuffer(short o)`
`static S.Buffer`	`newBuffer(String s)`
`static StringBuilder`	`newBuilder()` Return an new StringBuilder instance
`static StringBuilder`	`newBuilder(byte o)`
`static StringBuilder`	`newBuilder(char o)`
`static StringBuilder`	`newBuilder(double o)`
`static StringBuilder`	`newBuilder(float o)`
`static StringBuilder`	`newBuilder(int o)`
`static StringBuilder`	`newBuilder(long o)`
`static StringBuilder`	`newBuilder(Object o)`
`static StringBuilder`	`newBuilder(short o)`
`static StringBuilder`	`newBuilder(String s)`
`static S.List`	`newList()`
`static S.List`	`newList(Iterable<String> iterable)`
`static S.List`	`newList(String string)`
`static S.List`	`newList(String s1, String s2)`
`static S.List`	`newList(String s1, String s2, String s3)`
`static S.List`	`newList(String s1, String s2, String s3, String... sa)`
`static S.List`	`newListOf(String[] sa)`
`static S.Buffer`	`newSizedBuffer(int size)` Return an new `S.Buffer` instance with predefined size specified
`static StringBuilder`	`newSizedBuilder(int capacity)`
`static boolean`	`noBlank(String... sa)` Antonym of `anyBlank(String...)`
`static boolean`	`noEmpty(String... sa)` Antonym of `anyEmpty(String...)`
`static boolean`	`notBlank(String s)` Antonym of `blank(String)`
`static boolean`	`notEmpty(String s)` Antonym of `empty(String)`
`static boolean`	`notEqual(String s1, String s2)` Return false if 2 strings are equals to each other
`static String`	`padLeadingZero(int number, int digits)` Add leading zero to number
`static String`	`padLeadingZero(long number, int digits)`
`static String`	`padLeft(String s, char c, int number)` Left pad a string with character specified
`static String`	`padLeft(String s, int number)` Left pad a string with number of space specified
`static String`	`padRight(String s, char c, int number)` Right pad a string with character specified
`static String`	`padRight(String s, int number)` Right pad a string with number of space specified
`static S.T2`	`pair(char left, char right)`
`static S.T2`	`pair(Lang.T2<String,String> t2)`
`static S.T2`	`pair(String left, String right)`
`static String`	`pathConcat(String prefix, char sep, String suffix)`
`static String`	`quote(Object content, char mark)` Deprecated.
`static String`	`quote(Object content, String mark)` Deprecated.
`static String`	`quote(String content, char mark)` Deprecated.
`static String`	`quote(String s, String mark)` Deprecated.
`static String`	`random()`
`static String`	`random(int len)` Generate random string.
`static String`	`random(int len, Random r)` Generate a random string with specified length and a random instance
`static String`	`random(int len, Random r, char[] pool)` Generate a random string with specified length, a `Random` instance, a customized character pool
`static S._CharRepeater`	`repeat(char c)`
`static S._StringRepeater`	`repeat(String content)`
`static S._ReplaceCharStage`	`replace(char c)`
`static S._ReplaceStage`	`replace(Object keyword)`
`static S._ReplaceStage`	`replace(Pattern pattern)`
`static S._ReplaceStage`	`replace(String keyword)`
`static String`	`requireNotBlank(String s)` Throw IllegalArgumentException if the string specified `is blank`, otherwise return the string specified
`static String`	`requireNotEmpty(String s)` Throw IllegalArgumentException if the string specified `isEmpty(String)` is empty}, otherwise return the string specified
`static String`	`reversed(String s)` Reverse a String.
`static String`	`rpad(String s, char c, int number)` Alias of `padRight(String, char, int)`
`static String`	`rpad(String s, int number)` Alias of `padRight(String, int)`
`static String`	`secureRandom()` This is the secure version of `random()`.
`static String`	`secureRandom(int len)` This is the secure version of `random(int)`.
`static String`	`secureUrlSafeRandom()` This is the secure version of `urlSafeRandom()`.
`static String`	`secureUrlSafeRandom(int len)` This is the secure version of `urlSafeRandom(int)`.
`static String`	`shortRandom()` return a random string with 2 to 5 (inclusive) chars.
`static String`	`shortUrlSafeRandom()` return a URL safe random string with 2 to 5 (inclusive) chars.
`static S.Buffer`	`sizedBuffer(int size)`
`static StringBuilder`	`sizedBuilder(int capacity)` Deprecated.
`static S._SplitStage`	`split(CharSequence csq)`
`static S.List`	`split(CharSequence csq, Pattern regex)` Split a char sequence by regex and return a list of strings
`static S.List`	`split(CharSequence csq, String regex)` Split a char sequence by regex and return a list of strings
`static S.List`	`split(String string, char separator)` Split a string into a list of strings by specified separator char
`static boolean`	`startsWith(String string, char prefix)`
`static boolean`	`startsWith(String string, String prefix)`
`static Str`	`str(char... ca)`
`static Str`	`str(Object o)`
`static String`	`string(char c)`
`static String`	`string(char[] ca)`
`static String`	`string(double d)`
`static String`	`string(float f)`
`static String`	`string(int n)`
`static String`	`string(long l)`
`static String`	`string(Object o)`
`static String`	`string(Object o, boolean quoted)` Get string representation of an object instance
`static S._StripStage`	`strip(Object o)`
`static String`	`strip(Object o, Lang.Tuple<String,String> wrapper)` Strip the prefix and suffix of an Object’s string representation and return the result.
`static String`	`strip(Object o, String prefix, String suffix)` Strip the prefix and suffix from an object’s String representation and return the result
`static S._Have`	`take(Object o)`
`static S._Have`	`take(String s)`
`static String`	`times(char c, int times)` Return a string composed of `times` of char `c`
`static String`	`times(String s, int times)` Alias of `join(String, int)`
`static String`	`trim(String s)` Null safety trim
`static S.T3`	`tripleSplit(String string, char separator)` Split string by separator into three parts and return in a `S.T3` object
`static String`	`underscore(CharSequence s)`
`static String`	`unix2dos(String s)`
`static String`	`unsafeCapFirst(String s)`
`static String`	`urlDecode(String s)`
`static String`	`urlEncode(String s)` perform URL encoding on a giving string
`static String`	`urlSafeRandom()`
`static String`	`urlSafeRandom(int len)` Generate URL safe random string.
`static String`	`urlSafeRandom(int len, Random r)` Generate a URL safe random string with specified length and a random instance
`static String`	`uuid()`
`static S.Val`	`val(String s)`
`static S.Var`	`var(String s)`
`static S._WrapStringBuilder`	`wrap(Object content)`
`static String`	`wrap(Object content, char symbol)`
`static String`	`wrap(Object content, char left, char right)`
`static String`	`wrap(Object content, Lang.Tuple<String,String> wrapper)`
`static String`	`wrap(Object content, String wrapper)`
`static String`	`wrap(Object content, String left, String right)`
`static S._WrapStringBuilder`	`wrap(String content)`
`static String`	`wrap(String text, char symbol)`
`static String`	`wrap(String text, char left, char right)`
`static String`	`wrap(String text, Lang.Tuple<String,String> wrapper)`
`static String`	`wrap(String text, String wrapper)`
`static String`	`wrap(String text, String left, String right)`

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

Field Detail
- EMPTY_ARRAY
```
public static final String[] EMPTY_ARRAY
```
  An empty string array constant
- HSEP
```
public static final String HSEP
```
  The invisible separator used by program: “”
  
  See Also:
  
  Constant Field Values
- HIDDEN_SEPARATOR
```
public static final String HIDDEN_SEPARATOR
```
  Alias of HSEP
  
  See Also:
  
  Constant Field Values
- HSEP_CHAR
```
public static final char HSEP_CHAR
```
  The invisible separator char ''
  
  See Also:
  
  Constant Field Values
- HIDDEN_SEPARATOR_CHAR
```
public static final char HIDDEN_SEPARATOR_CHAR
```
  Alias of HSEP_CHAR
  
  See Also:
  
  Constant Field Values
- COMMON_SEP
```
public static final String COMMON_SEP
```
  A commonly used separator: [,;:\s]+
  
  See Also:
  
  Constant Field Values
- PATTERN_COMMON_SEP
```
public static final Pattern PATTERN_COMMON_SEP
```
  A precompiled Pattern of COMMON_SEP
- FILE_SEP
```
public static final String FILE_SEP
```
  The File.separator
- FILE_SEP_CHAR
```
public static final char FILE_SEP_CHAR
```
  The File.separatorChar
- PATH_SEP
```
public static final String PATH_SEP
```
  The File.pathSeparator
- PATH_SEP_CHAR
```
public static final char PATH_SEP_CHAR
```
  The {@link File#pathSeparatorChar
- SINGLE_QUOTE
```
public static final String SINGLE_QUOTE
```
  The single quote: "'"
  
  See Also:
  
  Constant Field Values
- DOUBLE_QUOTE
```
public static final String DOUBLE_QUOTE
```
  The double quote: "\""
  
  See Also:
  
  Constant Field Values
- SINGLE_QUOTE_CHAR
```
public static final char SINGLE_QUOTE_CHAR
```
  The char '
  
  See Also:
  
  Constant Field Values
- DOUBLE_QUOTE_CHAR
```
public static final char DOUBLE_QUOTE_CHAR
```
  The char "
  
  See Also:
  
  Constant Field Values
- DOUBLE_QUOTES
```
public static final S.Pair DOUBLE_QUOTES
```
  A pair of double quotes: " and "
- SINGLE_QUOTES
```
public static final S.Pair SINGLE_QUOTES
```
  A pair of single quotes: ' and '
- PARENTHESES
```
public static final S.Pair PARENTHESES
```
  A pair of parentheses: ( and )
- BRACKETS
```
public static final S.Pair BRACKETS
```
  A pair of brackets: [ and ]
- SQUARE_BRACKETS
```
public static final S.Pair SQUARE_BRACKETS
```
  Alias of BRACKETS
- BRACES
```
public static final S.Pair BRACES
```
  A pair of braces: { and }
- CURLY_BRACES
```
public static final S.Pair CURLY_BRACES
```
  Alias of BRACES
- DIAMOND
```
public static final S.Pair DIAMOND
```
  A pair of angle brackets: < and >
- ANGLE_BRACKETS
```
public static final S.Pair ANGLE_BRACKETS
```
  Alias of DIAMOND
- SINGLE_ANGLE_QUOTATION_MARK
```
public static final S.Pair SINGLE_ANGLE_QUOTATION_MARK
```
  A pair of single angle quotation mark: ‹ (u2039) and › (u203a)
- DOUBLE_ANGLE_QUOTATION_MARK
```
public static final S.Pair DOUBLE_ANGLE_QUOTATION_MARK
```
  A pair of double angle quotation mark: « (u00ab) and » (u00bb)
- 书名号
```
public static final S.Pair 书名号
```
  A pair of 书名号 (ShuMingHao, a Chevron-like symbol): 《 (u300a) and 》 (u300b)
- SHU_MING_HAO
```
public static final S.Pair SHU_MING_HAO
```
  Alias of 书名号
- IGNORECASE
```
public static final int IGNORECASE
```
  equal modifier: specify equal comparison should ignore leading and after spaces. i.e. it will call trim() method on strings before comparison
  
  See Also:
  
  Constant Field Values
- IGNORESPACE
```
public static final int IGNORESPACE
```
  equal modifier: specify equal comparison should be case insensitive
  
  See Also:
  
  Constant Field Values
- DIGITS
```
public static final char[] DIGITS
```
  digital characters from 0 to 9
- ALPHABETICS
```
public static final char[] ALPHABETICS
```
  alphabetic characters include both lowercase and uppercase characters
- ALPHANUMERICS
```
public static final char[] ALPHANUMERICS
```
  digits plus alphabetic characters
- EMPTY_LIST
```
public static final S.List EMPTY_LIST
```

Method Detail

getCommonSep
```
public static String getCommonSep()
```

fmt

public static final String fmt(String tmpl)

fmt
```
public static final String fmt(String tmpl,
                               Object... args)
```
A handy alias for String.format(String, Object...)

Parameters:

tmpl - the message template

args - the message arguments

Returns:

the formatted string

msgFmt
```
public static String msgFmt(String template)
```
Returns the template or "" if template is null

Parameters:

template - a string

Returns:

the template or "" if template is null

msgFmt
```
public static String msgFmt(String template,
                            Object... args)
```
A handy alias for MessageFormat.format(String, Object...)

Parameters:

template - the message template

args - the message arguments

Returns:

the formatted string or "" if template is null

isEmpty
```
public static boolean isEmpty(String s)
```
alias of empty(String)

Parameters:

s - the string to be checked

Returns:

true if s is null or empty

isEmpty
```
public static boolean isEmpty(CharSequence csq)
```
Alias of empty(CharSequence)

Parameters:

csq - the char sequence to be tested

Returns:

true if the char sequence is null or empty

empty
```
public static boolean empty(String s)
```
Determine if a string is empty or null

Parameters:

s - the string to be checked

Returns:

true if the string is null or empty (no spaces)

empty
```
public static boolean empty(CharSequence csq)
```
Check if a CharSequence is null or empty.

Parameters:

csq - the char sequence to be checked.

Returns:

true if the char sequence is null or empty

blank
```
public static boolean blank(String s)
```
Determine if a string is all blank or empty or null

Parameters:

s - the string to be checked

Returns:

true if the string is null or empty or all blanks

isBlank
```
public static boolean isBlank(String s)
```
alias of blank(String)

Parameters:

s - the string to be checked

Returns:

true if s is null or empty or blank

isNotEmpty
```
public static boolean isNotEmpty(String s)
```
alias of notEmpty(String)

Parameters:

s - the string to be checked

Returns:

true if s is null or empty

notEmpty
```
public static boolean notEmpty(String s)
```
Antonym of empty(String)

Parameters:

s - the string to be checked

Returns:

true if s is not null or empty

notBlank
```
public static boolean notBlank(String s)
```
Antonym of blank(String)

Parameters:

s - the string to be checked

Returns:

true if s is not null or empty or all in blank

isNotBlank
```
public static boolean isNotBlank(String s)
```
Antonym of blank(String)

Parameters:

s - the string to be checked

Returns:

true if s is not null or empty or all in blank

isAllEmpty
```
public static boolean isAllEmpty(String... sa)
```
Check if all of the specified string is empty

Parameters:

sa - the string to be checked

Returns:

true if all of the specified string is empty

allEmpty
```
public static boolean allEmpty(String... sa)
```
Alias of isAllEmpty(String...)

Parameters:

sa - the strings to be checked

Returns:

true if all of the specified string is empty

isAllBlank
```
public static boolean isAllBlank(String... sa)
```
Alias of allBlank(String...)

Parameters:

sa - the strings to be checked

Returns:

true if all of the specified string is blank

allBlank
```
public static boolean allBlank(String... sa)
```
Check if all of the specified string is blank

Parameters:

sa - the strings to be checked

Returns:

true if all of the specified string is blank

isAnyEmpty
```
public static boolean isAnyEmpty(String... sa)
```
Check if anyone of the specified string is empty

Parameters:

sa - the strings to be checked

Returns:

true if anyone of the specified string is empty

anyEmpty
```
public static boolean anyEmpty(String... sa)
```
Alias of isAnyEmpty(String...)

Parameters:

sa - the strings to be checked

Returns:

true if anyone of the specified string is empty

isAnyBlank
```
public static boolean isAnyBlank(String... sa)
```
Alias of anyBlank(String...)

Parameters:

sa - the strings to be checked

Returns:

true if anyone of the specified string is blank

anyBlank
```
public static boolean anyBlank(String... sa)
```
Check if anyone of the specified string is blank

Parameters:

sa - the strings to be checked

Returns:

true if anyone of the specified string is blank

noEmpty
```
public static boolean noEmpty(String... sa)
```
Antonym of anyEmpty(String...)

Parameters:

sa - the strings to be checked

Returns:

false if anyone of the specified string is empty

noBlank
```
public static boolean noBlank(String... sa)
```
Antonym of anyBlank(String...)

Parameters:

sa - the strings to be checked

Returns:

false if anyone of the specified string is empty

isIntOrLong
```
public static boolean isIntOrLong(String s)
```
Check if a string is integer or long

Parameters:

s - the string

Returns:

true if the string is integer or long

See Also:

N.isInt(String)

isInt
```
public static boolean isInt(String s)
```
Check if a string is integer or long

Parameters:

s - the string

Returns:

true if the string is integer or long

See Also:

N.isInt(String)

isNumeric
```
public static boolean isNumeric(String s)
```
Check if a string is numeric

Parameters:

s - the string to be checked

Returns:

true if s is numeric string

See Also:

N.isNumeric(String)

requireNotBlank
```
public static String requireNotBlank(String s)
```
Throw IllegalArgumentException if the string specified is blank, otherwise return the string specified

Parameters:

s - the string to be tested

Returns:

the string if it is not blank

Throws:

IllegalArgumentException - if the string s is blank

requireNotEmpty
```
public static String requireNotEmpty(String s)
```
Throw IllegalArgumentException if the string specified isEmpty(String) is empty}, otherwise return the string specified

Parameters:

s - the string to be tested

Returns:

the string if it is not empty

Throws:

IllegalArgumentException - if the string s is empty

first
```
public static String first(String s,
                           int n)
```
Return the string of first N chars.
If n is negative number, then return a string of the first N chars

If n is larger than the length of the string, then return the string

Parameters:

s - the string from which the first n chars will be returned

n - the number of chars to be returned from s

Returns:

the string consists of the first n chars of the specified string s

len
```
public static int len(String s1)
```

len

public static int len(String s1,
                      String... sa)

binarySplit
```
public static S.T2 binarySplit(String string,
                               char separator)
```
Split string by separator into two parts and return in a S.T2 object

Note this will only check the first position of the separator, anything after that will be put into the second element of the T2 instance, including the following separator char

Note it will put the entire string into the first element of the return object if no separator is found in the string and leave the second element to be an empty string

Parameters:

string - the string to be split

separator - the separator character

Returns:

a T2 instance contains the two parts

tripleSplit
```
public static S.T3 tripleSplit(String string,
                               char separator)
```
Split string by separator into three parts and return in a S.T3 object

Note this will only check the first two positions of the separator, anything after that will be put into the third element of the T2 instance, including the following separator char

Note it will put the entire string into the first element of the return object if no separator is found in the string and leave the second element to be an empty string

Parameters:

string - the string to be split

separator - the separator character

Returns:

a T2 instance contains the two parts

fastSplit
```
public static S.List fastSplit(String string,
                               String separator)
```
Split a string by separator literal and return a list of strings

Note： * Unlike String.split(String) method, this will NOT do regex based split * If there are consecutive separators they will be treated as a single separator * Leading or ending separator will be trimmed * If separator not found then the string will be returned in a single element list

Parameters:

string - the string to be split

separator - the string literal to split the string

Returns:

a list of strings

Throws:

IllegalArgumentException - if the separator is empty or null

split
```
public static S.List split(CharSequence csq,
                           String regex)
```
Split a char sequence by regex and return a list of strings

Parameters:

csq - the target string to be split

regex - the regex to split the string

Returns:

a list of string

split
```
public static S.List split(CharSequence csq,
                           Pattern regex)
```
Split a char sequence by regex and return a list of strings

Parameters:

csq - the target string to be split

regex - the regex pattern to split the string

Returns:

a list of string

split
```
public static S.List split(String string,
                           char separator)
```
Split a string into a list of strings by specified separator char
* If there are consecutive separators they will be treated as a single separator * Leading or ending separator will be trimmed * If separator not found then the string will be returned in a single element list

Parameters:

string - the string to be split

separator - the char to split the string

Returns:

a list of strings

concat

public static String concat(String s1,
                            String s2)

concat

public static String concat(Object o1,
                            Object o2)

concat

public static String concat(String s1,
                            String s2,
                            String s3)

concat

public static String concat(Object o1,
                            Object o2,
                            Object o3)

concat

public static String concat(String s1,
                            String s2,
                            String s3,
                            String s4)

concat

public static String concat(Object o1,
                            Object o2,
                            Object o3,
                            Object o4)

concat

public static String concat(String s1,
                            String s2,
                            String s3,
                            String s4,
                            String s5)

concat

public static String concat(Object o1,
                            Object o2,
                            Object o3,
                            Object o4,
                            Object o5)

concat

public static String concat(String s1,
                            String s2,
                            String s3,
                            String s4,
                            String s5,
                            String... extra)

concat

public static String concat(Object o1,
                            Object o2,
                            Object o3,
                            Object o4,
                            Object o5,
                            Object... extra)

concat

public static String concat(String[] sa)

concat

public static String concat(Object[] oa)

is

public static S._Is is(Object content)

endsWith

public static boolean endsWith(String string,
                               String suffix)

endsWith

public static boolean endsWith(String string,
                               char suffix)

startsWith

public static boolean startsWith(String string,
                                 String prefix)

startsWith

public static boolean startsWith(String string,
                                 char prefix)

ensure

public static S._Ensure ensure(Object object)

ensureStartsWith

public static String ensureStartsWith(String string,
                                      String prefix)

ensureStartsWith

public static String ensureStartsWith(String string,
                                      char prefix)

ensureEndsWith

public static String ensureEndsWith(String string,
                                    String suffix)

ensureEndsWith

public static String ensureEndsWith(String string,
                                    char suffix)

ensureWrappedWith

public static String ensureWrappedWith(String string,
                                       String left,
                                       String right)

ensureWrappedWith

public static String ensureWrappedWith(String string,
                                       Lang.Tuple<String,String> wrapper)

ensureStrippedOff

public static String ensureStrippedOff(String string,
                                       String left,
                                       String right)

ensureStrippedOff

public static String ensureStrippedOff(String string,
                                       Lang.Tuple<String,String> wrapper)

split

public static S._SplitStage split(CharSequence csq)

have

public static S._Have have(char[] ca)

have
```
public static S._Have have(Object o)
```

have
```
public static S._Have have(String s)
```

take
```
public static S._Have take(Object o)
```

take
```
public static S._Have take(String s)
```

given

public static S._Have given(Object o)

given

public static S._Have given(String s)

replace

public static S._ReplaceStage replace(Pattern pattern)

replace

public static S._ReplaceStage replace(Object keyword)

replace

public static S._ReplaceStage replace(String keyword)

replace

public static S._ReplaceCharStage replace(char c)

pathConcat

public static String pathConcat(String prefix,
                                char sep,
                                String suffix)

join
```
public static String join(String separator,
                          Iterable<?> iterable)
```
Join a list of object into a string

Parameters:

separator - the symbol used to separate the listed itmes

iterable - a list of object instances

Returns:

a string representation of the listed objects

join
```
public static String join(String separator,
                          String prefix,
                          String suffix,
                          Iterable<?> iterable)
```
Join a list of object into a string, prefix and suffix will be added if supplied

Parameters:

separator - the symbols used to separate the listed items and prefix and suffix

prefix - the symbols prepended to the beginning of the item list

suffix - the symbols appended to the end of the item list

iterable - an iterable

Returns:

a string representation of the listed objects

join
```
public static String join(String separator,
                          String prefix,
                          String suffix,
                          Iterable<?> iterable,
                          boolean quoted,
                          boolean separateFixes)
```
Join a list of object into a string, prefix and suffix will be added if supplied

Parameters:

separator - the symbols used to separate the listed items and prefix and suffix

prefix - the symbols prepended to the beginning of the item list

suffix - the symbols appended to the end of the item list

iterable - an iterable

quoted - if true then each listed item will be quoted with quotation mark

separateFixes - if false then no separator after prefix and no separator before suffix

Returns:

a string representation of the listed objects

join

public static S._IterableJoiner join(Iterable<?> iterable)

join

public static S._IterableJoiner join(byte[] array)

join

public static S._IterableJoiner join(short[] array)

join

public static S._IterableJoiner join(int[] array)

join

public static S._IterableJoiner join(long[] array)

join

public static S._IterableJoiner join(float[] array)

join

public static S._IterableJoiner join(double[] array)

join

public static S._IterableJoiner join(Object... array)

repeat

public static S._StringRepeater repeat(String content)

join
```
public static String join(String separator,
                          String... list)
```
Join an array of strings into a string

Parameters:

separator - the symbol used to separate the listed itmes

list - the array of strings

Returns:

a string joined

join
```
public static String join(String separator,
                          String s,
                          int times)
```
Join a string by separator for n times

Parameters:

separator - the separator

s - the string to be joined

times - the times the string to be joined

Returns:

the result

join
```
public static String join(String s,
                          int times)
```
Join a string for n times

Parameters:

s - the string to be joined

times - the times the string to be joined

Returns:

the result

times
```
public static String times(String s,
                           int times)
```
Alias of join(String, int)

Parameters:

s - the string to be joined

times - the times the string to be joined

Returns:

the result

repeat

public static S._CharRepeater repeat(char c)

times
```
public static String times(char c,
                           int times)
```
Return a string composed of times of char c

Parameters:

c - the character

times - the number of times the c in the string returned

Returns:

the string as described

wrap

public static S._WrapStringBuilder wrap(Object content)

wrap

public static S._WrapStringBuilder wrap(String content)

wrap

public static String wrap(Object content,
                          char symbol)

wrap

public static String wrap(String text,
                          char symbol)

wrap

public static String wrap(Object content,
                          char left,
                          char right)

wrap

public static String wrap(String text,
                          char left,
                          char right)

wrap

public static String wrap(Object content,
                          String left,
                          String right)

wrap

public static String wrap(String text,
                          String left,
                          String right)

wrap

public static String wrap(Object content,
                          Lang.Tuple<String,String> wrapper)

wrap

public static String wrap(String text,
                          Lang.Tuple<String,String> wrapper)

wrap

public static String wrap(Object content,
                          String wrapper)

wrap

public static String wrap(String text,
                          String wrapper)

quote
```
@Deprecated
public static String quote(Object content,
                                       char mark)
```
Deprecated.

This method is deprecated. Please use wrap(Object, char) instead

Parameters:

content - the content object

mark - the quotation mark

Returns:

a string that wrap the content string with quotation mark

quote
```
@Deprecated
public static String quote(String content,
                                       char mark)
```
Deprecated.

This method is deprecated. Please use wrap(String, char) instead

Parameters:

content - the content object

mark - the quotation mark

Returns:

a string that wrap the content string with quotation mark

quote
```
@Deprecated
public static String quote(Object content,
                                       String mark)
```
Deprecated.

This method is deprecated. Please use wrap(Object, char) instead

Parameters:

content - the content object

mark - the quotation mark

Returns:

a string that wrap the content string with quotation mark

quote
```
@Deprecated
public static String quote(String s,
                                       String mark)
```
Deprecated.

This method is deprecated. Please use wrap(String, char) instead

Parameters:

s - the content string

mark - the quotation mark

Returns:

a string that wrap the content string with quotation mark

cut

public static S._Cut cut(Object object)

cutOff
```
public static String cutOff(String s,
                            int max)
```
Return a string no longer than specified max length.
If the string supplied is longer than the specified max length then only it’s part that is less than the max length returned, appended with “…”

Parameters:

s - the original string

max - the maximum length of the result

Returns:

the string as described

maxLength
```
public static String maxLength(String s,
                               int max)
```
Return a string no longer than specified max length.
If the string supplied is longer than the specified max length then only it’s part that is less than the max length returned, appended with “…”

Parameters:

s - the original string

max - the maximum length of the result

Returns:

the string as described

last
```
public static String last(String s,
                          int n)
```
Return last n chars

Parameters:

s - the string from which last n chars will be returned

n - the number of chars should be returned from s

Returns:

a string consists of the last n chars in s

after

public static String after(String s0,
                           String search)

after

public static String after(String s0,
                           String search,
                           boolean first)

afterLast

public static String afterLast(String s0,
                               String search)

afterFirst

public static String afterFirst(String s0,
                                String search)

before

public static String before(String s0,
                            String search)

before

public static String before(String s0,
                            String search,
                            boolean last)

beforeFirst

public static String beforeFirst(String s0,
                                 String search)

beforeLast

public static final String beforeLast(String s0,
                                      String search)

trim
```
public static String trim(String s)
```
Null safety trim

Parameters:

s - the string to be trimed

Returns:

the trimed string

count

public static S._CountStage count(String search)

count
```
public static int count(String s,
                        String search)
```
Count how many times a search string occurred in the give string

Parameters:

s - string to be searched

search - the search token

Returns:

the times the search token appeared in s without overlap calculation

count
```
public static int count(String s,
                        String search,
                        boolean overlap)
```
Count how many times a search string occurred in the give string

Parameters:

s - string to be searched

search - the search token

overlap - specify if it should take overlap into considerations

Returns:

the times the search token appeared in s

camelCase

public static String camelCase(CharSequence s)

underscore

public static String underscore(CharSequence s)

dashed

public static String dashed(CharSequence s)

hyphenated

public static String hyphenated(CharSequence s)

dotted

public static String dotted(CharSequence s)

capFirst

public static String capFirst(String s)

lowerFirst

public static String lowerFirst(String s)

unsafeCapFirst

public static String unsafeCapFirst(String s)

eq

public static boolean eq(String s1,
                         String s2)

alias of equal(String, String)

Parameters:: s1 - string 1; s2 - string 2
Returns:: true if s1 equals to s2

eq
```
public static boolean eq(String s1,
                         String s2,
                         int modifier)
```
Alias of equal(String, String, int)

Parameters:

s1 - string 1

s2 - String 2

modifier - could be combination of IGNORESPACE or IGNORECASE

Returns:

true if s1 equals to s2 according to modifier

neq

public static boolean neq(String s1,
                          String s2)

Antonym of equal(String, String)

Parameters:: s1 - string 1; s2 - string 2
Returns:: true if s1 doesn’t equal to s2

neq
```
public static boolean neq(String s1,
                          String s2,
                          int modifier)
```
Antonym of equal(String, String, int)

Parameters:

s1 - string 1

s2 - string 2

modifier - could be combination of IGNORESPACE or IGNORECASE

Returns:

true if s1 doesn’t equal to s2 as per modifier

equal
```
public static boolean equal(String s1,
                            String s2)
```
Return true if 2 strings are equals to each other without ignore space and case sensitive.

Parameters:

s1 - string 1

s2 - string 2

Returns:

true if s1 equals to s2

notEqual
```
public static boolean notEqual(String s1,
                               String s2)
```
Return false if 2 strings are equals to each other

Parameters:

s1 - string 1

s2 - string 2

Returns:

true if s1 does not equal to s2

isEqual

public static boolean isEqual(String s1,
                              String s2)

alias of eq(String, String)

Parameters:: s1 - string 1; s2 - string 2
Returns:: true if s1 equals to s2

equal
```
public static boolean equal(String s1,
                            String s2,
                            int modifier)
```
Return true if 2 strings are equals to each other as per rule specified

Parameters:

s1 - string 1

s2 - String 2

modifier - could be combination of IGNORESPACE or IGNORECASE

Returns:

true if s1 equals to s2 according to modifier

equal
```
public static boolean equal(int modifier,
                            String... sa)
```
Check if all strings are equal to each other

Parameters:

modifier - specify whether ignore space or case sensitive

sa - the list of strings

Returns:

true if all strings are equal to each other as per modifier specified

isEqual
```
public static boolean isEqual(String s1,
                              String s2,
                              int modifier)
```
Alias of equal(String, String, int)

Parameters:

s1 - string 1

s2 - string 2

modifier - the modifier could be combination of IGNORESPACE or IGNORECASE

Returns:

true if s1 equals to s2 as per modifier

strip

public static S._StripStage strip(Object o)

strip
```
public static String strip(Object o,
                           String prefix,
                           String suffix)
```
Strip the prefix and suffix from an object’s String representation and return the result

For example:
```
Object o = "xxBByy";
String s = S.strip(o, "xx", "yy")
```
At the end above code, s should be “BB”
Parameters:

o - the object to which string representation will be used

prefix - the prefix

suffix - the suffix

Returns:

the String result as described above

strip
```
public static String strip(Object o,
                           Lang.Tuple<String,String> wrapper)
```
Strip the prefix and suffix of an Object’s string representation and return the result.

Parameters:

o - the object to which string representation will be used

wrapper - a pair of prefix and suffix

Returns:

the String result as described above.

See Also:

strip(Object, String, String)

padLeadingZero
```
public static String padLeadingZero(int number,
                                    int digits)
```
Add leading zero to number

Parameters:

number - the number to which leading zero to be padded

digits - the number of digits of the result string, max number is 20.

Returns:

a String with leading zero which has digits of digits

padLeadingZero

public static String padLeadingZero(long number,
                                    int digits)

padLeft
```
public static String padLeft(String s,
                             char c,
                             int number)
```
Left pad a string with character specified

Parameters:

s - the string

c - the character

number - the number of character to pad to the left

Returns:

an new string with specified number of character c padded to s at left

padLeft
```
public static String padLeft(String s,
                             int number)
```
Left pad a string with number of space specified

Parameters:

s - the string

number - the number of space to left pad to s

Returns:

the string as described

lpad
```
public static String lpad(String s,
                          char c,
                          int number)
```
Alias of padLeft(String, char, int)

Parameters:

s - the string

c - the char

number - number of char to be left pad to s

Returns:

the string as described above

lpad
```
public static String lpad(String s,
                          int number)
```
Alias of padLeft(String, int)

Parameters:

s - the string

number - the number of space to left pad to s

Returns:

the string as described

padRight
```
public static String padRight(String s,
                              char c,
                              int number)
```
Right pad a string with character specified

Parameters:

s - the string

c - the character

number - the number of character to pad to the left

Returns:

an new string with specified number of character c padded to s at right

padRight
```
public static String padRight(String s,
                              int number)
```
Right pad a string with number of space specified

Parameters:

s - the string

number - the number of space to right pad to s

Returns:

the string as described

rpad
```
public static String rpad(String s,
                          char c,
                          int number)
```
Alias of padRight(String, char, int)

Parameters:

s - the string

c - the char

number - number of char to be left pad to s

Returns:

the string as described above

rpad
```
public static String rpad(String s,
                          int number)
```
Alias of padRight(String, int)

Parameters:

s - the string

number - the number of space to left pad to s

Returns:

the string as described

center
```
public static String center(String s,
                            int length)
```
Centers a String in a larger String of size size using the space character (‘ ’).

If the size is less than the String length, the String is returned. A null String is treated as empty string "". A negative size is treated as zero.

Equivalent to center(str, size, " ").

Parameters:

s - the string to center

length - the size of new string

Returns:

centered String

center
```
public static String center(String s,
                            int length,
                            char padChar)
```
Centers a String in a larger String of size size.

Uses a supplied character as the value to pad the String with.

If the size is less than the String length, the String is returned. A null String is treated as empty string"". A negative size is treated as zero.

Parameters:

s - The string to center

length - The size of the new string

padChar - the character to pad the new String with

Returns:

centered String as described above

reversed
```
public static String reversed(String s)
```
Reverse a String.

Parameters:

s - the string to be reversed.

Returns:

reversed string

decodeBASE64
```
public static String decodeBASE64(String str)
```
Decode Base64 encoded string

Parameters:

str - the string to be decoded

Returns:

decoded string

decodeBase64

public static String decodeBase64(String string)

encodeBASE64
```
public static String encodeBASE64(String str)
```
Encode a string using Base64 encoding

Parameters:

str - the string to be encoded

Returns:

encoded string

encodeBase64

public static String encodeBase64(String str)

urlEncode
```
public static String urlEncode(String s)
```
perform URL encoding on a giving string

Parameters:

s - the string to be encoded

Returns:

return encoded string

urlDecode

public static String urlDecode(String s)

dos2unix

public static String dos2unix(String s)

unix2dos

public static String unix2dos(String s)

fileExtension
```
public static String fileExtension(String fileName)
```
Get the extension of a filename.

The returned string will be trimmed and converted to lowercase

Parameters:

fileName - the (supposed) file name

Returns:

the extension from the file name

uuid
```
public static String uuid()
```

random
```
public static String random(int len)
```
Generate random string. The generated string is safe to be used as filename.

Parameters:

len - the number of chars in the returned string

Returns:

a random string with specified number of chars

urlSafeRandom
```
public static String urlSafeRandom(int len)
```
Generate URL safe random string. The generated string is safe to be used as part of URL.

Parameters:

len - the number of chars in the returned string

Returns:

a random string with specified number of chars

random
```
public static String random()
```
Returns:

a random string with 8 chars

urlSafeRandom
```
public static String urlSafeRandom()
```
Returns:

a URL safe random string with 8 chars

shortRandom
```
public static String shortRandom()
```
return a random string with 2 to 5 (inclusive) chars.

shortUrlSafeRandom
```
public static String shortUrlSafeRandom()
```
return a URL safe random string with 2 to 5 (inclusive) chars.

mediumRandom
```
public static String mediumRandom()
```
return a random string with 6 to 15 (inclusive) chars.

mediumUrlSafeRandom
```
public static String mediumUrlSafeRandom()
```
return a URL safe random string with 6 to 15 (inclusive) chars.

longRandom
```
public static String longRandom()
```
return a random string with 16 to 100 (inclusive) chars.

longUrlSafeRandom
```
public static String longUrlSafeRandom()
```
return a URL safe random string with 16 to 100 (inclusive) chars.

secureRandom
```
public static String secureRandom(int len)
```
This is the secure version of random(int).

secureUrlSafeRandom
```
public static String secureUrlSafeRandom(int len)
```
This is the secure version of urlSafeRandom(int).

secureRandom
```
public static String secureRandom()
```
This is the secure version of random().

secureUrlSafeRandom
```
public static String secureUrlSafeRandom()
```
This is the secure version of urlSafeRandom().

random
```
public static String random(int len,
                            Random r)
```
Generate a random string with specified length and a random instance

Parameters:

len - the length of the random string

r - the Random instance

Returns:

the random string

urlSafeRandom
```
public static String urlSafeRandom(int len,
                                   Random r)
```
Generate a URL safe random string with specified length and a random instance

Parameters:

len - the length of the random string

r - the Random instance

Returns:

the random string

random
```
public static String random(int len,
                            Random r,
                            char[] pool)
```
Generate a random string with specified length, a Random instance, a customized character pool

Parameters:

len - the generated random string length

r - the Random instance

pool - the customized character pool

Returns:

the random string

string
```
public static final String string(Object o,
                                  boolean quoted)
```
Get string representation of an object instance

Parameters:

o - the instance to be displayed

quoted - whether display quotation mark

Returns:

the string representation of object

string

public static String string(Object o)

string
```
public static String string(char c)
```

string

public static String string(char[] ca)

string
```
public static String string(int n)
```

string
```
public static String string(long l)
```

string
```
public static String string(float f)
```

string

public static String string(double d)

str
```
public static Str str(Object o)
```

str
```
public static Str str(char... ca)
```

newSizedBuffer
```
public static S.Buffer newSizedBuffer(int size)
```
Return an new S.Buffer instance with predefined size specified

Parameters:

size - the initial capacity of the buffer

Returns:

an new Buffer instance

sizedBuffer

public static S.Buffer sizedBuffer(int size)

newBuffer
```
public static S.Buffer newBuffer()
```
Returns an new S.Buffer instance

Returns:

an new Buffer instance

newBuffer

public static S.Buffer newBuffer(byte o)

newBuffer

public static S.Buffer newBuffer(short o)

newBuffer

public static S.Buffer newBuffer(char o)

newBuffer

public static S.Buffer newBuffer(int o)

newBuffer

public static S.Buffer newBuffer(float o)

newBuffer

public static S.Buffer newBuffer(long o)

newBuffer

public static S.Buffer newBuffer(double o)

newBuffer

public static S.Buffer newBuffer(Object o)

newBuffer

public static S.Buffer newBuffer(String s)

buffer
```
public static S.Buffer buffer()
```
Returns a S.Buffer instance. If the thread local instance is consumed already then return it. Otherwise, return an new Buffer instance

Returns:

a Buffer instance as described above

buffer

public static S.Buffer buffer(boolean o)

buffer

public static S.Buffer buffer(byte o)

buffer

public static S.Buffer buffer(short o)

buffer

public static S.Buffer buffer(char o)

buffer
```
public static S.Buffer buffer(int o)
```

buffer

public static S.Buffer buffer(float o)

buffer

public static S.Buffer buffer(long o)

buffer

public static S.Buffer buffer(double o)

buffer

public static S.Buffer buffer(char[] ca)

buffer

public static S.Buffer buffer(Object o)

buffer

public static S.Buffer buffer(String s)

newBuilder
```
public static StringBuilder newBuilder()
```
Return an new StringBuilder instance

Returns:

the new StringBuilder instance

newBuilder

public static StringBuilder newBuilder(byte o)

newBuilder

public static StringBuilder newBuilder(short o)

newBuilder

public static StringBuilder newBuilder(char o)

newBuilder

public static StringBuilder newBuilder(int o)

newBuilder

public static StringBuilder newBuilder(float o)

newBuilder

public static StringBuilder newBuilder(long o)

newBuilder

public static StringBuilder newBuilder(double o)

newBuilder

public static StringBuilder newBuilder(Object o)

newBuilder

public static StringBuilder newBuilder(String s)

builder
```
public static StringBuilder builder()
```
Returns the ThreadLocal StringBuilder instance with length set to 0

Returns:

the thread local StringBuilder instance

builder

public static StringBuilder builder(boolean o)

builder

public static StringBuilder builder(byte o)

builder

public static StringBuilder builder(short o)

builder

public static StringBuilder builder(char o)

builder

public static StringBuilder builder(int o)

builder

public static StringBuilder builder(float o)

builder

public static StringBuilder builder(long o)

builder

public static StringBuilder builder(double o)

builder

public static StringBuilder builder(Object o)

builder

public static StringBuilder builder(String s)

sizedBuilder

@Deprecated
public static StringBuilder sizedBuilder(int capacity)

Deprecated.

newSizedBuilder

public static StringBuilder newSizedBuilder(int capacity)

pair

public static S.T2 pair(Lang.T2<String,String> t2)

pair

public static S.T2 pair(String left,
                        String right)

pair

public static S.T2 pair(char left,
                        char right)

binary

public static S.T2 binary(Lang.T2<String,String> t2)

binary

public static S.T2 binary(String left,
                          String right)

indexOf
```
public static int indexOf(char[] source,
                          int sourceOffset,
                          int sourceCount,
                          char[] target,
                          int targetOffset,
                          int targetCount,
                          int fromIndex)
```
Search for strings. Copied from jdk String.indexOf. The source is the character array being searched, and the target is the string being searched for.

Parameters:

source - the characters being searched.

sourceOffset - offset of the source string.

sourceCount - count of the source string.

target - the characters being searched for.

targetOffset - offset of the target string.

targetCount - count of the target string.

fromIndex - the index to begin searching from.

list
```
public static S.List list()
```
Returns an empty immutable list

Returns:

the empty list

list
```
public static S.List list(String s)
```

list

public static S.List list(String s1,
                          String s2)

list

public static S.List list(String s1,
                          String s2,
                          String... sa)

list

public static S.List list(Iterable<String> iterable)

listOf

public static S.List listOf(String... sa)

newList
```
public static S.List newList()
```

newList

public static S.List newList(Iterable<String> iterable)

newList

public static S.List newList(String string)

newList

public static S.List newList(String s1,
                             String s2)

newList

public static S.List newList(String s1,
                             String s2,
                             String s3)

newList

public static S.List newList(String s1,
                             String s2,
                             String s3,
                             String... sa)

newListOf

public static S.List newListOf(String[] sa)

var
```
public static S.Var var(String s)
```

val
```
public static S.Val val(String s)
```

main

public static void main(String[] args)

Class S

Nested Class Summary

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

EMPTY_ARRAY

HSEP

HIDDEN_SEPARATOR

HSEP_CHAR

HIDDEN_SEPARATOR_CHAR

COMMON_SEP

PATTERN_COMMON_SEP

FILE_SEP

FILE_SEP_CHAR

PATH_SEP

PATH_SEP_CHAR

SINGLE_QUOTE

DOUBLE_QUOTE

SINGLE_QUOTE_CHAR

DOUBLE_QUOTE_CHAR

DOUBLE_QUOTES

SINGLE_QUOTES

PARENTHESES

BRACKETS

SQUARE_BRACKETS

BRACES

CURLY_BRACES

DIAMOND

ANGLE_BRACKETS

SINGLE_ANGLE_QUOTATION_MARK

DOUBLE_ANGLE_QUOTATION_MARK

书名号

SHU_MING_HAO

IGNORECASE

IGNORESPACE

DIGITS

ALPHABETICS

ALPHANUMERICS

EMPTY_LIST

Method Detail

getCommonSep

fmt

fmt

msgFmt

msgFmt

isEmpty

isEmpty

empty

empty

blank

isBlank

isNotEmpty

notEmpty

notBlank

isNotBlank

isAllEmpty

allEmpty

isAllBlank

allBlank

isAnyEmpty

anyEmpty

isAnyBlank

anyBlank

noEmpty

noBlank

isIntOrLong

isInt

isNumeric

requireNotBlank

requireNotEmpty

first

len

len

binarySplit

tripleSplit

fastSplit

split

split

split