scale a number by a power of 10 - Maple Help

Online Help

All Products    Maple    MapleSim


Home : Support : Online Help : Mathematics : Numerical Computations : Maple Numerics : Functions : Scale10

Scale10 - scale a number by a power of 10

Scale2 - scale a number by a power of 2

Calling Sequence

Scale10(x, N)

Scale2(x, N)

Parameters

x

-

numeric type

N

-

integer

Description

• 

The Scale10(x, N) function returns x * 10^N.

  

The operation is carried out in the computation domain determined by x, and the result is a member of this computation domain. The UseHardwareFloats mode is not checked.

  

This function can signal either overflow or underflow.

  

If x is undefined, the result is x. If N is undefined, the result is undefined in the computation domain of x.

  

If x is a software floating-point number, Scale10(x,N) just adds N to the exponent of x (that is, no multiplication is required).

• 

The Scale2(x, N) function returns x * 2^N.

  

The operation is carried out in the computation domain determined by x, and the result is a member of this computation domain. The UseHardwareFloats mode is not checked.

  

This function can signal either overflow or underflow.

  

If x is undefined, the result is x. If N is undefined, the result is undefined in the computation domain of x.

• 

For special values, Scale2 returns the following results. Similar results are returned in the case of Scale10.

1.  Scale2(undefined, N) = undefined

the input undefined

2.  Scale2(x, undefined) = undefined

in the domain of x

3.  Scale2(0, infinity) = undefined

in the domain of the first argument; signals Invalid

4.  Scale2(x, infinity) = sgn(x)*infinity

no signal

5.  Scale2(+-infinity, -infinity) = undefined

in the domain of the first argument; signals Invalid

6.  Scale2(+-infinity, N) = +-infinity

 

7.  Scale2(x, -infinity) = sgn(x)*0

the 0 of the domain of x; no signal

Thread Safety

• 

The Scale10 and Scale2 commands are thread-safe as of Maple 15.

• 

For more information on thread safety, see index/threadsafe.

Examples

Scale100.5,1000

5.10999

(1)

Scale103+2I,20

300000000000000000000+200000000000000000000I

(2)

Scale102.,∞

Float∞

(3)

Scale20.5,1000

5.35754303510300

(4)

Scale23+2I,20

3145728+2097152I

(5)

Scale22.,∞

Float∞

(6)

See Also

exceptions, float, ilog10, ilog2, numeric_types


Download Help Document

Was this information helpful?



Please add your Comment (Optional)
E-mail Address (Optional)
What is ? This question helps us to combat spam