aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation
diff options
context:
space:
mode:
authorMatthieu Codron <matthieu.codron+dev@anakeen.com>2013-08-12 21:46:43 +0200
committerMatthieu Codron <matthieu.codron+dev@anakeen.com>2013-08-13 11:33:59 +0200
commita9cf5cd7b6fff49269bd71b0c95b95b0b2e7e781 (patch)
tree037091dbd06baafdba702bb641554e30e615f9d1 /Documentation
parent07f1c75368f9bd9c9ac45bf2d3cf04ad5b31a453 (diff)
downloadUstring-a9cf5cd7b6fff49269bd71b0c95b95b0b2e7e781.zip
Ustring-a9cf5cd7b6fff49269bd71b0c95b95b0b2e7e781.tar.gz
Ustring-a9cf5cd7b6fff49269bd71b0c95b95b0b2e7e781.tar.bz2
review french documentation
Diffstat (limited to 'Documentation')
-rw-r--r--Documentation/Fr/Index.xyl38
1 files changed, 20 insertions, 18 deletions
diff --git a/Documentation/Fr/Index.xyl b/Documentation/Fr/Index.xyl
index e950c11..2b135ba 100644
--- a/Documentation/Fr/Index.xyl
+++ b/Documentation/Fr/Index.xyl
@@ -20,17 +20,17 @@
ASCII) et par sa grande capacité à comprendre une très <strong>large</strong>
plage de caractères et de symboles, pour toutes les cultures et toutes les
régions de notre monde. PHP propose plusieurs outils pour manipuler de telles
- chaînes, comme l'extension
+ chaînes, comme les extensions
<a href="http://php.net/mbstring"><code>mbstring</code></a>,
<a href="http://php.net/iconv"><code>iconv</code></a> ou encore l'excellente
<a href="http://php.net/intl"><code>intl</code></a> qui se base sur
<a href="http://icu-project.org/">ICU</a>, l'implémentation de référence
d'Unicode. Malheureusement, il faut parfois mélanger ces extensions pour
arriver à nos fins et au prix d'une certaine <strong>complexité</strong> et
- <strong>verbosité</strong> regrettable.</p>
+ d'une <strong>verbosité</strong> regrettable.</p>
<p>La bibliothèque <code>Hoa\String</code> répond à ces problématiques en
proposant une façon <strong>simple</strong> de manipuler des chaînes de
- caractères de manière <strong>performante</strong> et
+ caractères, de manière <strong>performante</strong> et
<strong>efficace</strong>. Elle propose également des algorithmes évolués pour
des opérations de <strong>recherche</strong> sur des chaînes de
caractères.</p>
@@ -39,7 +39,7 @@
Unicode</h2>
<p>La classe <code>Hoa\String</code> représente une chaîne de caractères
- Unicode <strong>UTF-8</strong> et permet de la manipuler plus facilement. Elle
+ Unicode <strong>UTF-8</strong> et permet de la manipuler facilement. Elle
implémente les interfaces
<a href="http://php.net/arrayaccess"><code>ArrayAccess</code></a>,
<a href="http://php.net/countable"><code>Countable</code></a> et
@@ -57,7 +57,7 @@ $japanese = new Hoa\String('私はあなたを愛して');</code></pre>
<p>Commençons par les opérations <strong>élémentaires</strong>. Si nous
voulons <strong>compter</strong> le nombre de caractères (et non pas
d'octets), nous allons utiliser <a href="http://php.net/count">la fonction
- <code>count</code></a> de PHP. Ainsi :</p>
+ <code>count</code></a> de PHP. Ainsi :</p>
<pre><code class="language-php">var_dump(
count($french),
count($arabic),
@@ -95,15 +95,14 @@ $japanese = new Hoa\String('私はあなたを愛して');</code></pre>
* bool(true)
* bool(true)
*/</code></pre>
- <p>Le résultat de cette méthode est calculée grâce à la méthode statique
+ <p>Le résultat de cette méthode est calculé grâce à la méthode statique
<code>Hoa\String::getCharDirection</code> qui calcule la direction d'un seul
- caractère. À chaque fois que la chaîne est modifiée, la direction du texte est
- recalculée à la demande.</p>
+ caractère.</p>
<p>Si nous voulons <strong>concaténer</strong> une autre chaîne à la fin ou au
début, nous utiliserons respectivement les méthodes
<code>Hoa\String::append</code> et <code>Hoa\String::prepend</code>. Ces
méthodes, comme la plupart de celles qui modifient la chaîne, retournent
- l'objet lui-même, ce afin d'enchaîner les méthodes. Par exemple :</p>
+ l'objet lui-même, ce afin de chaîner les méthodes. Par exemple :</p>
<pre><code class="language-php">echo $french->append('… et toi, m\'aimes-tu ?')->prepend('Mam\'zelle ! ');
/**
@@ -112,7 +111,7 @@ $japanese = new Hoa\String('私はあなたを愛して');</code></pre>
*/</code></pre>
<p>Nous avons également les méthodes <code>Hoa\String::toLowerCase</code> et
<code>Hoa\String::toUpperCase</code> pour, respectivement, mettre la chaîne en
- <strong>minuscule</strong> ou en <strong>majuscule</strong>. Par exemple :</p>
+ <strong>minuscules</strong> ou en <strong>majuscules</strong>. Par exemple :</p>
<pre><code class="language-php">echo $french->toUpperCase();
/**
@@ -121,8 +120,8 @@ $japanese = new Hoa\String('私はあなたを愛して');</code></pre>
*/</code></pre>
<p>Nous pouvons aussi ajouter des caractères en début ou en fin de chaîne pour
atteindre une taille <strong>minimum</strong>. Cette opération est plus
- couramment appeler le <em lang="en">padding</em> (pour des raisons historiques
- en remontant jusqu'aux machines à écrire). C'est pourquoi nous trouvons la
+ couramment appelée le <em lang="en">padding</em> (pour des raisons historiques
+ remontant aux machines à écrire). C'est pourquoi nous trouvons la
méthode <code>Hoa\String::pad</code> qui prend trois arguments : la taille
minimum, les caractères à ajouter et un booléen indiquant si nous devons
ajouter en fin ou en début de chaîne (par défaut en fin avec
@@ -135,7 +134,7 @@ $japanese = new Hoa\String('私はあなたを愛して');</code></pre>
*/</code></pre>
<p>Une opération similairement inverse permet de supprimer les
<strong>espaces</strong> en début et en fin de chaîne grâce à la méthode
- <code>Hoa\String::trim</code>. Par exemple, pour revenir à notre chaîne arabe
+ <code>Hoa\String::trim</code>. Par exemple, pour revenir à notre chaîne arabe
originale :</p>
<pre><code class="language-php">echo $arabic->trim();
@@ -307,7 +306,8 @@ echo $title->toAscii();
borné.</p>
<p>Enfin, une autre méthode bien pratique est
<code>Hoa\String::getWidth</code> qui calcule la <strong>largeur</strong>
- d'une chaîne, c'est à dire le nombre de colonne. Ainsi :</p>
+ d'une chaîne, c'est à dire le nombre de colonnes utilisées par cette chaîne
+ lors de son affichage. Ainsi :</p>
<pre><code class="language-php">var_dump(
$french->getWidth(),
$arabic->getWidth(),
@@ -338,8 +338,9 @@ var_dump(
* Will output:
* string(-1)
*/</code></pre>
- <p>Cette méthode retourne -1 si la chaîne initiale est plus petite, 0 si elle
- est égale et 1 si elle est plus grande. Si nous voulons utiliser la pleine
+ <p>Cette méthode retourne -1 si la chaîne initiale vient avant (par ordre
+ alphabétique), 0 si elle est identique, et 1 si elle vient après. Si nous
+ voulons utiliser la pleine
puissance du mécanisme sous-jacent, nous pouvons appeler la méthode statique
<code>Hoa\String::getCollator</code> (si la classe
<a href="http://php.net/Collator"><code>Collator</code></a> existe, auquel
@@ -391,7 +392,7 @@ var_dump($matches['direct_object']);
*/</code></pre>
<p>Cette méthode retourne <code>false</code> si une erreur est survenue (par
exemple si le motif n'est pas correct), 0 si aucune correspondance n'a été
- trouvé, 1 ou plus sinon.</p>
+ trouvée, le nombre de correspondances trouvées sinon.</p>
<p>Similairement, nous pouvons <strong>chercher</strong> et
<strong>remplacer</strong> des sous-chaînes par d'autres sous-chaînes suivant
un motif, toujours exprimé avec une expression régulière. Pour cela, nous
@@ -451,7 +452,8 @@ echo $french;
<p>Nous allons étudier l'algorithme
<code>Hoa\String\Search::approximated</code> qui fait une recherche d'une
sous-chaîne dans une chaîne avec au maximum <strong><em>k</em>
- différences</strong>. Prenons un exemple classique avec une représentation
+ différences</strong> (une différence étant une insertion, une délétion ou une
+ modification). Prenons un exemple classique avec une représentation
ADN : nous allons chercher toutes les sous-chaînes s'approchant de
<code>GATAA</code> à 1 différence près (au maximum) dans
<code>CAGATAAGAGAA</code>. Pour cela, nous allons donc écrire :</p>