Usage

`javascript
var findLast = require( '@stdlib/ndarray-find-last' );
`

#### findLast( x\[, options], predicate\[, thisArg] )

Returns a new [ndarray][@stdlib/ndarray/ctor] containing the last elements which pass a test implemented by a predicate function along one or more [ndarray][@stdlib/ndarray/ctor] dimensions.

`javascript
var array = require( '@stdlib/ndarray-array' );

function isEven( value ) {
return value % 2.0 === 0.0;
}

// Create an input ndarray:
var x = array( [ [ [ 1.0, 2.0 ], [ 3.0, 4.0 ] ], [ [ 5.0, 6.0 ], [ 7.0, 8.0 ] ] ] );
// returns

// Perform reduction:
var out = findLast( x, isEven );
// returns [ 8.0 ]
`

The function accepts the following arguments:

- x: input [ndarray][@stdlib/ndarray/ctor].
- options: function options _(optional)_.
- predicate: predicate function.
- thisArg: predicate function execution context _(optional)_.

The function accepts the following options:

- dims: list of dimensions over which to perform a reduction.
- keepdims: boolean indicating whether the reduced dimensions should be included in the returned [ndarray][@stdlib/ndarray/ctor] as singleton dimensions. Default: false.
- sentinel: value to return when no element passes the test. May be either a scalar value or a zero-dimensional [ndarray][@stdlib/ndarray/ctor].

By default, the function performs reduction over all elements in a provided [ndarray][@stdlib/ndarray/ctor]. To reduce specific dimensions, set the dims option.

`javascript
var array = require( '@stdlib/ndarray-array' );

function isEven( value ) {
return value % 2.0 === 0.0;
}

// Create an input ndarray:
var x = array( [ [ [ 1.0, 2.0 ], [ 3.0, 4.0 ] ], [ [ 5.0, 6.0 ], [ 7.0, 8.0 ] ] ] );
// returns

var opts = {
'dims': [ 0 ]
};

// Perform reduction:
var out = findLast( x, opts, isEven );
// returns [ [ NaN, 6.0 ], [ NaN, 8.0 ] ]
`

By default, the function returns an [ndarray][@stdlib/ndarray/ctor] having a shape matching only the non-reduced dimensions of the input [ndarray][@stdlib/ndarray/ctor] (i.e., the reduced dimensions are dropped). To include the reduced dimensions as singleton dimensions in the output [ndarray][@stdlib/ndarray/ctor], set the keepdims option to true.

`javascript
var array = require( '@stdlib/ndarray-array' );

function isEven( value ) {
return value % 2.0 === 0.0;
}

// Create an input ndarray:
var x = array( [ [ [ 1.0, 2.0 ], [ 3.0, 4.0 ] ], [ [ 5.0, 6.0 ], [ 7.0, 8.0 ] ] ] );
// returns

var opts = {
'dims': [ 0 ],
'keepdims': true
};

// Perform reduction:
var out = findLast( x, opts, isEven );
// returns [ [ [ NaN, 6.0 ], [ NaN, 8.0 ] ] ]
`

To specify a custom sentinel value to return when no element passes the test, set the sentinel option.

`javascript
var array = require( '@stdlib/ndarray-array' );

function isEven( value ) {
return value % 2.0 === 0.0;
}

// Create an input ndarray:
var x = array( [ [ [ 1.0, 3.0 ], [ 5.0, 7.0 ] ], [ [ 9.0, 11.0 ], [ 13.0, 15.0 ] ] ] );
// returns

var opts = {
'sentinel': -999
};

// Perform reduction:
var out = findLast( x, opts, isEven );
// returns [ -999 ]
`

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

`javascript
var array = require( '@stdlib/ndarray-array' );

function isEven( value ) {
this.count += 1;
return value % 2.0 === 0.0;
}

// Create an input ndarray:
var x = array( [ [ [ 1.0, 2.0 ], [ 3.0, 4.0 ] ], [ [ 5.0, 6.0 ], [ 7.0, 8.0 ] ] ] );
// returns

var ctx = {
'count': 0
};

// Perform reduction:
var out = findLast( x, isEven, ctx );
// returns [ 8.0 ]

var count = ctx.count;
// returns 1
`

#### findLast.assign( x, out\[, options], predicate\[, thisArg] )

Finds the last elements which pass a test implemented by a predicate function along one or more [ndarray][@stdlib/ndarray/ctor] dimensions and assigns results to a provided output [ndarray][@stdlib/ndarray/ctor].

`javascript
var array = require( '@stdlib/ndarray-array' );
var empty = require( '@stdlib/ndarray-empty' );
var getDType = require( '@stdlib/ndarray-dtype' );

function isEven( value ) {
return value % 2.0 === 0.0;
}

// Create an input ndarray:
var x = array( [ [ [ 1.0, 2.0 ], [ 3.0, 4.0 ] ], [ [ 5.0, 6.0 ], [ 7.0, 8.0 ] ] ] );
// returns

// Create an output ndarray:
var y = empty( [], {
'dtype': getDType( x )
});

// Perform reduction:
var out = findLast.assign( x, y, isEven );
// returns [ 8.0 ]

var bool = ( out === y );
// returns true
`

The function accepts the following arguments:

- x: input [ndarray][@stdlib/ndarray/ctor].
- out: output [ndarray][@stdlib/ndarray/ctor].
- options: function options _(optional)_.
- predicate: predicate function.
- thisArg: predicate function execution context _(optional)_.

The function accepts the following options:

- dims: list of dimensions over which to perform a reduction.
- sentinel: value to return when no element passes the test. May be either a scalar value or a zero-dimensional [ndarray][@stdlib/ndarray/ctor].

`javascript
var array = require( '@stdlib/ndarray-array' );
var empty = require( '@stdlib/ndarray-empty' );
var getDType = require( '@stdlib/ndarray-dtype' );

function isEven( value ) {
return value % 2.0 === 0.0;
}

// Create an input ndarray:
var x = array( [ [ [ 1.0, 2.0 ], [ 3.0, 4.0 ] ], [ [ 5.0, 6.0 ], [ 7.0, 8.0 ] ] ] );
// returns

// Create an output ndarray:
var y = empty( [ 2, 2 ], {
'dtype': getDType( x )
});

var opts = {
'dims': [ 0 ]
};

// Perform reduction:
var out = findLast.assign( x, y, opts, isEven );
// returns [ [ NaN, 6.0 ], [ NaN, 8.0 ] ]

var bool = ( out === y );
// returns true
`