assert_options

(PHP 4, PHP 5, PHP 7)

assert_options — Establecer/obtener valores de las directivas relacionadas con las aserciones

Descripción

assert_options ( int $what [, mixed $value ] ) : mixed

Se utiliza para establecer el valor de las diferentes opciones de la función assert() o consultar su valor actual.

Parámetros

what

**Assert Options**
Opción	Configuración inicial	Valor predeterminado	Descripción
ASSERT_ACTIVE	assert.active	1	Activa la función assert()
ASSERT_WARNING	assert.warning	1	Cada vez que una aserción falla se genera una advertencia
ASSERT_BAIL	assert.bail	0	Termina la ejecución cuando falla una aserción
ASSERT_QUIET_EVAL	assert.quiet_eval	0	Desactiva la directiva error_reporting durante la evaluación de la aserción
ASSERT_CALLBACK	assert.callback	(`NULL`)	Función que se encargará de gestionar las aserciones cuando fallen

value

Nuevo valor para la directiva.

Valores devueltos

Devuelve el valor original de cualquiera de las opciones o FALSE en caso de error.

Ejemplos

Ejemplo #1 Ejemplo de assert_options()


<?php
// Esta es nuestra función manejadora 
// de los fallos en un aserción
function assert_failure()
{
    echo 'Assert failed';
}

// Esta es nuestra función de test
function test_assert($parameter)
{
    assert(is_bool($parameter));
}

// Establecemos nuestras propias opciones para gestionar las aserciones
// Activamos las aserciones
assert_options(ASSERT_ACTIVE,   true);
// Si una aserción falla se detiene la ejecución
assert_options(ASSERT_BAIL,     true);
// Si una aserción falla NO se genera una advertencia
assert_options(ASSERT_WARNING,  false);
// Establecemos la función 'assert_failure' como manejadora (callback) de las aserciones 
assert_options(ASSERT_CALLBACK, 'assert_failure');

// Creamos una aserción la cual queremos que falle
test_assert(1);

// Este código nunca se ejecuta porque ASSERT_BAIL 
// está a TRUE
echo 'Never reached';
?>

Ver también

assert()

add a note

User Contributed Notes 2 notes

down

keithy at consultant dot com ¶

1 year ago


To reset the callback:

 assert_options(ASSERT_CALLBACK,null); // does not work   

 assert_options(ASSERT_CALLBACK,"");  // appears to work

down

17 years ago


Here is an exemple how to use the assertion callback function :

<?php
  assert_options( ASSERT_CALLBACK, 'assert_callback');

  function assert_callback( $script, $line, $message ) {
    echo 'You have a design error in your script <b>', $script,'</b> : line <b>', $line,'</b> :<br />';
    echo '<b>', ereg_replace( '^.*//\*', '', $message ), '</b><br /><br />';
    echo 'Open the source file and check it, because it\'s not a normal behaviour !';
    exit;
  }

  $x = 3;
  assert('is_integer( $x ) && ($x >= 0) && ($x <= 10); //* $x must be an integer value from 0 to 10' );
  echo "0 <= $x <= 10";
?>

assertion is usefull for "design by contract" methodology ...

add a note