modulus 結構

預先定義的函式物件，在其自變數上執行模數除法運算 （operator%） 。

語法

template <class Type = void>
struct modulus : public binary_function <Type, Type, Type>
{
    Type operator()(const Type& Left, const Type& Right) const;
};

// specialized transparent functor for operator%
template <>
struct modulus<void>
{
  template <class T, class U>
  auto operator()(T&& Left, U&& Right) const
    -> decltype(std::forward<T>(Left) % std::forward<U>(Right));
};

參數

Type、 T、 U
支援 operator% 的任何類型，其接受指定或推斷類型的運算元。

Left
模數運算的左運算元。 未指定的範本會採用 Type 類型的左值參考自變數。 特製化範本會完美轉送推斷類型 T 的左值和右值參考自變數。

Right
模數運算的右運算元。 未指定的範本會採用 Type 類型的左值參考自變數。 特製化範本會完美轉送推斷類型 U 的左值和右值參考自變數。

傳回值

Left % Right 的結果。 此特製化的範本會完美地轉送結果，其具有 operator% 所傳回的類型。

備註

對於基本資料類型，modulus 函式僅限於整數類型，或會實作 operator% 的使用者定義類型。

範例

// functional_modulus.cpp
// compile with: /EHsc
#include <vector>
#include <functional>
#include <algorithm>
#include <iostream>

using namespace std;

int main( )
{
   vector <int> v1, v2, v3 ( 6 );
   vector <int>::iterator Iter1, Iter2, Iter3;

   int i;
   for ( i = 1 ; i <= 6 ; i++ )
   {
      v1.push_back( 5 * i );
   }

   int j;
   for ( j = 1 ; j <= 6 ; j++ )
   {
      v2.push_back( 3 * j );
   }

   cout << "The vector v1 = ( " ;
   for ( Iter1 = v1.begin( ) ; Iter1 != v1.end( ) ; Iter1++ )
      cout << *Iter1 << " ";
   cout << ")" << endl;

   cout << "The vector v2 = ( " ;
   for ( Iter2 = v2.begin( ) ; Iter2 != v2.end( ) ; Iter2++ )
      cout << *Iter2 << " ";
   cout << ")" << endl;

   // Finding the element-wise remainders of the elements of v1 & v2
   transform (v1.begin( ),  v1.end( ), v2.begin( ), v3.begin ( ),
      modulus<int>() );

   cout << "The element-wise remainders of the modular division\n are: ( " ;
   for ( Iter3 = v3.begin( ) ; Iter3 != v3.end( ) ; Iter3++ )
      cout << *Iter3 << " ";
   cout << ")" << endl;
}

The vector v1 = ( 5 10 15 20 25 30 )
The vector v2 = ( 3 6 9 12 15 18 )
The element-wise remainders of the modular division
are: ( 2 4 6 8 10 12 )