ASSERT_OPTIONS(3) 1 ASSERT_OPTIONS(3)
assert_options - Set/get the various assert flags
SYNOPSIS
mixed assert_options (int $what, [mixed $value])
DESCRIPTION
Set the various assert(3) control options or just query their current settings.
PARAMETERS
o $what
-
Assert Options
+------------------+-------------------------------+---+---+
| Option | | | |
| | | | |
| | INI Setting | | |
| | | | |
| | Default value | | |
| | | | |
| | Description | | |
| | | | |
+------------------+-------------------------------+---+---+
| ASSERT_ACTIVE | | | |
| | | | |
| | assert.active | | |
| | | | |
| | 1 | | |
| | | | |
| | enable assert(3) evaluation | | |
| | | | |
| ASSERT_WARNING | | | |
| | | | |
| | assert.warning | | |
| | | | |
| | 1 | | |
| | | | |
| | issue a PHP warning for each | | |
| | failed assertion | | |
| | | | |
| ASSERT_BAIL | | | |
| | | | |
| | assert.bail | | |
| | | | |
| | 0 | | |
| | | | |
| | terminate execution on failed | | |
| | assertions | | |
| | | | |
|ASSERT_QUIET_EVAL | | | |
| | | | |
| | assert.quiet_eval | | |
| | | | |
| | 0 | | |
| | | | |
| | disable error_reporting dur- | | |
| | ing assertion expression | | |
| | evaluation | | |
| | | | |
| ASSERT_CALLBACK | | | |
| | | | |
| | assert.callback | | |
| | | | |
| | ( NULL) | | |
| | | | |
| | Callback to call on failed | | |
| | assertions | | |
| | | | |
+------------------+-------------------------------+---+---+
o $value
- An optional new value for the option.
RETURN VALUES
Returns the original setting of any option or FALSE on errors.
EXAMPLES
Example #1
assert_options(3) example
<?php
// This is our function to handle
// assert failures
function assert_failure()
{
echo 'Assert failed';
}
// This is our test function
function test_assert($parameter)
{
assert(is_bool($parameter));
}
// Set our assert options
assert_options(ASSERT_ACTIVE, true);
assert_options(ASSERT_BAIL, true);
assert_options(ASSERT_WARNING, false);
assert_options(ASSERT_CALLBACK, 'assert_failure');
// Make an assert that would fail
test_assert(1);
// This is never reached due to ASSERT_BAIL
// being true
echo 'Never reached';
?>
SEE ALSO
assert(3).
PHP Documentation Group ASSERT_OPTIONS(3)
