stdlib icon indicating copy to clipboard operation
stdlib copied to clipboard

[RFC]: add `@stdlib/array/base/cuany-by-right`

Open kgryte opened this issue 1 year ago • 0 comments

Description

This RFC proposes adding the package @stdlib/array/base/cuany-by-right, which cumulatively tests whether at least one array element in a provided array passes a test implemented by a predicate function, while iterating from right-to-left. The function should return a new generic array. The package should also provide an #assign API for setting output values in a provided output array.

function isPositive( value ) {
	return ( value > 0 );
}

var x = [ 0, 1, 0, 0, 0 ];

var y1 = cuanyByRight( x, isPositive );
// returns [ false, false, false, true, true ]

var y2 = [ false, null, false, null, false, null, false, null, false, null ];
var out = cuanyByRight.assign( x, y2, 2, 0, isPositive );
// returns [ false, null, false, null, false, null, true, null, true, null ]

var bool = ( out === y2 );
// returns true

where the assign API supports an offset and stride (see, e.g., @stdlib/array/base/take). Note that, by iterating from right to left, the values in the output array are equivalent to having first reversed the input array x and then using left-to-right iteration.

Both APIs should support accessor arrays (see, e.g., @stdlib/array/base/take).

Related Issues

No.

Questions

No.

Other

  • See also @stdlib/array/base/any-by-right

Checklist

  • [X] I have read and understood the Code of Conduct.
  • [X] Searched for existing issues and pull requests.
  • [X] The issue name begins with RFC:.

kgryte avatar Jun 08 '24 00:06 kgryte