lightbulb_outline Please take our October 2018 developer survey. Start survey
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

Public constructors

Rfc822Tokenizer

added in API level 1
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[]