org.spf4j.base

Class CharSequences

java.lang.Object

org.spf4j.base.CharSequences

@GwtCompatible
public final class CharSequences
extends Object

Special methods to use for character sequences...

Author:

zoly

Method Summary

Modifier and Type	Method and Description
static int	compare(CharSequence s, CharSequence t)
static int	compare(CharSequence s, int sLength, CharSequence t, int tLength)
static int	compare(CharSequence s, int sFrom, int sLength, CharSequence t, int tFrom, int tLength) compare 2 CharSequence fragments.
static int	compareTo(CharSequence s, CharSequence t) Deprecated. use compare.
static boolean	containsAnyChar(CharSequence string, char... chars)
static boolean	containsIgnoreCase(CharSequence str, CharSequence searchStr)
static int	distance(char c1, char c2)
static int	distance(CharSequence s1, CharSequence s2) function that calculates the number of operations that are needed to transform s1 into s2.
static boolean	endsWith(CharSequence qc, CharSequence with)
static boolean	equals(CharSequence s, CharSequence t)
static boolean	equalsNullables(CharSequence s, CharSequence t)
CharSequence	getJavaRegexpStr(CharSequence wildcard) Transform a wildcard expression 2 a java regular expression.
static int	hashcode(CharSequence cs)
static int	indexOf(CharSequence cs, int from, int to, char c)
static int	indexOfIgnoreCase(CharSequence str, CharSequence searchStr)
static boolean	isValidFileName(CharSequence fileName)
static Appendable	lineNumbered(int startLineNr, Appendable appendable)
static Appendable	lineNumbered(int startLineNr, Appendable appendable, IntAppender ia)
static boolean	match(CharSequence wildcard, CharSequence cs2Match) regular wildcard matcher.
static int	parseInt(CharSequence s) A more flexible version of Integer.parseInt.
static int	parseInt(CharSequence cs, int radix) A more flexible version of Integer.parseInt.
static long	parseLong(CharSequence cs) A more flexible version of Long.parseLong.
static long	parseLong(CharSequence cs, int radix) A more flexible version of Long.parseLong.
static boolean	regionMatches(CharSequence t, int toffset, CharSequence other, int ooffset, int plen) Equivalent to String.regionMatches.
static boolean	regionMatchesIgnoreCase(CharSequence ta, int toffset, CharSequence pa, int ooffset, int plen) Equivalent/based on to String.regionMatches.
static CharSequence	subSequence(CharSequence seq, int startIdx, int endIdx)
static CharSequence	toLineNumbered(int startLineNr, CharSequence source)
static CharSequence	toLineNumbered(int startLineNr, CharSequence source, IntAppender ia)
static <T extends CharSequence> T	validatedFileName(T fileName)

Methods inherited from class java.lang.Object

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

Method Detail

distance

public static int distance(@Nonnull
                           CharSequence s1,
                           @Nonnull
                           CharSequence s2)

function that calculates the number of operations that are needed to transform s1 into s2. operations are: char add, char delete, char modify See https://en.wikipedia.org/wiki/Levenshtein_distance for more info.

Parameters:

s1 -

s2 -

Returns:

the number of operations required to transfor s1 into s2

distance

public static int distance(char c1,
                           char c2)

compareTo

@Deprecated
public static int compareTo(@Nonnull
                                        CharSequence s,
                                        @Nonnull
                                        CharSequence t)

Deprecated. use compare.

compare s to t.

Parameters:

s -

t -

Returns:

compare

public static int compare(@Nonnull
                          CharSequence s,
                          @Nonnull
                          CharSequence t)

compare

public static int compare(@Nonnull
                          CharSequence s,
                          int sLength,
                          @Nonnull
                          CharSequence t,
                          int tLength)

compare

public static int compare(@Nonnull
                          CharSequence s,
                          int sFrom,
                          int sLength,
                          @Nonnull
                          CharSequence t,
                          int tFrom,
                          int tLength)

compare 2 CharSequence fragments.

Parameters:

s - the charsequence to compare

sFrom - the index for the first chars to compare.

sLength - the number of characters to compare.

t - the charsequence to compare to

tFrom - the index for the first character to compare to.

tLength - the number of characters to compare to.

Returns:

equalsNullables

public static boolean equalsNullables(@Nullable
                                      CharSequence s,
                                      @Nullable
                                      CharSequence t)

equals

public static boolean equals(@Nonnull
                             CharSequence s,
                             @Nonnull
                             CharSequence t)

hashcode

public static int hashcode(@Nonnull
                           CharSequence cs)

subSequence

public static CharSequence subSequence(@Nonnull
                                       CharSequence seq,
                                       int startIdx,
                                       int endIdx)

endsWith

public static boolean endsWith(CharSequence qc,
                               CharSequence with)

lineNumbered

public static Appendable lineNumbered(int startLineNr,
                                      Appendable appendable)
                               throws IOException

Throws:

IOException

lineNumbered

public static Appendable lineNumbered(int startLineNr,
                                      Appendable appendable,
                                      IntAppender ia)
                               throws IOException

Throws:

IOException

toLineNumbered

public static CharSequence toLineNumbered(int startLineNr,
                                          CharSequence source)

toLineNumbered

public static CharSequence toLineNumbered(int startLineNr,
                                          CharSequence source,
                                          IntAppender ia)

parseInt

public static int parseInt(@Nonnull
                           CharSequence s)

A more flexible version of Integer.parseInt.

See Also:

Integer.parseInt

parseInt

public static int parseInt(@Nonnull
                           CharSequence cs,
                           int radix)

A more flexible version of Integer.parseInt.

See Also:

Integer.parseInt

parseLong

public static long parseLong(@Nonnull
                             CharSequence cs)

A more flexible version of Long.parseLong.

See Also:

Long.parseLong

parseLong

public static long parseLong(@Nonnull
                             CharSequence cs,
                             int radix)

A more flexible version of Long.parseLong.

See Also:

Long.parseLong

containsAnyChar

public static boolean containsAnyChar(CharSequence string,
                                      char... chars)

isValidFileName

public static boolean isValidFileName(@Nonnull
                                      CharSequence fileName)

validatedFileName

public static <T extends CharSequence> T validatedFileName(@Nonnull
                                                           T fileName)

regionMatches

public static boolean regionMatches(CharSequence t,
                                    int toffset,
                                    CharSequence other,
                                    int ooffset,
                                    int plen)

Equivalent to String.regionMatches.

regionMatchesIgnoreCase

public static boolean regionMatchesIgnoreCase(CharSequence ta,
                                              int toffset,
                                              CharSequence pa,
                                              int ooffset,
                                              int plen)

Equivalent/based on to String.regionMatches.

match

public static boolean match(CharSequence wildcard,
                            CharSequence cs2Match)

regular wildcard matcher. * matches any number of consecutive characters. ? matches any single character.

Parameters:

wildcard -

cs2Match -

Returns:

getJavaRegexpStr

public CharSequence getJavaRegexpStr(CharSequence wildcard)

Transform a wildcard expression 2 a java regular expression. * matches any number of consecutive characters. ? matches any single character.

Parameters:

wildcard -

Returns:

indexOf

public static int indexOf(CharSequence cs,
                          int from,
                          int to,
                          char c)

containsIgnoreCase

public static boolean containsIgnoreCase(CharSequence str,
                                         CharSequence searchStr)

indexOfIgnoreCase

public static int indexOfIgnoreCase(CharSequence str,
                                    CharSequence searchStr)