RarArchive::isBroken

rar_broken_is

(PECL rar >= 3.0.0)

RarArchive::isBroken -- rar_broken_isTest si une archive est corrompue (incomplète)

Description

Style orienté objet (méthode) :

public RarArchive::isBroken ( void ) : bool

Style procédural :

rar_broken_is ( RarArchive $rarfile ) : bool

Cette fonction détermine si une archive est incomplète, i.e., si un volume est manquant ou un volume est tronqué.

Liste de paramètres

rarfile

Un objet RarArchive, ouvert avec la fonction rar_open().

Valeurs de retour

Retourne TRUE si l'archive est corrompue, FALSE sinon. Cette fonction peut également retournée FALSE si le fichier passé a déjà été clos. La seule solution pour faire la différence entre ces 2 cas est d'activer les exceptions grâce à la méthode RarException::setUsingExceptions() ; cependant, ce n'est pas nécessaire sachant qu'un programme ne doit pas fonctionner sur des fichiers fermés.

Exemples

Exemple #1 Style orienté objet

<?php
function retnull() { return null; }
$file dirname(__FILE__) . "/multi_broken.part1.rar";
/* Le 3ème argument est utilisé pour éviter une alerte */
$arch RarArchive::open($filenull'retnull');
var_dump($arch->isBroken());
?>

L'exemple ci-dessus va afficher quelque chose de similaire à :

bool(true)

Exemple #2 Style procédural

<?php
function retnull() { return null; }
$file dirname(__FILE__) . "/multi_broken.part1.rar";
/* Le 3ème argument est utilisé pour éviter une alerte */
$arch rar_open($filenull'retnull');
var_dump(rar_broken_is($arch));
?>

Voir aussi