[#BloombergLP-bslstl-SharedPtrAllocateOutofplaceRep]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bslstl.adoc[bslstl]::SharedPtrAllocateOutofplaceRep
:relfileprefix: ../../
:mrdocs:

Out‐of‐place concrete implementation of the `SharedPtrRep` protocol.

== Synopsis

Declared in `<bslstl_sharedptrallocateoutofplacerep.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<
    class TYPE,
    class DELETER,
    class ALLOCATOR>
class SharedPtrAllocateOutofplaceRep
    : public xref:BloombergLP/bslma/SharedPtrRep.adoc[BloombergLP::bslma::SharedPtrRep]
----

== Description

This class provides a concrete implementation of the `SharedPtrRep` protocol for out‐of‐place instances of the parameterized `TYPE`. Upon destruction of this object, the parameterized `DELETER` type is invoked on the pointer to the shared object.

== Base Classes

[cols="1,4"]
|===
| Name| Description
| `xref:BloombergLP/bslma/SharedPtrRep.adoc[BloombergLP::bslma::SharedPtrRep]`
| Partially implemented shared pointer representation protocol.
|===

== Member Functions

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/bslma/SharedPtrRep/acquireRef.adoc[`acquireRef`] 
| Atomically acquire a shared reference to the shared object referred to by this representation. The behavior is undefined unless `0 < numReferences()`.
| xref:BloombergLP/bslma/SharedPtrRep/acquireWeakRef.adoc[`acquireWeakRef`] 
| Atomically acquire a weak reference to the shared object.
| xref:BloombergLP/bslstl/SharedPtrAllocateOutofplaceRep/disposeObject.adoc[`disposeObject`]  [.small]#[virtual]#
| Destroy the object referred to by this representation.
| xref:BloombergLP/bslstl/SharedPtrAllocateOutofplaceRep/disposeRep.adoc[`disposeRep`]  [.small]#[virtual]#
| Destroy this representation and deallocate its memory.
| xref:BloombergLP/bslstl/SharedPtrAllocateOutofplaceRep/getDeleter.adoc[`getDeleter`]  [.small]#[virtual]#
| Return a pointer to the stored deleter if it matches `type`.
| xref:BloombergLP/bslma/SharedPtrRep/hasUniqueOwner.adoc[`hasUniqueOwner`] 
| Return `true` if there is only one shared reference and no weak references to the object referred to by this representation, and `false` otherwise.
| xref:BloombergLP/bslma/SharedPtrRep/incrementRefs.adoc[`incrementRefs`] 
| Atomically increment the number of shared references.
| xref:BloombergLP/bslma/SharedPtrRep/numReferences.adoc[`numReferences`] 
| Return a "snapshot" of the current number of shared references to the shared object referred to by this representation object.
| xref:BloombergLP/bslma/SharedPtrRep/numWeakReferences.adoc[`numWeakReferences`] 
| Return a "snapshot" of the current number of weak references to the shared object referred to by this representation object.
| xref:BloombergLP/bslstl/SharedPtrAllocateOutofplaceRep/originalPtr.adoc[`originalPtr`]  [.small]#[virtual]#
| Return the (untyped) address of the modifiable shared object to which this object refers.
| xref:BloombergLP/bslstl/SharedPtrAllocateOutofplaceRep/ptr.adoc[`ptr`] 
| Return the address of the modifiable shared object to which this object refers.
| xref:BloombergLP/bslma/SharedPtrRep/releaseRef.adoc[`releaseRef`] 
| Atomically release a shared reference to the shared object.
| xref:BloombergLP/bslma/SharedPtrRep/releaseWeakRef.adoc[`releaseWeakRef`] 
| Atomically release a weak reference to the shared object.
| xref:BloombergLP/bslma/SharedPtrRep/resetCountsRaw.adoc[`resetCountsRaw`] 
| Reset the shared and weak reference counts to the specified values.
| xref:BloombergLP/bslma/SharedPtrRep/tryAcquireRef.adoc[`tryAcquireRef`] 
| Try to atomically acquire a shared reference to the shared object.
|===


== Static Member Functions

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/bslstl/SharedPtrAllocateOutofplaceRep/makeOutofplaceRep.adoc[`makeOutofplaceRep`] 
| Create a new out‐of‐place shared‐pointer representation.
| xref:BloombergLP/bslma/SharedPtrRep/managedPtrDeleter.adoc[`managedPtrDeleter`] 
| Release the shared reference held by the specified representation.
| xref:BloombergLP/bslma/SharedPtrRep/managedPtrEmptyDeleter.adoc[`managedPtrEmptyDeleter`] 
| Deleter that has no effect when converting a null shared pointer.
|===



[.small]#Created with https://www.mrdocs.com[MrDocs]#