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

Invoke the installed handler with expression text, file, and line&period;

== Synopsis

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

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
void
invokeHandler(
    char const* text,
    char const* file,
    int line);
----

== Description

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

DEPRECATED&colon; Use `invokeHandler(const AssertViolation&amp;)` instead&period;

== Parameters

[cols="1,4"]
|===
| Name| Description
| *text*
| expression text of the failed assertion
| *file*
| source file name where the assertion failed
| *line*
| source line number where the assertion failed
|===


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