com.android.utils

Class CharSequences

java.lang.Object

com.android.utils.CharSequences

public class CharSequences
extends java.lang.Object

A number of utility methods around CharSequence handling, which adds methods that are available on Strings (such as indexOf, startsWith and regionMatches and provides equivalent methods for character sequences.

NOTE: This is not a public or final API; if you rely on this be prepared to adjust your code for the next tools release.

Constructor Summary

Constructors

Constructor and Description
CharSequences()

Method Summary

Modifier and Type	Method and Description
static boolean	containsUpperCase(java.lang.CharSequence s) Returns true if the given sequence contains any upper case characters
static java.lang.CharSequence	createSequence(char[] data)
static java.lang.CharSequence	createSequence(char[] data, int offset, int length)
static boolean	endsWith(java.lang.CharSequence sequence, java.lang.CharSequence suffix, boolean caseSensitive) Returns true if the given character sequence ends with the given suffix
static char[]	getCharArray(java.lang.CharSequence sequence)
static java.io.InputStream	getInputStream(java.lang.CharSequence text)
static CharSequenceReader	getReader(java.lang.CharSequence data, boolean stripBom) The CharSequenceReader returned by this method is intended for single-thread use only.
static int	indexOf(java.lang.CharSequence sequence, char c)
static int	indexOf(java.lang.CharSequence sequence, char c, int start)
static int	indexOf(java.lang.CharSequence haystack, java.lang.CharSequence needle)
static int	indexOf(java.lang.CharSequence haystack, java.lang.CharSequence needle, int start)
static int	indexOfIgnoreCase(java.lang.CharSequence where, java.lang.CharSequence what, int fromIndex) Similar to String.indexOf(int, int) but with case insensitive comparison.
static int	lastIndexOf(java.lang.CharSequence sequence, char c)
static int	lastIndexOf(java.lang.CharSequence sequence, int c, int start)
static int	lastIndexOf(java.lang.CharSequence haystack, java.lang.String needle)
static int	lastIndexOf(java.lang.CharSequence haystack, java.lang.String needle, int start)
static org.w3c.dom.Document	parseDocumentSilently(java.lang.CharSequence xml, boolean namespaceAware)
static boolean	regionMatches(java.lang.CharSequence sequence, boolean ignoreCase, int thisStart, java.lang.CharSequence string, int start, int length)
static boolean	regionMatches(java.lang.CharSequence sequence, int thisStart, java.lang.CharSequence string, int start, int length)
static boolean	startsWith(java.lang.CharSequence sequence, java.lang.CharSequence prefix)
static boolean	startsWith(java.lang.CharSequence sequence, java.lang.CharSequence prefix, int start)
static char	toLowerCase(char c) Converts a character to lower case.
static char	toUpperCase(char c) Converts a character to upper case.

Methods inherited from class java.lang.Object

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

Constructor Detail

CharSequences

public CharSequences()

Method Detail

indexOf

public static int indexOf(@NonNull
                          java.lang.CharSequence sequence,
                          char c)

indexOf

public static int indexOf(@NonNull
                          java.lang.CharSequence sequence,
                          char c,
                          int start)

lastIndexOf

public static int lastIndexOf(@NonNull
                              java.lang.CharSequence haystack,
                              @NonNull
                              java.lang.String needle,
                              int start)

lastIndexOf

public static int lastIndexOf(@NonNull
                              java.lang.CharSequence sequence,
                              char c)

lastIndexOf

public static int lastIndexOf(@NonNull
                              java.lang.CharSequence sequence,
                              int c,
                              int start)

lastIndexOf

public static int lastIndexOf(@NonNull
                              java.lang.CharSequence haystack,
                              @NonNull
                              java.lang.String needle)

regionMatches

public static boolean regionMatches(@NonNull
                                    java.lang.CharSequence sequence,
                                    int thisStart,
                                    @NonNull
                                    java.lang.CharSequence string,
                                    int start,
                                    int length)

regionMatches

public static boolean regionMatches(@NonNull
                                    java.lang.CharSequence sequence,
                                    boolean ignoreCase,
                                    int thisStart,
                                    @NonNull
                                    java.lang.CharSequence string,
                                    int start,
                                    int length)

startsWith

public static boolean startsWith(@NonNull
                                 java.lang.CharSequence sequence,
                                 @NonNull
                                 java.lang.CharSequence prefix)

startsWith

public static boolean startsWith(@NonNull
                                 java.lang.CharSequence sequence,
                                 @NonNull
                                 java.lang.CharSequence prefix,
                                 int start)

endsWith

public static boolean endsWith(@NonNull
                               java.lang.CharSequence sequence,
                               @NonNull
                               java.lang.CharSequence suffix,
                               boolean caseSensitive)

Returns true if the given character sequence ends with the given suffix

Parameters:

sequence - the sequence to check

suffix - the suffix to check for

caseSensitive - whether the check should be case sensitive

Returns:

true if the sequence ends with the given suffix

containsUpperCase

public static boolean containsUpperCase(@Nullable
                                        java.lang.CharSequence s)

Returns true if the given sequence contains any upper case characters

Parameters:

s - the sequence to test

Returns:

true if there are any upper case characters in the string

indexOf

public static int indexOf(@NonNull
                          java.lang.CharSequence haystack,
                          @NonNull
                          java.lang.CharSequence needle)

indexOf

public static int indexOf(@NonNull
                          java.lang.CharSequence haystack,
                          @NonNull
                          java.lang.CharSequence needle,
                          int start)

indexOfIgnoreCase

public static int indexOfIgnoreCase(@NonNull
                                    java.lang.CharSequence where,
                                    @NonNull
                                    java.lang.CharSequence what,
                                    int fromIndex)

Similar to String.indexOf(int, int) but with case insensitive comparison.

toUpperCase

public static char toUpperCase(char c)

Converts a character to upper case. A slightly optimized version of Character.toUpperCase(char).

toLowerCase

public static char toLowerCase(char c)

Converts a character to lower case. A slightly optimized version of Character.toLowerCase(char).

createSequence

@NonNull
public static java.lang.CharSequence createSequence(@NonNull
                                                             char[] data)

createSequence

@NonNull
public static java.lang.CharSequence createSequence(@NonNull
                                                             char[] data,
                                                             int offset,
                                                             int length)

getCharArray

@NonNull
public static char[] getCharArray(@NonNull
                                           java.lang.CharSequence sequence)

getReader

@NonNull
public static CharSequenceReader getReader(@NonNull
                                                    java.lang.CharSequence data,
                                                    boolean stripBom)

The CharSequenceReader returned by this method is intended for single-thread use only.

Parameters:

data - the character sequence to read

stripBom - whether a byte order mark at the beginning of the charachter sequence should be skipped if present

Returns:

the reader obtaining its data from the given characher sequence

parseDocumentSilently

@Nullable
public static org.w3c.dom.Document parseDocumentSilently(@NonNull
                                                                   java.lang.CharSequence xml,
                                                                   boolean namespaceAware)

getInputStream

@NonNull
public static java.io.InputStream getInputStream(@NonNull
                                                          java.lang.CharSequence text)