S (Java Tool 1.2.2 API)

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

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

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`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`

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`COMMON_SEP` A commonly used separator: [,;:\\s]+
`static String`	`HSEP` The invisible separator used by program: ""
`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

Constructor Summary

Constructors
Constructor and Description

S()

Constructors
Constructor and Description
`S()`

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 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(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`	`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 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 String`	`cutOff(String s, int max)` Return a string no longer than specified max length.
`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 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 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 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 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 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(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`	`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 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 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 String`	`maxLength(String s, int max)` Return a string no longer than specified max length.
`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.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`	`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 String`	`pathConcat(String prefix, char sep, String suffix)`
`static String`	`quote(String s, char quote)`
`static String`	`quote(String s, String quote)`
`static String`	`random()`
`static String`	`random(int len)` Generate random 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 S.Buffer`	`sizedBuffer(int size)`
`static StringBuilder`	`sizedBuilder(int capacity)` Deprecated.
`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(Object o)`
`static String`	`string(Object o, boolean quoted)` Get string representation of an object instance
`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 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 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`	`uuid()`

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

Field Detail
- HSEP
```
public static final String HSEP
```
  The invisible separator used by program: ""
  
  See Also:
  
  Constant Field Values
- COMMON_SEP
```
public static final String COMMON_SEP
```
  A commonly used separator: [,;:\\s]+
  
  See Also:
  
  Constant Field Values
- 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

Constructor Detail
- S
```
public S()
```

Method Detail

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

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`

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)

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

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)

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)

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)

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)

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 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

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

quote

public static String quote(String s,
                           char quote)

quote

public static String quote(String s,
                           String quote)

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 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)

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 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

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

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

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

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

a random string with 8 chars

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)

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(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)

Class S

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

HSEP

COMMON_SEP

IGNORECASE

IGNORESPACE

Constructor Detail

S

Method Detail

fmt

fmt

isEmpty

empty

blank

isBlank

isNotEmpty

notEmpty

notBlank

isNotBlank

isAllEmpty

allEmpty

isAllBlank

allBlank

isAnyEmpty

anyEmpty

isAnyBlank

anyBlank

noEmpty

noBlank

isIntOrLong

first

len

len

concat

concat

concat

concat

concat

concat

concat

concat

concat

concat

concat

concat

endsWith

endsWith

startsWith

startsWith

ensureStartsWith

ensureStartsWith

ensureEndsWith

ensureEndsWith

pathConcat

join

join

join

join

join

join

times

times

quote

quote

cutOff

maxLength

last

after

after

afterLast

afterFirst

before

before

beforeFirst

beforeLast