CollationDataBuilder.java

// © 2016 and later: Unicode, Inc. and others.
// License & terms of use: http://www.unicode.org/copyright.html
/*
 *******************************************************************************
 * Copyright (C) 2012-2015, International Business Machines
 * Corporation and others.  All Rights Reserved.
 *******************************************************************************
 * CollationDataBuilder.java, ported from collationdatabuilder.h/.cpp
 *
 * C++ version created on: 2012apr01
 * created by: Markus W. Scherer
 */

package com.ibm.icu.impl.coll;

import com.ibm.icu.impl.Norm2AllModes;
import com.ibm.icu.impl.Normalizer2Impl;
import com.ibm.icu.impl.Normalizer2Impl.Hangul;
import com.ibm.icu.impl.Trie2;
import com.ibm.icu.impl.Trie2Writable;
import com.ibm.icu.lang.UCharacter;
import com.ibm.icu.text.UnicodeSet;
import com.ibm.icu.text.UnicodeSetIterator;
import com.ibm.icu.util.CharsTrie;
import com.ibm.icu.util.CharsTrieBuilder;
import com.ibm.icu.util.StringTrieBuilder;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Iterator;

/**
 * Low-level CollationData builder. Takes (character, CE) pairs and builds them into runtime data
 * structures. Supports characters with context prefixes and contraction suffixes.
 */
final class CollationDataBuilder { // not final in C++
    /**
     * Collation element modifier. Interface class for a modifier that changes a tailoring builder's
     * temporary CEs to final CEs. Called for every non-special CE32 and every expansion CE.
     */
    interface CEModifier {
        /** Returns a new CE to replace the non-special input CE32, or else Collation.NO_CE. */
        long modifyCE32(int ce32);

        /** Returns a new CE to replace the input CE, or else Collation.NO_CE. */
        long modifyCE(long ce);
    }

    CollationDataBuilder() {
        nfcImpl = Norm2AllModes.getNFCInstance().impl;
        base = null;
        baseSettings = null;
        trie = null;
        ce32s = new UVector32();
        ce64s = new UVector64();
        conditionalCE32s = new ArrayList<>();
        modified = false;
        fastLatinEnabled = false;
        fastLatinBuilder = null;
        collIter = null;
        // Reserve the first CE32 for U+0000.
        ce32s.addElement(0);
    }

    void initForTailoring(CollationData b) {
        if (trie != null) {
            throw new IllegalStateException("attempt to reuse a CollationDataBuilder");
        }
        if (b == null) {
            throw new IllegalArgumentException("null CollationData");
        }
        base = b;

        // For a tailoring, the default is to fall back to the base.
        trie = new Trie2Writable(Collation.FALLBACK_CE32, Collation.FFFD_CE32);

        // Set the Latin-1 letters block so that it is allocated first in the data array,
        // to try to improve locality of reference when sorting Latin-1 text.
        // Do not use utrie2_setRange32() since that will not actually allocate blocks
        // that are filled with the default value.
        // ASCII (0..7F) is already preallocated anyway.
        for (int c = 0xc0; c <= 0xff; ++c) {
            trie.set(c, Collation.FALLBACK_CE32);
        }

        // Hangul syllables are not tailorable (except via tailoring Jamos).
        // Always set the Hangul tag to help performance.
        // Do this here, rather than in buildMappings(),
        // so that we see the HANGUL_TAG in various assertions.
        int hangulCE32 = Collation.makeCE32FromTagAndIndex(Collation.HANGUL_TAG, 0);
        trie.setRange(Hangul.HANGUL_BASE, Hangul.HANGUL_END, hangulCE32, true);

        // Copy the set contents but don't copy/clone the set as a whole because
        // that would copy the isFrozen state too.
        unsafeBackwardSet.addAll(b.unsafeBackwardSet);
    }

    boolean isCompressibleLeadByte(int b) {
        return base.isCompressibleLeadByte(b);
    }

    boolean isCompressiblePrimary(long p) {
        return isCompressibleLeadByte((int) p >>> 24);
    }

    /**
     * @return true if this builder has mappings (e.g., add() has been called)
     */
    boolean hasMappings() {
        return modified;
    }

    /**
     * @return true if c has CEs in this builder
     */
    boolean isAssigned(int c) {
        return Collation.isAssignedCE32(trie.get(c));
    }

    void add(CharSequence prefix, CharSequence s, long ces[], int cesLength) {
        int ce32 = encodeCEs(ces, cesLength);
        addCE32(prefix, s, ce32);
    }

    /**
     * Encodes the ces as either the returned ce32 by itself, or by storing an expansion, with the
     * returned ce32 referring to that.
     *
     * <p>add(p, s, ces, cesLength) = addCE32(p, s, encodeCEs(ces, cesLength))
     */
    int encodeCEs(long ces[], int cesLength) {
        if (cesLength < 0 || cesLength > Collation.MAX_EXPANSION_LENGTH) {
            throw new IllegalArgumentException("mapping to too many CEs");
        }
        if (!isMutable()) {
            throw new IllegalStateException("attempt to add mappings after build()");
        }
        if (cesLength == 0) {
            // Convenience: We cannot map to nothing, but we can map to a completely ignorable CE.
            // Do this here so that callers need not do it.
            return encodeOneCEAsCE32(0);
        } else if (cesLength == 1) {
            return encodeOneCE(ces[0]);
        } else if (cesLength == 2) {
            // Try to encode two CEs as one CE32.
            long ce0 = ces[0];
            long ce1 = ces[1];
            long p0 = ce0 >>> 32;
            if ((ce0 & 0xffffffffff00ffL) == Collation.COMMON_SECONDARY_CE
                    && (ce1 & 0xffffffff00ffffffL) == Collation.COMMON_TERTIARY_CE
                    && p0 != 0) {
                // Latin mini expansion
                return (int) p0
                        | (((int) ce0 & 0xff00) << 8)
                        | (((int) ce1 >> 16) & 0xff00)
                        | Collation.SPECIAL_CE32_LOW_BYTE
                        | Collation.LATIN_EXPANSION_TAG;
            }
        }
        // Try to encode two or more CEs as CE32s.
        int[] newCE32s = new int[Collation.MAX_EXPANSION_LENGTH]; // TODO: instance field?
        for (int i = 0; ; ++i) {
            if (i == cesLength) {
                return encodeExpansion32(newCE32s, 0, cesLength);
            }
            int ce32 = encodeOneCEAsCE32(ces[i]);
            if (ce32 == Collation.NO_CE32) {
                break;
            }
            newCE32s[i] = ce32;
        }
        return encodeExpansion(ces, 0, cesLength);
    }

    void addCE32(CharSequence prefix, CharSequence s, int ce32) {
        if (s.length() == 0) {
            throw new IllegalArgumentException("mapping from empty string");
        }
        if (!isMutable()) {
            throw new IllegalStateException("attempt to add mappings after build()");
        }
        int c = Character.codePointAt(s, 0);
        int cLength = Character.charCount(c);
        int oldCE32 = trie.get(c);
        boolean hasContext = prefix.length() != 0 || s.length() > cLength;
        if (oldCE32 == Collation.FALLBACK_CE32) {
            // First tailoring for c.
            // If c has contextual base mappings or if we add a contextual mapping,
            // then copy the base mappings.
            // Otherwise we just override the base mapping.
            int baseCE32 = base.getFinalCE32(base.getCE32(c));
            if (hasContext || Collation.ce32HasContext(baseCE32)) {
                oldCE32 = copyFromBaseCE32(c, baseCE32, true);
                trie.set(c, oldCE32);
            }
        }
        if (!hasContext) {
            // No prefix, no contraction.
            if (!isBuilderContextCE32(oldCE32)) {
                trie.set(c, ce32);
            } else {
                ConditionalCE32 cond = getConditionalCE32ForCE32(oldCE32);
                cond.builtCE32 = Collation.NO_CE32;
                cond.ce32 = ce32;
            }
        } else {
            ConditionalCE32 cond;
            if (!isBuilderContextCE32(oldCE32)) {
                // Replace the simple oldCE32 with a builder context CE32
                // pointing to a new ConditionalCE32 list head.
                int index = addConditionalCE32("\0", oldCE32);
                int contextCE32 = makeBuilderContextCE32(index);
                trie.set(c, contextCE32);
                contextChars.add(c);
                cond = getConditionalCE32(index);
            } else {
                cond = getConditionalCE32ForCE32(oldCE32);
                cond.builtCE32 = Collation.NO_CE32;
            }
            CharSequence suffix = s.subSequence(cLength, s.length());
            String context =
                    new StringBuilder()
                            .append((char) prefix.length())
                            .append(prefix)
                            .append(suffix)
                            .toString();
            unsafeBackwardSet.addAll(suffix);
            for (; ; ) {
                // invariant: context > cond.context
                int next = cond.next;
                if (next < 0) {
                    // Append a new ConditionalCE32 after cond.
                    int index = addConditionalCE32(context, ce32);
                    cond.next = index;
                    break;
                }
                ConditionalCE32 nextCond = getConditionalCE32(next);
                int cmp = context.compareTo(nextCond.context);
                if (cmp < 0) {
                    // Insert a new ConditionalCE32 between cond and nextCond.
                    int index = addConditionalCE32(context, ce32);
                    cond.next = index;
                    getConditionalCE32(index).next = next;
                    break;
                } else if (cmp == 0) {
                    // Same context as before, overwrite its ce32.
                    nextCond.ce32 = ce32;
                    break;
                }
                cond = nextCond;
            }
        }
        modified = true;
    }

    /**
     * Copies all mappings from the src builder, with modifications. This builder here must not be
     * built yet, and should be empty.
     */
    void copyFrom(CollationDataBuilder src, CEModifier modifier) {
        if (!isMutable()) {
            throw new IllegalStateException("attempt to copyFrom() after build()");
        }
        CopyHelper helper = new CopyHelper(src, this, modifier);
        Iterator<Trie2.Range> trieIterator = src.trie.iterator();
        Trie2.Range range;
        while (trieIterator.hasNext() && !(range = trieIterator.next()).leadSurrogate) {
            enumRangeForCopy(range.startCodePoint, range.endCodePoint, range.value, helper);
        }
        // Update the contextChars and the unsafeBackwardSet while copying,
        // in case a character had conditional mappings in the source builder
        // and they were removed later.
        modified |= src.modified;
    }

    void optimize(UnicodeSet set) {
        if (set.isEmpty()) {
            return;
        }
        UnicodeSetIterator iter = new UnicodeSetIterator(set);
        while (iter.next() && iter.codepoint != UnicodeSetIterator.IS_STRING) {
            int c = iter.codepoint;
            int ce32 = trie.get(c);
            if (ce32 == Collation.FALLBACK_CE32) {
                ce32 = base.getFinalCE32(base.getCE32(c));
                ce32 = copyFromBaseCE32(c, ce32, true);
                trie.set(c, ce32);
            }
        }
        modified = true;
    }

    void suppressContractions(UnicodeSet set) {
        if (set.isEmpty()) {
            return;
        }
        UnicodeSetIterator iter = new UnicodeSetIterator(set);
        while (iter.next() && iter.codepoint != UnicodeSetIterator.IS_STRING) {
            int c = iter.codepoint;
            int ce32 = trie.get(c);
            if (ce32 == Collation.FALLBACK_CE32) {
                ce32 = base.getFinalCE32(base.getCE32(c));
                if (Collation.ce32HasContext(ce32)) {
                    ce32 = copyFromBaseCE32(c, ce32, false /* without context */);
                    trie.set(c, ce32);
                }
            } else if (isBuilderContextCE32(ce32)) {
                ce32 = getConditionalCE32ForCE32(ce32).ce32;
                // Simply abandon the list of ConditionalCE32.
                // The caller will copy this builder in the end,
                // eliminating unreachable data.
                trie.set(c, ce32);
                contextChars.remove(c);
            }
        }
        modified = true;
    }

    void enableFastLatin() {
        fastLatinEnabled = true;
    }

    void build(CollationData data) {
        buildMappings(data);
        if (base != null) {
            data.numericPrimary = base.numericPrimary;
            data.compressibleBytes = base.compressibleBytes;
            data.numScripts = base.numScripts;
            data.scriptsIndex = base.scriptsIndex;
            data.scriptStarts = base.scriptStarts;
        }
        buildFastLatinTable(data);
    }

    /**
     * Looks up CEs for s and appends them to the ces array. Does not handle normalization: s should
     * be in FCD form.
     *
     * <p>Does not write completely ignorable CEs. Does not write beyond
     * Collation.MAX_EXPANSION_LENGTH.
     *
     * @return incremented cesLength
     */
    int getCEs(CharSequence s, long ces[], int cesLength) {
        return getCEs(s, 0, ces, cesLength);
    }

    int getCEs(CharSequence prefix, CharSequence s, long ces[], int cesLength) {
        int prefixLength = prefix.length();
        if (prefixLength == 0) {
            return getCEs(s, 0, ces, cesLength);
        } else {
            return getCEs(new StringBuilder(prefix).append(s), prefixLength, ces, cesLength);
        }
    }

    /**
     * Build-time context and CE32 for a code point. If a code point has contextual mappings, then
     * the default (no-context) mapping and all conditional mappings are stored in a singly-linked
     * list of ConditionalCE32, sorted by context strings.
     *
     * <p>Context strings sort by prefix length, then by prefix, then by contraction suffix. Context
     * strings must be unique and in ascending order.
     */
    private static final class ConditionalCE32 {
        ConditionalCE32(String ct, int ce) {
            context = ct;
            ce32 = ce;
            defaultCE32 = Collation.NO_CE32;
            builtCE32 = Collation.NO_CE32;
            next = -1;
        }

        boolean hasContext() {
            return context.length() > 1;
        }

        int prefixLength() {
            return context.charAt(0);
        }

        /**
         * "\0" for the first entry for any code point, with its default CE32.
         *
         * <p>Otherwise one unit with the length of the prefix string, then the prefix string, then
         * the contraction suffix.
         */
        String context;

        /**
         * CE32 for the code point and its context. Can be special (e.g., for an expansion) but not
         * contextual (prefix or contraction tag).
         */
        int ce32;

        /**
         * Default CE32 for all contexts with this same prefix. Initially NO_CE32. Set only while
         * building runtime data structures, and only on one of the nodes of a sub-list with the
         * same prefix.
         */
        int defaultCE32;

        /**
         * CE32 for the built contexts. When fetching CEs from the builder, the contexts are built
         * into their runtime form so that the normal collation implementation can process them. The
         * result is cached in the list head. It is reset when the contexts are modified. All of
         * these builtCE32 are invalidated by clearContexts(), via incrementing the contextsEra.
         */
        int builtCE32;

        /**
         * The "era" of building intermediate contexts when the above builtCE32 was set. When the
         * array of cached, temporary contexts overflows, then clearContexts() removes them all and
         * invalidates the builtCE32 that used to point to built tries.
         */
        int era = -1;

        /** Index of the next ConditionalCE32. Negative for the end of the list. */
        int next;
        // Note: We could create a separate class for all of the contextual mappings for
        // a code point, with the builtCE32, the era, and a list of the actual mappings.
        // The class that represents one mapping would then not need to
        // store those fields in each element.
    }

    protected int getCE32FromOffsetCE32(boolean fromBase, int c, int ce32) {
        int i = Collation.indexFromCE32(ce32);
        long dataCE = fromBase ? base.ces[i] : ce64s.elementAti(i);
        long p = Collation.getThreeBytePrimaryForOffsetData(c, dataCE);
        return Collation.makeLongPrimaryCE32(p);
    }

    protected int addCE(long ce) {
        int length = ce64s.size();
        for (int i = 0; i < length; ++i) {
            if (ce == ce64s.elementAti(i)) {
                return i;
            }
        }
        ce64s.addElement(ce);
        return length;
    }

    protected int addCE32(int ce32) {
        int length = ce32s.size();
        for (int i = 0; i < length; ++i) {
            if (ce32 == ce32s.elementAti(i)) {
                return i;
            }
        }
        ce32s.addElement(ce32);
        return length;
    }

    protected int addConditionalCE32(String context, int ce32) {
        assert (context.length() != 0);
        int index = conditionalCE32s.size();
        if (index > Collation.MAX_INDEX) {
            throw new IndexOutOfBoundsException("too many context-sensitive mappings");
            // BufferOverflowException is a better fit
            // but cannot be constructed with a message string.
        }
        ConditionalCE32 cond = new ConditionalCE32(context, ce32);
        conditionalCE32s.add(cond);
        return index;
    }

    protected ConditionalCE32 getConditionalCE32(int index) {
        return conditionalCE32s.get(index);
    }

    protected ConditionalCE32 getConditionalCE32ForCE32(int ce32) {
        return getConditionalCE32(Collation.indexFromCE32(ce32));
    }

    protected static int makeBuilderContextCE32(int index) {
        return Collation.makeCE32FromTagAndIndex(Collation.BUILDER_DATA_TAG, index);
    }

    protected static boolean isBuilderContextCE32(int ce32) {
        return Collation.hasCE32Tag(ce32, Collation.BUILDER_DATA_TAG);
    }

    protected static int encodeOneCEAsCE32(long ce) {
        long p = ce >>> 32;
        int lower32 = (int) ce;
        int t = lower32 & 0xffff;
        assert ((t & 0xc000) != 0xc000); // Impossible case bits 11 mark special CE32s.
        if ((ce & 0xffff00ff00ffL) == 0) {
            // normal form ppppsstt
            return (int) p | (lower32 >>> 16) | (t >> 8);
        } else if ((ce & 0xffffffffffL) == Collation.COMMON_SEC_AND_TER_CE) {
            // long-primary form ppppppC1
            return Collation.makeLongPrimaryCE32(p);
        } else if (p == 0 && (t & 0xff) == 0) {
            // long-secondary form ssssttC2
            return Collation.makeLongSecondaryCE32(lower32);
        }
        return Collation.NO_CE32;
    }

    protected int encodeOneCE(long ce) {
        // Try to encode one CE as one CE32.
        int ce32 = encodeOneCEAsCE32(ce);
        if (ce32 != Collation.NO_CE32) {
            return ce32;
        }
        int index = addCE(ce);
        if (index > Collation.MAX_INDEX) {
            throw new IndexOutOfBoundsException("too many mappings");
            // BufferOverflowException is a better fit
            // but cannot be constructed with a message string.
        }
        return Collation.makeCE32FromTagIndexAndLength(Collation.EXPANSION_TAG, index, 1);
    }

    protected int encodeExpansion(long ces[], int start, int length) {
        // See if this sequence of CEs has already been stored.
        long first = ces[start];
        int ce64sMax = ce64s.size() - length;
        for (int i = 0; i <= ce64sMax; ++i) {
            if (first == ce64s.elementAti(i)) {
                if (i > Collation.MAX_INDEX) {
                    throw new IndexOutOfBoundsException("too many mappings");
                    // BufferOverflowException is a better fit
                    // but cannot be constructed with a message string.
                }
                for (int j = 1; ; ++j) {
                    if (j == length) {
                        return Collation.makeCE32FromTagIndexAndLength(
                                Collation.EXPANSION_TAG, i, length);
                    }
                    if (ce64s.elementAti(i + j) != ces[start + j]) {
                        break;
                    }
                }
            }
        }
        // Store the new sequence.
        int i = ce64s.size();
        if (i > Collation.MAX_INDEX) {
            throw new IndexOutOfBoundsException("too many mappings");
            // BufferOverflowException is a better fit
            // but cannot be constructed with a message string.
        }
        for (int j = 0; j < length; ++j) {
            ce64s.addElement(ces[start + j]);
        }
        return Collation.makeCE32FromTagIndexAndLength(Collation.EXPANSION_TAG, i, length);
    }

    protected int encodeExpansion32(int newCE32s[], int start, int length) {
        // See if this sequence of CE32s has already been stored.
        int first = newCE32s[start];
        int ce32sMax = ce32s.size() - length;
        for (int i = 0; i <= ce32sMax; ++i) {
            if (first == ce32s.elementAti(i)) {
                if (i > Collation.MAX_INDEX) {
                    throw new IndexOutOfBoundsException("too many mappings");
                    // BufferOverflowException is a better fit
                    // but cannot be constructed with a message string.
                }
                for (int j = 1; ; ++j) {
                    if (j == length) {
                        return Collation.makeCE32FromTagIndexAndLength(
                                Collation.EXPANSION32_TAG, i, length);
                    }
                    if (ce32s.elementAti(i + j) != newCE32s[start + j]) {
                        break;
                    }
                }
            }
        }
        // Store the new sequence.
        int i = ce32s.size();
        if (i > Collation.MAX_INDEX) {
            throw new IndexOutOfBoundsException("too many mappings");
            // BufferOverflowException is a better fit
            // but cannot be constructed with a message string.
        }
        for (int j = 0; j < length; ++j) {
            ce32s.addElement(newCE32s[start + j]);
        }
        return Collation.makeCE32FromTagIndexAndLength(Collation.EXPANSION32_TAG, i, length);
    }

    protected int copyFromBaseCE32(int c, int ce32, boolean withContext) {
        if (!Collation.isSpecialCE32(ce32)) {
            return ce32;
        }
        switch (Collation.tagFromCE32(ce32)) {
            case Collation.LONG_PRIMARY_TAG:
            case Collation.LONG_SECONDARY_TAG:
            case Collation.LATIN_EXPANSION_TAG:
                // copy as is
                break;
            case Collation.EXPANSION32_TAG:
                {
                    int index = Collation.indexFromCE32(ce32);
                    int length = Collation.lengthFromCE32(ce32);
                    ce32 = encodeExpansion32(base.ce32s, index, length);
                    break;
                }
            case Collation.EXPANSION_TAG:
                {
                    int index = Collation.indexFromCE32(ce32);
                    int length = Collation.lengthFromCE32(ce32);
                    ce32 = encodeExpansion(base.ces, index, length);
                    break;
                }
            case Collation.PREFIX_TAG:
                {
                    // Flatten prefixes and nested suffixes (contractions)
                    // into a linear list of ConditionalCE32.
                    int trieIndex = Collation.indexFromCE32(ce32);
                    ce32 = base.getCE32FromContexts(trieIndex); // Default if no prefix match.
                    if (!withContext) {
                        return copyFromBaseCE32(c, ce32, false);
                    }
                    ConditionalCE32 head = new ConditionalCE32("", 0);
                    StringBuilder context = new StringBuilder("\0");
                    int index;
                    if (Collation.isContractionCE32(ce32)) {
                        index = copyContractionsFromBaseCE32(context, c, ce32, head);
                    } else {
                        ce32 = copyFromBaseCE32(c, ce32, true);
                        head.next = index = addConditionalCE32(context.toString(), ce32);
                    }
                    ConditionalCE32 cond =
                            getConditionalCE32(index); // the last ConditionalCE32 so far
                    CharsTrie.Iterator prefixes =
                            CharsTrie.iterator(base.contexts, trieIndex + 2, 0);
                    while (prefixes.hasNext()) {
                        CharsTrie.Entry entry = prefixes.next();
                        context.setLength(0);
                        context.append(entry.chars)
                                .reverse()
                                .insert(0, (char) entry.chars.length());
                        ce32 = entry.value;
                        if (Collation.isContractionCE32(ce32)) {
                            index = copyContractionsFromBaseCE32(context, c, ce32, cond);
                        } else {
                            ce32 = copyFromBaseCE32(c, ce32, true);
                            cond.next = index = addConditionalCE32(context.toString(), ce32);
                        }
                        cond = getConditionalCE32(index);
                    }
                    ce32 = makeBuilderContextCE32(head.next);
                    contextChars.add(c);
                    break;
                }
            case Collation.CONTRACTION_TAG:
                {
                    if (!withContext) {
                        int index = Collation.indexFromCE32(ce32);
                        ce32 = base.getCE32FromContexts(index); // Default if no suffix match.
                        return copyFromBaseCE32(c, ce32, false);
                    }
                    ConditionalCE32 head = new ConditionalCE32("", 0);
                    StringBuilder context = new StringBuilder("\0");
                    copyContractionsFromBaseCE32(context, c, ce32, head);
                    ce32 = makeBuilderContextCE32(head.next);
                    contextChars.add(c);
                    break;
                }
            case Collation.HANGUL_TAG:
                throw new UnsupportedOperationException("We forbid tailoring of Hangul syllables.");
            case Collation.OFFSET_TAG:
                ce32 = getCE32FromOffsetCE32(true, c, ce32);
                break;
            case Collation.IMPLICIT_TAG:
                ce32 = encodeOneCE(Collation.unassignedCEFromCodePoint(c));
                break;
            default:
                throw new AssertionError(
                        "copyFromBaseCE32(c, ce32, withContext) "
                                + "requires ce32 == base.getFinalCE32(ce32)");
        }
        return ce32;
    }

    /**
     * Copies base contractions to a list of ConditionalCE32. Sets cond.next to the index of the
     * first new item and returns the index of the last new item.
     */
    protected int copyContractionsFromBaseCE32(
            StringBuilder context, int c, int ce32, ConditionalCE32 cond) {
        int trieIndex = Collation.indexFromCE32(ce32);
        int index;
        if ((ce32 & Collation.CONTRACT_SINGLE_CP_NO_MATCH) != 0) {
            // No match on the single code point.
            // We are underneath a prefix, and the default mapping is just
            // a fallback to the mappings for a shorter prefix.
            assert (context.length() > 1);
            index = -1;
        } else {
            ce32 = base.getCE32FromContexts(trieIndex); // Default if no suffix match.
            assert (!Collation.isContractionCE32(ce32));
            ce32 = copyFromBaseCE32(c, ce32, true);
            cond.next = index = addConditionalCE32(context.toString(), ce32);
            cond = getConditionalCE32(index);
        }

        int suffixStart = context.length();
        CharsTrie.Iterator suffixes = CharsTrie.iterator(base.contexts, trieIndex + 2, 0);
        while (suffixes.hasNext()) {
            CharsTrie.Entry entry = suffixes.next();
            context.append(entry.chars);
            ce32 = copyFromBaseCE32(c, entry.value, true);
            cond.next = index = addConditionalCE32(context.toString(), ce32);
            // No need to update the unsafeBackwardSet because the tailoring set
            // is already a copy of the base set.
            cond = getConditionalCE32(index);
            context.setLength(suffixStart);
        }
        assert (index >= 0);
        return index;
    }

    private static final class CopyHelper {
        CopyHelper(
                CollationDataBuilder s, CollationDataBuilder d, CollationDataBuilder.CEModifier m) {
            src = s;
            dest = d;
            modifier = m;
        }

        void copyRangeCE32(int start, int end, int ce32) {
            ce32 = copyCE32(ce32);
            dest.trie.setRange(start, end, ce32, true);
            if (CollationDataBuilder.isBuilderContextCE32(ce32)) {
                dest.contextChars.add(start, end);
            }
        }

        int copyCE32(int ce32) {
            if (!Collation.isSpecialCE32(ce32)) {
                long ce = modifier.modifyCE32(ce32);
                if (ce != Collation.NO_CE) {
                    ce32 = dest.encodeOneCE(ce);
                }
            } else {
                int tag = Collation.tagFromCE32(ce32);
                if (tag == Collation.EXPANSION32_TAG) {
                    int[] srcCE32s = src.ce32s.getBuffer();
                    int srcIndex = Collation.indexFromCE32(ce32);
                    int length = Collation.lengthFromCE32(ce32);
                    // Inspect the source CE32s. Just copy them if none are modified.
                    // Otherwise copy to modifiedCEs, with modifications.
                    boolean isModified = false;
                    for (int i = 0; i < length; ++i) {
                        ce32 = srcCE32s[srcIndex + i];
                        long ce;
                        if (Collation.isSpecialCE32(ce32)
                                || (ce = modifier.modifyCE32(ce32)) == Collation.NO_CE) {
                            if (isModified) {
                                modifiedCEs[i] = Collation.ceFromCE32(ce32);
                            }
                        } else {
                            if (!isModified) {
                                for (int j = 0; j < i; ++j) {
                                    modifiedCEs[j] = Collation.ceFromCE32(srcCE32s[srcIndex + j]);
                                }
                                isModified = true;
                            }
                            modifiedCEs[i] = ce;
                        }
                    }
                    if (isModified) {
                        ce32 = dest.encodeCEs(modifiedCEs, length);
                    } else {
                        ce32 = dest.encodeExpansion32(srcCE32s, srcIndex, length);
                    }
                } else if (tag == Collation.EXPANSION_TAG) {
                    long[] srcCEs = src.ce64s.getBuffer();
                    int srcIndex = Collation.indexFromCE32(ce32);
                    int length = Collation.lengthFromCE32(ce32);
                    // Inspect the source CEs. Just copy them if none are modified.
                    // Otherwise copy to modifiedCEs, with modifications.
                    boolean isModified = false;
                    for (int i = 0; i < length; ++i) {
                        long srcCE = srcCEs[srcIndex + i];
                        long ce = modifier.modifyCE(srcCE);
                        if (ce == Collation.NO_CE) {
                            if (isModified) {
                                modifiedCEs[i] = srcCE;
                            }
                        } else {
                            if (!isModified) {
                                for (int j = 0; j < i; ++j) {
                                    modifiedCEs[j] = srcCEs[srcIndex + j];
                                }
                                isModified = true;
                            }
                            modifiedCEs[i] = ce;
                        }
                    }
                    if (isModified) {
                        ce32 = dest.encodeCEs(modifiedCEs, length);
                    } else {
                        ce32 = dest.encodeExpansion(srcCEs, srcIndex, length);
                    }
                } else if (tag == Collation.BUILDER_DATA_TAG) {
                    // Copy the list of ConditionalCE32.
                    ConditionalCE32 cond = src.getConditionalCE32ForCE32(ce32);
                    assert (!cond.hasContext());
                    int destIndex = dest.addConditionalCE32(cond.context, copyCE32(cond.ce32));
                    ce32 = CollationDataBuilder.makeBuilderContextCE32(destIndex);
                    while (cond.next >= 0) {
                        cond = src.getConditionalCE32(cond.next);
                        ConditionalCE32 prevDestCond = dest.getConditionalCE32(destIndex);
                        destIndex = dest.addConditionalCE32(cond.context, copyCE32(cond.ce32));
                        int suffixStart = cond.prefixLength() + 1;
                        dest.unsafeBackwardSet.addAll(cond.context.substring(suffixStart));
                        prevDestCond.next = destIndex;
                    }
                } else {
                    // Just copy long CEs and Latin mini expansions (and other expected values) as
                    // is,
                    // assuming that the modifier would not modify them.
                    assert (tag == Collation.LONG_PRIMARY_TAG
                            || tag == Collation.LONG_SECONDARY_TAG
                            || tag == Collation.LATIN_EXPANSION_TAG
                            || tag == Collation.HANGUL_TAG);
                }
            }
            return ce32;
        }

        CollationDataBuilder src;
        CollationDataBuilder dest;
        CollationDataBuilder.CEModifier modifier;
        long[] modifiedCEs = new long[Collation.MAX_EXPANSION_LENGTH];
    }

    private static void enumRangeForCopy(int start, int end, int value, CopyHelper helper) {
        if (value != Collation.UNASSIGNED_CE32 && value != Collation.FALLBACK_CE32) {
            helper.copyRangeCE32(start, end, value);
        }
    }

    protected boolean getJamoCE32s(int jamoCE32s[]) {
        boolean anyJamoAssigned = base == null; // always set jamoCE32s in the base data
        boolean needToCopyFromBase = false;
        for (int j = 0; j < CollationData.JAMO_CE32S_LENGTH; ++j) { // Count across Jamo types.
            int jamo = jamoCpFromIndex(j);
            boolean fromBase = false;
            int ce32 = trie.get(jamo);
            anyJamoAssigned |= Collation.isAssignedCE32(ce32);
            // TODO: Try to prevent [optimize [Jamo]] from counting as anyJamoAssigned.
            // (As of CLDR 24 [2013] the Korean tailoring does not optimize conjoining Jamo.)
            if (ce32 == Collation.FALLBACK_CE32) {
                fromBase = true;
                ce32 = base.getCE32(jamo);
            }
            if (Collation.isSpecialCE32(ce32)) {
                switch (Collation.tagFromCE32(ce32)) {
                    case Collation.LONG_PRIMARY_TAG:
                    case Collation.LONG_SECONDARY_TAG:
                    case Collation.LATIN_EXPANSION_TAG:
                        // Copy the ce32 as-is.
                        break;
                    case Collation.EXPANSION32_TAG:
                    case Collation.EXPANSION_TAG:
                    case Collation.PREFIX_TAG:
                    case Collation.CONTRACTION_TAG:
                        if (fromBase) {
                            // Defer copying until we know if anyJamoAssigned.
                            ce32 = Collation.FALLBACK_CE32;
                            needToCopyFromBase = true;
                        }
                        break;
                    case Collation.IMPLICIT_TAG:
                        // An unassigned Jamo should only occur in tests with incomplete bases.
                        assert (fromBase);
                        ce32 = Collation.FALLBACK_CE32;
                        needToCopyFromBase = true;
                        break;
                    case Collation.OFFSET_TAG:
                        ce32 = getCE32FromOffsetCE32(fromBase, jamo, ce32);
                        break;
                    case Collation.FALLBACK_TAG:
                    case Collation.RESERVED_TAG_3:
                    case Collation.BUILDER_DATA_TAG:
                    case Collation.DIGIT_TAG:
                    case Collation.U0000_TAG:
                    case Collation.HANGUL_TAG:
                    case Collation.LEAD_SURROGATE_TAG:
                        throw new AssertionError(
                                String.format("unexpected special tag in ce32=0x%08x", ce32));
                }
            }
            jamoCE32s[j] = ce32;
        }
        if (anyJamoAssigned && needToCopyFromBase) {
            for (int j = 0; j < CollationData.JAMO_CE32S_LENGTH; ++j) {
                if (jamoCE32s[j] == Collation.FALLBACK_CE32) {
                    int jamo = jamoCpFromIndex(j);
                    jamoCE32s[j] =
                            copyFromBaseCE32(jamo, base.getCE32(jamo), /* withContext= */ true);
                }
            }
        }
        return anyJamoAssigned;
    }

    protected void setDigitTags() {
        UnicodeSet digits = new UnicodeSet("[:Nd:]");
        UnicodeSetIterator iter = new UnicodeSetIterator(digits);
        while (iter.next()) {
            assert (iter.codepoint != UnicodeSetIterator.IS_STRING);
            int c = iter.codepoint;
            int ce32 = trie.get(c);
            if (ce32 != Collation.FALLBACK_CE32 && ce32 != Collation.UNASSIGNED_CE32) {
                int index = addCE32(ce32);
                if (index > Collation.MAX_INDEX) {
                    throw new IndexOutOfBoundsException("too many mappings");
                    // BufferOverflowException is a better fit
                    // but cannot be constructed with a message string.
                }
                ce32 =
                        Collation.makeCE32FromTagIndexAndLength(
                                Collation.DIGIT_TAG,
                                index,
                                UCharacter.digit(c)); // u_charDigitValue(c)
                trie.set(c, ce32);
            }
        }
    }

    protected void setLeadSurrogates() {
        for (char lead = 0xd800; lead < 0xdc00; ++lead) {
            int leadValue = -1;
            // utrie2_enumForLeadSurrogate(trie, lead, null, , &value);
            Iterator<Trie2.Range> trieIterator = trie.iteratorForLeadSurrogate(lead);
            while (trieIterator.hasNext()) {
                Trie2.Range range = trieIterator.next();
                // The rest of this loop is equivalent to C++ enumRangeLeadValue().
                int value = range.value;
                if (value == Collation.UNASSIGNED_CE32) {
                    value = Collation.LEAD_ALL_UNASSIGNED;
                } else if (value == Collation.FALLBACK_CE32) {
                    value = Collation.LEAD_ALL_FALLBACK;
                } else {
                    leadValue = Collation.LEAD_MIXED;
                    break;
                }
                if (leadValue < 0) {
                    leadValue = value;
                } else if (leadValue != value) {
                    leadValue = Collation.LEAD_MIXED;
                    break;
                }
            }
            trie.setForLeadSurrogateCodeUnit(
                    lead,
                    Collation.makeCE32FromTagAndIndex(Collation.LEAD_SURROGATE_TAG, 0) | leadValue);
        }
    }

    protected void buildMappings(CollationData data) {
        if (!isMutable()) {
            throw new IllegalStateException("attempt to build() after build()");
        }

        buildContexts();

        int[] jamoCE32s = new int[CollationData.JAMO_CE32S_LENGTH];
        int jamoIndex = -1;
        if (getJamoCE32s(jamoCE32s)) {
            jamoIndex = ce32s.size();
            for (int i = 0; i < CollationData.JAMO_CE32S_LENGTH; ++i) {
                ce32s.addElement(jamoCE32s[i]);
            }
            // Small optimization: Use a bit in the Hangul ce32
            // to indicate that none of the Jamo CE32s are isSpecialCE32()
            // (as it should be in the root collator).
            // It allows CollationIterator to avoid recursive function calls and per-Jamo tests.
            // In order to still have good trie compression and keep this code simple,
            // we only set this flag if a whole block of 588 Hangul syllables starting with
            // a common leading consonant (Jamo L) has this property.
            boolean isAnyJamoVTSpecial = false;
            for (int i = Hangul.JAMO_L_COUNT; i < CollationData.JAMO_CE32S_LENGTH; ++i) {
                if (Collation.isSpecialCE32(jamoCE32s[i])) {
                    isAnyJamoVTSpecial = true;
                    break;
                }
            }
            int hangulCE32 = Collation.makeCE32FromTagAndIndex(Collation.HANGUL_TAG, 0);
            int c = Hangul.HANGUL_BASE;
            for (int i = 0; i < Hangul.JAMO_L_COUNT; ++i) { // iterate over the Jamo L
                int ce32 = hangulCE32;
                if (!isAnyJamoVTSpecial && !Collation.isSpecialCE32(jamoCE32s[i])) {
                    ce32 |= Collation.HANGUL_NO_SPECIAL_JAMO;
                }
                int limit = c + Hangul.JAMO_VT_COUNT;
                trie.setRange(c, limit - 1, ce32, true);
                c = limit;
            }
        } else {
            // Copy the Hangul CE32s from the base in blocks per Jamo L,
            // assuming that HANGUL_NO_SPECIAL_JAMO is set or not set for whole blocks.
            for (int c = Hangul.HANGUL_BASE; c < Hangul.HANGUL_LIMIT; ) {
                int ce32 = base.getCE32(c);
                assert (Collation.hasCE32Tag(ce32, Collation.HANGUL_TAG));
                int limit = c + Hangul.JAMO_VT_COUNT;
                trie.setRange(c, limit - 1, ce32, true);
                c = limit;
            }
        }

        setDigitTags();
        setLeadSurrogates();

        // For U+0000, move its normal ce32 into CE32s[0] and set U0000_TAG.
        ce32s.setElementAt(trie.get(0), 0);
        trie.set(0, Collation.makeCE32FromTagAndIndex(Collation.U0000_TAG, 0));

        data.trie = trie.toTrie2_32();

        // Mark each lead surrogate as "unsafe"
        // if any of its 1024 associated supplementary code points is "unsafe".
        int c = 0x10000;
        for (char lead = 0xd800; lead < 0xdc00; ++lead, c += 0x400) {
            if (unsafeBackwardSet.containsSome(c, c + 0x3ff)) {
                unsafeBackwardSet.add(lead);
            }
        }
        unsafeBackwardSet.freeze();

        data.ce32s = ce32s.getBuffer();
        data.ces = ce64s.getBuffer();
        data.contexts = contexts.toString();

        data.base = base;
        if (jamoIndex >= 0) {
            data.jamoCE32s = jamoCE32s; // C++: data.ce32s + jamoIndex
        } else {
            data.jamoCE32s = base.jamoCE32s;
        }
        data.unsafeBackwardSet = unsafeBackwardSet;
    }

    protected void clearContexts() {
        contexts.setLength(0);
        // Incrementing the contexts build "era" invalidates all of the builtCE32
        // from before this clearContexts() call.
        // Simpler than finding and resetting all of those fields.
        ++contextsEra;
    }

    protected void buildContexts() {
        // Ignore abandoned lists and the cached builtCE32,
        // and build all contexts from scratch.
        clearContexts();
        UnicodeSetIterator iter = new UnicodeSetIterator(contextChars);
        while (iter.next()) {
            assert (iter.codepoint != UnicodeSetIterator.IS_STRING);
            int c = iter.codepoint;
            int ce32 = trie.get(c);
            if (!isBuilderContextCE32(ce32)) {
                throw new AssertionError("Impossible: No context data for c in contextChars.");
            }
            ConditionalCE32 cond = getConditionalCE32ForCE32(ce32);
            ce32 = buildContext(cond);
            trie.set(c, ce32);
        }
    }

    protected int buildContext(ConditionalCE32 head) {
        // The list head must have no context.
        assert (!head.hasContext());
        // The list head must be followed by one or more nodes that all do have context.
        assert (head.next >= 0);
        CharsTrieBuilder prefixBuilder = null;
        CharsTrieBuilder contractionBuilder = null;
        // This outer loop goes from each prefix to the next.
        // For each prefix it finds the one or more same-prefix entries (firstCond..lastCond).
        // If there are multiple suffixes for the same prefix,
        // then an inner loop builds a contraction trie for them.
        for (ConditionalCE32 cond = head; ; cond = getConditionalCE32(cond.next)) {
            // After the list head, the prefix or suffix can be empty, but not both.
            assert (cond == head || cond.hasContext());
            int prefixLength = cond.prefixLength();
            StringBuilder prefix = new StringBuilder().append(cond.context, 0, prefixLength + 1);
            String prefixString = prefix.toString();
            // Collect all contraction suffixes for one prefix.
            ConditionalCE32 firstCond = cond;
            ConditionalCE32 lastCond;
            do {
                lastCond = cond;
                // Clear the defaultCE32 fields as we go.
                // They are left over from building a previous version of this list of contexts.
                //
                // One of the code paths below may copy a preceding defaultCE32
                // into its emptySuffixCE32.
                // If a new suffix has been inserted before what used to be
                // the firstCond for its prefix, then that previous firstCond could still
                // contain an outdated defaultCE32 from an earlier buildContext() and
                // result in an incorrect emptySuffixCE32.
                // So we reset all defaultCE32 before reading and setting new values.
                cond.defaultCE32 = Collation.NO_CE32;
            } while (cond.next >= 0
                    && (cond = getConditionalCE32(cond.next)).context.startsWith(prefixString));
            int ce32;
            int suffixStart = prefixLength + 1; // == prefix.length()
            if (lastCond.context.length() == suffixStart) {
                // One prefix without contraction suffix.
                assert (firstCond == lastCond);
                ce32 = lastCond.ce32;
                cond = lastCond;
            } else {
                // Build the contractions trie.
                if (contractionBuilder == null) {
                    contractionBuilder = new CharsTrieBuilder();
                } else {
                    contractionBuilder.clear();
                }
                // Entry for an empty suffix, to be stored before the trie.
                int emptySuffixCE32 = Collation.NO_CE32; // Will always be set to a real value.
                int flags = 0;
                if (firstCond.context.length() == suffixStart) {
                    // There is a mapping for the prefix and the single character c. (p|c)
                    // If no other suffix matches, then we return this value.
                    emptySuffixCE32 = firstCond.ce32;
                    cond = getConditionalCE32(firstCond.next);
                } else {
                    // There is no mapping for the prefix and just the single character.
                    // (There is no p|c, only p|cd, p|ce etc.)
                    flags |= Collation.CONTRACT_SINGLE_CP_NO_MATCH;
                    // When the prefix matches but none of the prefix-specific suffixes,
                    // then we fall back to the mappings with the next-longest prefix,
                    // and ultimately to mappings with no prefix.
                    // Each fallback might be another set of contractions.
                    // For example, if there are mappings for ch, p|cd, p|ce, but not for p|c,
                    // then in text "pch" we find the ch contraction.
                    for (cond = head; ; cond = getConditionalCE32(cond.next)) {
                        int length = cond.prefixLength();
                        if (length == prefixLength) {
                            break;
                        }
                        if (cond.defaultCE32 != Collation.NO_CE32
                                && (length == 0
                                        || prefixString.regionMatches(
                                                prefix.length() - length, cond.context, 1, length)
                                /* C++: prefix.endsWith(cond.context, 1, length) */ )) {
                            emptySuffixCE32 = cond.defaultCE32;
                        }
                    }
                    cond = firstCond;
                }
                // Optimization: Set a flag when
                // the first character of every contraction suffix has lccc!=0.
                // Short-circuits contraction matching when a normal letter follows.
                flags |= Collation.CONTRACT_NEXT_CCC;
                // Add all of the non-empty suffixes into the contraction trie.
                for (; ; ) {
                    String suffix = cond.context.substring(suffixStart);
                    int fcd16 = nfcImpl.getFCD16(suffix.codePointAt(0));
                    if (fcd16 <= 0xff) {
                        flags &= ~Collation.CONTRACT_NEXT_CCC;
                    }
                    fcd16 = nfcImpl.getFCD16(suffix.codePointBefore(suffix.length()));
                    if (fcd16 > 0xff) {
                        // The last suffix character has lccc!=0, allowing for discontiguous
                        // contractions.
                        flags |= Collation.CONTRACT_TRAILING_CCC;
                    }
                    contractionBuilder.add(suffix, cond.ce32);
                    if (cond == lastCond) {
                        break;
                    }
                    cond = getConditionalCE32(cond.next);
                }
                int index = addContextTrie(emptySuffixCE32, contractionBuilder);
                if (index > Collation.MAX_INDEX) {
                    throw new IndexOutOfBoundsException("too many context-sensitive mappings");
                    // BufferOverflowException is a better fit
                    // but cannot be constructed with a message string.
                }
                ce32 = Collation.makeCE32FromTagAndIndex(Collation.CONTRACTION_TAG, index) | flags;
            }
            assert (cond == lastCond);
            firstCond.defaultCE32 = ce32;
            if (prefixLength == 0) {
                if (cond.next < 0) {
                    // No non-empty prefixes, only contractions.
                    return ce32;
                }
            } else {
                prefix.delete(0, 1); // Remove the length unit.
                prefix.reverse();
                if (prefixBuilder == null) {
                    prefixBuilder = new CharsTrieBuilder();
                }
                prefixBuilder.add(prefix, ce32);
                if (cond.next < 0) {
                    break;
                }
            }
        }
        assert (head.defaultCE32 != Collation.NO_CE32);
        int index = addContextTrie(head.defaultCE32, prefixBuilder);
        if (index > Collation.MAX_INDEX) {
            throw new IndexOutOfBoundsException("too many context-sensitive mappings");
            // BufferOverflowException is a better fit
            // but cannot be constructed with a message string.
        }
        return Collation.makeCE32FromTagAndIndex(Collation.PREFIX_TAG, index);
    }

    protected int addContextTrie(int defaultCE32, CharsTrieBuilder trieBuilder) {
        StringBuilder context = new StringBuilder();
        context.append((char) (defaultCE32 >> 16)).append((char) defaultCE32);
        context.append(trieBuilder.buildCharSequence(StringTrieBuilder.Option.SMALL));
        int index = contexts.indexOf(context.toString());
        if (index < 0) {
            index = contexts.length();
            contexts.append(context);
        }
        return index;
    }

    protected void buildFastLatinTable(CollationData data) {
        if (!fastLatinEnabled) {
            return;
        }

        fastLatinBuilder = new CollationFastLatinBuilder();
        if (fastLatinBuilder.forData(data)) {
            char[] header = fastLatinBuilder.getHeader();
            char[] table = fastLatinBuilder.getTable();
            if (base != null
                    && Arrays.equals(header, base.fastLatinTableHeader)
                    && Arrays.equals(table, base.fastLatinTable)) {
                // Same fast Latin table as in the base, use that one instead.
                fastLatinBuilder = null;
                header = base.fastLatinTableHeader;
                table = base.fastLatinTable;
            }
            data.fastLatinTableHeader = header;
            data.fastLatinTable = table;
        } else {
            fastLatinBuilder = null;
        }
    }

    protected int getCEs(CharSequence s, int start, long ces[], int cesLength) {
        if (collIter == null) {
            collIter = new DataBuilderCollationIterator(this, new CollationData(nfcImpl));
            if (collIter == null) {
                return 0;
            }
        }
        return collIter.fetchCEs(s, start, ces, cesLength);
    }

    protected static int jamoCpFromIndex(int i) {
        // 0 <= i < CollationData.JAMO_CE32S_LENGTH = 19 + 21 + 27
        if (i < Hangul.JAMO_L_COUNT) {
            return Hangul.JAMO_L_BASE + i;
        }
        i -= Hangul.JAMO_L_COUNT;
        if (i < Hangul.JAMO_V_COUNT) {
            return Hangul.JAMO_V_BASE + i;
        }
        i -= Hangul.JAMO_V_COUNT;
        // i < 27
        return Hangul.JAMO_T_BASE + 1 + i;
    }

    /**
     * Build-time collation element and character iterator. Uses the runtime CollationIterator for
     * fetching CEs for a string but reads from the builder's unfinished data structures. In
     * particular, this class reads from the unfinished trie and has to avoid
     * CollationIterator.nextCE() and redirect other calls to data.getCE32() and
     * data.getCE32FromSupplementary().
     *
     * <p>We do this so that we need not implement the collation algorithm again for the builder and
     * make it behave exactly like the runtime code. That would be more difficult to test and
     * maintain than this indirection.
     *
     * <p>Some CE32 tags (for example, the DIGIT_TAG) do not occur in the builder data, so the data
     * accesses from those code paths need not be modified.
     *
     * <p>This class iterates directly over whole code points so that the CollationIterator does not
     * need the finished trie for handling the LEAD_SURROGATE_TAG.
     */
    private static final class DataBuilderCollationIterator extends CollationIterator {
        DataBuilderCollationIterator(CollationDataBuilder b, CollationData newData) {
            super(newData, /* numeric= */ false);
            builder = b;
            builderData = newData;
            builderData.base = builder.base;
            // Set all of the jamoCE32s[] to indirection CE32s.
            for (int j = 0; j < CollationData.JAMO_CE32S_LENGTH; ++j) { // Count across Jamo types.
                int jamo = CollationDataBuilder.jamoCpFromIndex(j);
                jamoCE32s[j] =
                        Collation.makeCE32FromTagAndIndex(Collation.BUILDER_DATA_TAG, jamo)
                                | CollationDataBuilder.IS_BUILDER_JAMO_CE32;
            }
            builderData.jamoCE32s = jamoCE32s;
        }

        int fetchCEs(CharSequence str, int start, long ces[], int cesLength) {
            // Set the pointers each time, in case they changed due to reallocation.
            builderData.ce32s = builder.ce32s.getBuffer();
            builderData.ces = builder.ce64s.getBuffer();
            builderData.contexts = builder.contexts.toString();
            // Modified copy of CollationIterator.nextCE() and CollationIterator.nextCEFromCE32().
            reset();
            s = str;
            pos = start;
            while (pos < s.length()) {
                // No need to keep all CEs in the iterator buffer.
                clearCEs();
                int c = Character.codePointAt(s, pos);
                pos += Character.charCount(c);
                int ce32 = builder.trie.get(c);
                CollationData d;
                if (ce32 == Collation.FALLBACK_CE32) {
                    d = builder.base;
                    ce32 = builder.base.getCE32(c);
                } else {
                    d = builderData;
                }
                appendCEsFromCE32(d, c, ce32, /* forward= */ true);
                for (int i = 0; i < getCEsLength(); ++i) {
                    long ce = getCE(i);
                    if (ce != 0) {
                        if (cesLength < Collation.MAX_EXPANSION_LENGTH) {
                            ces[cesLength] = ce;
                        }
                        ++cesLength;
                    }
                }
            }
            return cesLength;
        }

        @Override
        public void resetToOffset(int newOffset) {
            reset();
            pos = newOffset;
        }

        @Override
        public int getOffset() {
            return pos;
        }

        @Override
        public int nextCodePoint() {
            if (pos == s.length()) {
                return Collation.SENTINEL_CP;
            }
            int c = Character.codePointAt(s, pos);
            pos += Character.charCount(c);
            return c;
        }

        @Override
        public int previousCodePoint() {
            if (pos == 0) {
                return Collation.SENTINEL_CP;
            }
            int c = Character.codePointBefore(s, pos);
            pos -= Character.charCount(c);
            return c;
        }

        @Override
        protected void forwardNumCodePoints(int num) {
            pos = Character.offsetByCodePoints(s, pos, num);
        }

        @Override
        protected void backwardNumCodePoints(int num) {
            pos = Character.offsetByCodePoints(s, pos, -num);
        }

        @Override
        protected int getDataCE32(int c) {
            return builder.trie.get(c);
        }

        @Override
        protected int getCE32FromBuilderData(int ce32) {
            assert (Collation.hasCE32Tag(ce32, Collation.BUILDER_DATA_TAG));
            if ((ce32 & CollationDataBuilder.IS_BUILDER_JAMO_CE32) != 0) {
                int jamo = Collation.indexFromCE32(ce32);
                return builder.trie.get(jamo);
            } else {
                ConditionalCE32 cond = builder.getConditionalCE32ForCE32(ce32);
                if (cond.builtCE32 == Collation.NO_CE32 || cond.era != builder.contextsEra) {
                    // Build the context-sensitive mappings into their runtime form and cache the
                    // result.
                    try {
                        cond.builtCE32 = builder.buildContext(cond);
                    } catch (IndexOutOfBoundsException e) {
                        builder.clearContexts();
                        cond.builtCE32 = builder.buildContext(cond);
                    }
                    cond.era = builder.contextsEra;
                    builderData.contexts = builder.contexts.toString();
                }
                return cond.builtCE32;
            }
        }

        protected final CollationDataBuilder builder;
        protected final CollationData builderData;
        protected final int[] jamoCE32s = new int[CollationData.JAMO_CE32S_LENGTH];
        protected CharSequence s;
        protected int pos;
    }

    protected final boolean isMutable() {
        // C++ tests !(trie == NULL || utrie2_isFrozen(trie))
        // but Java Trie2Writable does not have an observable isFrozen() state.
        return trie != null && unsafeBackwardSet != null && !unsafeBackwardSet.isFrozen();
    }

    /**
     * @see Collation.BUILDER_DATA_TAG
     */
    private static final int IS_BUILDER_JAMO_CE32 = 0x100;

    protected Normalizer2Impl nfcImpl;
    protected CollationData base;
    protected CollationSettings baseSettings;
    protected Trie2Writable trie;
    protected UVector32 ce32s;
    protected UVector64 ce64s;
    protected ArrayList<ConditionalCE32> conditionalCE32s; // vector of ConditionalCE32
    // Characters that have context (prefixes or contraction suffixes).
    protected UnicodeSet contextChars = new UnicodeSet();
    // Serialized UCharsTrie structures for finalized contexts.
    protected StringBuilder contexts = new StringBuilder();

    /**
     * The "era" of building intermediate contexts. When the array of cached, temporary contexts
     * overflows, then clearContexts() removes them all and invalidates the builtCE32 that used to
     * point to built tries. See {@link ConditionalCE32#era}.
     */
    private int contextsEra = 0;

    protected UnicodeSet unsafeBackwardSet = new UnicodeSet();
    protected boolean modified;

    protected boolean fastLatinEnabled;
    protected CollationFastLatinBuilder fastLatinBuilder;

    protected DataBuilderCollationIterator collIter;
}