[#BloombergLP-bsls-AtomicPointer-swapAcqRel]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bsls.adoc[bsls]::xref:BloombergLP/bsls/AtomicPointer.adoc[AtomicPointer]::swapAcqRel
:relfileprefix: ../../../
:mrdocs:

Atomically set the value of this object to the specified `swapValue` and return its previous value, providing the acquire/release memory ordering guarantee.

== Synopsis

Declared in `<bsls_atomic.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
TYPE*
swapAcqRel(TYPE* swapValue);
----

== Return Value

previous value of this object

== Parameters

[cols="1,4"]
|===
| Name| Description
| *swapValue*
| pointer to store, returning the previous value
|===


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