QuotationAwareTokenizer

public class QuotationAwareTokenizer
extends Object

java.lang.Object
↳	com.android.tradefed.util.QuotationAwareTokenizer

Summary

Public constructors
`QuotationAwareTokenizer()`

Public methods
`static String`	`combineTokens(String... tokens)` Perform the reverse of `tokenizeLine(String)`.
`static String[]`	`tokenizeLine(String line, String delim)`
`static String[]`	`tokenizeLine(String line)` Tokenizes the string, splitting on spaces.
`static String[]`	`tokenizeLine(String line, String delim, boolean logging)` Tokenizes the string, splitting on specified delimiter.
`static String[]`	`tokenizeLine(String line, boolean logging)` Tokenizes the string, splitting on spaces.

public QuotationAwareTokenizer ()

public static String combineTokens (String... tokens)

Perform the reverse of tokenizeLine(String).
Given array of tokens, combine them into a single line.

Returns
`String`	A `String` created from all the tokens.

public static String[] tokenizeLine (String line, 
                String delim)

Parameters
`line`	`String`
`delim`	`String`

Returns
`String[]`

public static String[] tokenizeLine (String line)

Tokenizes the string, splitting on spaces. Does not split between consecutive, unquoted double-quote marks.

public static String[] tokenizeLine (String line, 
                String delim, 
                boolean logging)

Tokenizes the string, splitting on specified delimiter. Does not split between consecutive, unquoted double-quote marks.

How the tokenizer works:

Split the string into "characters" where each "character" is either an escaped character like \" (that is, "\\\"") or a single real character like f (just "f").
For each "character"
1. If it's a space, finish a token unless we're being quoted
2. If it's a quotation mark, flip the "we're being quoted" bit
3. Otherwise, add it to the token being built
At EOL, we typically haven't added the final token to the (tokens) ERROR(/ArrayList)
1. If the last "character" is an escape character, throw an exception; that's not valid
2. If we're in the middle of a quotation, throw an exception; that's not valid
3. Otherwise, add the final token to (tokens)
Return a String[] version of (tokens)

Parameters
`line`	`String`: A `String` to be tokenized
`delim`	`String`: the delimiter to split on
`logging`	`boolean`: whether or not to log operations

Returns
`String[]`	A tokenized version of the string

Throws
`IllegalArgumentException`	if the line cannot be parsed

public static String[] tokenizeLine (String line, 
                boolean logging)

Tokenizes the string, splitting on spaces. Does not split between consecutive, unquoted double-quote marks.