aureooms/js-integer-big-endian

View on GitHub
src/core/arithmetic/div/_idivmod_schoolbook_subroutine.js

Summary

Maintainability
A
1 hr
Test Coverage
import assert from 'assert';

import increment from '../../../api/arithmetic/add/increment.js';
import _cmp_half from '../../compare/_cmp_half.js';
import _cmp_n from '../../compare/_cmp_n.js';
import _isub from '../sub/_isub.js';

import _idivmod_schoolbook_subroutine_do from './_idivmod_schoolbook_subroutine_do.js';

/**
 * Input
 * -----
 *  - Two integers A and B such that 0 <= A < β^(n+1) and (β^n)/2 <= B < β^n.
 *  - |A| = |B| + 1
 *  - |Q| = |A|
 *
 * Output
 * -----
 *  The quotient floor( A/B ) and the remainder A mod B.
 *
 * @param {Number} r The radix.
 * @param {Array} a Dividend.
 * @param {Number} ai Left of dividend.
 * @param {Number} aj Right of dividend.
 * @param {Array} b Divisor.
 * @param {Number} bi Left of divisor.
 * @param {Number} bj Right of divisor.
 * @param {Array} q Quotient.
 * @param {Number} qi Left of quotient.
 */
export default function _idivmod_schoolbook_subroutine(
    r,
    a,
    ai,
    aj,
    b,
    bi,
    bj,
    q,
    qi,
) {
    assert(r >= 2);
    assert(ai >= 0 && aj <= a.length);
    assert(bi >= 0 && bj <= b.length);
    assert(qi >= 0);
    assert(q.length - qi >= aj - ai);
    assert(aj - ai === bj - bi + 1); // |A| = |B| + 1
    assert(q.length - qi >= aj - ai); // |Q| >= |A|
    assert(_cmp_half(r, b, bi, bj) >= 0); // (β^n)/2 <= B < β^n

    // If A ≥ B*β, compute the quotient q and remainder r of ( A − B*β ) / B
    // and return β + q and r.
    // Note that then A − B*β < B*β since A < 2 B*β because of the
    // preconditions above. Hence the preconditions hold for
    // _idivmod_schoolbook_subroutine_do.
    if (_cmp_n(a, ai, aj - 1, b, bi) >= 0) {
        _isub(r, a, ai, aj - 1, b, bi, bj);
        _idivmod_schoolbook_subroutine_do(r, a, ai, aj, b, bi, bj, q, qi);
        increment(r, q, qi, qi + aj - ai - 1);
    } else {
        _idivmod_schoolbook_subroutine_do(r, a, ai, aj, b, bi, bj, q, qi);
    }
}