<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ref.xdiff.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'fr',
  ),
  'this' => 
  array (
    0 => 'function.xdiff-file-rabdiff.php',
    1 => 'xdiff_file_rabdiff',
    2 => 'Cr&eacute;e un diff binaire de 2 fichiers en utilisant l\'algorithme polynomial de Rabin des empreintes digitales',
  ),
  'up' => 
  array (
    0 => 'ref.xdiff.php',
    1 => 'Fonctions xdiff',
  ),
  'prev' => 
  array (
    0 => 'function.xdiff-file-patch-binary.php',
    1 => 'xdiff_file_patch_binary',
  ),
  'next' => 
  array (
    0 => 'function.xdiff-string-bdiff.php',
    1 => 'xdiff_string_bdiff',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'fr',
    'path' => 'reference/xdiff/functions/xdiff-file-rabdiff.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="function.xdiff-file-rabdiff" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">xdiff_file_rabdiff</h1>
  <p class="verinfo">(PECL xdiff &gt;= 1.5.0)</p><p class="refpurpose"><span class="refname">xdiff_file_rabdiff</span> &mdash; <span class="dc-title">Crée un diff binaire de 2 fichiers en utilisant l&#039;algorithme polynomial de Rabin des empreintes digitales</span></p>

 </div>
 
 <div class="refsect1 description" id="refsect1-function.xdiff-file-rabdiff-description">
  <h3 class="title">Description</h3>
  <div class="methodsynopsis dc-description">
   <span class="methodname"><strong>xdiff_file_rabdiff</strong></span>(<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$old_file</code></span>, <span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$new_file</code></span>, <span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$dest</code></span>): <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span></div>

  <p class="para rdfs-comment">
   Crée un diff binaire de 2 fichiers et enregistre le résultat dans un fichier patch.
   La différence entre cette fonction et la fonction <span class="function"><a href="function.xdiff-file-bdiff.php" class="function">xdiff_file_bdiff()</a></span>
   se situe au niveau de l&#039;algorithme utilisé. Aussi, cette fonction devrait être plus rapide
   et devrait produire un diff plus petit. Cette fonction fonctionne avec des fichiers
   textes, comme avec des fichiers binaires. Le fichier patch résultant pourra ensuite
   être appliqué avec les fonctions <span class="function"><a href="function.xdiff-file-bpatch.php" class="function">xdiff_file_bpatch()</a></span> et
   <span class="function"><a href="function.xdiff-string-bpatch.php" class="function">xdiff_string_bpatch()</a></span>.
  </p>
  <p class="para">
   Pour plus de détails concernant les différences d&#039;algorithme, se reporter
   au site web de la bibliothèque <a href="http://www.xmailserver.org/xdiff-lib.html" class="link external">&raquo;&nbsp;libxdiff</a>.
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-function.xdiff-file-rabdiff-parameters">
  <h3 class="title">Liste de paramètres</h3>
  <p class="para">
   <dl>
    
     <dt><code class="parameter">old_file</code></dt>
     <dd>
      <p class="para">
       Chemin vers le premier fichier. C&#039;est l&#039;ancien fichier.
      </p>
     </dd>
    
    
     <dt><code class="parameter">new_file</code></dt>
     <dd>
      <p class="para">
       Chemin vers le second fichier. C&#039;est le nouveau fichier.
      </p>
     </dd>
    
    
     <dt><code class="parameter">dest</code></dt>
     <dd>
      <p class="para">
       Chemin vers le fichier résultant. Le fichier résultant contient les
       différences entre l&#039;ancien et le nouveau fichier. Il est au format
       binaire, aussi, il ne sera pas humainement lisible.
      </p>
     </dd>
    
   </dl>
  </p>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-function.xdiff-file-rabdiff-returnvalues">
  <h3 class="title">Valeurs de retour</h3>
  <p class="para">
   Cette fonction retourne <strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong> en cas de succès ou <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong> si une erreur survient.
  </p>
 </div>


 <div class="refsect1 examples" id="refsect1-function.xdiff-file-rabdiff-examples">
  <h3 class="title">Exemples</h3>
  <p class="para">
   <div class="example" id="example-1">
    <p><strong>Exemple #1 Exemple avec <span class="function"><strong>xdiff_file_rabdiff()</strong></span></strong></p>
    <div class="example-contents"><p>
     Le code suivant crée un diff binaire de 2 archives.
    </p></div>
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$old_version </span><span style="color: #007700">= </span><span style="color: #DD0000">'my_script_1.0.tgz'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$new_version </span><span style="color: #007700">= </span><span style="color: #DD0000">'my_script_1.1.tgz'</span><span style="color: #007700">;<br /><br /></span><span style="color: #0000BB">xdiff_file_rabdiff</span><span style="color: #007700">(</span><span style="color: #0000BB">$old_version</span><span style="color: #007700">, </span><span style="color: #0000BB">$new_version</span><span style="color: #007700">, </span><span style="color: #DD0000">'my_script.bdiff'</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>
  </p>
 </div>


 <div class="refsect1 notes" id="refsect1-function.xdiff-file-rabdiff-notes">
  <h3 class="title">Notes</h3>
  <blockquote class="note"><p><strong class="note">Note</strong>: 
   <p class="para">
    Les 2 fichiers seront chargés en mémoire ; aussi, il faut s&#039;assurer que le
    paramétrage de memory_limit est suffisamment élevé.
   </p>
  </p></blockquote>
 </div>


 <div class="refsect1 seealso" id="refsect1-function.xdiff-file-rabdiff-seealso">
  <h3 class="title">Voir aussi</h3>
  <p class="para">
   <ul class="simplelist">
    <li><span class="function"><a href="function.xdiff-file-bpatch.php" class="function" rel="rdfs-seeAlso">xdiff_file_bpatch()</a> - Patche un fichier avec un diff binaire</span></li>
   </ul>
  </p>
 </div>


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