Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
58 changes: 58 additions & 0 deletions lib/node_modules/@stdlib/array/uint64/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -316,6 +316,64 @@ The returned [iterator][mdn-iterator-protocol] protocol-compliant object has the
- **next**: function which returns an [iterator][mdn-iterator-protocol] protocol-compliant object containing the next iterated value (if one exists) assigned to a `value` property and a `done` property having a `boolean` value indicating whether the [iterator][mdn-iterator-protocol] is finished.
- **return**: function which closes an [iterator][mdn-iterator-protocol] and returns a single (optional) argument in an [iterator][mdn-iterator-protocol] protocol-compliant object.

<a name="method-every"></a>

#### Uint64Array.prototype.every( predicate\[, thisArg] )

Returns a boolean indicating whether all elements pass a test.

```javascript
var isEven = require( '@stdlib/assert/is-even' );
var Number = require( '@stdlib/number/ctor' );

function predicate( v ) {
return ( isEven( Number( v ) ) );
}

var arr = new Uint64Array( 3 );

// Set the first three elements:
arr.set( 2, 0 );
arr.set( 4, 1 );
arr.set( 6, 2 );

// Check whether all elements pass a test:
var bool = arr.every( predicate );
// returns true
```

The `predicate` function is provided three arguments:

- **value**: current array element.
- **index**: current array element index.
- **arr**: the array on which this method was called.

To set the function execution context, provide a `thisArg`.

```javascript
function predicate( v, i ) {
this.count += 1;
return ( i >= 0 );
}

var arr = new Uint64Array( 3 );

var context = {
'count': 0
};

// Set the first three elements:
arr.set( 2, 0 );
arr.set( 4, 1 );
arr.set( 6, 2 );

var bool = arr.every( predicate, context );
// returns true

var count = context.count;
// returns 3
```

<a name="method-get"></a>

#### Uint64Array.prototype.get( i )
Expand Down
84 changes: 84 additions & 0 deletions lib/node_modules/@stdlib/array/uint64/benchmark/benchmark.every.js
Original file line number Diff line number Diff line change
@@ -0,0 +1,84 @@
/**
* @license Apache-2.0
*
* Copyright (c) 2026 The Stdlib Authors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/

'use strict';

// MODULES //

var bench = require( '@stdlib/bench' );
var format = require( '@stdlib/string/format' );
var isBoolean = require( '@stdlib/assert/is-boolean' ).isPrimitive;
var isEven = require( '@stdlib/assert/is-even' );
var Number = require( '@stdlib/number/ctor' );
var pkg = require( './../package.json' ).name;
var Uint64Array = require( './../lib' );


// MAIN //

bench( format( '%s:every', pkg ), function benchmark( b ) {
var bool;
var arr;
var i;

arr = new Uint64Array( 2 );

b.tic();
for ( i = 0; i < b.iterations; i++ ) {
bool = arr.every( predicate );
if ( typeof bool !== 'boolean' ) {
b.fail( 'should return a boolean' );
}
}
b.toc();
if ( !isBoolean( bool ) ) {
b.fail( 'should return a boolean' );
}
b.pass( 'benchmark finished' );
b.end();

function predicate( v ) {
return ( isEven( Number( v ) ) );
}
});

bench( format( '%s::this_context:every', pkg ), function benchmark( b ) {
var bool;
var arr;
var i;

arr = new Uint64Array( 2 );

b.tic();
for ( i = 0; i < b.iterations; i++ ) {
bool = arr.every( predicate, {} );
if ( typeof bool !== 'boolean' ) {
b.fail( 'should return a boolean' );
}
}
b.toc();
if ( !isBoolean( bool ) ) {
b.fail( 'should return a boolean' );
}
b.pass( 'benchmark finished' );
b.end();

function predicate( v ) {
return ( isEven( Number( v ) ) );
}
});
Original file line number Diff line number Diff line change
@@ -0,0 +1,108 @@
/**
* @license Apache-2.0
*
* Copyright (c) 2026 The Stdlib Authors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/

'use strict';

// MODULES //

var bench = require( '@stdlib/bench' );
var format = require( '@stdlib/string/format' );
var isBoolean = require( '@stdlib/assert/is-boolean' ).isPrimitive;
var isEven = require( '@stdlib/assert/is-even' );
var Number = require( '@stdlib/number/ctor' );
var pow = require( '@stdlib/math/base/special/pow' );
var pkg = require( './../package.json' ).name;
var Uint64Array = require( './../lib' );


// FUNCTIONS //

/**
* Returns a boolean indicating whether an array element passes a test.
*
* @private
* @param {*} value - value to test
* @returns {boolean} boolean indicating whether an array element passes a test
*/
function predicate( value ) {
return ( isEven( Number( value ) ) );
}

/**
* Creates a benchmark function.
*
* @private
* @param {PositiveInteger} len - array length
* @returns {Function} benchmark function
*/
function createBenchmark( len ) {
var arr = new Uint64Array( len );
return benchmark;

/**
* Benchmark function.
*
* @private
* @param {Benchmark} b - benchmark instance
*/
function benchmark( b ) {
var bool;
var i;

b.tic();
for ( i = 0; i < b.iterations; i++ ) {
bool = arr.every( predicate );
if ( typeof bool !== 'boolean' ) {
b.fail( 'should return a boolean' );
}
}
b.toc();
if ( !isBoolean( bool ) ) {
b.fail( 'should return a boolean' );
}
b.pass( 'benchmark finished' );
b.end();
}
}


// MAIN //

/**
* Main execution sequence.
*
* @private
*/
function main() {
var len;
var min;
var max;
var f;
var i;

min = 1; // 10^min
max = 6; // 10^max

for ( i = min; i <= max; i++ ) {
len = pow( 10, i );
f = createBenchmark( len );
bench( format( '%s:every:len=%d', pkg, len ), f );
}
}

main();
33 changes: 33 additions & 0 deletions lib/node_modules/@stdlib/array/uint64/docs/repl.txt
Original file line number Diff line number Diff line change
Expand Up @@ -275,6 +275,39 @@
true


{{alias}}.prototype.every( predicate[, thisArg] )
Returns a boolean indicating whether all elements in the array pass a test.

A predicate function is provided the following arguments:

- value: current array element.
- index: current array element index.
- arr: the array on which the method was called.

Parameters
----------
predicate: Function
Predicate function which tests array elements. If a predicate function
returns a truthy value, an array element passes; otherwise, an array
element fails.

thisArg: any (optional)
Execution context.

Returns
-------
bool: boolean
Boolean indicating whether all elements pass the test.

Examples
--------
> function predicate( v ) {return({{alias:@stdlib/assert/is-uint64}}(v));};
> var arr = new {{alias}}( [ 2, 4, 6 ] )
<Uint64Array>
> var bool = arr.every( predicate )
true


{{alias}}.prototype.get( i )
Returns an array element located at integer position (index) `i`.

Expand Down
26 changes: 26 additions & 0 deletions lib/node_modules/@stdlib/array/uint64/docs/types/index.d.ts
Original file line number Diff line number Diff line change
Expand Up @@ -459,6 +459,32 @@ declare class Uint64Array implements Uint64ArrayInterface {
*/
entries(): TypedIterator<[number, Uint64]>;

/**
* Tests whether all elements in an array pass a test implemented by a predicate function.
*
* @param predicate - test function
* @param thisArg - execution context
* @returns boolean indicating whether all elements pass a test
*
* @example
* var isEven = require( '@stdlib/assert/is-even' );
* var Number = require( '@stdlib/number/ctor' );
*
* function predicate( v ) {
* return ( isEven( Number( v ) ) );
* }
*
* var arr = new Uint64Array( 3 );
*
* arr.set( 2, 0 );
* arr.set( 4, 1 );
* arr.set( 6, 2 );
*
* var bool = arr.every( predicate );
* // returns true
*/
every<U = unknown>( predicate: Predicate<U>, thisArg?: ThisParameterType<Predicate<U>> ): boolean;

/**
* Returns an array element.
*
Expand Down
47 changes: 47 additions & 0 deletions lib/node_modules/@stdlib/array/uint64/lib/main.js
Original file line number Diff line number Diff line change
Expand Up @@ -709,6 +709,53 @@
}
});

/**
* Tests whether all elements in an array pass a test implemented by a predicate function.
*
* @name every
* @memberof Uint64Array.prototype
* @type {Function}
* @param {Function} predicate - test function
* @param {*} [thisArg] - predicate function execution context
* @throws {TypeError} `this` must be a 64-bit unsigned integer array
* @throws {TypeError} first argument must be a function
* @returns {boolean} boolean indicating whether all elements pass a test
*
* @example
* var isEven = require( '@stdlib/assert/is-even' );
* var Number = require( '@stdlib/number/ctor' );
*
* function predicate( v ) {
* return ( isEven( Number( v ) ) );
* }
*
* var arr = new Uint64Array( 3 );
*
* arr.set( 2, 0 );
* arr.set( 4, 1 );
* arr.set( 6, 2 );
*
* var bool = arr.every( predicate );
* // returns true
*/
setReadOnly( Uint64Array.prototype, 'every', function every( predicate, thisArg ) {
var buf;
var i;
if ( !isUint64Array( this ) ) {
throw new TypeError( 'invalid invocation. `this` is not a 64-bit unsigned integer array.' );
}
if ( !isFunction( predicate ) ) {
throw new TypeError( format( 'invalid argument. First argument must be a function. Value: `%s`.', predicate ) );
}
buf = this._buffer;
for ( i = 0; i < this._length; i++ ) {
if ( !predicate.call( thisArg, getUint64( buf, i ), i, this ) ) {
return false;
}
}
return true;
});

/**
* Returns an array element.
*
Expand Down Expand Up @@ -846,7 +893,7 @@
buf[ idx+indices.LOW ] = words[ 1 ];
return;
}
if ( isNonNegativeInteger( value ) || ( isBigInt( value ) && isNonNegativeInteger( Number( value ) ) ) ) {

Check warning on line 896 in lib/node_modules/@stdlib/array/uint64/lib/main.js

View workflow job for this annotation

GitHub Actions / Lint Changed Files

This line has a length of 110. Maximum allowed is 80
if ( idx >= this._length ) {
throw new RangeError( format( 'invalid argument. Index argument is out-of-bounds. Value: `%u`.', idx ) );
}
Expand Down Expand Up @@ -909,7 +956,7 @@
// We need to copy source values...
tmp = new Uint32Array( sbuf.length );
for ( i = 0; i < sbuf.length; i++ ) {
tmp[ i ] = sbuf[ i ]; // TODO: handle accessor arrays

Check warning on line 959 in lib/node_modules/@stdlib/array/uint64/lib/main.js

View workflow job for this annotation

GitHub Actions / Lint Changed Files

Unexpected 'todo' comment: 'TODO: handle accessor arrays'
}
sbuf = tmp;
}
Expand Down
Loading