# times, .*

Element-by-element multiplication of `fi` objects

## Syntax

``C = A.*B``
``C = times(A,B)``

## Description

example

````C = A.*B` performs element-by-element multiplication of `A` and `B`, and returns the result in `C`.`times` does not support `fi` objects of data type `boolean`.```
````C = times(A,B)` is an alternate way to execute `A.*B`. ```

## Examples

collapse all

Use the `times` function to perform element-by-element multiplication of a `fi` object and a scalar.

```a=4; b=fi([2 4 7; 9 0 2])```
```b = 2 4 7 9 0 2 DataTypeMode: Fixed-point: binary point scaling Signedness: Signed WordLength: 16 FractionLength: 11 ```

`a` is a scalar double, and `b` is a matrix of `fi` objects. When doing arithmetic between a `fi` and a double, the double is cast to a `fi` with the same word length and signedness of the `fi`, and best-precision fraction length. The result of the operation is a `fi`.

`c=a.*b`
```c = 8 16 28 36 0 8 DataTypeMode: Fixed-point: binary point scaling Signedness: Signed WordLength: 32 FractionLength: 23 ```

During the operation, `a` was cast to a `fi` object with wordlength 16. The output, `c`, is a `fi` object with word length 32, the sum of the word lengths of the two multiplicands, `a` and `b`. This is because the default setting of `ProductMode` in `fimath` is `FullPrecision`.

Use the `times` function to perform element-by-element multiplication of two `fi` objects.

`a=fi([5 9 9; 1 2 -3], 1, 16, 3)`
```a = 5 9 9 1 2 -3 DataTypeMode: Fixed-point: binary point scaling Signedness: Signed WordLength: 16 FractionLength: 3 ```
`b=fi([2 4 7; 9 0 2], 1, 16, 3)`
```b = 2 4 7 9 0 2 DataTypeMode: Fixed-point: binary point scaling Signedness: Signed WordLength: 16 FractionLength: 3 ```
`c=a.*b`
```c = 10 36 63 9 0 -6 DataTypeMode: Fixed-point: binary point scaling Signedness: Signed WordLength: 32 FractionLength: 6 ```

The word length and fraction length of `c` are equal to the sums of the word lengths and fraction lengths of `a` and `b`. This is because the default setting of `ProductMode` in `fimath` is `FullPrecision`.

## Input Arguments

collapse all

Input array, specified as a scalar, vector, matrix, or multidimensional array of `fi` objects or built-in data types. Inputs `A` and `B` must either be the same size or have sizes that are compatible. For more information, see Compatible Array Sizes for Basic Operations.

`times` does not support `fi` objects of data type `boolean`.

Data Types: `single` | `double` | `int8` | `int16` | `int32` | `int64` | `uint8` | `uint16` | `uint32` | `uint64` | `fi`
Complex Number Support: Yes

Input array, specified as a scalar, vector, matrix, or multidimensional array of `fi` objects or built-in data types. Inputs `A` and `B` must either be the same size or have sizes that are compatible. For more information, see Compatible Array Sizes for Basic Operations.

`times` does not support `fi` objects of data type `boolean`.

Data Types: `single` | `double` | `int8` | `int16` | `int32` | `int64` | `uint8` | `uint16` | `uint32` | `uint64` | `fi`
Complex Number Support: Yes

## Version History

Introduced before R2006a

expand all