OptiVec: VF

VF_neg

VD_neg

VE_neg

VCF_neg

VCD_neg

VCE_neg

VPF_neg

VPD_neg

VPE_neg

VI_neg

VBI_neg

VSI_neg

VLI_neg

VQI_neg

Function

Negation

Syntax C/C++	#include <VFmath.h> int VF_neg( fVector Y, fVector X, ui size );
C++ VecObj	#include <OptiVec.h> int vector<T>::neg( const vector<T>& X );
Pascal/Delphi	uses VFmath; function VF_neg( Y, X:fVector; size:UInt ): IntBool;

Description

Y_i = - (X_i)
VBI_, VSI_, VI_, and VLI_ versions only: the negation of the most negative number possible (-128 for byte/ByteInt, -32768 for short/SmallInt, -2147483648 for long/LongInt) is again the same - negative! - number. This is due to the implicit modulo-2ⁿ arithmetics, where the overflowing byte/ByteInt, +128, is stored as -128, the overflowing short/SmallInt, +32768, is stored as -32768, and the overflowing long/LongInt, +2147483648, is stored as -2147483648.

Error handling

none

Return value

By analogy with VF_abs, the floating-point versions are treated as math functions. Therefore, they have a return value which, since no errors can occur, is always FALSE (0). The integer versions have no return value.