std::is_null_pointer - cppreference.com
From cppreference.com
|
|
(since C++11) | |
std::is_null_pointer is a UnaryTypeTrait.
Checks whether T is the type std::nullptr_t.
Provides the member constant value that is equal to true, if T is the type std::nullptr_t, const std::nullptr_t, volatile std::nullptr_t, or const volatile std::nullptr_t.
Otherwise, value is equal to false.
If the program adds specializations for std::is_null_pointer or std::is_null_pointer_v(since C++17), the behavior is undefined.
Template parameters
Helper variable template
|
|
(since C++17) | |
Inherited from std::integral_constant
Member constants
true if T is the type std::nullptr_t (possibly cv-qualified), false otherwise (public static member constant) |
Member functions
converts the object to bool, returns value (public member function) | |
returns value (public member function) |
Member types
| Type | Definition |
value_type
|
bool
|
type
|
std::integral_constant<bool, value>
|
Possible implementation
template<class T> struct is_null_pointer : std::is_same<std::nullptr_t, std::remove_cv_t<T>> {};
Notes
std::is_pointer is false for std::nullptr_t because it is not a built-in pointer type.
In libc++, std::is_null_pointer is not available in C++11 mode.
| Feature-test macro | Value | Std | Feature |
|---|---|---|---|
__cpp_lib_is_null_pointer |
201309L |
(C++14) (DR11) |
std::is_null_pointer
|
Example
#include <type_traits> static_assert(std::is_null_pointer_v<decltype(nullptr)>); static_assert(!std::is_null_pointer_v<int*>); static_assert(!std::is_pointer_v<decltype(nullptr)>); static_assert(std::is_pointer_v<int*>); int main() { }
Defect reports
The following behavior-changing defect reports were applied retroactively to previously published C++ standards.
| DR | Applied to | Behavior as published | Correct behavior |
|---|---|---|---|
| LWG 2247 | C++11 | the type trait for detecting std::nullptr_t was missing | added |
See also
(C++11) |
checks if a type is void (class template) [edit] |
(C++11) |
checks if a type is an array type (class template) [edit] |
(C++11) |
checks if a type is a pointer type (class template) [edit] |
(C++11) |
checks if a type is an enumeration type (class template) [edit] |
(C++11) |
checks if a type is a union type (class template) [edit] |
(C++11) |
checks if a type is a non-union class type (class template) [edit] |
(C++11) |
checks if a type is a function type (class template) [edit] |
(C++11) |
checks if a type is an object type (class template) [edit] |