io.servicetalk.http.api

Class CharSequences

Object

CharSequences

public final class CharSequences
extends Object

Provides factory methods for creating CharSequence implementations.

Method Summary

Modifier and Type	Method and Description
static boolean	contentEquals(CharSequence a, CharSequence b) Returns true if the content of both CharSequence's are equals.
static boolean	contentEqualsIgnoreCase(CharSequence a, CharSequence b) Perform a case-insensitive comparison of two CharSequences.
static CharSequence	emptyAsciiString() Get a reference to an unmodifiable empty CharSequence with the same properties as newAsciiString(Buffer).
static int	indexOf(CharSequence sequence, char c, int fromIndex) Find the index of c within sequence starting at index fromIndex.
static CharSequence	newAsciiString(Buffer input) Create a new CharSequence from the specified input, supporting only 8-bit ASCII characters, and with a case-insensitive hashCode.
static CharSequence	newAsciiString(String input) Create a new CharSequence from the specified input, supporting only 8-bit ASCII characters, and with a case-insensitive hashCode.
static boolean	regionMatches(CharSequence cs, boolean ignoreCase, int csStart, CharSequence string, int start, int length) This methods make regionMatches operation correctly for any chars in strings.
static Buffer	unwrapBuffer(CharSequence cs) Attempt to unwrap a CharSequence and obtain the underlying Buffer if possible.

Methods inherited from class Object

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

Method Detail

newAsciiString

public static CharSequence newAsciiString(String input)

Create a new CharSequence from the specified input, supporting only 8-bit ASCII characters, and with a case-insensitive hashCode.

Supporting only 8-bit ASCII and providing a case-insensitive hashCode allows for optimizations when the CharSequence returned is used as HttpHeaders names or values.

Parameters:

input - a string containing only 8-bit ASCII characters.

Returns:

a CharSequence

newAsciiString

public static CharSequence newAsciiString(Buffer input)

Create a new CharSequence from the specified input, supporting only 8-bit ASCII characters, and with a case-insensitive hashCode.

Supporting only 8-bit ASCII and providing a case-insensitive hashCode allows for optimizations when the CharSequence returned is used as HttpHeaders names or values.

Parameters:

input - a Buffer containing

Returns:

a CharSequence.

emptyAsciiString

public static CharSequence emptyAsciiString()

Get a reference to an unmodifiable empty CharSequence with the same properties as newAsciiString(Buffer).

Returns:

a reference to an unmodifiable empty CharSequence with the same properties as newAsciiString(Buffer).

unwrapBuffer

@Nullable
public static Buffer unwrapBuffer(CharSequence cs)

Attempt to unwrap a CharSequence and obtain the underlying Buffer if possible.

Parameters:

cs - the CharSequence to unwrap.

Returns:

the underlying Buffer or null.

contentEqualsIgnoreCase

public static boolean contentEqualsIgnoreCase(@Nullable
                                              CharSequence a,
                                              @Nullable
                                              CharSequence b)

Perform a case-insensitive comparison of two CharSequences.

NOTE: This only supports 8-bit ASCII.

Parameters:

a - first CharSequence to compare.

b - second CharSequence to compare.

Returns:

true if both CharSequence's are equals when ignoring the case.

contentEquals

public static boolean contentEquals(CharSequence a,
                                    CharSequence b)

Returns true if the content of both CharSequence's are equals. This only supports 8-bit ASCII.

Parameters:

a - left hand side of comparison.

b - right hand side of comparison.

Returns:

true if a's content equals b.

indexOf

public static int indexOf(CharSequence sequence,
                          char c,
                          int fromIndex)

Find the index of c within sequence starting at index fromIndex.

Parameters:

sequence - The CharSequence to search in.

c - The character to find.

fromIndex - The index to start searching (inclusive).

Returns:

The index of c or -1 otherwise.

regionMatches

public static boolean regionMatches(CharSequence cs,
                                    boolean ignoreCase,
                                    int csStart,
                                    CharSequence string,
                                    int start,
                                    int length)

This methods make regionMatches operation correctly for any chars in strings.

Parameters:

cs - the CharSequence to be processed

ignoreCase - specifies if case should be ignored.

csStart - the starting offset in the cs CharSequence

string - the CharSequence to compare.

start - the starting offset in the specified string.

length - the number of characters to compare.

Returns:

true if the ranges of characters are equal, false otherwise.