CharEscaperBuilder (Guava: Google Core Libraries for Java 30.0-jre API)

java.lang.Object
- com.google.common.escape.CharEscaperBuilder

```
@Beta
@GwtCompatible
public final class CharEscaperBuilder
extends 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.

Since:

15.0

Author:

Sven Mawson

Constructor Summary

Constructors
Constructor Description

CharEscaperBuilder()
Construct a new sparse array builder.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`CharEscaperBuilder`	`addEscape(char c, String r)`	Add a new mapping from an index to an object to the escaping.
`CharEscaperBuilder`	`addEscapes(char[] cs, 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.
`Escaper`	`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
```
@CanIgnoreReturnValue
public CharEscaperBuilder addEscape(char c,
                                    String r)
```
    Add a new mapping from an index to an object to the escaping.
  - addEscapes
```
@CanIgnoreReturnValue
public CharEscaperBuilder addEscapes(char[] cs,
                                     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 Escaper 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.