Added in API level 1

Rfc822Tokenizer


public class Rfc822Tokenizer
extends Object implements MultiAutoCompleteTextView.Tokenizer

java.lang.Object
   ↳ android.text.util.Rfc822Tokenizer


This class works as a Tokenizer for MultiAutoCompleteTextView for address list fields, and also provides a method for converting a string of addresses (such as might be typed into such a field) into a series of Rfc822Tokens.

Summary

Public constructors

Rfc822Tokenizer()

Public methods

int findTokenEnd(CharSequence text, int cursor)

Returns the end of the token (minus trailing punctuation) that begins at offset cursor within text.

int findTokenStart(CharSequence text, int cursor)

Returns the start of the token that ends at offset cursor within text.

CharSequence terminateToken(CharSequence text)

Terminates the specified address with a comma and space.

static void tokenize(CharSequence text, Collection<Rfc822Token> out)

This constructor will try to take a string like "Foo Bar (something) <foo\@google.com>, blah\@google.com (something)" and convert it into one or more Rfc822Tokens, output into the supplied collection.

static Rfc822Token[] tokenize(CharSequence text)

This method will try to take a string like "Foo Bar (something) <foo\@google.com>, blah\@google.com (something)" and convert it into one or more Rfc822Tokens.

Inherited methods

Object clone()

Creates and returns a copy of this object.

boolean equals(Object obj)

Indicates whether some other object is "equal to" this one.

void finalize()

Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.

final Class<?> getClass()

Returns the runtime class of this Object.

int hashCode()

Returns a hash code value for the object.

final void notify()

Wakes up a single thread that is waiting on this object's monitor.

final void notifyAll()

Wakes up all threads that are waiting on this object's monitor.

String toString()

Returns a string representation of the object.

final void wait(long timeoutMillis, int nanos)

Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.

final void wait(long timeoutMillis)

Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.

final void wait()

Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

abstract int findTokenEnd(CharSequence text, int cursor)

Returns the end of the token (minus trailing punctuation) that begins at offset cursor within text.

abstract int findTokenStart(CharSequence text, int cursor)

Returns the start of the token that ends at offset cursor within text.

abstract CharSequence terminateToken(CharSequence text)

Returns text, modified, if necessary, to ensure that it ends with a token terminator (for example a space or comma).

Public constructors

Rfc822Tokenizer

public Rfc822Tokenizer ()

Public methods

findTokenEnd

Added in API level 1
public int findTokenEnd (CharSequence text, 
                int cursor)

Returns the end of the token (minus trailing punctuation) that begins at offset cursor within text.

Parameters
text CharSequence

cursor int

Returns
int

findTokenStart

Added in API level 1
public int findTokenStart (CharSequence text, 
                int cursor)

Returns the start of the token that ends at offset cursor within text.

Parameters
text CharSequence

cursor int

Returns
int

terminateToken

Added in API level 1
public CharSequence terminateToken (CharSequence text)

Terminates the specified address with a comma and space. This assumes that the specified text already has valid syntax. The Adapter subclass's convertToString() method must make that guarantee.

Parameters
text CharSequence

Returns
CharSequence

tokenize

Added in API level 8
public static void tokenize (CharSequence text, 
                Collection<Rfc822Token> out)

This constructor will try to take a string like "Foo Bar (something) <foo\@google.com>, blah\@google.com (something)" and convert it into one or more Rfc822Tokens, output into the supplied collection. It does *not* decode MIME encoded-words; charset conversion must already have taken place if necessary. It will try to be tolerant of broken syntax instead of returning an error.

Parameters
text CharSequence

out Collection

tokenize

Added in API level 1
public static Rfc822Token[] tokenize (CharSequence text)

This method will try to take a string like "Foo Bar (something) <foo\@google.com>, blah\@google.com (something)" and convert it into one or more Rfc822Tokens. It does *not* decode MIME encoded-words; charset conversion must already have taken place if necessary. It will try to be tolerant of broken syntax instead of returning an error.

Parameters
text CharSequence

Returns
Rfc822Token[]