Difference between revisions of "cpp/utility/functional/bit not"
From cppreference.com
< cpp | utility | functional
m (deprecated typedefs) |
Andreas Krug (Talk | contribs) m ({{c}}) |
||
| (11 intermediate revisions by 4 users not shown) | |||
| Line 2: | Line 2: | ||
{{cpp/utility/functional/navbar}} | {{cpp/utility/functional/navbar}} | ||
{{dcl begin}} | {{dcl begin}} | ||
| − | {{dcl header | functional }} | + | {{dcl header|functional}} |
| − | {{dcl | since=c++14 | | + | {{dcl|since=c++14|1= |
| − | template< class T | + | template< class T = void > |
struct bit_not; | struct bit_not; | ||
}} | }} | ||
| Line 12: | Line 12: | ||
===Specializations=== | ===Specializations=== | ||
| − | |||
| − | |||
The standard library provides a specialization of {{tt|std::bit_not}} 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::bit_not}} 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 bit_not_void}} | + | {{dsc inc|cpp/utility/functional/dsc bit_not_void}} |
{{dsc end}} | {{dsc end}} | ||
| − | |||
| − | |||
| − | + | {{cpp/utility/functional/member types|result=T|arg1=T|inherit=no}} | |
| − | {{ | + | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
===Member functions=== | ===Member functions=== | ||
{{dsc begin}} | {{dsc begin}} | ||
| − | {{dsc mem fun | operator() | nolink=true | returns the result of bitwise NOT of its argument}} | + | {{dsc mem fun|operator()|nolink=true|returns the result of bitwise NOT of its argument|notes={{mark c++14}}}} |
{{dsc end}} | {{dsc end}} | ||
| − | {{member | {{small|std::bit_not::}}operator() | 2= | + | {{member|{{small|std::bit_not::}}operator()|2= |
{{dcl begin}} | {{dcl begin}} | ||
| − | {{dcl| | + | {{dcl|since=c++14| |
constexpr T operator()( const T& arg ) const; | constexpr T operator()( const T& arg ) const; | ||
}} | }} | ||
{{dcl end}} | {{dcl end}} | ||
| − | Returns the result of bitwise NOT of {{ | + | Returns the result of bitwise NOT of {{c|arg}}. |
===Parameters=== | ===Parameters=== | ||
{{par begin}} | {{par begin}} | ||
| − | {{par | arg | value to compute bitwise NOT of}} | + | {{par|arg|value to compute bitwise NOT of}} |
{{par end}} | {{par end}} | ||
| Line 50: | Line 41: | ||
The result of {{c|~arg}}. | The result of {{c|~arg}}. | ||
| − | + | {{cpp/impldef exception}} | |
| − | + | ||
===Possible implementation=== | ===Possible implementation=== | ||
| − | {{eq fun | 1= | + | {{eq fun|1= |
| − | constexpr T operator()(const T& arg) const | + | constexpr T operator()(const T& arg) const |
{ | { | ||
return ~arg; | return ~arg; | ||
| Line 62: | Line 52: | ||
}} | }} | ||
| − | + | ===Notes=== | |
| − | + | Although {{tt|std::bit_not}} is added via post-C++11 proposal {{wg21|N3421}}, it is treated as a part of the resolution for {{lwg|660}} (except for its transparent specialization {{rlpt|bit_not void|std::bit_not<>}}) by common implementations, and thus available in their C++98/03 mode. | |
| − | + | ||
| − | + | {{langlinks|de|es|fr|it|ja|pt|ru|zh}} | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
Latest revision as of 05:43, 12 August 2023
| Defined in header <functional>
|
||
| template< class T = void > struct bit_not; |
(since C++14) | |
Function object for performing bitwise NOT. Effectively calls operator~ on type T.
Contents |
[edit] Specializations
The standard library provides a specialization of std::bit_not when T is not specified, which leaves the parameter types and return type to be deduced.
| (C++14) |
function object implementing ~x deducing parameter and return types (class template specialization) |
[edit] Member types
| Type | Definition |
result_type (deprecated in C++17)(removed in C++20)
|
T
|
argument_type (deprecated in C++17)(removed in C++20)
|
T
|
[edit] Member functions
| operator() (C++14) |
returns the result of bitwise NOT of its argument (public member function) |
std::bit_not::operator()
| constexpr T operator()( const T& arg ) const; |
(since C++14) | |
Returns the result of bitwise NOT of arg.
Parameters
| arg | - | value to compute bitwise NOT of |
Return value
The result of ~arg.
[edit] Exceptions
May throw implementation-defined exceptions.
Possible implementation
constexpr T operator()(const T& arg) const { return ~arg; } |
[edit] Notes
Although std::bit_not is added via post-C++11 proposal N3421, it is treated as a part of the resolution for LWG issue 660 (except for its transparent specialization std::bit_not<>) by common implementations, and thus available in their C++98/03 mode.
