salve-annos/lib/salve/set.js

A fork with support for documentation of Salve, a Javascript library which implements a validator able to validate an XML document on the basis of a subset of RelaxNG.

"use strict";
/**
 * Set utilities.
 *
 * @author Louis-Dominique Dubeau
 * @license MPL 2.0
 * @copyright Mangalam Research Center for Buddhist Languages
 * @private
 */
Object.defineProperty(exports, "__esModule", { value: true });
exports.union = union;
exports.filter = filter;
exports.map = map;
/**
 * Add the elements of another set to this set. This mutates this set.
 *
 * @param me The set to mutate.
 *
 * @param s The set to add.
 */
function union(me, s) {
    for (const x of s) {
        me.add(x);
    }
}
/**
 * Selects a subset of values.
 *
 * @param me The set to filter.
 *
 * @param f A function that selects values.
 *
 * @returns An object of the same class as the object on which the method is
 * called. This object contains only the value selected by the function.
 */
function filter(me, f) {
    const ret = new me.constructor();
    // The fat arrow is used to prevent a caller from accessing ``this.b``
    // through the 3rd parameter that would be passed to ``f``.
    let index = 0;
    for (const x of me) {
        if (f(x, index++, me)) {
            ret.add(x);
        }
    }
    return ret;
}
/**
 * This method works like Array.map but with a provision for eliminating
 * elements.
 *
 * @param me The set to map.
 *
 * @param f This parameter plays the same role as for ``Array``'s ``map``
 * method.  However, when it returns an undefined value, this return value is
 * not added to set that will be returned.
 *
 * @returns The new set. This set is of the same class as the original set.
 */
function map(me, f) {
    const ret = new me.constructor();
    let index = 0;
    for (const x of me) {
        const result = f(x, index++, me);
        if (result !== undefined) {
            ret.add(result);
        }
    }
    return ret;
}
//  LocalWords:  param NaiveSet Mangalam MPL Dubeau HashSet hashstructs
//# sourceMappingURL=set.js.map