RarArchive::isBroken

rar_broken_is

Test whether an archive is broken (incomplete)

&reftitle.description;

&style.oop; (method):

public `bool` `RarArchive::isBroken`

&style.procedural;:

`bool` `rar_broken_is` `RarArchive` `rarfile`

This function determines whether an archive is incomplete, i.e., if a volume is missing or a volume is truncated.

&reftitle.parameters;

`rarfile`

- A `RarArchive` object, opened with `rar_open`.

&reftitle.returnvalues;

Returns &true; if the archive is broken, &false; otherwise. This function may also return &false; if the passed file has already been closed. The only way to tell the two cases apart is to enable exceptions with `RarException::setUsingExceptions`; however, this should be unnecessary as a program should not operate on closed files.

&reftitle.examples;

### &style.oop;

    <?php
    function retnull() { return null; }
    $file = dirname(__FILE__) . "/multi_broken.part1.rar";
    /* Third argument is used to omit notice */
    $arch = RarArchive::open($file, null, 'retnull');
    var_dump($arch->isBroken());
    ?>

&example.outputs.similar;

    bool(true)

### &style.procedural;

    <?php
    function retnull() { return null; }
    $file = dirname(__FILE__) . "/multi_broken.part1.rar";
    /* Third argument is used to omit notice */
    $arch = rar_open($file, null, 'retnull');
    var_dump(rar_broken_is($arch));
    ?>

&reftitle.seealso;

- `RarArchive::setAllowBroken`