Files
doc-fr/reference/xdiff/functions/xdiff-file-rabdiff.xml
2014-09-05 20:58:33 +00:00

139 lines
4.0 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 14af302c9c0e561fa6f9cdd956268758ba9a89c5 Maintainer: yannick Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="function.xdiff-file-rabdiff" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>xdiff_file_rabdiff</refname>
<refpurpose>Crée un diff binaire de 2 fichiers en utilisant l'algorithme polynomial de Rabin des empreintes digitales</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>xdiff_file_rabdiff</methodname>
<methodparam><type>string</type><parameter>old_file</parameter></methodparam>
<methodparam><type>string</type><parameter>new_file</parameter></methodparam>
<methodparam><type>string</type><parameter>dest</parameter></methodparam>
</methodsynopsis>
<para>
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 <function>xdiff_file_bdiff</function>
se situe au niveau de l'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 <function>xdiff_file_bpatch</function> et
<function>xdiff_string_bpatch</function>.
</para>
<para>
Pour plus de détails concernant les différences d'algorithme, reportez-vous
au site web de la bibliothèque <link xlink:href="&url.xdiff;">libxdiff</link>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>old_file</parameter></term>
<listitem>
<para>
Chemin vers le premier fichier. C'est l'ancien fichier.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>new_file</parameter></term>
<listitem>
<para>
Chemin vers le second fichier. C'est le nouveau fichier.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>dest</parameter></term>
<listitem>
<para>
Chemin vers le fichier résultant. Le fichier résultant contient les
différences entre l'ancien et le nouveau fichier. Il est au format
binaire, aussi, il ne sera pas humainement lisible.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.success;
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Exemple avec <function>xdiff_file_rabdiff</function></title>
<para>
Le code suivant crée un diff binaire de 2 archives.
</para>
<programlisting role="php">
<![CDATA[
<?php
$old_version = 'my_script_1.0.tgz';
$new_version = 'my_script_1.1.tgz';
xdiff_file_rabdiff($old_version, $new_version, 'my_script.bdiff');
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
Les 2 fichiers seront chargés en mémoire ; aussi, assurez-vous que votre
paramétrage de memory_limit est suffisamment élevé.
</para>
</note>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>xdiff_file_bpatch</function></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->