Main Content

power, .^

Fixed-point element-wise power

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

See Also

|

Introduced in R2010a