std::pointer_traits::pointer_to

 

C++

Language

Standard library headers

Concepts

Utilities library

Strings library

Containers library

Algorithms library

Iterators library

Numerics library

Input/output library

Localizations library

Regular expressions library (C++11)

Atomic operations library (C++11)

Thread support library (C++11)

Technical Specifications

 

Dynamic memory management

Smart pointers
unique_ptr (C++11)
shared_ptr (C++11)
weak_ptr (C++11)
auto_ptr (until C++17)
owner_less (C++11)
enable_shared_from_this (C++11)
bad_weak_ptr (C++11)
default_delete (C++11)
Allocators
allocator
allocator_traits (C++11)
allocator_arg_t (C++11)
allocator_arg (C++11)
uses_allocator (C++11)
scoped_allocator_adaptor (C++11)
Uninitialized storage
uninitialized_copy
uninitialized_copy_n (C++11)
uninitialized_fill
uninitialized_fill_n
raw_storage_iterator
get_temporary_buffer
return_temporary_buffer
Garbage collection support
declare_reachable (C++11)
undeclare_reachable (C++11)
declare_no_pointers (C++11)
undeclare_no_pointers (C++11)
pointer_safety (C++11)
get_pointer_safety (C++11)
Miscellaneous
pointer_traits (C++11)
addressof (C++11)
align (C++11)
C Library
malloc calloc	realloc free
Low level memory management

 

std::pointer_traits

Member functions

pointer_traits::pointer_to

 

Defined in header <memory>
static pointer pointer_to( element_type& r );	(1)	(since C++11) (member of pointer_traits<Ptr> specialization)
static pointer pointer_to( element_type& r );	(2)	(since C++11) (member of pointer_traits<T*> specialization)

Constructs a dereferenceable pointer to its argument.

1) The version of this function in the non-specialized std::pointer_traits template simply calls Ptr::pointer_to(r), and if Ptr does not provide a static member function pointer_to, instantiation of this function is a compile-time error.

2) The version of this function in the specialization of std::pointer_traits for pointer types returns std::addressof(r)

Parameters

r

-

reference to an object of type element_type&, except if element_type is void, in which case the type of r is unspecified

Return value

A dereferenceable pointer to r, of the type pointer_traits<>::pointer.

Exceptions

1) Unspecified (typically same as Ptr::pointer_to)

2)

noexcept specification:  

noexcept

  

Notes

The boost library version of this function returns pointer(std::addressof(r)) if Ptr::pointer_to does not exist.

See also

addressof (C++11)	obtains actual address of an object, even if the & operator is overloaded (function template)
address	obtains the address of an object, even if operator& is overloaded (public member function of std::allocator)