# dispatchBy
> Create an [ndarray][@stdlib/ndarray/ctor] function interface which performs multiple dispatch.
## Usage
```javascript
var dispatchBy = require( '@stdlib/ndarray/dispatch-by' );
```
#### dispatchBy( fcns, types, data, nargs, nin, nout )
Returns an [ndarray][@stdlib/ndarray/ctor] function interface which performs multiple dispatch.
```javascript
console.log( 'TODO' );
```
The function accepts the following arguments:
- **fcns**: list of [ndarray][@stdlib/ndarray/ctor] functions.
- **types**: one-dimensional list of [ndarray][@stdlib/ndarray/ctor] argument [data types][@stdlib/ndarray/dtypes]. The length of `types` must be the number of [ndarray][@stdlib/ndarray/ctor] functions multiplied by `nin+nout`. If `fcns` is a function, rather than a list, the number of [ndarray][@stdlib/ndarray/ctor] functions is computed as `types.length / (nin+nout)`.
- **data**: [ndarray][@stdlib/ndarray/ctor] function data (e.g., callbacks). If a list, the length of `data` must equal the number of [ndarray][@stdlib/ndarray/ctor] functions. If `null`, a returned [ndarray][@stdlib/ndarray/ctor] function interface does **not** provide a `data` argument to an invoked [ndarray][@stdlib/ndarray/ctor] function.
- **nargs**: total number of [ndarray][@stdlib/ndarray/ctor] function interface arguments.
- **nin**: number of input [ndarrays][@stdlib/ndarray/ctor].
- **nout**: number of output [ndarrays][@stdlib/ndarray/ctor].
## Notes
- A returned [ndarray][@stdlib/ndarray/ctor] function interface has the following signature:
```text
f( x, y, ... )
```
where
- **x**: [ndarray][@stdlib/ndarray/ctor].
- **y**: [ndarray][@stdlib/ndarray/ctor].
- **...**: additional [ndarrays][@stdlib/ndarray/ctor].
- The number of [ndarray][@stdlib/ndarray/ctor] function interface parameters is derived from `nargs`, the number of input [ndarrays][@stdlib/ndarray/ctor] is derived from `nin`, and the number of output [ndarrays][@stdlib/ndarray/ctor] is derived from `nout`.
- An [ndarray][@stdlib/ndarray/ctor] function (i.e., a value provided for the `fcns` argument) should have the following signature:
```text
f( arrays[, data] )
```
where
- **arrays**: array containing input and output [ndarrays][@stdlib/ndarray/ctor].
- **data**: [ndarray][@stdlib/ndarray/ctor] function data (e.g., a callback).
- For convenience, a single [ndarray][@stdlib/ndarray/ctor] function may be provided which will be invoked whenever the [ndarray][@stdlib/ndarray/ctor] argument data types match a sequence of types in `types`. Providing a single [ndarray][@stdlib/ndarray/ctor] function is particularly convenient for the case where, regardless of array data types, traversing arrays remains the same, but the [ndarray][@stdlib/ndarray/ctor] function `data` differs (e.g., callbacks which differ based on the array data types). For example, the following
```javascript
var unary = require( '@stdlib/ndarray/base/unary-by' );
function foo( x ) {
return x * 10.0;
}
function bar( x ) {
return x * 5.0;
}
var fcns = [
unary,
unary
];
var types = [
'float64', 'float64',
'float32', 'float32'
];
var data = [
foo,
bar
];
var fcn = dispatchBy( fcns, types, data, 2, 1, 1 );
```
is equivalent to
```javascript
var unary = require( '@stdlib/ndarray/base/unary-by' );
function foo( x ) {
return x * 10.0;
}
function bar( x ) {
return x * 5.0;
}
var types = [
'float64', 'float64',
'float32', 'float32'
];
var data = [
foo,
bar
];
var fcn = dispatchBy( unary, types, data, 2, 1, 1 );
```
## Examples
```javascript
console.log( 'TODO' );
```
[@stdlib/ndarray/array]: https://github.com/stdlib-js/ndarray/tree/main/array
[@stdlib/ndarray/ctor]: https://github.com/stdlib-js/ndarray/tree/main/ctor
[@stdlib/ndarray/dtypes]: https://github.com/stdlib-js/ndarray/tree/main/dtypes