CARVIEW |
Select Language
HTTP/1.1 301 Moved Permanently
Server: nginx
Date: Thu, 24 Jul 2025 05:01:54 GMT
Content-Type: text/html; charset=UTF-8
Transfer-Encoding: chunked
Connection: keep-alive
Location: /reference/memory/pointer_traits/
HTTP/1.1 200 OK
Server: nginx
Date: Thu, 24 Jul 2025 05:01:55 GMT
Content-Type: text/html; charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
ETag: W/"8606-xkKCFzkd30dx2RxMenO7GNMDtRA"
Content-Encoding: gzip
This is a traits class to describe certain attributes of pointers and pointer-like classes.
The <memory> header provides both an unspecialized version (with default functionality for pointer-like classes), and a version specialized for pointer types (T*).
A pointer-like class is a class that simulates the behavior of a pointer. The unspecialized version of this template can be used for any pointer-like class that either has element_type as member type, or is a template instantiation of a class that uses the first template parameter to represent the pointed type. Additional requirements shall be met if members rebind and/or pointer_to are instantiated (see below).
If a pointer-like class lacks these requirements, this template class can still be custom specialized to provide a more specific functionality applicable to the type.
*Note: rebind is an alias template.
Output:
Reference
C library:
- <cassert> (assert.h)
- <cctype> (ctype.h)
- <cerrno> (errno.h)
-
<cfenv> (fenv.h)C++11
- <cfloat> (float.h)
-
<cinttypes> (inttypes.h)C++11
- <ciso646> (iso646.h)
- <climits> (limits.h)
- <clocale> (locale.h)
- <cmath> (math.h)
- <csetjmp> (setjmp.h)
- <csignal> (signal.h)
- <cstdarg> (stdarg.h)
-
<cstdbool> (stdbool.h)C++11
- <cstddef> (stddef.h)
-
<cstdint> (stdint.h)C++11
- <cstdio> (stdio.h)
- <cstdlib> (stdlib.h)
- <cstring> (string.h)
-
<ctgmath> (tgmath.h)C++11
- <ctime> (time.h)
-
<cuchar> (uchar.h)C++11
- <cwchar> (wchar.h)
- <cwctype> (wctype.h)
Containers:
-
<array>C++11
- <deque>
-
<forward_list>C++11
- <list>
- <map>
- <queue>
- <set>
- <stack>
-
<unordered_map>C++11
-
<unordered_set>C++11
- <vector>
-
Input/Output:
Multi-threading:
-
<atomic>C++11
-
<condition_variable>C++11
-
<future>C++11
-
<mutex>C++11
-
<thread>C++11
-
Other:
- <algorithm>
- <bitset>
-
<chrono>C++11
-
<codecvt>C++11
- <complex>
- <exception>
- <functional>
-
<initializer_list>C++11
- <iterator>
- <limits>
- <locale>
- <memory>
- <new>
- <numeric>
-
<random>C++11
-
<ratio>C++11
-
<regex>C++11
- <stdexcept>
- <string>
-
<system_error>C++11
-
<tuple>C++11
-
<type_traits>C++11
-
<typeindex>C++11
- <typeinfo>
- <utility>
- <valarray>
<memory>
classes
- allocator
-
allocator_arg_tC++11
-
allocator_traitsC++11
- auto_ptr
- auto_ptr_ref
-
bad_weak_ptrC++11
-
default_deleteC++11
-
enable_shared_from_thisC++11
-
owner_lessC++11
-
pointer_traitsC++11
- raw_storage_iterator
-
shared_ptrC++11
-
unique_ptrC++11
-
uses_allocatorC++11
-
weak_ptrC++11
enum classes
-
pointer_safetyC++11
-
functions
-
addressofC++11
-
alignC++11
-
allocate_sharedC++11
-
const_pointer_castC++11
-
declare_no_pointersC++11
-
declare_reachableC++11
-
dynamic_pointer_castC++11
-
get_deleterC++11
-
get_pointer_safetyC++11
- get_temporary_buffer
-
make_sharedC++11
- return_temporary_buffer
-
static_pointer_castC++11
-
undeclare_no_pointersC++11
-
undeclare_reachableC++11
- uninitialized_copy
-
uninitialized_copy_nC++11
- uninitialized_fill
- uninitialized_fill_n
-
objects
-
allocator_argC++11
-
pointer_traits
static member functions
class template
<memory>
std::pointer_traits
template <class Ptr> class pointer_traits; // templatetemplate <class T> class pointer_traits<T*>; // template specialization
Pointer traits
The <memory> header provides both an unspecialized version (with default functionality for pointer-like classes), and a version specialized for pointer types (T*).
A pointer-like class is a class that simulates the behavior of a pointer. The unspecialized version of this template can be used for any pointer-like class that either has element_type as member type, or is a template instantiation of a class that uses the first template parameter to represent the pointed type. Additional requirements shall be met if members rebind and/or pointer_to are instantiated (see below).
If a pointer-like class lacks these requirements, this template class can still be custom specialized to provide a more specific functionality applicable to the type.
Template parameters
- Ptr
- Pointer-like type.
- T
- Pointed type.
Member types
The following aliases are member types of pointer_traits:member type | interpretation | definition in unspecialized pointer_traits | definition in pointer_traits<T*> specialization |
---|---|---|---|
pointer | The pointer type | Template parameter Ptr | T* |
element_type | Type of pointed value | Either Ptr::element_type (if such type exists), or the first template argument used to instantiate Ptr (if Ptr is a class template instantiation). | T |
difference_type | Type resulting from subtracting two elements of type Ptr. | Ptr::difference_type (if such type exists), or std::ptrdiff_t otherwise. | std::ptrdiff_t |
rebind<V> | Type that rebinds to V | Either Ptr::rebind<V> (if such type exists), or an instantiation of the template used to instantiate Ptr, using V as first template parameter instead (if Ptr is a class template instantiation). | V* |
Member functions
- pointer_to
- Return pointer to (public static member function)
Example
|
|
Output:
foo: 1 bar: 2 |
Home page | Privacy policy
© cplusplus.com, 2000-2025 - All rights reserved - v3.3.4s
Spotted an error? contact us
© cplusplus.com, 2000-2025 - All rights reserved - v3.3.4s
Spotted an error? contact us