[#BloombergLP-bslma-AllocatorUtil-assign-05]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bslma.adoc[bslma]::xref:BloombergLP/bslma/AllocatorUtil.adoc[AllocatorUtil]::assign
:relfileprefix: ../../../
:mrdocs:

`assign` overloads

== Synopses

Declared in `<bslma_allocatorutil.h>`

Conditionally assign `rhs` to `*lhs` when `allowed` is `false_type`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<class t_TYPE>
static
t_TYPE&
xref:BloombergLP/bslma/AllocatorUtil/assign-01.adoc[assign](
    t_TYPE* lhs,
    t_TYPE const& rhs,
    xref:bsl/false_type.adoc[bsl::false_type] allowed);
----

[.small]#xref:BloombergLP/bslma/AllocatorUtil/assign-01.adoc[_» more..._]#

Conditionally assign `rhs` to `*lhs` based on `allowed`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<class t_TYPE>
static
t_TYPE&
xref:BloombergLP/bslma/AllocatorUtil/assign-02.adoc[assign](
    t_TYPE* lhs,
    t_TYPE const& rhs,
    xref:bsl/true_type.adoc[bsl::true_type] allowed);
----

[.small]#xref:BloombergLP/bslma/AllocatorUtil/assign-02.adoc[_» more..._]#

== Return Value

modifiable reference to `*lhs`

== Parameters

[cols="1,4"]
|===
| Name| Description
| *lhs*
| address of the object to assign to
| *rhs*
| value compared for equality when assignment is disallowed
| *allowed*
| `false_type` tag indicating assignment is not permitted
|===


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