Namespaces
Variants
Views
Actions

Difference between revisions of "cpp/utility/functional/bit not"

From cppreference.com
< cpp‎ | utility‎ | functional
m (Notes)
m (hide (until C++11) notion - this class template is since C++14.)
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 | 1=
+
{{dcl|since=c++14|1=
 
template< class T = void >
 
template< class T = void >
 
struct bit_not;
 
struct bit_not;
Line 14: Line 14:
 
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}}
  
Line 21: Line 21:
 
===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}}
 
{{dsc end}}
 
{{dsc end}}
  
{{member | {{small|std::bit_not::}}operator() | 2=
+
{{member|{{small|std::bit_not::}}operator()|2=
 
{{dcl begin}}
 
{{dcl begin}}
 
{{dcl|
 
{{dcl|
Line 35: Line 35:
 
===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 44: Line 44:
  
 
===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;

Revision as of 12:40, 10 February 2023

 
 
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 = void >
struct bit_not;
(since C++14)

Function object for performing bitwise NOT. Effectively calls operator~ on type T.

Contents

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.

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

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

(until C++11)

Member functions

operator()
returns the result of bitwise NOT of its argument
(public member function)

std::bit_not::operator()

constexpr T operator()( const T& arg ) const;

Returns the result of bitwise NOT of arg.

Parameters

arg - value to compute bitwise NOT of

Return value

The result of ~arg.

Exceptions

May throw implementation-defined exceptions.

Possible implementation

constexpr T operator()(const T& arg) const
{
    return ~arg;
}

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.