VMS Help
CXXLSTD, Function Objects, multiplies

 *Conan The Librarian

 			   Standard C++	Library
 		 Copyright 1996, Rogue Wave Software, Inc.

 NAME

   multiplies  -	A binary function object that returns the result of
   multiplying its first	and second arguments.

 SYNOPSIS

   #include<functional>

   template <class T>
   struct multiplies : binary_function<T, T, T> {
    typedef typename binary_function<T, T, T>::second_argument_type
 					      second_argument_type;
    typedef typename binary_function<T, T, T>::first_argument_type
 					      first_argument_type;
    typedef typename binary_function<T, T, T>::result_type result_type;
    T operator()	(const T&, const T&) const;
   };

 DESCRIPTION

   multiplies is	a binary function object.  Its operator() returns the
   result of multiplying x and y.  You can pass	a multiplies object to
   any algorithm that uses a binary function.	For example, the
   transform  algorithm applies a binary operation to	corresponding
   values in	two collections	and stores the result.	multiplies
   would be used  in that algorithm in the following manner:

   vector<int> vec1;
   vector<int> vec2;
   vector<int> vecResult;
   transform(vec1.begin(), vec1.end(),
 	    vec2.begin(), vec2.end(),
 	    vecResult.begin(), multiplies<int>());

   After	this call to transform,	vecResult(n) will contain vec1(n)
   times vec2(n).

 WARNING

   If your compiler does	not support default template parameters, then
   you need to always supply	the Allocator template argument.  For
   instance,	you will have to write :

   vector<int, allocator<int> >

   instead of :

   vector<int>

 SEE ALSO

   binary_function, function objects

 STANDARDS CONFORMANCE
   ANSI X3J16/ISO WG21 Joint C++	Committee
  Close     Help