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

== Synopsis

Declared in `<bsls_assert.h>`

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

== Description

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.

DEPRECATED: Use `invokeHandler(const AssertViolation&)` instead.

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