/* -*- Mode: js; js-indent-level: 2; -*- */ /* * Copyright 2011 Mozilla Foundation and contributors * Licensed under the New BSD license. See LICENSE or: * http://opensource.org/licenses/BSD-3-Clause */ /** * A data structure which is a combination of an array and a set. Adding a new * member is O(1), testing for membership is O(1), and finding the index of an * element is O(1). Removing elements from the set is not supported. Only * strings are supported for membership. */ class ArraySet { constructor() { this._array = []; this._set = new Map(); } /** * Static method for creating ArraySet instances from an existing array. */ static fromArray(aArray, aAllowDuplicates) { const set = new ArraySet(); for (let i = 0, len = aArray.length; i < len; i++) { set.add(aArray[i], aAllowDuplicates); } return set; } /** * Return how many unique items are in this ArraySet. If duplicates have been * added, than those do not count towards the size. * * @returns Number */ size() { return this._set.size; } /** * Add the given string to this set. * * @param String aStr */ add(aStr, aAllowDuplicates) { const isDuplicate = this.has(aStr); const idx = this._array.length; if (!isDuplicate || aAllowDuplicates) { this._array.push(aStr); } if (!isDuplicate) { this._set.set(aStr, idx); } } /** * Is the given string a member of this set? * * @param String aStr */ has(aStr) { return this._set.has(aStr); } /** * What is the index of the given string in the array? * * @param String aStr */ indexOf(aStr) { const idx = this._set.get(aStr); if (idx >= 0) { return idx; } throw new Error('"' + aStr + '" is not in the set.'); } /** * What is the element at the given index? * * @param Number aIdx */ at(aIdx) { if (aIdx >= 0 && aIdx < this._array.length) { return this._array[aIdx]; } throw new Error("No element indexed by " + aIdx); } /** * Returns the array representation of this set (which has the proper indices * indicated by indexOf). Note that this is a copy of the internal array used * for storing the members so that no one can mess with internal state. */ toArray() { return this._array.slice(); } } exports.ArraySet = ArraySet;