Accelerating the pace of engineering and science

# times

Element-by-element multiplication of fi objects

## Description

example

C =A.*B performs element-by-element multiplication of A and B, and returns the result in C.

C = times(A, B) is an alternate way to execute A.*B.

## Examples

expand all

### Multiply a fi Object by a Scalar

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.

### Multiply Two fi Objects

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

expand all

### A — Input arrayscalar | vector | matrix | multidimensional array

Input array, specified as a scalar, vector, matrix, or multidimensional array of fi objects or built-in types. A and B must have the same dimensions unless one is a scalar value.

Data Types: fi |single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Complex Number Support: Yes

### B — Input arrayscalar | vector | matrix | multidimensional array

Input array, specified as a scalar, vector, matrix, or multidimensional array of fi objects or built-in types. A and B must have the same dimensions unless one is a scalar value.

Data Types: fi |single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Complex Number Support: Yes

## Output Arguments

expand all

### C — Output arrayscalar | vector | matrix | multidimensional array

Output array, specified as a scalar, vector, matrix or multidimensional array.

## See Also

Was this topic helpful?