Class CharsTrieBuilder


  • public final class CharsTrieBuilder
    extends StringTrieBuilder
    Builder class for CharsTrie.

    This class is not intended for public subclassing.

    Author:
    Markus W. Scherer
    • Constructor Detail

      • CharsTrieBuilder

        public CharsTrieBuilder()
        Constructs an empty builder.
    • Method Detail

      • add

        public CharsTrieBuilder add​(CharSequence s,
                                    int value)
        Adds a (string, value) pair. The string must be unique. The string contents will be copied; the builder does not keep a reference to the input CharSequence.
        Parameters:
        s - The input string.
        value - The value associated with this char sequence.
        Returns:
        this
      • build

        public CharsTrie build​(StringTrieBuilder.Option buildOption)
        Builds a CharsTrie for the add()ed data. Once built, no further data can be add()ed until clear() is called.

        A CharsTrie cannot be empty. At least one (string, value) pair must have been add()ed.

        Multiple calls to build() or buildCharSequence() return tries or sequences which share the builder's char array, without rebuilding. After clear() has been called, a new array will be used.

        Parameters:
        buildOption - Build option, see StringTrieBuilder.Option.
        Returns:
        A new CharsTrie for the add()ed data.
      • buildCharSequence

        public CharSequence buildCharSequence​(StringTrieBuilder.Option buildOption)
        Builds a CharsTrie for the add()ed data and char-serializes it. Once built, no further data can be add()ed until clear() is called.

        A CharsTrie cannot be empty. At least one (string, value) pair must have been add()ed.

        Multiple calls to build() or buildCharSequence() return tries or sequences which share the builder's char array, without rebuilding. After clear() has been called, a new array will be used.

        Parameters:
        buildOption - Build option, see StringTrieBuilder.Option.
        Returns:
        A CharSequence with the char-serialized CharsTrie for the add()ed data.
      • clear

        public CharsTrieBuilder clear()
        Removes all (string, value) pairs. New data can then be add()ed and a new trie can be built.
        Returns:
        this