[#bsl-shared_ptr-0a-load-06] = xref:bsl.adoc[bsl]::xref:bsl/shared_ptr-0a.adoc[shared_ptr]::load :relfileprefix: ../../ :mrdocs: `load` overloads == Synopses Declared in `<bslstl_sharedptr.h>` Modify this shared pointer to manage the modifiable object of the (template parameter) type `COMPATIBLE_TYPE` at the specified `ptr` address and to refer to `(ELEMENT_TYPE *)ptr`. If this shared pointer is already managing a (possibly shared) object, then, unless an exception is thrown allocating memory to manage `ptr`, release the reference to the shared object, calling the associated deleter to destroy the shared object if this shared pointer is the last reference. The currently installed default allocator is used to allocate the internal representation of this shared pointer, and the shared object will be destroyed by a call to `delete ptr` when all references have been released. If an exception is thrown allocating the internal representation, then `delete ptr` is called and this shared pointer retains ownership of its original object. If `COMPATIBLE_TYPE*` is not implicitly convertible to `ELEMENT_TYPE*`, then a compiler diagnostic will be emitted indicating the error. Note that if `ptr` is 0, then this shared pointer will still allocate an internal representation to share ownership of that empty state, which will be reclaimed when the last reference is destroyed. Also note also that the behavior of this method is the same as `reset(ptr)`. [source,cpp,subs="verbatim,replacements,macros,-callouts"] ---- template<class COMPATIBLE_TYPE> void xref:bsl/shared_ptr-0a/load-0b.adoc[load](COMPATIBLE_TYPE* ptr); ---- [.small]#xref:bsl/shared_ptr-0a/load-0b.adoc[_» more..._]# Modify this shared pointer to manage the modifiable object of the (template parameter) type `COMPATIBLE_TYPE` at the specified `ptr` address and to refer to `(ELEMENT_TYPE *)ptr`. If this shared pointer is already managing a (possibly shared) object, then, unless an exception is thrown allocating memory to manage `ptr`, release the reference to the shared object, calling the associated deleter to destroy the shared object if this shared pointer is the last reference. Use the specified `basicAllocator` to allocate the internal representation of this shared pointer and to destroy the shared object when all references have been released; if `basicAllocator` is 0, the currently installed default allocator is used. If an exception is thrown allocating the internal representation, then destroy `*ptr` with a call to `alloc‐>deleteObject(ptr)` where `alloc` is the chosen allocator, and this shared pointer retains ownership of its original object. If `COMPATIBLE_TYPE *` is not implicitly convertible to `ELEMENT_TYPE *`, then a compiler diagnostic will be emitted indicating the error. Note that if `ptr` is 0, then this shared pointer will still allocate an internal representation to share ownership of that empty state, which will be reclaimed when the last reference is destroyed. Also note that this function is logically equivalent to: ` *this = shared_ptr<ELEMENT_TYPE>(ptr, basicAllocator); ` [source,cpp,subs="verbatim,replacements,macros,-callouts"] ---- template<class COMPATIBLE_TYPE> void xref:bsl/shared_ptr-0a/load-00.adoc[load]( COMPATIBLE_TYPE* ptr, xref:BloombergLP/bslma/Allocator.adoc[BloombergLP::bslma::Allocator]* basicAllocator); ---- [.small]#xref:bsl/shared_ptr-0a/load-00.adoc[_» more..._]# Modify this shared pointer to manage the modifiable object of the (template parameter) type `COMPATIBLE_TYPE` at the specified `ptr` address, refer to `(ELEMENT_TYPE *)ptr` and use the specified `deleter` to delete the shared object when all references have been released. Use the specified `basicAllocator` to allocate and deallocate the internal representation of the shared pointer. If `basicAllocator` is 0, the currently installed default allocator is used. If this shared pointer is already managing a (possibly shared) object, then, unless an exception is thrown creating storage to manage `ptr`, release the shared reference to that shared object, and destroy it using its associated deleter if this shared pointer held the last shared reference to that object. If `DELETER` is a reference type, then `deleter` is assumed to be a function‐like deleter that may be invoked to destroy the object referred to by a single argument of type `COMPATIBLE_TYPE *` (i.e., `deleter(ptr)` will be called to destroy the shared object). If `DELETER` is a pointer type, then `deleter` is assumed to be a pointer to a factory object that exposes a member function that can be invoked as `deleteObject(ptr)` that will be called to destroy the object at the `ptr` address (i.e., `deleter‐>deleteObject(ptr)` will be called to delete the shared object). (See the "Deleters" section in the component‐level documentation.) If an exception is thrown allocating the internal representation, then `deleter(ptr)` is called (or `deleter‐>deleteObject(ptr)` for factory‐type deleters) and this shared pointer retains ownership of its original object. The behavior is undefined unless `deleter(ptr)` is a well‐defined expression (or `deleter‐>deleteObject(ptr)` for factory‐type deleters), and unless the copy constructor for `deleter` does not throw an exception. If `COMPATIBLE_TYPE *` is not implicitly convertible to `ELEMENT_TYPE *`, then a compiler diagnostic will be emitted indicating the error. Note that, for factory deleters, the `deleter` must remain valid until all references to `ptr` have been released. Also note that if `ptr` is 0, then an internal representation will still be allocated, and this shared pointer will share ownership of a copy of `deleter`. Further note that this function is logically equivalent to: ` *this = shared_ptr<ELEMENT_TYPE>(ptr, deleter, basicAllocator); ` [source,cpp,subs="verbatim,replacements,macros,-callouts"] ---- template< class COMPATIBLE_TYPE, class DELETER> void xref:bsl/shared_ptr-0a/load-0f.adoc[load]( COMPATIBLE_TYPE* ptr, DELETER const& deleter, xref:BloombergLP/bslma/Allocator.adoc[BloombergLP::bslma::Allocator]* basicAllocator); ---- [.small]#xref:bsl/shared_ptr-0a/load-0f.adoc[_» more..._]# [.small]#Created with https://www.mrdocs.com[MrDocs]#