Merge branch 'develop' of github.com:stdlib-js/stdlib into endian-toSorted

Author: ahmad-kashkoush

.github/workflows/lint_changed_files.yml

@@ -257,7 +257,7 @@ jobs:
       - name: 'Setup R'
         if: ( success() || failure() ) && steps.check-r-files.outputs.files != ''
         # Pin action to full length commit SHA
-        uses: r-lib/actions/setup-r@e6be4b3706e0f39bc7a4cf4496a5f2c4cb840040 # v2.10.1
+        uses: r-lib/actions/setup-r@473c68190595b311a74f208fba61a8d8c0d4c247 # v2.11.1
         with:
           r-version: '3.5.3'
 

.github/workflows/lint_random_files.yml

@@ -326,7 +326,7 @@ jobs:
       - name: 'Setup R'
         if: ( github.event.inputs.r != 'false' ) && ( success() || failure() )
         # Pin action to full length commit SHA
-        uses: r-lib/actions/setup-r@e6be4b3706e0f39bc7a4cf4496a5f2c4cb840040 # v2.10.1
+        uses: r-lib/actions/setup-r@473c68190595b311a74f208fba61a8d8c0d4c247 # v2.11.1
         with:
           r-version: '4.3.3'
 

.github/workflows/windows_test_npm_install.yml

@@ -152,7 +152,7 @@ jobs:
       # Install MSYS2:
       - name: 'Install MSYS2'
         # Pin action to full length commit SHA
-        uses: msys2/setup-msys2@ddf331adaebd714795f1042345e6ca57bd66cea8 # v2.24.1
+        uses: msys2/setup-msys2@c52d1fa9c7492275e60fe763540fb601f5f232a1 # v2.25.0
         with:
           # Set the MSYS system:
           msystem: MINGW64

lib/node_modules/@stdlib/array/base/broadcasted-ternary3d/package.json

@@ -1,5 +1,5 @@
 {
-    "name": "@stdlib/array/base/broadcasted-ternary3d",
+  "name": "@stdlib/array/base/broadcasted-ternary3d",
   "version": "0.0.0",
   "description": "Apply a ternary callback to elements in three broadcasted input arrays and assign results to elements in a three-dimensional nested output array.",
   "license": "Apache-2.0",

lib/node_modules/@stdlib/array/base/broadcasted-ternary4d/package.json

@@ -1,5 +1,5 @@
 {
-    "name": "@stdlib/array/base/broadcasted-ternary4d",
+  "name": "@stdlib/array/base/broadcasted-ternary4d",
   "version": "0.0.0",
   "description": "Apply a ternary callback to elements in three broadcasted input arrays and assign results to elements in a four-dimensional nested output array.",
   "license": "Apache-2.0",

lib/node_modules/@stdlib/array/fixed-endian-factory/README.md

@@ -451,6 +451,66 @@ var count = context.count;
 // returns 3
 ```
 
+<a name="method-filter"></a>
+
+#### TypedArrayFE.prototype.filter( predicate\[, thisArg] )
+
+Returns a new array containing the elements of an array which pass a test implemented by a predicate function.
+
+```javascript
+function predicate( v ) {
+    return ( v % 2 === 0 );
+}
+
+var Float64ArrayFE = fixedEndianFactory( 'float64' );
+
+var arr = new Float64ArrayFE( 'little-endian', [ 1.0, 2.0, 3.0, 4.0 ] );
+
+var out = arr.filter( predicate );
+// returns <Float64ArrayFE>
+
+var len = out.length;
+// returns 2
+
+var v = out.get( 0 );
+// returns 2.0
+
+v = out.get( 1 );
+// return 4.0
+```
+
+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 ( v % 2 === 0 );
+}
+
+var context = {
+    'count': 0
+};
+
+var Float64ArrayFE = fixedEndianFactory( 'float64' );
+
+var arr = new Float64ArrayFE( 'little-endian', [ 1.0, 2.0, 3.0, 4.0 ] );
+
+var out = arr.filter( predicate, context );
+// returns <Float64ArrayFE>
+
+var len = out.length;
+// returns 2
+
+var count = context.count;
+// returns 4
+```
+
 <a name="method-get"></a>
 
 #### TypedArrayFE.prototype.get( i )
@@ -515,6 +575,38 @@ var idx = arr.indexOf( 5.0 );
 // returns -1
 ```
 
+<a name="method-last-index-of"></a>
+
+#### TypedArrayFE.prototype.lastIndexOf( searchElement\[, fromIndex] )
+
+Returns the last index at which a given element can be found in the array.
+
+```javascript
+var Float64ArrayFE = fixedEndianFactory( 'float64' );
+
+var arr = new Float64ArrayFE( 'little-endian', [ 1.0, 2.0, 3.0, 4.0, 2.0 ] );
+
+var idx = arr.lastIndexOf( 2.0 );
+// returns 4
+
+idx = arr.lastIndexOf( 2.0, 3 );
+// returns 1
+
+idx = arr.lastIndexOf( 2.0, -2 );
+// returns 1
+```
+
+If `searchElement` is not present in the array, the method returns `-1`.
+
+```javascript
+var Float64ArrayFE = fixedEndianFactory( 'float64' );
+
+var arr = new Float64ArrayFE( 'little-endian', [ 1.0, 2.0, 3.0, 4.0, 2.0 ] );
+
+var idx = arr.lastIndexOf( 5.0 );
+// returns -1
+```
+
 <a name="method-toSorted"></a>
 
 #### TypedArrayFE.prototype.toSorted( compareFcn )
@@ -609,7 +701,99 @@ var out = arr.map( fcn, context );
 var count = context.count;
 // returns 3;
 ```
+  
+<a name="method-reduce"></a>
+
+#### TypedArray.prototype.reduce( reducerFn\[, initialValue] )
+
+Applies a provided callback function to each element of the array, in order, passing in the return value from the calculation on the preceding element and returning the accumulated result upon completion.
+
+```javascript
+function reducer( acc, v ) {
+    return ( acc && v );
+}
+
+var Float64ArrayFE = fixedEndianFactory( 'float64' );
+
+var arr = new Float64ArrayFE( 'little-endian', [ 1.0, 0.0, 1.0 ] );
+// returns <Float64ArrayFE>
+
+var out = arr.reduce( reducer );
+// returns 0.0
+```
+
+The reducer function is provided four arguments:
+
+-   **acc**: accumulated result.
+-   **value**: current array element.
+-   **index**: current array element index.
+-   **arr**: the array on which this method was called.
+
+By default, the function initializes the accumulated result to the first element in the array and passes the second array element as `value` during the first invocation of the provided callback. To begin accumulation from a different starting value and pass in the first array element as `value` during the first invocation of the provided callback, provide an `initialValue` argument.
+
+```javascript
+function reducer( acc, v ) {
+    if ( v ) {
+        return acc + 1;
+    }
+    return acc;
+}
+
+var Float64ArrayFE = fixedEndianFactory( 'float64' );
+
+var arr = new Float64ArrayFE( 'little-endian', [ 1.0, 0.0, 1.0 ] );
+// returns <Float64ArrayFE>
+
+var out = arr.reduce( reducer, 0 );
+// returns 2
+```
+
+<a name="method-reduce-right"></a>
+
+#### TypedArray.prototype.reduceRight( reducerFn\[, initialValue] )
+
+Applies a provided callback function to each element of the array, in reverse order, passing in the return value from the calculation on the following element and returning the accumulated result upon completion.
+
+```javascript
+function reducer( acc, v ) {
+    return ( acc && v );
+}
+
+var Float64ArrayFE = fixedEndianFactory( 'float64' );
+
+var arr = new Float64ArrayFE( 'little-endian', [ 1.0, 0.0, 1.0 ] );
+// returns <Float64ArrayFE>
+
+var out = arr.reduceRight( reducer );
+// returns 0.0
+```
+  
+The reducer function is provided four arguments:
+
+-   **acc**: accumulated result.
+-   **value**: current array element.
+-   **index**: current array element index.
+-   **arr**: the array on which this method was called.
+
+By default, the function initializes the accumulated result to the first element in the array and passes the second array element as `value` during the first invocation of the provided callback. To begin accumulation from a different starting value and pass in the first array element as `value` during the first invocation of the provided callback, provide an `initialValue` argument.
+
+```javascript
+function reducer( acc, v ) {
+    if ( v ) {
+        return acc + 1;
+    }
+    return acc;
+}
+
+var Float64ArrayFE = fixedEndianFactory( 'float64' );
+
+var arr = new Float64ArrayFE( 'little-endian', [ 1.0, 0.0, 1.0 ] );
+// returns <Float64ArrayFE>
 
+var out = arr.reduceRight( reducer, 0 );
+// returns 2
+```
+  
 <a name="method-set"></a>
 
 #### TypedArrayFE.prototype.set( arr\[, offset] )
@@ -728,6 +912,35 @@ var str = arr.toString();
 // returns '1,2,3'
 ```
 
+<a name="method-join"></a>
+
+#### TypedArrayFE.prototype.join( \[separator] )
+
+Serializes the array elements into a string, with elements separated by the specified `separator`. If no `separator` is provided, a comma (`,`) is used as the default.
+
+```javascript
+var Float64ArrayFE = fixedEndianFactory( 'float64' );
+
+var arr = new Float64ArrayFE( 'little-endian', [ 1.0, 2.0, 3.0 ] );
+
+var str = arr.join();
+// returns '1,2,3'
+
+str = arr.join( ' - ' );
+// returns '1 - 2 - 3'
+```
+
+If the provided `separator` is not a string, it is coerced to a string.
+
+```javascript
+var Float64ArrayFE = fixedEndianFactory( 'float64' );
+
+var arr = new Float64ArrayFE( 'little-endian', [ 1.0, 2.0, 3.0 ] );
+
+var str = arr.join( 0 );
+// returns '10203'
+```
+
 </section>
 
 <!-- /.usage -->

lib/node_modules/@stdlib/array/fixed-endian-factory/benchmark/benchmark.filter.js

@@ -0,0 +1,59 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2024 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 pkg = require( './../package.json' ).name;
+var factory = require( './../lib' );
+
+
+// VARIABLES //
+
+var Float64ArrayFE = factory( 'float64' );
+
+
+// MAIN //
+
+bench( pkg+':filter', function benchmark( b ) {
+	var out;
+	var arr;
+	var i;
+
+	arr = new Float64ArrayFE( 'little-endian', [ 1.0, 2.0, 2.0, 1.0 ] );
+
+	b.tic();
+	for ( i = 0; i < b.iterations; i++ ) {
+		out = arr.filter( predicate );
+		if ( typeof out !== 'object' ) {
+			b.fail( 'should return an object' );
+		}
+	}
+	b.toc();
+	if ( !( out instanceof Float64ArrayFE ) ) {
+		b.fail( 'should return a typed array' );
+	}
+	b.pass( 'benchmark finished' );
+	b.end();
+
+	function predicate( v ) {
+		return v % 2 === 0;
+	}
+});