scalbnf4

NAME

scalbnf4 - return float elements multiplied by integral power of 2

SYNOPSIS

Procedure call syntax:

#include <simdmath.h>
vector float scalbnf4(vector float x, vector signed int n);
Link with -lsimdmath

Inline call syntax:

#include <simdmath.h>
#include <scalbnf4.h>
vector float _scalbnf4(vector float x, vector signed int n);
Parameters  
x input vector
n scale factor

DESCRIPTION

The scalbnf4 function returns a vector containing each element of x multiplied by 2^n computed efficiently. This function is computed without the assistance of any floating point operations and as such does not set any floating point exceptions.

RETURN VALUE

The function scalbnf4 returns a float vector in which each element is defined as:
  • the corresponding element of x multiplied by 2^n.
  • If the exponent is 0 then either x is 0 or x is a subnormal, and the result will be returned as 0.
  • If the result underflows it will be returned as 0.
  • If the result overflows it will be returned as FLT_MAX.

ENVIRONMENT

SPU and PPU

CONFORMING TO

SIMD Math library specification for the Cell Broadband Engine™ Architecture.

NOTES

Basis

ISO9899 (C99) scalbn functions.

SEE ALSO

scalbn(3), log2(3), log2d2(3), log2f4(3), cbrt(3), cbrtd2(3), cbrtf4(3), exp(3), expd2(3), expf4(3), exp2(3), exp2d2(3), exp2f4(3), frexp(3), frexpd2(3), frexpf4(3), hypot(3), hypotd2(3), ilogb(3), ilogbd2(3), ilogbf4(3), ldexp(3), ldexpd2(3), ldexpf4(3), log(3), logd2(3), logf4(3), log10(3), log10d2(3), log10f4(3), log1p(3), log1pd2(3), log1pf4(3), logb(3), logbf4(3), sqrt(3), sqrtd2(3), sqrtf4(3)