* @author David Beaumont
 * @since 15.0
 */
@GwtCompatible
@ElementTypesAreNonnullByDefault
public final class HtmlEscapers {
  /**
   * Returns an {@link Escaper} instance that escapes HTML metacharacters as specified by <a
   * href="http://www.w3.org/TR/html4/">HTML 4.01</a>. The resulting strings can be used both in
   * attribute values and in most elements' text contents, provided that the HTML

        match => match.indexOf('\\') === 0
            ? SPACE
            : EMPTY
    ],

    // replace (\ ) with ' '
    [
        /\\\s/g,
        () => SPACE
    ],

    // Escape metacharacters
    // which is written down by users but means special for regular expressions.

    // > There are 12 characters with special meanings:
    // > - the backslash \,
    // > - the caret ^,

#   set -- "${ARGS[@]}" "$@"
#
# but POSIX shell has neither arrays nor command substitution, so instead we
# post-process each arg (as a line of input to sed) to backslash-escape any
# character that might be a shell metacharacter, then use eval to reverse
# that process (while maintaining the separation between arguments), and wrap
# the whole thing up as a single "set" statement.
#