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

[kgryte]

Description

This RFC proposes adding the package @stdlib/array/base/cuany, which cumulatively tests whether at least one array element in a provided array is truthy. 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.

var x = [ false, false, true, false, false ];

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

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

where the assign API supports an offset and stride (see, e.g., @stdlib/array/base/take).

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

Related Issues

No.

Questions

No.

Other

No.

Checklist

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

[adityacodes30]

I'd like to take this up

[kgryte]

@adityacodes30 Sounds good! Thanks for volunteering to work on this!

[adityacodes30]

in the cuany api - the return type would be a accessor array or a indexed one ? provided the input was an accessor one

[kgryte]

@adityacodes30 For the main export, the return type should be a "generic" array (e.g., [ true, false, true ]; i.e., Array<boolean>). For the assign API attached to the main export, the return type should be whatever the input array is (see, e.g.,

stdlib/lib/node_modules/@stdlib/array/empty-like/docs/types/index.d.ts

Line 67 in 3cf2e89

declare function emptyLike<T extends TypedArray | ComplexTypedArray>( x: T ): T;

).

[adityacodes30]

I have question to as to how to export a particular function in an export to use it for the api as in -

i have 2 function and one main function in main.js named indexed , accessor and cuany (the export)

now i need to use cuany in my assign.js but that doesnt work because of the arraylike2object conversions to support accessor arrays , i want to use the accessor function in my assign api . what are the conventions for doing that and how should i go about it ?

[kgryte]

@adityacodes30 I suggest exploring the variety of implementations in array/base/*, as you are likely to find something which is applicable for what you are trying to do. At a high level, my sense is that the main export should actually be using the implementations in assign.js, rather than the other way around. The main export should allocate a generic array filled with false values using @stdlib/array/base/filled. That allocated array should then be passed along to the assign implementation as the output array.