com.google.gdata.util.common.base
Class CharEscaperBuilder

java.lang.Object
  extended by com.google.gdata.util.common.base.CharEscaperBuilder

public class CharEscaperBuilder
extends java.lang.Object

Simple helper class to build a "sparse" array of objects based on the indexes that were added to it. The array will be from 0 to the maximum index given. All non-set indexes will contain null (so it's not really a sparse array, just a pseudo sparse array). The builder can also return a CharEscaper based on the generated array.


Constructor Summary
CharEscaperBuilder()
          Construct a new sparse array builder.
 
Method Summary
 CharEscaperBuilder addEscape(char c, java.lang.String r)
          Add a new mapping from an index to an object to the escaping.
 CharEscaperBuilder addEscapes(char[] cs, java.lang.String r)
          Add multiple mappings at once for a particular index.
 char[][] toArray()
          Convert this builder into an array of char[]s where the maximum index is the value of the highest character that has been seen.
 CharEscaper toEscaper()
          Convert this builder into a char escaper which is just a decorator around the underlying array of replacement char[]s.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

CharEscaperBuilder

public CharEscaperBuilder()
Construct a new sparse array builder.

Method Detail

addEscape

public CharEscaperBuilder addEscape(char c,
                                    java.lang.String r)
Add a new mapping from an index to an object to the escaping.


addEscapes

public CharEscaperBuilder addEscapes(char[] cs,
                                     java.lang.String r)
Add multiple mappings at once for a particular index.


toArray

public char[][] toArray()
Convert this builder into an array of char[]s where the maximum index is the value of the highest character that has been seen. The array will be sparse in the sense that any unseen index will default to null.

Returns:
a "sparse" array that holds the replacement mappings.

toEscaper

public CharEscaper toEscaper()
Convert this builder into a char escaper which is just a decorator around the underlying array of replacement char[]s.

Returns:
an escaper that escapes based on the underlying array.