[#bsl-stop_source-request_stop]
= xref:bsl.adoc[bsl]::xref:bsl/stop_source.adoc[stop&lowbar;source]::request&lowbar;stop
:relfileprefix: ../../
:mrdocs:

If `&ast;this` refers to a stop state and that stop state has not had a stop requested yet, atomically request a stop on that stop state, invoke all registered callbacks in an unspecified order, and finally return `true`&period; Otherwise, return `false`&period; If this function returns `true`, the call synchronizes with any call to `stop&lowbar;requested` that returns `true`&period; A call to `request&lowbar;stop` that is potentially concurrent with a call to `stop&lowbar;requested`, `stop&lowbar;possible`, or `request&lowbar;stop` does not cause a data race&period;

== Synopsis

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

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
bool
request&lowbar;stop() noexcept;
----


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