Package com.ibm.icu.util

Class CharsTrieBuilder

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

    This class is not intended for public subclassing.

    Author:
    Markus W. Scherer
    Status:
    Stable ICU 4.8.

    • Constructor Detail

      • CharsTrieBuilder

        public CharsTrieBuilder()
        Constructs an empty builder.
        Status:
        Stable ICU 4.8.

    • 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
        Status:
        Stable ICU 4.8.

      • 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.
        Status:
        Stable ICU 4.8.

      • 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.
        Status:
        Stable ICU 4.8.

      • 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
        Status:
        Stable ICU 4.8.

      • write

        @Deprecated
protected int write​(int unit)
        Deprecated.
        This API is ICU internal only.
        Specified by:
        write in class StringTrieBuilder
        Status:
        Internal. This API is ICU internal only.

      • write

        @Deprecated
protected int write​(int offset,
                    int length)
        Deprecated.
        This API is ICU internal only.
        Specified by:
        write in class StringTrieBuilder
        Status:
        Internal. This API is ICU internal only.

      • writeValueAndFinal

        @Deprecated
protected int writeValueAndFinal​(int i,
                                 boolean isFinal)
        Deprecated.
        This API is ICU internal only.
        Specified by:
        writeValueAndFinal in class StringTrieBuilder
        Status:
        Internal. This API is ICU internal only.

      • writeValueAndType

        @Deprecated
protected int writeValueAndType​(boolean hasValue,
                                int value,
                                int node)
        Deprecated.
        This API is ICU internal only.
        Specified by:
        writeValueAndType in class StringTrieBuilder
        Status:
        Internal. This API is ICU internal only.

      • writeDeltaTo

        @Deprecated
protected int writeDeltaTo​(int jumpTarget)
        Deprecated.
        This API is ICU internal only.
        Specified by:
        writeDeltaTo in class StringTrieBuilder
        Status:
        Internal. This API is ICU internal only.