[#bsl-function-0a-operator_assign-01]
= xref:bsl.adoc[bsl]::xref:bsl/function-0a.adoc[function]::operator=
:relfileprefix: ../../
:mrdocs:

Assignment operators

== Synopses

Declared in `<bslstl_function.h>`

Copy‐assign the target from `rhs` and return `*this`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:bsl/function-0a.adoc[bsl::function<PROTOTYPE>]&
xref:bsl/function-0a/operator_assign-0f0f.adoc[operator=](xref:bsl/function-0a.adoc[function] const& rhs);
----

[.small]#xref:bsl/function-0a/operator_assign-0f0f.adoc[_» more..._]#

Set this object to empty and return `*this`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:bsl/function-0a.adoc[bsl::function<PROTOTYPE>]&
xref:bsl/function-0a/operator_assign-08.adoc[operator=](xref:bsl/nullptr_t-08.adoc[nullptr_t] unused) noexcept;
----

[.small]#xref:bsl/function-0a/operator_assign-08.adoc[_» more..._]#

Move‐assign the target from `rhs` and return `*this`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:bsl/function-0a.adoc[bsl::function<PROTOTYPE>]&
xref:bsl/function-0a/operator_assign-0f04.adoc[operator=](xref:BloombergLP/bslmf/MovableRef.adoc[BloombergLP::bslmf::MovableRef<function>] rhs);
----

[.small]#xref:bsl/function-0a/operator_assign-0f04.adoc[_» more..._]#

Assign from a `reference_wrapper` target and return `*this`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<class FUNC>
xref:bsl/function-0a.adoc[function]&
xref:bsl/function-0a/operator_assign-05.adoc[operator=](bsl::reference_wrapper<FUNC> rhs) noexcept
requires IsInvocableWithPrototype<typename Decay<FUNC>::type>::value;
----

[.small]#xref:bsl/function-0a/operator_assign-05.adoc[_» more..._]#

Assign a new callable target from the specified `rhs` and return `*this`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<class FUNC>
xref:bsl/function-0a.adoc[function]&
xref:bsl/function-0a/operator_assign-03.adoc[operator=](FUNC&& rhs)
requires ! IsReferenceCompatible<typename Decay<FUNC>::type, function>::value
        &&   IsInvocableWithPrototype<typename Decay<FUNC>::type>::value;
----

[.small]#xref:bsl/function-0a/operator_assign-03.adoc[_» more..._]#

== Return Value

reference providing modifiable access to this object

== Parameters

[cols="1,4"]
|===
| Name| Description
| *rhs*
| function whose target is copied into this object
| *unused*
| null pointer literal selecting the empty state
|===


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