[#BloombergLP-bsls-AssertTest-failTestDriver]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bsls.adoc[bsls]::xref:BloombergLP/bsls/AssertTest.adoc[AssertTest]::failTestDriver
:relfileprefix: ../../../
:mrdocs:

Throw or abort in response to an assertion violation&period;

== Synopsis

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

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

== Description

Throw an `AssertTestException` having the pointer values `text` and `file` and the integer `line` from the specified `violation` as its salient attributes, provided that `BDE&lowbar;BUILD&lowbar;TARGET&lowbar;EXC` is defined&semi; otherwise, log an appropriate message and abort the program (similar to `Assert&colon;&colon;failAbort`)&period; Note that this function is intended to have a signature compatible with a registered assertion&hyphen;failure handler function in `bsls&lowbar;assert`&period;

== Return Value

[NOTE]
====
This function https://en.cppreference.com/cpp/language/attributes/noreturn[does not return^].
====
== Parameters

[cols="1,4"]
|===
| Name| Description
| *violation*
| details of the failed assertion
|===


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