# prependSingletonDimensions
> Return a read-only view of an input [ndarray][@stdlib/ndarray/ctor] with a specified number of prepended singleton dimensions.
## Usage
```javascript
var prependSingletonDimensions = require( '@stdlib/ndarray/prepend-singleton-dimensions' );
```
#### prependSingletonDimensions( x, n )
Returns a read-only view of an input [ndarray][@stdlib/ndarray/ctor] with a specified number of prepended singleton dimensions.
```javascript
var array = require( '@stdlib/ndarray/array' );
// Create a 2x2 ndarray:
var x = array( [ [ 1, 2 ], [ 3, 4 ] ] );
// returns [ [ 1, 2 ], [ 3, 4 ] ]
// Prepend singleton dimensions:
var y = prependSingletonDimensions( x, 3 );
// returns [ [ [ [ [ 1, 2 ], [ 3, 4 ] ] ] ] ]
```
The function accepts the following arguments:
- **x**: input [ndarray][@stdlib/ndarray/ctor].
- **n**: number of singleton dimensions to prepend.
## Examples
```javascript
var uniform = require( '@stdlib/random/uniform' );
var ndarray2array = require( '@stdlib/ndarray/to-array' );
var prependSingletonDimensions = require( '@stdlib/ndarray/prepend-singleton-dimensions' );
var x = uniform( [ 3, 3, 3 ], -10.0, 10.0 );
console.log( ndarray2array( x ) );
var y = prependSingletonDimensions( x, 3 );
console.log( ndarray2array( y ) );
```
[@stdlib/ndarray/ctor]: https://github.com/stdlib-js/ndarray/tree/main/ctor