Method values

data_structures/unstable_multimap.ts:588–616

* Returns an iterator of all individual values across all keys, in insertion * order. * * Mutating the map during iteration is not supported and may skip or repeat * values. * * @experimental **UNSTABLE**: New API, yet to be vetted. * * @returns An iterator of values. *

()

   * ```
   */
  values(): IterableIterator<V> {
    // Hand-rolled for consistency with `entries()` / `groups()`. See
    // `entries()` for the rationale. The bucket is snapshotted on first
    // entry so mutations to the current bucket during iteration do not
    // extend, truncate, or shift the visit.
    const outer = this.#map.values();
    let currentList: V[] | null = null;
    let innerIndex = 0;
    const iter: IterableIterator<V> = {
      next(): IteratorResult<V> {
        while (true) {
          if (currentList !== null && innerIndex < currentList.length) {
            return { value: currentList[innerIndex++]!, done: false };
          }
          const outerResult = outer.next();
          if (outerResult.done) {
            currentList = null;
            return { value: undefined, done: true };
          }
          currentList = outerResult.value.slice();
          innerIndex = 0;
        }
      },
      [Symbol.iterator]() {
        return this;
      },
    };
    return iter;
  }

  /**
   * Returns a new {@linkcode Map} snapshot of the multimap, with each key