[#BloombergLP-bsls-Assert-invokeHandler-0b]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bsls.adoc[bsls]::xref:BloombergLP/bsls/Assert.adoc[Assert]::invokeHandler
:relfileprefix: ../../../
:mrdocs:

Invoke the currently installed assertion&hyphen;failure handler function with the specified `violation`&period; The behavior is undefined if the macro `BSLS&lowbar;ASSERT&lowbar;ENABLE&lowbar;NORETURN&lowbar;FOR&lowbar;INVOKE&lowbar;HANDLER` is defined, and the currently installed assertion&hyphen;failure handler function returns to the caller (i&period;e&period;, the assertion handler does _not_ `abort`, `exit`, `terminate`, `throw`, or hang)&period; Note that this function is intended for use by the (BSLS) &quot;ASSERT&quot; macros, but may also be called by clients directly as needed (preferably with `BSLS&lowbar;ASSERT&lowbar;INVOKE`)&period; Also note that the configuration macro `BSLS&lowbar;ASSERT&lowbar;ENABLE&lowbar;NORETURN&lowbar;FOR&lowbar;INVOKE&lowbar;HANDLER` is intended to support static analysis tools, which require an annotation to see that a failed &quot;ASSERT&quot; prevents further execution of a function with &quot;bad&quot; values&period;

== Synopsis

Declared in `&lt;bsls&lowbar;assert&period;h&gt;`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
void
invokeHandler(xref:BloombergLP/bsls/AssertViolation.adoc[AssertViolation] const& violation);
----


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