org.spf4j.base

Class CharSequences

java.lang.Object

org.spf4j.base.CharSequences

@GwtCompatible
 @ParametersAreNonnullByDefault
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	containsAnyChar(CharSequence string, int start, int end, char... chars)
static boolean	containsIgnoreCase(CharSequence str, CharSequence searchStr)
static int	countIgnoreCase(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... chars)
static int	indexOf(CharSequence cs, int from, int to, char c)
static int	indexOf(CharSequence cs, int from, int to, IntPredicate cp)
static int	indexOfIgnoreCase(CharSequence str, CharSequence searchStr, int idxStart)
static boolean	isValidFileName(CharSequence fileName)
static boolean	isValidJavaId(CharSequence name)
static int	lastIndexOfIgnoreCase(CharSequence str, CharSequence searchStr)
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 int	parseUnsignedInt(CharSequence cs, int radix, int idxFrom) will parse a unsigned integer from a char sequence from idxFrom.
static int	parseUnsignedInt(CharSequence cs, int radix, int idxFrom, int idxTo) will parse a unsigned integer from a char sequence from idxFrom.
static long	parseUnsignedLong(CharSequence cs, int radix, int idxFrom)
static long	parseUnsignedLong(CharSequence cs, int radix, int idxFrom, int idxTo, boolean strict)
static Reader	reader(CharSequence cs)
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 boolean	startsWith(CharSequence sequence, CharSequence prefix, int toffset)
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(CharSequence s1,
                           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 transform s1 into s2

distance

public static int distance(char c1,
                           char c2)

compareTo

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

Deprecated. use compare.

compare s to t.

Parameters:

s -

t -

Returns:

compare

public static int compare(CharSequence s,
                          CharSequence t)

compare

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

compare

public static int compare(CharSequence s,
                          int sFrom,
                          int sLength,
                          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(CharSequence s,
                                      CharSequence t)

equals

public static boolean equals(CharSequence s,
                             CharSequence t)

hashcode

public static int hashcode(CharSequence cs)

subSequence

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

startsWith

public static boolean startsWith(CharSequence sequence,
                                 CharSequence prefix,
                                 int toffset)

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

parseUnsignedInt

public static int parseUnsignedInt(@Nonnull
                                   CharSequence cs,
                                   int radix,
                                   int idxFrom)

will parse a unsigned integer from a char sequence from idxFrom.

Parameters:

cs -

radix -

idxFrom -

Returns:

parseUnsignedInt

public static int parseUnsignedInt(@Nonnull
                                   CharSequence cs,
                                   int radix,
                                   int idxFrom,
                                   int idxTo)

will parse a unsigned integer from a char sequence from idxFrom.

Parameters:

cs -

radix -

idxFrom -

idxTo -

Returns:

parseUnsignedLong

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

parseUnsignedLong

public static long parseUnsignedLong(@Nonnull
                                     CharSequence cs,
                                     int radix,
                                     int idxFrom,
                                     int idxTo,
                                     boolean strict)

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)

containsAnyChar

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

isValidJavaId

public static boolean isValidJavaId(CharSequence name)

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)

indexOf

public static int indexOf(CharSequence cs,
                          int from,
                          int to,
                          IntPredicate cp)

indexOf

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

containsIgnoreCase

public static boolean containsIgnoreCase(CharSequence str,
                                         CharSequence searchStr)

lastIndexOfIgnoreCase

public static int lastIndexOfIgnoreCase(CharSequence str,
                                        CharSequence searchStr)

indexOfIgnoreCase

public static int indexOfIgnoreCase(CharSequence str,
                                    CharSequence searchStr,
                                    int idxStart)

countIgnoreCase

public static int countIgnoreCase(CharSequence str,
                                  CharSequence searchStr)

reader

@GwtIncompatible
public static Reader reader(CharSequence cs)