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

`invokeHandler` overloads

== Synopses

Declared in `<bsls_assert.h>`

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.


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

[.small]#xref:BloombergLP/bsls/Assert/invokeHandler-0b.adoc[_» more..._]#

Invoke the currently installed assertion‐failure handler function with the specified expression `text`, `file` name, and `line` number as its arguments. 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 deprecated, as the (BSLS) "ASSERT" macros all now use the `bsls::AssertViolation` overload of `invokeHandler` instead.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
void
xref:BloombergLP/bsls/Assert/invokeHandler-08d.adoc[invokeHandler](
    char const* text,
    char const* file,
    int line);
----

[.small]#xref:BloombergLP/bsls/Assert/invokeHandler-08d.adoc[_» more..._]#


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