RarException::setUsingExceptions

(PECL rar >= 2.0.0)

RarException::setUsingExceptions — Увімкнути або вимкнути генерацію винятків замість повернення помилок

Опис

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

Если аргумент задан как**true**, то, замість видачі попередження та повернення помилки, бібліотека UnRAR викидатиме виняток типу RarExceptionв случае возникновения ошибки.

Також винятки будуть викинуті у разі таких помилок, що відбулися поза бібліотекою (їх код повернення повинен дорівнювати -1):

• спроба здійснення дій із закритим об'єктомRarArchiveабо об'єктомRarEntryщо відноситься до першого;
• спроба витягти відсутній запис за допомогоюRarArchive::getEntry()

Список параметрів

using_exceptions

trueдля активации генерации исключений,false для деактивації (за замовчуванням).

Значення, що повертаються

Функція не повертає значення після виконання.

Приклади

Приклад #1 Приклад використання RarException::setUsingExceptions()****

Loading...
▶

Висновок наведеного прикладу буде схожим на:

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

Дивіться також

• RarException::isUsingExceptions() - Перевірити, чи будуть функції повертати помилки або викидати винятки