# toReversed
> Return a new ndarray where the order of elements of an input ndarray is reversed along each dimension.
## Usage
```javascript
var toReversed = require( '@stdlib/ndarray/base/to-reversed' );
```
#### toReversed( x )
Returns a new ndarray where the order of elements of an input ndarray is reversed along each dimension.
```javascript
var getShape = require( '@stdlib/ndarray/shape' );
var ndarray = require( '@stdlib/ndarray/ctor' );
var buffer = [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ];
var shape = [ 3, 2 ];
var strides = [ 2, 1 ];
var offset = 0;
var x = ndarray( 'generic', buffer, shape, strides, offset, 'row-major' );
// returns [ [ 1.0, 2.0 ], [ 3.0, 4.0 ], [ 5.0, 6.0 ] ]
var sh = getShape( x );
// returns [ 3, 2 ]
var y = toReversed( x );
// returns [ [ 6.0, 5.0 ], [ 4.0, 3.0 ], [ 2.0, 1.0 ] ]
sh = getShape( y );
// returns [ 3, 2 ]
```
The function accepts the following arguments:
- **x**: input ndarray.
## Examples
```javascript
var array = require( '@stdlib/ndarray/array' );
var ndarray2array = require( '@stdlib/ndarray/to-array' );
var zeroTo = require( '@stdlib/array/base/zero-to' );
var toReversed = require( '@stdlib/ndarray/base/to-reversed' );
// Create a linear ndarray buffer:
var buf = zeroTo( 16 );
// Create a one-dimensional ndarray:
var x1 = array( buf, {
'shape': [ 16 ]
});
// Reverse element order:
var y1 = toReversed( x1, false );
// returns
var a1 = ndarray2array( y1 );
// returns [ 15, 14, 13, 12, 11, 10, 9, 8, 7, 6, 5, 4, 3, 2, 1, 0 ]
// Create a two-dimensional ndarray:
var x2 = array( buf, {
'shape': [ 4, 4 ]
});
// Reverse element order:
var y2 = toReversed( x2, false );
// returns
var a2 = ndarray2array( y2 );
// returns [ [ 15, 14, 13, 12 ], [ 11, 10, 9, 8 ], [ 7, 6, 5, 4 ], [ 3, 2, 1, 0 ] ]
// Create a three-dimensional ndarray:
var x3 = array( buf, {
'shape': [ 2, 4, 2 ]
});
// Reverse element order:
var y3 = toReversed( x3, false );
// returns
var a3 = ndarray2array( y3 );
// returns [ [ [ 15, 14 ], [ 13, 12 ], [ 11, 10 ], [ 9, 8 ] ], [ [ 7, 6 ], [ 5, 4 ], [ 3, 2 ], [ 1, 0 ] ] ]
```