# scalar2ndarray
> Convert a scalar value to a zero-dimensional [ndarray][@stdlib/ndarray/base/ctor].
## Usage
```javascript
var scalar2ndarray = require( '@stdlib/ndarray/base/from-scalar' );
```
#### scalar2ndarray( value, dtype, order )
Returns a zero-dimensional [ndarray][@stdlib/ndarray/base/ctor] containing a provided scalar `value` and having a specified [data type][@stdlib/ndarray/dtypes].
```javascript
var getShape = require( '@stdlib/ndarray/shape' );
var getDType = require( '@stdlib/ndarray/dtype' );
var x = scalar2ndarray( 1.0, 'float64', 'row-major' );
// returns
var sh = getShape( x );
// returns []
var dt = String( getDType( x ) );
// returns 'float64'
var v = x.get();
// returns 1.0
```
## Notes
- If `value` is a number and [`dtype`][@stdlib/ndarray/dtypes] is a complex [data type][@stdlib/ndarray/dtypes], the function returns a zero-dimensional [ndarray][@stdlib/ndarray/base/ctor] containing a complex number whose real component equals the provided scalar `value` and whose imaginary component is zero.
## Examples
```javascript
var dtypes = require( '@stdlib/ndarray/dtypes' );
var scalar2ndarray = require( '@stdlib/ndarray/base/from-scalar' );
// Get a list of data types:
var dt = dtypes( 'integer_and_generic' );
// Generate zero-dimensional arrays...
var x;
var i;
for ( i = 0; i < dt.length; i++ ) {
x = scalar2ndarray( i, dt[ i ], 'row-major' );
console.log( x.get() );
}
```
[@stdlib/ndarray/base/ctor]: https://github.com/stdlib-js/ndarray/tree/main/base/ctor
[@stdlib/ndarray/dtypes]: https://github.com/stdlib-js/ndarray/tree/main/dtypes
[@stdlib/ndarray/array]: https://github.com/stdlib-js/ndarray/tree/main/array
[@stdlib/ndarray/ctor]: https://github.com/stdlib-js/ndarray/tree/main/ctor