Activar y desactivar el manejador de errores con excepciones

# RarException::setUsingExceptions

(PECL rar >= 2.0.0)

RarException::setUsingExceptions — Activar y desactivar el manejador de errores con excepciones

### Descripción

public static function RarException::setUsingExceptions(bool `$using_exceptions`): void

Si y sólo si el argumento es `true`, entonces, en lugar de emitir advertencias y devolver un valor especial indicando error cuando la biblioteca UnRAR encuentre un error, una excepción de tipo RarException será lanzada.

Las excepciones también será lanzado para los siguientes errores, que se producen fuera de la biblioteca (su código de error será -1):

- intentar algunas operaciones en un objeto RarArchive cerrado o un objeto RarEntry relativo al primero;
- intentar obtener una entrada que no existe con RarArchive::getEntry().

### Parámetros

`using_exceptions`
  Debe ser `true` para activar lanzamiento de excepciones, `false` para descativarlo (el valor por defecto).

### Valores devueltos

No se retorna ningún valor.

### Ejemplos

Ejemplo #1 Ejemplo de RarException::setUsingExceptions()

    <?php
    var_dump(RarException::isUsingExceptions());
    $arch = RarArchive::open("does_not_exist.rar");
    var_dump($arch);

    RarException::setUsingExceptions(true);
    var_dump(RarException::isUsingExceptions());
    $arch = RarArchive::open("does_not_exist.rar");
    var_dump($arch); //not reached
    ?>

Resultado del ejemplo anterior es similar a:

    bool(false)

    Warning: RarArchive::open(): Failed to open does_not_exist.rar: ERAR_EOPEN (file open error) in C:\php_rar\trunk\tests\test.php on line 3
    bool(false)
    bool(true)

    Fatal error: Uncaught exception 'RarException' with message 'unRAR internal error: Failed to open does_not_exist.rar: ERAR_EOPEN (file open error)' in C:\php_rar\trunk\tests\test.php:8
    Stack trace:
    #0 C:\php_rar\trunk\tests\test.php(8): RarArchive::open('does_not_exist....')
    #1 {main}
      thrown in C:\php_rar\trunk\tests\test.php on line 8

### Ver también

- RarException::isUsingExceptions() - Comprobar si el manejador de errores con excepciones está en uso

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open