Previous fileTop of DocumentContentsIndex pageNext file
Apache C++ Standard Library Reference Guide


Library:  General utilities

Does not inherit

Local Index

No Entries


Unary function object that returns the negation of its argument


#include <functional>

namespace std {
  template <class T>
  struct negate : public unary_function<T, T>;


negate is a unary function object. Its operator() returns the inverse of its argument. For boolean arguments, operator() returns true if its argument is false, or false if its argument is true. For numeric arguments, operator() returns the additive inverse of the argument. You can pass a negate object to any algorithm that requires a unary function. For example, the transform() algorithm applies a unary operation to the values in a collection and stores the result. negate could be used in that algorithm in the following manner:

After this call to transform(), vecResult(n) contains the negation of the element in vec1(n).


See Also

Function Objects, unary_function

Standards Conformance

ISO/IEC 14882:1998 -- International Standard for Information Systems -- Programming Language C++, Section 20.3.5

Previous fileTop of DocumentContentsIndex pageNext file