Namespaces
Variants
Views
Actions

Difference between revisions of "cpp/utility/functional/modulus"

From cppreference.com
< cpp‎ | utility‎ | functional
m (forgot c++14 in the declaration)
m (~)
 
(7 intermediate revisions by 5 users not shown)
Line 3: Line 3:
  
 
{{dcl begin}}
 
{{dcl begin}}
{{dcl header | functional }}
+
{{dcl header|functional}}
 
{{dcl rev begin}}
 
{{dcl rev begin}}
{{dcl | until=c++14 |
+
{{dcl|until=c++14|
 
template< class T >
 
template< class T >
 
struct modulus;
 
struct modulus;
 
}}
 
}}
{{dcl | since=c++14 |
+
{{dcl|since=c++14|
 
template< class T {{=}} void >
 
template< class T {{=}} void >
 
struct modulus;
 
struct modulus;
Line 20: Line 20:
 
===Specializations===
 
===Specializations===
 
{{rev begin}}
 
{{rev begin}}
{{rev | since=c++14 |
+
{{rev|since=c++14|
 
The standard library provides a specialization of {{tt|std::modulus}} when {{tt|T}} is not specified, which leaves the parameter types and return type to be deduced.
 
The standard library provides a specialization of {{tt|std::modulus}} when {{tt|T}} is not specified, which leaves the parameter types and return type to be deduced.
 
{{dsc begin}}
 
{{dsc begin}}
{{dsc inc | cpp/utility/functional/dsc modulus_void}}
+
{{dsc inc|cpp/utility/functional/dsc modulus_void}}
 
{{dsc end}}
 
{{dsc end}}
 
}}
 
}}
 
{{rev end}}
 
{{rev end}}
  
===Member types===
+
{{cpp/utility/functional/member types|result=T|arg1=T|arg2=T}}
{{dsc begin}}
+
{{dsc hitem | Type | Definition }}
+
{{dsc | {{tt|result_type}} | {{tt|T}}}}
+
{{dsc | {{tt|first_argument_type}} | {{tt|T}} }}
+
{{dsc | {{tt|second_argument_type}} | {{tt|T}} }}
+
{{dsc end}}
+
  
 
===Member functions===
 
===Member functions===
 
{{dsc begin}}
 
{{dsc begin}}
{{dsc mem fun | operator() | nolink=true | returns the remainder from the division of the first argument by the second argument}}
+
{{dsc mem fun|operator()|nolink=true|returns the remainder from the division of the first argument by the second argument}}
 
{{dsc end}}
 
{{dsc end}}
  
{{member | {{small|std::modulus::}}operator() | 2=
+
{{member|{{small|std::modulus::}}operator()|2=
 
{{dcl begin}}
 
{{dcl begin}}
{{dcl rev begin}}
+
{{dcla|constexpr=c++14|1=
{{dcl |until=c++14|
+
 
T operator()( const T& lhs, const T& rhs ) const;
 
T operator()( const T& lhs, const T& rhs ) const;
 
}}
 
}}
{{dcl |since=c++14|
 
constexpr T operator()( const T& lhs, const T& rhs ) const;
 
}}
 
{{dcl rev end}}
 
 
{{dcl end}}
 
{{dcl end}}
  
Returns the remainder of the division of {{tt|lhs}} by {{tt|rhs}}.
+
Returns the remainder of the division of {{c|lhs}} by {{c|rhs}}.
  
 
===Parameters===
 
===Parameters===
 
{{par begin}}
 
{{par begin}}
{{par | lhs, rhs | values to divide one by another}}
+
{{par|lhs, rhs|values to divide one by another}}
 
{{par end}}
 
{{par end}}
  
Line 63: Line 52:
 
The result of {{c|lhs % rhs}}.
 
The result of {{c|lhs % rhs}}.
  
===Exceptions===
+
{{cpp/impldef exception}}
(none)
+
  
 
===Possible implementation===
 
===Possible implementation===
{{eq fun | 1=
+
{{eq fun|1=
constexpr T operator()(const T &lhs, const T &rhs) const  
+
constexpr T operator()(const T& lhs, const T& rhs) const  
 
{
 
{
 
     return lhs % rhs;
 
     return lhs % rhs;
Line 75: Line 63:
 
}}
 
}}
  
[[de:cpp/utility/functional/modulus]]
+
===See also===
[[es:cpp/utility/functional/modulus]]
+
{{dsc begin}}
[[fr:cpp/utility/functional/modulus]]
+
{{dsc inc|cpp/numeric/math/dsc fmod}}
[[it:cpp/utility/functional/modulus]]
+
{{dsc inc|cpp/numeric/math/dsc remainder}}
[[ja:cpp/utility/functional/modulus]]
+
{{dsc end}}
[[pt:cpp/utility/functional/modulus]]
+
 
[[ru:cpp/utility/functional/modulus]]
+
{{langlinks|de|es|fr|it|ja|pt|ru|zh}}
[[zh:cpp/utility/functional/modulus]]
+

Latest revision as of 21:10, 13 July 2024

 
 
Utilities library
General utilities
Relational operators (deprecated in C++20)
 
Function objects
Function invocation
(C++17)(C++23)
Identity function object
(C++20)
Transparent operator wrappers
(C++14)
(C++14)
(C++14)
(C++14)  
(C++14)
(C++14)
(C++14)
(C++14)
(C++14)
(C++14)
(C++14)
(C++14)
(C++14)

Old binders and adaptors
(until C++17*)
(until C++17*)
(until C++17*)
(until C++17*)  
(until C++17*)
(until C++17*)(until C++17*)(until C++17*)(until C++17*)
(until C++20*)
(until C++20*)
(until C++17*)(until C++17*)
(until C++17*)(until C++17*)

(until C++17*)
(until C++17*)(until C++17*)(until C++17*)(until C++17*)
(until C++20*)
(until C++20*)
 
Defined in header <functional>
template< class T >
struct modulus;
(until C++14)
template< class T = void >
struct modulus;
(since C++14)

Function object for computing remainders of divisions. Implements operator% for type T.

Contents

[edit] Specializations

The standard library provides a specialization of std::modulus when T is not specified, which leaves the parameter types and return type to be deduced.

function object implementing x % y deducing parameter and return types
(class template specialization) [edit]
(since C++14)

[edit] Member types

Type Definition
result_type (deprecated in C++17)(removed in C++20) T
first_argument_type (deprecated in C++17)(removed in C++20) T
second_argument_type (deprecated in C++17)(removed in C++20) T

These member types are obtained via publicly inheriting std::binary_function<T, T, T>.

(until C++11)

[edit] Member functions

operator()
returns the remainder from the division of the first argument by the second argument
(public member function)

std::modulus::operator()

T operator()( const T& lhs, const T& rhs ) const;
(constexpr since C++14)

Returns the remainder of the division of lhs by rhs.

Parameters

lhs, rhs - values to divide one by another

Return value

The result of lhs % rhs.

[edit] Exceptions

May throw implementation-defined exceptions.

Possible implementation

constexpr T operator()(const T& lhs, const T& rhs) const 
{
    return lhs % rhs;
}

[edit] See also

(C++11)(C++11)
remainder of the floating point division operation
(function) [edit]
(C++11)(C++11)(C++11)
signed remainder of the division operation
(function) [edit]