<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/class.rararchive.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'de',
  ),
  'this' => 
  array (
    0 => 'rararchive.setallowbroken.php',
    1 => 'RarArchive::setAllowBroken',
    2 => 'Whether opening broken archives is allowed',
  ),
  'up' => 
  array (
    0 => 'class.rararchive.php',
    1 => 'RarArchive',
  ),
  'prev' => 
  array (
    0 => 'rararchive.open.php',
    1 => 'RarArchive::open',
  ),
  'next' => 
  array (
    0 => 'rararchive.tostring.php',
    1 => 'RarArchive::__toString',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'en',
    'path' => 'reference/rar/rararchive/setallowbroken.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="rararchive.setallowbroken" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">RarArchive::setAllowBroken</h1>
  <p class="verinfo">(PECL rar &gt;= 3.0.0)</p><p class="refpurpose"><span class="refname">RarArchive::setAllowBroken</span> &mdash; <span class="dc-title">Whether opening broken archives is allowed</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-rararchive.setallowbroken-description">
  <h3 class="title">Beschreibung</h3>
  <p class="simpara">Objektorientierter Stil (method):</p>
   <div class="methodsynopsis dc-description">
    <span class="modifier">public</span> <span class="methodname"><strong>RarArchive::setAllowBroken</strong></span>(<span class="methodparam"><span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span> <code class="parameter">$allow_broken</code></span>): <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span></div>

  <p class="simpara">Prozeduraler Stil:</p>
  <div class="methodsynopsis dc-description"><span class="methodname"><strong>rar_allow_broken_set</strong></span>(<span class="methodparam"><span class="type"><a href="class.rararchive.php" class="type RarArchive">RarArchive</a></span> <code class="parameter">$rarfile</code></span>, <span class="methodparam"><span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span> <code class="parameter">$allow_broken</code></span>): <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span></div>

  <p class="simpara">
   This method defines whether broken archives can be read or all the operations that
   attempt to extract the archive entries will fail. Broken archives are archives for
   which no error is detected when the file is opened but an error occurs when reading
   the entries.
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-rararchive.setallowbroken-parameters">
  <h3 class="title">Parameter-Liste</h3>
  <dl>
   
    <dt><code class="parameter">rarfile</code></dt>
    <dd>
     <span class="simpara">
      A <span class="type"><a href="class.rararchive.php" class="type RarArchive">RarArchive</a></span> object, opened with <span class="function"><a href="rararchive.open.php" class="function">rar_open()</a></span>.
     </span>
    </dd>
   
   
    <dt><code class="parameter">allow_broken</code></dt>
    <dd>
     <span class="simpara">
      Whether to allow reading broken files (<strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong>) or not (<strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong>).
     </span>
    </dd>
   
  </dl>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-rararchive.setallowbroken-returnvalues">
  <h3 class="title">Rückgabewerte</h3>
  <p class="simpara">
   Returns <strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong> Bei einem Fehler wird <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong> zurückgegeben.. It will only fail if the file has
   already been closed.
  </p>
 </div>


  <div class="refsect1 examples" id="refsect1-rararchive.setallowbroken-examples">
  <h3 class="title">Beispiele</h3>
  <div class="example" id="example-1">
   <p><strong>Beispiel #1 Objektorientierter Stil</strong></p>
   <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /></span><span style="color: #007700">function </span><span style="color: #0000BB">retnull</span><span style="color: #007700">() { return </span><span style="color: #0000BB">null</span><span style="color: #007700">; }<br /></span><span style="color: #0000BB">$file </span><span style="color: #007700">= </span><span style="color: #0000BB">dirname</span><span style="color: #007700">(</span><span style="color: #0000BB">__FILE__</span><span style="color: #007700">) . </span><span style="color: #DD0000">"/multi_broken.part1.rar"</span><span style="color: #007700">;<br /></span><span style="color: #FF8000">/* Third argument omits "volume not found" message */<br /></span><span style="color: #0000BB">$a </span><span style="color: #007700">= </span><span style="color: #0000BB">RarArchive</span><span style="color: #007700">::</span><span style="color: #0000BB">open</span><span style="color: #007700">(</span><span style="color: #0000BB">$file</span><span style="color: #007700">, </span><span style="color: #0000BB">null</span><span style="color: #007700">, </span><span style="color: #DD0000">'retnull'</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">$a</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">setAllowBroken</span><span style="color: #007700">(</span><span style="color: #0000BB">true</span><span style="color: #007700">);<br />foreach (</span><span style="color: #0000BB">$a</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">getEntries</span><span style="color: #007700">() as </span><span style="color: #0000BB">$e</span><span style="color: #007700">) {<br />    echo </span><span style="color: #DD0000">"</span><span style="color: #0000BB">$e</span><span style="color: #DD0000">\n"</span><span style="color: #007700">;<br />}<br /></span><span style="color: #0000BB">var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">count</span><span style="color: #007700">(</span><span style="color: #0000BB">$a</span><span style="color: #007700">));<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

    <div class="example-contents"><p>Das oben gezeigte Beispiel erzeugt
eine ähnliche Ausgabe wie:</p></div>
    <div class="example-contents screen">
<div class="examplescode"><pre class="examplescode">RarEntry for file &quot;file1.txt&quot; (52b28202)
int(1)</pre>
</div>
   </div>
  </div>
  <div class="example" id="example-2">
   <p><strong>Beispiel #2 Prozeduraler Stil</strong></p>
   <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /></span><span style="color: #007700">function </span><span style="color: #0000BB">retnull</span><span style="color: #007700">() { return </span><span style="color: #0000BB">null</span><span style="color: #007700">; }<br /></span><span style="color: #0000BB">$file </span><span style="color: #007700">= </span><span style="color: #0000BB">dirname</span><span style="color: #007700">(</span><span style="color: #0000BB">__FILE__</span><span style="color: #007700">) . </span><span style="color: #DD0000">"/multi_broken.part1.rar"</span><span style="color: #007700">;<br /></span><span style="color: #FF8000">/* Third argument omits "volume not found" message */<br /></span><span style="color: #0000BB">$a </span><span style="color: #007700">= </span><span style="color: #0000BB">rar_open</span><span style="color: #007700">(</span><span style="color: #0000BB">$file</span><span style="color: #007700">, </span><span style="color: #0000BB">null</span><span style="color: #007700">, </span><span style="color: #DD0000">'retnull'</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">rar_allow_broken_set</span><span style="color: #007700">(</span><span style="color: #0000BB">$a</span><span style="color: #007700">, </span><span style="color: #0000BB">true</span><span style="color: #007700">);<br />foreach (</span><span style="color: #0000BB">rar_list</span><span style="color: #007700">(</span><span style="color: #0000BB">$a</span><span style="color: #007700">) as </span><span style="color: #0000BB">$e</span><span style="color: #007700">) {<br />    echo </span><span style="color: #DD0000">"</span><span style="color: #0000BB">$e</span><span style="color: #DD0000">\n"</span><span style="color: #007700">;<br />}<br /></span><span style="color: #0000BB">var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">count</span><span style="color: #007700">(</span><span style="color: #0000BB">$a</span><span style="color: #007700">));<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

  </div>
 </div>


  <div class="refsect1 seealso" id="refsect1-rararchive.setallowbroken-seealso">
  <h3 class="title">Siehe auch</h3>
  <ul class="simplelist">
   <li><span class="methodname"><a href="rararchive.isbroken.php" class="methodname" rel="rdfs-seeAlso">RarArchive::isBroken()</a> - Test whether an archive is broken (incomplete)</span></li>
  </ul>
 </div>


</div><?php manual_footer($setup); ?>