com.landawn.abacus.util

Class Splitter

java.lang.Object

com.landawn.abacus.util.Splitter

public final class Splitter
extends Object

Since:

0.8

Author:

Haiyang Li

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Splitter.MapSplitter The Class MapSplitter.

Field Summary

Fields

Modifier and Type	Field and Description
static Pattern	WHITE_SPACE_PATTERN

Method Summary

Modifier and Type	Method and Description
static Splitter	defauLt() Returns the Splitter with the default delimiter: ", ".
Splitter	limit(int limit)
Splitter	omitEmptyStrings()
Splitter	omitEmptyStrings(boolean omitEmptyStrings) Deprecated. replaced with omitEmptyStrings()
static Splitter	pattern(CharSequence delimiterRegex)
<C extends Collection<String>> C	split(C output, CharSequence source)
<T,C extends Collection<T>> C	split(C output, Class<T> targetType, CharSequence source)
List<String>	split(CharSequence source)
<C extends Collection<String>> C	split(CharSequence source, Supplier<? extends C> supplier)
<R,E extends Exception> List<R>	split(CharSequence source, Throwables.Function<? super String,R,E> mapper)
<T> List<T>	split(Class<T> targetType, CharSequence source)
<T,C extends Collection<T>> C	split(Class<T> targetType, CharSequence source, Supplier<? extends C> supplier)
<T,C extends Collection<T>> C	split(C output, com.landawn.abacus.type.Type<T> targetType, CharSequence source)
<T> List<T>	split(com.landawn.abacus.type.Type<T> targetType, CharSequence source)
<T,C extends Collection<T>> C	split(com.landawn.abacus.type.Type<T> targetType, CharSequence source, Supplier<? extends C> supplier)
<T,E extends Exception> T	splitAndThen(CharSequence source, Throwables.Function<? super List<String>,T,E> converter) Split and then.
String[]	splitToArray(CharSequence source) Split to array.
<E extends Exception> String[]	splitToArray(CharSequence source, Throwables.Function<? super String,String,E> mapper) Split to array.
<T> T	splitToArray(Class<T> arrayType, CharSequence source) Split to array.
String[]	splitToArray(String[] output, CharSequence source) Split to array.
ImmutableList<String>	splitToImmutableList(CharSequence source) Split to array.
<T> ImmutableList<T>	splitToImmutableList(Class<T> targetType, CharSequence source) Split to array.
Splitter	strip(boolean strip) Deprecated. replaced with stripResults()
Splitter	stripResults()
Splitter	trim(boolean trim) Deprecated. replaced with trimResults()
Splitter	trimResults()
static Splitter	with(char delimiter)
static Splitter	with(CharSequence delimiter)
static Splitter	with(Pattern delimiter)

Methods inherited from class java.lang.Object

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

Field Detail

WHITE_SPACE_PATTERN

public static final Pattern WHITE_SPACE_PATTERN

Method Detail

defauLt

public static Splitter defauLt()

Returns the Splitter with the default delimiter: ", ".

Returns:

with

public static Splitter with(char delimiter)

Parameters:

delimiter -

Returns:

with

public static Splitter with(CharSequence delimiter)
                     throws IllegalArgumentException

Parameters:

delimiter -

Returns:

Throws:

IllegalArgumentException - if the specified delimiter is null or empty.

with

public static Splitter with(Pattern delimiter)
                     throws IllegalArgumentException

Parameters:

delimiter -

Returns:

Throws:

IllegalArgumentException - if the specified delimiter is null, or empty string may be matched by it.

pattern

public static Splitter pattern(CharSequence delimiterRegex)
                        throws IllegalArgumentException

Parameters:

delimiterRegex -

Returns:

Throws:

IllegalArgumentException - if the specified delimiter is null or empty, or empty string may be matched by it.

omitEmptyStrings

@Deprecated
public Splitter omitEmptyStrings(boolean omitEmptyStrings)

Deprecated. replaced with omitEmptyStrings()

Omit empty strings.

Parameters:

omitEmptyStrings -

Returns:

omitEmptyStrings

public Splitter omitEmptyStrings()

trim

@Deprecated
public Splitter trim(boolean trim)

Deprecated. replaced with trimResults()

Parameters:

trim -

Returns:

trimResults

public Splitter trimResults()

strip

@Deprecated
public Splitter strip(boolean strip)

Deprecated. replaced with stripResults()

Removes the starting and ending white space characters if strip is true.

Parameters:

strip -

Returns:

See Also:

Character.isWhitespace(char)

stripResults

public Splitter stripResults()

Returns:

limit

public Splitter limit(int limit)

Parameters:

limit -

Returns:

split

public List<String> split(CharSequence source)

Parameters:

source -

Returns:

split

public <R,E extends Exception> List<R> split(CharSequence source,
                                             Throwables.Function<? super String,R,E> mapper)
                                      throws E extends Exception

Parameters:

source -

mapper -

Returns:

Throws:

E extends Exception

split

public <T> List<T> split(Class<T> targetType,
                         CharSequence source)

Type Parameters:

T -

Parameters:

targetType -

source -

Returns:

split

public <T> List<T> split(com.landawn.abacus.type.Type<T> targetType,
                         CharSequence source)

Type Parameters:

T -

Parameters:

targetType -

source -

Returns:

split

public <C extends Collection<String>> C split(C output,
                                              CharSequence source)

Type Parameters:

C -

Parameters:

output -

source -

Returns:

split

public <T,C extends Collection<T>> C split(C output,
                                           Class<T> targetType,
                                           CharSequence source)

Type Parameters:

T -

C -

Parameters:

output -

targetType -

source -

Returns:

split

public <T,C extends Collection<T>> C split(C output,
                                           com.landawn.abacus.type.Type<T> targetType,
                                           CharSequence source)

Type Parameters:

T -

C -

Parameters:

output -

targetType -

source -

Returns:

split

public <C extends Collection<String>> C split(CharSequence source,
                                              Supplier<? extends C> supplier)

Type Parameters:

C -

Parameters:

source -

supplier -

Returns:

split

public <T,C extends Collection<T>> C split(Class<T> targetType,
                                           CharSequence source,
                                           Supplier<? extends C> supplier)

Type Parameters:

T -

C -

Parameters:

targetType -

source -

supplier -

Returns:

split

public <T,C extends Collection<T>> C split(com.landawn.abacus.type.Type<T> targetType,
                                           CharSequence source,
                                           Supplier<? extends C> supplier)

Type Parameters:

T -

C -

Parameters:

targetType -

source -

supplier -

Returns:

splitToImmutableList

public ImmutableList<String> splitToImmutableList(CharSequence source)

Split to array.

Parameters:

source -

Returns:

splitToImmutableList

public <T> ImmutableList<T> splitToImmutableList(Class<T> targetType,
                                                 CharSequence source)

Split to array.

Type Parameters:

T -

Parameters:

arrayType -

source -

Returns:

splitToArray

public String[] splitToArray(String[] output,
                             CharSequence source)

Split to array.

Parameters:

output -

source -

Returns:

splitToArray

public String[] splitToArray(CharSequence source)

Split to array.

Parameters:

source -

Returns:

splitToArray

public <E extends Exception> String[] splitToArray(CharSequence source,
                                                   Throwables.Function<? super String,String,E> mapper)
                                            throws E extends Exception

Split to array.

Parameters:

source -

Returns:

Throws:

E extends Exception

splitToArray

public <T> T splitToArray(Class<T> arrayType,
                          CharSequence source)

Split to array.

Type Parameters:

T -

Parameters:

arrayType -

source -

Returns:

splitAndThen

public <T,E extends Exception> T splitAndThen(CharSequence source,
                                              Throwables.Function<? super List<String>,T,E> converter)
                                       throws E extends Exception

Split and then.

Type Parameters:

T -

E -

Parameters:

source -

converter -

Returns:

Throws:

E - the e

E extends Exception