# times (DataMatrix)

Multiply DataMatrix objects

## Syntax

```DMObjNew = times(DMObj1, DMObj2) DMObjNew = DMObj1 .* DMObj2 DMObjNew = times(DMObj1, B) DMObjNew = DMObj1 .* B DMObjNew = times(B, DMObj1) DMObjNew = B .* DMObj1 ```

## Input Arguments

 `DMObj1`, `DMObj2` DataMatrix objects, such as created by `DataMatrix` (object constructor). `B` MATLAB® numeric or logical array.

## Output Arguments

 `DMObjNew` DataMatrix object created by multiplication.

## Description

```DMObjNew = times(DMObj1, DMObj2)``` or the equivalent `DMObjNew = DMObj1 .* DMObj2` performs an element-by-element multiplication of the DataMatrix objects `DMObj1` and `DMObj2` and places the results in `DMObjNew`, another DataMatrix object. `DMObj1` and `DMObj2` must have the same size (number of rows and columns), unless one is a scalar (1-by-1 DataMatrix object). The size (number of rows and columns), row names, and column names for `DMObjNew` are the same as `DMObj1`, unless `DMObj1` is a scalar; then they are the same as `DMObj2`.

```DMObjNew = times(DMObj1, B)``` or the equivalent `DMObjNew = DMObj1 .* B` performs an element-by-element multiplication of the DataMatrix object `DMObj1` and `B`, a numeric or logical array, and places the results in `DMObjNew`, another DataMatrix object. `DMObj1` and `B` must have the same size (number of rows and columns), unless `B` is a scalar. The size (number of rows and columns), row names, and column names for `DMObjNew` are the same as `DMObj1`.

```DMObjNew = times(B, DMObj1)``` or the equivalent `DMObjNew = B .* DMObj1` performs an element-by-element multiplication of `B`, a numeric or logical array, and the DataMatrix object `DMObj1`, and places the results in `DMObjNew`, another DataMatrix object. `DMObj1` and `B` must have the same size (number of rows and columns), unless `B` is a scalar. The size (number of rows and columns), row names, and column names for `DMObjNew` are the same as `DMObj1`.

Note

Arithmetic operations between a scalar DataMatrix object and a nonscalar array are not supported.

MATLAB calls ```DMObjNew = times(X, Y)``` for the syntax `DMObjNew = X .* Y` when `X` or `Y` is a DataMatrix object.

## Version History

Introduced in R2008b