assert_options

Set/get the various assert flags

&reftitle.description; `mixed` `assert_options` `int` `what` `mixed` `value`

Set the various `assert` control options or just query their current settings.

&reftitle.parameters;

`what`

- ## Assert Options

  Option | INI Setting | Default value | Description
  ASSERT_ACTIVE | assert.active | 1 | enable `assert` 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 during assertion expression evaluation
  ASSERT_CALLBACK | assert.callback | (&null;) | Callback to call on failed assertions

`value`

- An optional new value for the option.

&reftitle.returnvalues;

Returns the original setting of any option or &false; on errors.

&reftitle.examples;

### `assert_options` 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';
    ?>

&reftitle.seealso;

- `assert`