[#BloombergLP-bslstl-StopState-enregister]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bslstl.adoc[bslstl]::xref:BloombergLP/bslstl/StopState.adoc[StopState]::enregister
:relfileprefix: ../../../
:mrdocs:

Register `node` with this stop state, or invoke it if a stop was already requested.

== Synopsis

Declared in `<bslstl_stopstate.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
bool
enregister(xref:BloombergLP/bslstl/StopStateCallbackNode.adoc[StopStateCallbackNode]* node);
----

== Description

If a stop has already been requested, then invoke the callback of the specified `node` and return `false`. Otherwise, add `node` to the list of nodes registered to this state and return `true`. The behavior is undefined if this method is called more than once for a given `node`.

== Return Value

`true` if `node` was registered, and `false` if a stop was already requested and the callback was invoked instead

== Parameters

[cols="1,4"]
|===
| Name| Description
| *node*
| callback node to register or invoke
|===


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