[#bsl-basic_string-0faf-operator_assign-06a]
= xref:bsl.adoc[bsl]::xref:bsl/basic_string-0faf.adoc[basic&lowbar;string]::operator&equals;
:relfileprefix: ../../
:mrdocs:

Move&hyphen;assign from the specified `rhs` string and return `&ast;this`&period;

== Synopsis

Declared in `&lt;bslstl&lowbar;string&period;h&gt;`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:bsl/basic_string-0faf.adoc[basic&lowbar;string]&
operator&equals;(xref:BloombergLP/bslmf/MovableRef.adoc[BloombergLP::bslmf::MovableRef&lt;basic&lowbar;string&gt;] rhs) noexcept(&sol;&ast; see-below &ast;&sol;);
----

== Exception specification

This function is potentially-throwing unless `AllocatorTraits&colon;&colon;propagate&lowbar;on&lowbar;container&lowbar;move&lowbar;assignment&colon;&colon;value &verbar;&verbar; AllocatorTraits&colon;&colon;is&lowbar;always&lowbar;equal&colon;&colon;value`.

== Return Value

reference providing modifiable access to this string

== Parameters

[cols="1,4"]
|===
| Name| Description
| *rhs*
| right&hyphen;hand operand
|===


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