OptiVec: VF

VF_ipow

VD_ipow

VE_ipow

VFx_ipow

VDx_ipow

VEx_ipow

VFu_ipow

VDu_ipow

VEu_ipow

VFux_ipow

VDux_ipow

VEux_ipow

VCF_ipow

VCD_ipow

VCE_ipow

VCFx_ipow

VCDx_ipow

VCEx_ipow

VCFu_ipow

VCDu_ipow

VCEu_ipow

VCFux_ipow

VCDux_ipow

VCEux_ipow

VPF_ipow

VPD_ipow

VPE_ipow

VPFu_ipow

VPDu_ipow

VPEu_ipow

Function

Raise each element of a vector to a specified integer power.

Syntax C/C++	#include <VFmath.h> int VF_ipow( fVector Y, fVector X, ui size, int Expo ); int VFx_ipow( fVector Y, fVector X, ui size, int Expo, float A, float B, float C ); int VFu_ipow( fVector Y, fVector X, ui size, int Expo ); int VFux_ipow( fVector Y, fVector X, ui size, int Expo, float A, float B, float C );
C++ VecObj	#include <OptiVec.h> int vector<T>::ipow( const vector<T>& X ); int vector<T>::x_ipow( const vector<T>& X, const T& A, const T& B, const T& C ); int vector<T>::u_ipow( const vector<T>& X ); int vector<T>::ux_ipow( const vector<T>& X, const T& A, const T& B, const T& C );
Pascal/Delphi	uses VFmath; function VF_ipow( Y, X:fVector; size:UIntSize; ipow:Integer ): IntBool; function VFx_ipow( Y, X:fVector; size:UIntSize; ipow:Integer; A, B, C:Single ): IntBool; function VFu_ipow( Y, X:fVector; size:UIntSize; ipow:Integer ): IntBool; function VFux_ipow( Y, X:fVector; size:UIntSize; ipow:Integer; A, B, C:Single ): IntBool;

Description

normal versions: Y_i = X_i^Expo
expanded versions: Y_i = C * (A*X_i+B)^Expo
If Expo is larger than a data-type dependent threshold (which will be a very rare occasion), VF_ipow does not calculate the result itself, but calls VF_pow, which is safer and faster in this case.
The "unprotected" versions (prefix VFu_ and VFux_) do not perform any error handling and do not redirect calls to VF_pow. These simplifications make them very fast, but also risky; they should be used very carefully.

Error handling

SING errors occur, if zero is raised to a negative power; the default result is ±HUGE_VAL, as in the case of OVERFLOW errors.

Return value

FALSE (0), if no error occurred, otherwise TRUE (non-zero)