RarException::setUsingExceptions

Activate and deactivate error handling with exceptions

&reftitle.description; public static `void` `RarException::setUsingExceptions` `bool` `using_exceptions`

If and only if the argument is &true;, then, instead of emitting warnings and returning a special value indicating error when the UnRAR library encounters an error, an exception of type `RarException` will be thrown.

Exceptions will also be thrown for the following errors, which occur outside the library (their error code will be -1):

- attempting some operations on a closed `RarArchive` object or a `RarEntry` object relative to the first;

- attempting to get an entry that does not exist with `RarArchive::getEntry`.

&reftitle.parameters;

`using_exceptions`

- Should be &true; to activate exception throwing, &false; to deactivate (the default).

&reftitle.returnvalues;

&return.void;

&reftitle.examples;

### `RarException::setUsingExceptions` example

    <?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
    ?>

&example.outputs.similar;

    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

&reftitle.seealso;

- `RarException::isUsingExceptions`