[#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‐failure handler function with the specified `violation`. The behavior is undefined if the macro `BSLS_ASSERT_ENABLE_NORETURN_FOR_INVOKE_HANDLER` is defined, and the currently installed assertion‐failure handler function returns to the caller (i.e., the assertion handler does _not_ `abort`, `exit`, `terminate`, `throw`, or hang). Note that this function is intended for use by the (BSLS) "ASSERT" macros, but may also be called by clients directly as needed (preferably with `BSLS_ASSERT_INVOKE`). Also note that the configuration macro `BSLS_ASSERT_ENABLE_NORETURN_FOR_INVOKE_HANDLER` is intended to support static analysis tools, which require an annotation to see that a failed "ASSERT" prevents further execution of a function with "bad" values.

== Synopsis

Declared in `<bsls_assert.h>`

[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]#