# pow2

## Purpose

Scale floating-point numbers.

## Synopsis

    X = pow2(Y)
    X = pow2(F,E)

## Description

`X = pow2(Y)` returns a matrix `X` whose elements are the corresponding elements of `Y` raised to the power 2. `Y` can also be a vector or a scalar.

`X = pow2(F,E)`, for a real matrix `F` and a matrix of integers `E`, computes `X(i,j) = F(i,j).`*`(2.^E(i,j))`. The result is computed quickly by simply adding `E` to the floating-point exponent of `F`.

This function corresponds to the ANSI C function `ldexp()` and the IEEE floating-point standard function `scalbn()`.

## Examples

For IEEE arithmetic, the statement `X = pow2(F,E)` yields the following values:

        F         E        X

        1/2       1        1
        pi/4      2        pi
        -3/4      2        -3
        1/2       -51      eps
        1-eps/2   1024     realmax
        1/2       -1021    realmin

## See Also

    ^, .^, exp, hex2num, log2, realmax, realmin

(c) Copyright 1994 by The MathWorks, Inc.