negate

Category: functors		Component type: type

Description

Negate<T> is a functors. Specifically, it is an AdaptableUnaryFunction. If f is an object of class negate<T> and x is an object of class T, then f(x) returns -x.

Example

Each element in V2 will be the negative (additive inverse) of the corresponding element in V1.

const int N = 1000;
Vector<double> V1(N);
Vector<double> V2(N);

iota(V1.begin(), V1.end(), 1);

assert(V2.size() >= V1.size());
transform(V1.begin(), V1.end(), V2.begin(),
          negate<int>());

Definition

Defined in the standard header functional, and in the nonstandard backward-compatibility header function.h.

Template parameters

Parameter	Description	Default
T	The function object's argument type and result type.

Model of

AdaptableUnaryFunction, DefaultConstructible

Type requirements

T must be a numeric type; if x is an object of type T, then -x must be defined and must have a return type that is convertible to T. T must be Assignable.

Public base classes

unary_function<T, T>

Members

Member	Where defined	Description
argument_type	AdaptableUnaryFunction	The type of the second argument: T
result_type	AdaptableUnaryFunction	The type of the result: T
T operator()(const T& x)	AdaptableUnaryFunction	Function call operator. The return value is -x.
negate()	DefaultConstructible	The default constructor.

New members

All of negate's members are defined in the AdaptableUnaryFunction and DefaultConstructible requirements. Negate does not introduce any new members.

Notes

See also

The functors overview, AdaptableUnaryFunction, unary_function, plus, minus, multiplies, divides, modulus