# power, .^

Fixed-point element-wise power

## Syntax

``C = A.^B``
``C = power(A, B)``

## Description

example

````C = A.^B` raises each element of `A` to the corresponding power in `B`.```
````C = power(A, B)` is an alternative way to compute `A.^B`.```

## Examples

collapse all

Create a fixed-point matrix and raise it to a scalar power.

`A = fi([1, 3; 4, 2])`
```A=2×2 object 1 3 4 2 DataTypeMode: Fixed-point: binary point scaling Signedness: Signed WordLength: 16 FractionLength: 12 ```
`C = A.^3`
```C=2×2 object 1 27 64 8 DataTypeMode: Fixed-point: binary point scaling Signedness: Signed WordLength: 48 FractionLength: 36 ```

## Input Arguments

collapse all

Base, specified as a scalar, vector, matrix, or multidimensional array. Inputs `A` and `B` must either be the same size or have sizes that are compatible (for example, `A` is an M-by-N matrix and `B` is a scalar or 1-by-N row vector).

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

Exponent, specified as a non-negative, real, integer-valued scalar, vector, matrix, or multidimensional array. Inputs `A` and `B` must either be the same size or have sizes that are compatible (for example, `A` is an M-by-N matrix and `B` is a scalar or 1-by-N row vector).

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

## Output Arguments

collapse all

Power, returned as an array with the same dimensions as the input `A`. When `A` has a local `fimath` object, the output `C` also has the same local `fimath` object. The array power operation is always performed using the default `fimath` settings.

## Extended Capabilities 