diff --git a/lib/node_modules/@stdlib/complex/base/assert/docs/types/index.d.ts b/lib/node_modules/@stdlib/complex/base/assert/docs/types/index.d.ts index c900cd5cf13c..80c767d67cc2 100644 --- a/lib/node_modules/@stdlib/complex/base/assert/docs/types/index.d.ts +++ b/lib/node_modules/@stdlib/complex/base/assert/docs/types/index.d.ts @@ -21,6 +21,7 @@ /* eslint-disable max-lines */ import isAlmostEqual = require( '@stdlib/complex/base/assert/is-almost-equal' ); +import isAlmostSameValue = require( '@stdlib/complex/base/assert/is-almost-same-value' ); /** * Interface describing the `assert` namespace. @@ -40,11 +41,11 @@ interface Namespace { * @returns boolean indicating whether two complex numbers are approximately equal within a specified number of ULPs * * @example - * var EPS = require( '@stdlib/constants/float32/eps' ); - * var Complex64 = require( '@stdlib/complex/float32/ctor' ); + * var EPS = require( '@stdlib/constants/float64/eps' ); + * var Complex128 = require( '@stdlib/complex/float64/ctor' ); * - * var z1 = new Complex64( 1.0, 3.0 ); - * var z2 = new Complex64( 1.0+EPS, 3.0 ); + * var z1 = new Complex128( 1.0, 3.0 ); + * var z2 = new Complex128( 1.0+EPS, 3.0 ); * * var bool = ns.isAlmostEqual( z1, z2, 0 ); * // returns false @@ -53,6 +54,33 @@ interface Namespace { * // returns true */ isAlmostEqual: typeof isAlmostEqual; + + /** + * Tests whether two complex numbers are approximately the same value within a specified number of ULPs (units in the last place). + * + * ## Notes + * + * - The function differs from the `===` operator in that the function treats `-0` and `+0` as distinct and `NaNs` as the same. + * + * @param z1 - first complex number + * @param z2 - second complex number + * @param maxULP - maximum allowed ULP difference + * @returns boolean indicating whether two complex numbers are approximately the same value within a specified number of ULPs + * + * @example + * var EPS = require( '@stdlib/constants/float64/eps' ); + * var Complex128 = require( '@stdlib/complex/float64/ctor' ); + * + * var z1 = new Complex128( 1.0, 3.0 ); + * var z2 = new Complex128( 1.0+EPS, 3.0 ); + * + * var bool = ns.isAlmostSameValue( z1, z2, 0 ); + * // returns false + * + * bool = ns.isAlmostSameValue( z1, z2, 1 ); + * // returns true + */ + isAlmostSameValue: typeof isAlmostSameValue; } /**