dams Tue Jan 16 02:38:40 2001 EDT
Modified files:
/phpdoc/fr/functions array.xml aspell.xml bc.xml calendar.xml
ccvs.xml classobj.xml com.xml cpdf.xml
curl.xml cybercash.xml datetime.xml dba.xml
dbase.xml dbm.xml dir.xml dl.xml apache.xml
Log:
General update for functions (1/4)
Index: phpdoc/fr/functions/array.xml
diff -u phpdoc/fr/functions/array.xml:1.15 phpdoc/fr/functions/array.xml:1.16
--- phpdoc/fr/functions/array.xml:1.15 Wed Dec 20 02:11:47 2000
+++ phpdoc/fr/functions/array.xml Tue Jan 16 02:38:37 2001
@@ -8,7 +8,7 @@
qu'il s'agit de stocker, gérer et traiter des données en groupe.
</simpara>
<simpara>
- Les tableaus simples et multi-dimensionnels sont supportés et peuvent
+ Les tableaux simples et multi-dimensionnels sont supportés et peuvent
être créé par l'utilisateur, ou par une fonction. Il y a
des fonctions spécifiques qui remplissent des tableaux à partir
de résultats de requêtes, et de nombreuses fonctions retournent
@@ -40,7 +40,7 @@
<para>
<function>array</function> retourne un tableau créé avec les
paramètres passés. On peut attribuer un index particulier
- à une valeur avec l'opérateur <literal>=></literal>.
+ à une valeur avec l'opérateur <literal>=?></literal>.
</para>
<para>
<note>
@@ -52,7 +52,7 @@
</note>
</para>
<para>
- La syntaxe "index => values", séparés par des virgules,
+ La syntaxe "index => valeur", séparés par des virgules,
définit les index et leur valeur. Un index peut être une
chaîne ou un nombre. Si l'index est omis, un index numérique
sera automatiquement généré (commençant à
@@ -67,11 +67,13 @@
<example>
<title>Exemple avec <function>array</function></title>
<programlisting role="php">
+<?php
$fruits = array (
- "fruits" => array ("a"=>"orange", "b"=>"banane", "c"=>"pomme"),
- "numbers" => array (1, 2, 3, 4, 5, 6),
- "holes" => array ("premier", 5 => "deuxième", "troisième")
+ "fruits" => array ("a" => "orange", "b" => "banane", "c" => "pomme"),
+ "numbres" => array (1, 2, 3, 4, 5, 6),
+ "trous" => array ("premier", 5 => "deuxième", "troisième")
);
+?>
</programlisting>
</example>
</para>
@@ -79,13 +81,15 @@
<example>
<title>Index automatique d'un tableau avec <function>array</function></title>
<programlisting role="php">
+<?php
$array = array( 1, 1, 1, 1, 1, 8=>1, 4=>1, 19, 3=>13);
print_r($array);
+?>
</programlisting>
</example>
qui affichera :
<informalexample>
- <programlisting>
+ <computeroutput>
Array
(
[0] => 1
@@ -96,7 +100,7 @@
[8] => 1
[9] => 19
)
- </programlisting>
+ </computeroutput>
</informalexample>
Notez bien que l'index '3' est défini deux fois, et conserve finalement
sa dernière valeur de 13. L'index '4' est défini après
@@ -108,20 +112,22 @@
<example>
<title>Tableau d'index commencant à 1</title>
<programlisting role="php">
- $firstquarter = array(1 => 'Janvier', 'Février', 'Mars');
- print_r($firstquarter);
+<?php
+ $firstquarter = array(1 => 'Janvier', 'Février', 'Mars');
+ print_r($firstquarter);
+?>
</programlisting>
</example>
qui affichera :
<informalexample>
- <programlisting>
+ <computeroutput>
Array
(
[1] => 'Janvier'
[2] => 'Février'
[3] => 'Mars'
)
- </programlisting>
+ </computeroutput>
</informalexample>
</para>
<para>
@@ -151,8 +157,10 @@
<example>
<title>Exemple avec <function>array_count_values</function></title>
<programlisting role="php">
+<?php
$array = array(1, "bonjour", 1, "monde", "bonjour");
array_count_values($array); // retourne array(1=>2, "bonjour"=>2, "monde"=>1)
+?>
</programlisting>
</example>
<note>
@@ -191,9 +199,11 @@
<example>
<title>Exemple avec <function>array_diff</function></title>
<programlisting role="php">
+<?php
$array1 = array ("a" => "vert", "rouge", "bleu");
$array2 = array ("b" => "vert", "jaune", "rouge");
$result = array_diff ($array1, $array2);
+?>
</programlisting>
</example>
</para>
@@ -228,8 +238,10 @@
<example>
<title>Exemple avec <function>array_flip</function></title>
<programlisting role="php">
+<?php
$trans = array_flip ($trans);
$original = strtr ($str, $trans);
+?>
</programlisting>
</example>
<note>
@@ -267,15 +279,16 @@
<example>
<title>Exemple avec <function>array_intersect</function></title>
<programlisting role="php">
+<?php
$array1 = array ("a" => "vert", "rouge", "bleu");
$array2 = array ("b" => "vert", "jaune", "rouge");
$result = array_intersect ($array1, $array2);
+?>
</programlisting>
</example>
</para>
<para>
- <varname>$result</varname> contient <literal>array ("a"
- => "vert", "rouge");</literal>
+ <varname>$result</varname> contient <literal>array ("a" => "vert",
+"rouge");</literal>.
</para>
<para>
Voir aussi <function>array_diff</function>.
@@ -313,10 +326,12 @@
<example>
<title>Exemple avec <function>array_keys</function></title>
<programlisting role="php">
+<?php
$array = array(0 => 100, "couleur" => "rouge");
array_keys ($array); // retourne array (0, "couleur")
$array = array(1, 100, 2, 100);
array_keys ($array, 100); // retourne array (0, 2)
+?>
</programlisting>
</example>
</para>
@@ -330,6 +345,7 @@
les utilisateurs de PHP 3
</title>
<programlisting role="php">
+<?php
function array_keys ($arr, $term="") {
$t = array();
while (list($k,$v) = each($arr)) {
@@ -339,6 +355,7 @@
}
return $t;
}
+?>
</programlisting>
</example>
</para>
@@ -380,9 +397,11 @@
<example>
<title>Exemple avec <function>array_merge</function></title>
<programlisting role="php">
+<?php
$array1 = array ("couleur" => "rouge", 2, 4);
$array2 = array ("a", "b", "couleur" => "vert", "forme" => "trapézoïde");
array_merge ($array1, $array2);
+?>
</programlisting>
<para>
Le résultat sera array("couleur" => "vert", 2, 4, "a",
@@ -438,15 +457,17 @@
<example>
<title>Exemple avec <function>array_merge_recursive</function></title>
<programlisting role="php">
-$ar1 = array ("couleur" => array ("favorie" => "red"), 5);
-$ar2 = array (10, "couleur" => array ("favorie" => "vert", "rouge"));
+<?php
+$ar1 = array ("couleur" => array ("favorie" ?> "rouge"), 5);
+$ar2 = array (10, "couleur" ?> array ("favorie" ?> "vert", "rouge"));
$result = array_merge_recursive ($ar1, $ar2);
+?>
</programlisting>
</example>
</para>
<para>
- Le résultat sera <literal>array ("couleur" => array
- ("favorie" => array ("rouge", "vert"), "bleu"), 5, 10)</literal>.
+ Le résultat sera
+ <literal>array("couleur" => array("favorie" => array ("rouge", "vert"),
+"bleu"), 5, 10)</literal>.
</para>
<para>
Voir aussi <function>array_merge</function>.
@@ -526,15 +547,17 @@
à SORT_ASC et SORT_REGULAR.
</para>
<para>
- Retourne TRUE en cas de succès, FALSE sinon.
+ Retourne <literal>TRUE</literal> en cas de succès,
+<literal>FALSE</literal> sinon.
</para>
<para>
<example>
<title>Trier plusieurs tableaux</title>
<programlisting role="php">
+<?php
$ar1 = array ("10", 100, 100, "a");
$ar2 = array (1, 3, "2", 1);
array_multisort ($ar1, $ar2);
+?>
</programlisting>
</example>
</para>
@@ -549,9 +572,11 @@
<example>
<title>Classer un tableau multidimensionnel</title>
<programlisting role="php">
+<?php
$ar = array (array ("10", 100, 100, "a"), array (1, 3, "2", 1));
array_multisort ($ar[0], SORT_ASC, SORT_STRING,
$ar[1], SORT_NUMERIC, SORT_DESC);
+?>
</programlisting>
</example>
</para>
@@ -596,6 +621,7 @@
<example>
<title>Exemple avec <function>array_pad</function></title>
<programlisting role="php">
+<?php
$input = array (12, 10, 9);
$result = array_pad ($input, 5, 0);
// Le résultat est array (12, 10, 9, 0, 0)
@@ -603,6 +629,7 @@
// Le résultat est array (-1, -1, -1, -1, 12, 10, 9)
$result = array_pad ($input, 2, "noop");
// pas complété
+?>
</programlisting>
</example>
</para>
@@ -632,8 +659,10 @@
<example>
<title>Exemple avec <function>array_pop</function></title>
<programlisting role="php">
+<?php
$stack = array ("orange", "pomme", "framboise");
$fruit = array_pop ($stack);
+?>
</programlisting>
<para>
Après ceci, $stack n'a plus que 2 éléments: "orange" et "pomme",
@@ -679,7 +708,9 @@
La longueur du tableau <parameter>array</parameter> augmente d'autant.
Cela a le même effet que :
<programlisting role="php">
+<?php
$array[] = $var;
+?>
</programlisting>
repeté pour chaque <parameter>var</parameter>.
</para>
@@ -690,8 +721,10 @@
<example>
<title>Exemple avec <function>array_push</function></title>
<programlisting role="php">
+<?php
$stack = array (1, 2);
array_push($stack, "+", 3);
+?>
</programlisting>
</example>
Cet exemple fait que $stack a 4 éléments: 1, 2, "+",
@@ -734,8 +767,10 @@
<example>
<title>Exemple avec <function>array_reverse</function></title>
<programlisting role="php">
+<?php
$input = array ("php", 4.0, array ("rouge", "vert"));
$result = array_reverse ($input);
+?>
</programlisting>
</example>
Au final, $result contient (array ("rouge", "vert"), 4.0, "php").
@@ -786,11 +821,13 @@
<example>
<title>Exemple avec <function>array_rand</function></title>
<programlisting role="php">
+<?php
srand ((double) microtime() * 10000000);
$input = array ("Neo", "Morpheus", "Trinitée", "Cypher", "Tank");
$rand_keys = array_rand ($input, 2);
print $input[$rand_keys[0]]."\n";
print $input[$rand_keys[1]]."\n";
+?>
</programlisting>
</example>
</para>
@@ -820,8 +857,10 @@
<example>
<title>Exemple avec <function>array_shift</function></title>
<programlisting role="php">
+<?php
$args = array ("-v", "-f");
$opt = array_shift ($args);
+?>
</programlisting>
</example>
Cet exemple aura pour résultat que $args ne contiendra plus que "-f",
@@ -884,11 +923,13 @@
<example>
<title>Exemple avec <function>array_slice</function></title>
<programlisting role="php">
+<?php
$input = array ("a", "b", "c", "d", "e");
$output = array_slice ($input, 2); // retourne "c", "d", et "e"
$output = array_slice ($input, 2, -1); // retourne "c", "d"
$output = array_slice ($input, -2, 1); // retourne "d"
$output = array_slice ($input, 0, 3); // retourne "a", "b", et "c"
+?>
</programlisting>
</example>
</para>
@@ -954,42 +995,49 @@
count(<literal>count($input)</literal>) à la place de length.
</para>
<para>
- Si <parameter>replacement</parameter> est précisé, alors les
- éléments supprimés sont remplacés par les
- éléments de ce tableau. Si <parameter>loffset</parameter>
- et <parameter>length</parameter> sont tels que la taille du tableau ne change pas,
- alors les éléments du tableau de remplacement replacement sont
- insérés à partir de l'offset <parameter>offset</parameter>.
+ Si <parameter>replacement</parameter> est précisé, alors les
+ éléments supprimés sont remplacés par les
+ éléments de ce tableau. Si l'<parameter>offset</parameter>
+ et <parameter>length</parameter> sont tels que la taille du tableau ne change
+pas,
+ alors les éléments du tableau de remplacement replacement sont
+ insérés à partir de l'offset <parameter>offset</parameter>.
+ </para>
+ <para>
Conseil : si le tableau de remplacement ne contient qu'un seul
- élément, il n'est pas obligatoire de forcer le type à
- array avec <literal>array()</literal>, à moins que cette variable ne soit
+ élément, il n'est pas obligatoire de forcer le type en
+ tableau avec <function>array</function>, à moins que cette variable ne
+soit
elle même un tableau.
</para>
<para>
Les codes suivants sont équivalents :
<programlisting role="php">
+<?php
array_push($input, $x, $y) array_splice($input, count($input), 0, array($x, $y))
array_pop($input) array_splice($input, -1)
array_shift($input) array_splice($input, 0, 1)
array_unshift($input, $x, $y) array_splice($input, 0, 0, array($x, $y))
$a[$x] = $y array_splice($input, $x, 1, $y)
+?>
</programlisting>
</para>
<para>
- Retourne le tableau des éléments supprimés.
+ <function>array_splice</function> retourne le tableau des éléments
+ supprimés.
</para>
<para>
<example>
<title>Exemples avec <function>array_splice</function></title>
<programlisting role="php">
-$input = array("red", "green", "blue", "yellow");
-array_splice($input, 2); // $input est array("red", "green")
-array_splice($input, 1, -1); // $input est array("red", "yellow")
+<?php
+$input = array("rouge", "vert", "bleu", "jaune");
+array_splice($input, 2); // $input est array("rouge", "vert")
+array_splice($input, 1, -1); // $input est array("rouge", "yellow")
array_splice($input, 1, count($input), "orange");
- // $input est array("red", "orange")
-array_splice($input, -1, 1, array("black", "maroon"));
- // $input est array("red", "green",
- // "blue", "black", "maroon")
+ // $input est array("rouge", "orange")
+array_splice($input, -1, 1, array("noir", "marron"));
+ // $input est array("rouge", "vert",
+ // "bleu", "noir", "marron")
+?>
</programlisting>
</example>
</para>
@@ -997,7 +1045,8 @@
Voir aussi <function>array_slice</function>.
<note>
<para>
- <function>array_splice</function> a été ajoutée dans PHP
4.0.
+ <function>array_splice</function> a été ajoutée
+ dans PHP 4.0.
</para>
</note>
</para>
@@ -1026,14 +1075,16 @@
<example>
<title>Exemple avec <function>array_unique</function></title>
<programlisting role="php">
+<?php
$input = array ("a" => "vert", "rouge", "b" => "vert", "bleu", "rouge");
$result = array_unique ($input);
+?>
</programlisting>
</example>
</para>
<para>
- <varname>$result</varname> contient<literal>array ("a" =>
- "vert", "rouge", "bleu");</literal>.
+ <varname>$result</varname> contient
+ <literal>array ("a" => "vert", "rouge", "bleu");</literal>.
</para>
</refsect1>
</refentry>
@@ -1073,8 +1124,10 @@
<example>
<title>Exemples avec <function>array_unshift</function></title>
<programlisting role="php">
+<?php
$queue = array("p1", "p3");
array_unshift($queue, "p4", "p5", "p6");
+?>
</programlisting>
</example>
Le résultat de cet exemple est que $queue aura 5 éléments,
@@ -1113,8 +1166,10 @@
<example>
<title>Exemples avec <function>array_values</function></title>
<programlisting role="php">
+<?php
$array = array("taille" => "XL", "couleur" => "or");
array_values($array); // // retourne array("XL", "or")
+?>
</programlisting>
</example>
<note>
@@ -1128,6 +1183,7 @@
PHP 3
</title>
<programlisting role="php">
+<?php
function array_values ($arr) {
$t = array();
while (list($k, $v) = each ($arr)) {
@@ -1135,7 +1191,8 @@
return $t;
}
}
- </programlisting>
+?>
+ </programlisting>
</example>
</para>
</note>
@@ -1160,17 +1217,17 @@
</funcprototype>
</funcsynopsis>
<simpara>
- Exécute la fonction <parameter>func</parameter> avec chaque
- élément du tableau <parameter>arr</parameter>.Les
- éléments sont passés en tant que premier argument de la
- fonction <parameter>func</parameter>;
+ <function>array_walk</function> exécute la fonction
+<parameter>func</parameter>
+ avec chaque élément du tableau <parameter>arr</parameter>. Les
+ éléments sont passés en tant que premier argument de la
+ fonction <parameter>func</parameter>;
</simpara>
<simpara>
- Si <parameter>func</parameter> a besoin de plus d'un argument, une alerte
- sera générée pour chaque appel de
<parameter>func</parameter>.
- Ces alertes sont supprimées en ajoutant le suffixe '@' avant l'appel de
- <function>array_walk</function> ou simplement en utilisant
- <function>error_reporting</function>.
+ Si <parameter>func</parameter> a besoin de plus d'un argument, une alerte
+ sera générée pour chaque appel de
+<parameter>func</parameter>.
+ Ces alertes sont supprimées en ajoutant le suffixe '@' avant l'appel de
+ <function>array_walk</function> ou simplement en utilisant
+ <function>error_reporting</function>.
</simpara>
<note>
<para>
@@ -1196,6 +1253,7 @@
<example>
<title>Exemple avec <function>array_walk</function></title>
<programlisting role="php">
+<?php
$fruits = array("d"=>"citron","a"=>"orange","b"=>"banane","c"=>"pomme");
function test_alter( $item1 ) {
$item1 = 'bidon';
@@ -1206,6 +1264,7 @@
array_walk( $fruits, 'test_print' );
array_walk( $fruits, 'test_alter' );
array_walk( $fruits, 'test_print' );
+?>
</programlisting>
</example>
</para>
@@ -1237,11 +1296,13 @@
<example>
<title>Exemple avec <function>arsort</function></title>
<programlisting role="php">
+<?php
$fruits = array("d"=>"papaye","a"=>"orange","b"=>"banane","c"=>"ananas");
arsort ($fruits);
for (reset ($fruits); $key = key ($fruits); next ($fruits)) {
echo "fruits[$key] = ".$fruits[$key]."\n";
}
+?>
</programlisting>
</example>
Cet exemple va afficher:
@@ -1281,11 +1342,13 @@
<example>
<title>Exemple avec <function>asort</function></title>
<programlisting role="php">
+<?php
$fruits = array("d"=>"papaye","a"=>"orange","b"=>"banane","c"=>"ananas");
asort($fruits);
for(reset($fruits); $key = key($fruits); next($fruits)) {
echo "fruits[$key] = ".$fruits[$key]."\n";
}
+?>
</programlisting>
</example>
Cet exemple va afficher:
@@ -1324,10 +1387,10 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>compact</function> accepte différents paramètres. Les
- paramètres peuvent être des variables contenant des chaînes,
- ou un tableau de chaîne, qui peut contenir d'autres tableau de noms, que
- <function>compact</function> traitera récursivement.
+ <function>compact</function> accepte différents paramètres. Les
+ paramètres peuvent être des variables contenant des chaînes,
+ ou un tableau de chaîne, qui peut contenir d'autres tableau de noms, que
+ <function>compact</function> traitera récursivement.
</para>
<para>
Pour chacun des arguments, <function>compact</function> recherche une variable
@@ -1340,11 +1403,13 @@
<example>
<title>Exemple avec <function>compact</function></title>
<programlisting role="php">
+<?php
$ville = "San Francisco";
$etat = "CA";
$evenement = "SIGGRAPH";
$location_vars = array("ville", "etat");
$result = compact("evenement", $location_vars);
+?>
</programlisting>
<para>
Après cette opération, $result sera le tableau suivant :
@@ -1376,9 +1441,9 @@
</funcprototype>
</funcsynopsis>
<para>
- Retourne le nombre d'élément dans <parameter>var</parameter>, qui
- est généralement un tableau (et tout le reste n'aura qu'un
- élément).
+ <function>count</function> retourne le nombre d'élément dans
+ <parameter>var</parameter>, qui est généralement un tableau
+ (et tout le reste n'aura qu'un élément).
</para>
<para>
Retourne 1 si la variable n'est pas un tableau.
@@ -1400,6 +1465,7 @@
<example>
<title>Exemple avec <function>count</function></title>
<programlisting role="php">
+<?php
$a[0] = 1;
$a[1] = 3;
$a[2] = 5;
@@ -1413,6 +1479,7 @@
$a[12] = "";
$result = count ($a);
// $result == 4, car il y a 4 éléments assignés
+?>
</programlisting>
</example>
</para>
@@ -1437,19 +1504,19 @@
</funcprototype>
</funcsynopsis>
<para>
-Chaque tableau entretien un pointeur interne, qui est initialisé lors
-lorsque le premier élément est inséré dans le tableau.
+ Chaque tableau entretien un pointeur interne, qui est initialisé lors
+ lorsque le premier élément est inséré dans le
+tableau.
</para>
<para>
- La fonction <function>current</function> ne fait que retourner
+ <function>current</function> ne fait que retourner
l'élément courant pointé par le pointeur interne.
<function>current</function> ne déplace pas le pointeur.
Si le pointeur est au dela du dernier élément de la liste,
- <function>current</function> retourne FALSE.
+ <function>current</function> retourne <literal>FALSE</literal>.
<warning>
<para>
Si le tableau des éléments vides ou des zéros (0 ou "",
- la chaîne vide) alors <function>current</function> retournera FALSE pour
ces
+ la chaîne vide) alors <function>current</function> retournera
+<literal>FALSE</literal> pour ces
éléments. Il est donc impossible de determiner si vous
êtes réellement à la fin de la liste en utilisant
la fonction <function>current</function>. Pour passer en revue proprement un
@@ -1481,10 +1548,10 @@
</funcprototype>
</funcsynopsis>
<para>
- Retourne la paire (clé/valeur) courante du tableau
- <parameter>array</parameter> et avance le pointeur de tableau. Cette paire
- est retournée dans un tableau de 4 éléments, avec les
- clés <emphasis>0</emphasis>, <emphasis>1</emphasis>,
+ <function>each</function> retourne la paire (clé/valeur) courante
+ du tableau <parameter>array</parameter> et avance le pointeur de tableau.
+ Cette paire est retournée dans un tableau de 4 éléments,
+ avec les clés <emphasis>0</emphasis>, <emphasis>1</emphasis>,
<emphasis>key</emphasis>, et <emphasis>value</emphasis>. Les
éléments <emphasis>0</emphasis> et <emphasis>key</emphasis>
contiennent le nom de la clé et, et <emphasis>1</emphasis> et
@@ -1492,14 +1559,16 @@
</para>
<para>
Si le pointeur interne de fichier est au delà de la fin du tableau,
- <function>each</function> retourne FALSE.
+ <function>each</function> retourne <literal>FALSE</literal>.
</para>
<para>
<example>
<title>Exemples avec <function>each</function></title>
<programlisting role="php">
+<?php
$foo = array ("bob", "fred", "jussi", "jouni", "egon", "marliese");
$bar = each ($foo);
+?>
</programlisting>
<para>
<literal>$bar</literal> contient maintenant les paires suivantes:
@@ -1510,9 +1579,11 @@
<listitem><simpara>value => 'bob'</simpara></listitem>
</itemizedlist>
<programlisting role="php">
+<?php
$foo = array ("Robert" => "Bob", "Seppo" => "Sepi");
$bar = each ($foo);
- </programlisting>
+?>
+ </programlisting>
</para>
<para>
<literal>$bar</literal> contient maintenant les paires suivantes:
@@ -1534,11 +1605,13 @@
Affichage de $HTTP_POST_VARS avec <function>each</function>
</title>
<programlisting role="php">
+<?php
echo "Valeurs transmises par la méthode POST:<br>";
reset ($HTTP_POST_VARS);
while (list ($key, $val) = each ($HTTP_POST_VARS)) {
echo "$key => $val<br>";
}
+?>
</programlisting>
</example>
</para>
@@ -1584,14 +1657,14 @@
<refnamediv>
<refname>extract</refname>
<refpurpose>
- Import variables into the symbol table from an array
+ Importe les variables dans la table des symboles
</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<funcsynopsis>
<funcprototype>
- <funcdef>void <function>extract</function></funcdef>
+ <funcdef>int <function>extract</function></funcdef>
<paramdef>array <parameter>var_array</parameter></paramdef>
<paramdef>int
<parameter><optional>extract_type</optional></parameter>
@@ -1602,13 +1675,19 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>extract</function> sert à exporter un tableau vers la table
des symboles.
- Elle prend un tableau associatif <parameter>var_array</parameter> et crée
- les variables dont les noms sont les index de ce tableau, et leur affecte la
- valeur associée. Pour chaque paire clé/valeur,
<function>extract</function>
- crée une variable, avec les paramètres
- <parameter>extract_type</parameter> et <parameter>prefix</parameter>.
+ <function>extract</function> sert à exporter un tableau vers la table des
+symboles.
+ Elle prend un tableau associatif <parameter>var_array</parameter> et crée
+ les variables dont les noms sont les index de ce tableau, et leur affecte la
+ valeur associée. Pour chaque paire clé/valeur,
+<function>extract</function>
+ crée une variable, avec les paramètres
+ <parameter>extract_type</parameter> et <parameter>prefix</parameter>.
</para>
+ <note>
+ <para>
+ Depuis la version 4.0.5, <function>extract</function> retourne le nombre de
+ variables extraites.
+ </para>
+ </note>
<para>
<function>extract</function> vérifie l'existence de la variable avant
de la créer. La manière de traiter les collisions est
@@ -1618,80 +1697,80 @@
<varlistentry>
<term>EXTR_OVERWRITE</term>
<listitem>
- <simpara>
- Lors d'une collision, réécrire la variable existante.
- </simpara>
+ <simpara>
+ Lors d'une collision, réécrire la variable existante.
+ </simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>EXTR_SKIP</term>
<listitem>
- <simpara>
- Lors d'une collision, ne pas réécrire la variable existante
- </simpara>
+ <simpara>
+ Lors d'une collision, ne pas réécrire la variable existante
+ </simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>EXTR_PREFIX_SAME</term>
<listitem>
- <simpara>
- Lors d'une collision, ajouter le préfixe
<parameter>prefix</parameter>,
- et créer une nouvelle variable.
- </simpara>
+ <simpara>
+ Lors d'une collision, ajouter le préfixe
+<parameter>prefix</parameter>,
+ et créer une nouvelle variable.
+ </simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>EXTR_PREFIX_ALL</term>
<listitem>
- <simpara>
- Ajouter le préfixe <parameter>prefix</parameter>, et créer
- une nouvelle variable.
- </simpara>
+ <simpara>
+ Ajouter le préfixe <parameter>prefix</parameter>, et créer
+ une nouvelle variable.
+ </simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
<para>
- Si <parameter>extract_type</parameter> est omis, extract() utilise
- EXTR_OVERWRITE par défault.
+ Si <parameter>extract_type</parameter> est omis, extract() utilise
+ EXTR_OVERWRITE par défault.
</para>
<para>
- Notez que <parameter>prefix</parameter> n'est nécessaire que pour
- les valeurs de <parameter>extract_type</parameter> suivantes :
- EXTR_PREFIX_SAME et EXTR_PREFIX_ALL.
+ Notez que <parameter>prefix</parameter> n'est nécessaire que pour
+ les valeurs de <parameter>extract_type</parameter> suivantes :
+ EXTR_PREFIX_SAME et EXTR_PREFIX_ALL.
</para>
<para>
- <function>extract</function> vérifie que les clés constitue
- un nom de variable valide, et si c'est le cas, procède à son
- exportation.
+ <function>extract</function> vérifie que les clés constitue
+ un nom de variable valide, et si c'est le cas, procède à son
+ exportation.
</para>
<para>
- Une utilisation possible de <function>extract</function> est l'exportation vers
la table des
- symboles de tableau de variables retourné par la fonction
- <function>wddx_deserialize</function>.
+ Une utilisation possible de <function>extract</function> est l'exportation
+ vers la table des symboles de tableau de variables retourné
+ par <function>wddx_deserialize</function>.
</para>
<para>
<example>
- <title>Exemples avec <function>extract</function></title>
+ <title>Exemple avec <function>extract</function></title>
<programlisting role="php">
<?php
/* Supposons que $var_array est un tableau retourné par
- wddx_deserialize */
+ <function>wddx_deserialize</function> */
$taille = "grand";
$var_array = array("couleur" => "bleu",
"taille" => "moyen",
"forme" => "sphere");
extract($var_array, EXTR_PREFIX_SAME, "wddx");
print "$couleur, $taille, $forme, $wddx_taille\n";
-?>
+?>
</programlisting>
</example>
</para>
<para>
L'exemple ci dessus va afficher
- <programlisting>
+ <computeroutput>
bleu, large, sphere, moyen
- </programlisting>
+ </computeroutput>
</para>
<para>
La variable $taille n'a pas été réécrite, car on
@@ -1718,21 +1797,48 @@
<funcdef>bool <function>in_array</function></funcdef>
<paramdef>mixed <parameter>needle</parameter></paramdef>
<paramdef>array <parameter>haystack</parameter></paramdef>
+ <paramdef>bool <parameter>strict</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
- Recherche <parameter>needle</parameter> dans <parameter>haystack</parameter> et
- retourne TRUE si il s'y trouve, ou FALSE sinon.
+ <function>in_array</function> recherche <parameter>needle</parameter> dans
+ <parameter>haystack</parameter> et retourne <literal>TRUE</literal> si il s'y
+trouve, ou <literal>FALSE</literal> sinon.
</para>
<para>
+ Si le troisième paramètre <parameter>strict</parameter> est
+optionel. S'il
+ vaut <literal>TRUE</literal> alors <function>in_array</function>
+ vérifiera aussi les types du paramètre
+<parameter>needle</parameter>
+ dans <parameter>haystack</parameter>.
+ </para>
+ <para>
<example>
<title>Exemple avec <function>in_array</function></title>
<programlisting role="php">
+<?php
$os = array("Mac", "NT", "Irix", "Linux");
if (in_array("Irix", $os))
print "Irix trouve";
+?>
</programlisting>
</example>
+ </para>
+ <para>
+ <example>
+ <title><function>in_array</function> avec le paramètre
+<parameter>strict</parameter></title>
+ <programlisting role="php">
+<?php
+$a = array('1.10', 12.4, 1.13);
+if (in_array('12.4', $a, <literal>TRUE</literal>))
+ echo "'12.4' trouvé avec une recherche stricte\n";
+if (in_array(1.13, $a, <literal>TRUE</literal>))
+ echo "1.13 trouvé avec une recherche stricte\n";
+?>
+ </programlisting>
+ L'affichage sera :
+ <computeroutput>
+1.13 trouvé avec une recherche stricte
+ </computeroutput>
+ </example>
<note>
<para>
<function>in_array</function> a été ajoutée dans PHP 4.0.
@@ -1785,11 +1891,13 @@
<example>
<title>Exemple avec <function>krsort</function></title>
<programlisting role="php">
+<?php
$fruits = array("d"=>"papaye","a"=>"orange","b"=>"banane","c"=>"ananas");
ksort($fruits);
for(reset($fruits); $key = key($fruits); next($fruits)) {
echo "fruits[$key] = ".$fruits[$key]."\n";
}
+?>
</programlisting>
</example>
Cet exemple va afficher :
@@ -1828,12 +1936,14 @@
<example>
<title>Exemple avec <function>ksort</function></title>
<programlisting role="php">
+<?php
$fruits = array("d"=>"papaye","a"=>"orange","b"=>"banane","c"=>"ananas");
-ksort ($fruits);
-reset ($fruits);
+ksort($fruits);
+reset($fruits);
while (list ($key, $val) = each ($fruits)) {
- echo "$key -> $val\n";
+ echo "$key => $val\n";
}
+?>
</programlisting>
</example>
Cet exemple va afficher :
@@ -1876,13 +1986,14 @@
</funcprototype>
</funcsynopsis>
<para>
- Tout comme <function>array</function>, ce n'est pas une
+ Tout comme <function>array</function>, <function>list</function> n'est pas une
véritable fonction, mais une construction syntaxique,
qui permet d'assigner une série de variable en une
seule ligne.
<example>
<title>Exemple avec <function>list</function></title>
<programlisting role="php">
+<?php
<table>
<tr>
<th>Employee name</th>
@@ -1896,8 +2007,9 @@
" <td>$salary</td>\n".
" </tr>\n");
}
-?>
+?>
</table>
+?>
</programlisting>
</example>
</para>
@@ -1933,6 +2045,7 @@
<example>
<title>Exemple avec <function>natsort</function></title>
<programlisting role="php">
+<?php
$array1 = $array2 = array ("img12.png","img10.png","img2.png","img1.png");
sort($array1);
echo "Tri Standard\n";
@@ -1940,6 +2053,7 @@
natsort($array2);
echo "\nTri par Ordre Naturel\n";
print_r($array2);
+?>
</programlisting>
</example>
</para>
@@ -1948,7 +2062,7 @@
</para>
<para>
<informalexample>
- <programlisting>
+ <computeroutput>
Tri Standard
Array
(
@@ -1965,10 +2079,10 @@
[1] => img10.png
[0] => img12.png
)
- </programlisting>
+?>
+ </computeroutput>
</informalexample>
- Pour plus de détails, rendez vous sur le site de :
- Martin Pool's
+ Pour plus de détails, rendez vous sur le site de Martin Pool
<ulink url="&url.strnatcmp;">Natural Order String Comparison</ulink>.
</para>
<para>
@@ -2033,7 +2147,7 @@
</funcsynopsis>
<para>
<function>next</function> retourne l'élément suivant du tableau,
- ou FALSE si il n'y a plus d'éléments. Le pointeur de interne de
+ ou <literal>FALSE</literal> si il n'y a plus d'éléments. Le
+pointeur de interne de
tableau est avancé d'un élément.
</para>
<para>
@@ -2041,11 +2155,11 @@
<function>current</function>, mais avec une différence : il avance le
pointeur interne de tableau d'un élément avant de retourner la
valeur qu'il pointe. Lorsque le pointeur dépasse le dernier
- élément, <function>next</function> retourne false.
+ élément, <function>next</function> retourne
+<literal>FALSE</literal>.
<warning>
<para>
Si le tableau contient des éléments vides ou des zéros,
- <function>next</function> retournera FALSE pour ces éléments.
+ <function>next</function> retournera <literal>FALSE</literal> pour ces
+éléments.
Pour passer proprement en revue un tableau, il faut utiliser
<function>each</function>.
</para>
@@ -2072,7 +2186,7 @@
</funcprototype>
</funcsynopsis>
<simpara>
- C'est une fonction alias de <function>current</function>.
+ <function>pos</function> est une fonction alias de <function>current</function>.
</simpara>
<para>
Voir aussi:
@@ -2095,14 +2209,14 @@
</funcprototype>
</funcsynopsis>
<para>
- Repositionne le pointeur interne de tableau à la dernière
- place qu'il occupait, ou bien retourne FALSE si il ne reste plus
- d'éléments.
+ <function>prev</function> repositionne le pointeur interne de tableau à
+ la dernière place qu'il occupait, ou bien retourne
+<literal>FALSE</literal> si il
+ ne reste plus d'éléments.
<warning>
<para>
- Si le tableau contient des éléments vides,
- <function>prev</function> retournera FALSE pour ces
- éléments aussi. Pour passer en revue tous les
+ Si le tableau contient des éléments vides,
+ <function>prev</function> retournera <literal>FALSE</literal> pour ces
+ éléments aussi. Pour passer en revue tous les
éléments, utilisez plutôt <function>each</function>.
</para>
</warning>
@@ -2192,11 +2306,13 @@
<example>
<title>Exemple avec <function>rsort</function></title>
<programlisting role="php">
+<?php
$fruits = array("papaye","orange","banane","ananas");
rsort($fruits);
for (reset($fruits); list($key,$value) = each($fruits); ) {
echo "fruits[$key] = ", $value, "\n";
}
+?>
</programlisting>
</example>
Cet exemple va afficher:
@@ -2235,19 +2351,21 @@
<example>
<title>Exemple avec <function>shuffle</function></title>
<programlisting role="php">
+<?php
$numbers = range (1,20);
srand (time());
shuffle ($numbers);
while (list(, $number) = each ($numbers)) {
echo "$number ";
}
+?>
</programlisting>
</example>
</para>
<para>
Voir aussi <function>arsort</function>, <function>asort</function>,
<function>ksort</function>, <function>rsort</function>,
- <function>sort</function> and <function>usort</function>.
+ <function>sort</function> et <function>usort</function>.
</para>
</refsect1>
</refentry>
@@ -2265,7 +2383,7 @@
</funcprototype>
</funcsynopsis>
<para>
- Retourne le nombre d'élément d'un tableau.
+ <function>sizeof</function> retourne le nombre d'élément d'un
+tableau.
</para>
<para>
Voir aussi: <function>count</function>
@@ -2291,11 +2409,13 @@
<example>
<title>Exemple avec <function>sort</function></title>
<programlisting role="php">
+<?php
$fruits = array("papaye","orange","banane","ananas");
sort($fruits);
for(reset($fruits); $key = key($fruits); next($fruits)) {
echo "fruits[$key] = ".$fruits[$key]."\n";
}
+?>
</programlisting>
</example>
Cet exemple va afficher :
@@ -2363,6 +2483,7 @@
<example>
<title>Exemple avec <function>uksort</function></title>
<programlisting role="php">
+<?php
function mycompare($a, $b) {
if ($a == $b) return 0;
return ($a > $b) ? -1 : 1;
@@ -2372,6 +2493,7 @@
while(list($key, $value) = each($a)) {
echo "$key: $value\n";
}
+?>
</programlisting>
</example>
Cet exemple affichera:
@@ -2394,7 +2516,8 @@
<refnamediv>
<refname>usort</refname>
<refpurpose>
- Trie les valeurs d'un tableau en utilisant une fonction de comparaison
définie par l'utilisateur
+ Trie les valeurs d'un tableau en utilisant une fonction de comparaison
+définie
+ par l'utilisateur
</refpurpose>
</refnamediv>
<refsect1>
@@ -2413,14 +2536,15 @@
cette méthode.
</para>
<para>
- La fonction de comparaison doit retourner un entier, qui sera inférieur,
- égal ou supérieur à zéro suivant que le premier
- argument est considéré comme plus petit, égal ou plus
- grand que le second argument. Si les deux arguments sont égaux, leur
- ordre est indéfini.
+ La fonction de comparaison <parameter>cmp_function</parameter> doit retourner
+un entier,
+ qui sera inférieur, égal ou supérieur à zéro
+ suivant que le premier argument est considéré comme plus petit,
+ égal ou plus grand que le second argument. Si les deux arguments sont
+ égaux, leur ordre est indéfini.
<example>
<title>Exemple avec <function>usort</function></title>
- <programlisting>
+ <programlisting role="php">
+<?php
function cmp($a,$b) {
if ($a == $b) return 0;
return ($a > $b) ? -1 : 1;
@@ -2430,6 +2554,7 @@
while(list($key,$value) = each($a)) {
echo "$key: $value\n";
}
+?>
</programlisting>
</example>
Cet exemple va afficher :
@@ -2457,7 +2582,7 @@
<para>
Voir aussi: <function>arsort</function>,
<function>asort</function>, <function>ksort</function>,
- <function>rsort</function> and <function>sort</function>.
+ <function>rsort</function> et <function>sort</function>.
</para>
</refsect1>
</refentry>
Index: phpdoc/fr/functions/aspell.xml
diff -u phpdoc/fr/functions/aspell.xml:1.6 phpdoc/fr/functions/aspell.xml:1.7
--- phpdoc/fr/functions/aspell.xml:1.6 Thu Dec 14 01:17:32 2000
+++ phpdoc/fr/functions/aspell.xml Tue Jan 16 02:38:37 2001
@@ -1,30 +1,28 @@
<reference id="ref.aspell">
- <title>Fonctions Aspell</title>
+ <title>Aspell</title>
<titleabbrev>aspell</titleabbrev>
-
<partintro>
<simpara>
- Les fonctions Aspell vous permettent de vérifier l'orthographe d'un mot,
+ Les fonctions Aspell vous permettent de vérifier l'orthographe d'un mot,
et d'offrir des suggestions de corrections. Plusieurs langues sont disponibles,
comme le franç, l'allemand, le suédois et le danois.
</simpara>
<note>
<simpara>
- aspell fonctionne avec de très vielles versions (jusqu'à la
- version .27.* ou presque) de la librairie aspell. Ce module, et ces versions
- d'Aspell ne sont plus supportées. Si vous voulez utiliser les
- possibilités de vérifications d'orthographe en PHP,
- utilisez plutôt <link linkend="ref.pspell">pspell</link>.
- Ce module utilise la librairie pspell qui fonctionne avec les
+ aspell fonctionne avec de très vielles versions (jusqu'à la
+ version .27.* ou presque) de la librairie aspell. Ce module, et ces versions
+ d'Aspell ne sont plus supportées. Si vous voulez utiliser les
+ possibilités de vérifications d'orthographe en PHP,
+ utilisez plutôt <link linkend="ref.pspell">pspell</link>.
+ Ce module utilise la librairie pspell qui fonctionne avec les
nouvelles versions de Aspell.
</simpara>
</note>
<simpara>
- Vous avez besoin de la librairie Aspell, disponible à :
+ Vous avez besoin de la librairie Aspell, disponible à :
<ulink
url="http://aspell.sourceforge.net/">http://aspell.sourceforge.net/</ulink>.
</simpara>
</partintro>
-
<refentry id="function.aspell-new">
<refnamediv>
<refname>aspell_new</refname>
@@ -40,20 +38,22 @@
</funcprototype>
</funcsynopsis>
<simpara>
- <function>aspell_new</function> ouvre un nouveau dictionaire, et
+ <function>aspell_new</function> ouvre un nouveau dictionaire, et
retourne un identifiant de dictionnaire pour utilisation ultérieure
dans les fonctions aspell.
</simpara>
<para>
<example>
<title>aspell_new</title>
- <programlisting>
+ <programlisting role="php">
+<?php
$aspell_link=aspell_new("english");
+?>
</programlisting>
- </example></para>
+ </example>
+ </para>
</refsect1>
</refentry>
-
<refentry id="function.aspell-check">
<refnamediv>
<refname>aspell_check</refname>
@@ -69,30 +69,30 @@
</funcprototype>
</funcsynopsis>
<simpara>
- <function>aspell_check</function> vérifie l'orthographe d'un mot et
retourne TRUE
- si l'orthographe est correcte, et FALSE sinon.
+ <function>aspell_check</function> vérifie l'orthographe d'un mot et
+retourne <literal>TRUE</literal> si l'orthographe est correcte, et
+<literal>FALSE</literal> sinon.
</simpara>
<para>
<example>
<title>aspell_check</title>
- <programlisting>
+ <programlisting role="php">
+<?php
$aspell_link=aspell_new("english");
if (aspell_check($aspell_link,"testt")) {
echo "L'orthographe est correcte.";
} else {
echo "Désolé, l'orthographe est incorrecte.";
}
+?>
</programlisting>
</example>
</para>
</refsect1>
</refentry>
-
<refentry id="function.aspell-check-raw">
<refnamediv>
- <refname>aspell_check-raw</refname>
+ <refname>aspell_check-raw</refname>
<refpurpose>
- Vérifie un mot sans en changer la casse et sans essayer de supprimer
+ Vérifie un mot sans en changer la casse et sans essayer de supprimer
les espaces aux extrémités.
</refpurpose>
</refnamediv>
@@ -106,27 +106,28 @@
</funcprototype>
</funcsynopsis>
<simpara>
- <function>aspell_check_raw</function> vérifie l'orthographe
- d'un mot sans en changer la casse, et sans essayer de supprimer les
- espaces aux extrémités. Elle retourne true si l'orthographe
- est bonne, et false sinon.
+ <function>aspell_check_raw</function> vérifie l'orthographe
+ d'un mot sans en changer la casse, et sans essayer de supprimer les
+ espaces aux extrémités. Elle retourne <literal>TRUE</literal> si
+l'orthographe
+ est bonne, et <literal>FALSE</literal> sinon.
</simpara>
<para>
<example>
<title>aspell_check_raw</title>
- <programlisting>
+ <programlisting role="php">
+<?php
$aspell_link=aspell_new("french");
if (aspell_check_raw($aspell_link,"testt")) {
echo "L'orthographe est OK";
} else {
echo "Attention : faute d'orthographe";
}
+?>
</programlisting>
</example>
</para>
</refsect1>
</refentry>
-
<refentry id="function.aspell-suggest">
<refnamediv>
<refname>aspell_suggest</refname>
@@ -142,22 +143,22 @@
</funcprototype>
</funcsynopsis>
<simpara>
- <function>aspell_suggest</function> retourne un tableau contenant
+ <function>aspell_suggest</function> retourne un tableau contenant
les orthographes possibles d'un mot mal formé.
</simpara>
<para>
<example>
<title>aspell_suggest</title>
- <programlisting>
+ <programlisting role="php">
+<?php
$aspell_link=aspell_new("french");
-
if (!aspell_check($aspell_link,"testt")) {
$suggestions=aspell_suggest($aspell_link,"testt");
-
for($i=0; $i < count($suggestions); $i++) {
- echo "Orthographes envisageables : " . $suggestions[$i] . "<br>";
+ echo "Orthographes envisageables : " . $suggestions[$i] . "<br>";
}
}
+?>
</programlisting>
</example>
</para>
Index: phpdoc/fr/functions/bc.xml
diff -u phpdoc/fr/functions/bc.xml:1.2 phpdoc/fr/functions/bc.xml:1.3
--- phpdoc/fr/functions/bc.xml:1.2 Fri Nov 3 03:59:58 2000
+++ phpdoc/fr/functions/bc.xml Tue Jan 16 02:38:38 2001
@@ -1,25 +1,23 @@
<reference id="ref.bc">
- <title>Fonctions mathématiques sur des nombres de taille arbitraire</title>
+ <title>Nombres de grande taille</title>
<titleabbrev>BC math</titleabbrev>
-
<partintro>
<simpara>
- Ces fonctions ne sont disponibles que si l'option de configuration
- <option role="configure">--enable-bcmath</option> a été
activée lors de la
+ Ces fonctions ne sont disponibles que si l'option de configuration
+ <option role="configure">--enable-bcmath</option> a été
+activée lors de la
compilation.
</simpara>
<note>
<para>
Suite aux changement de licence, la librairie BCMATH
- est désormais distribuée séparemment.
- Vous pouvez télécharger l'archive à
+ est désormais distribuée séparemment.
+ Vous pouvez télécharger l'archive à
<ulink url="&url.bcmath;">&url.bcmath;</ulink>. Lisez
attentivement le fichier <filename>README.BCMATH</filename>
de la distribution PHP.
</para>
</note>
</partintro>
-
<refentry id="function.bcadd">
<refnamediv>
<refname>bcadd</refname>
@@ -32,23 +30,23 @@
<funcdef>string <function>bcadd</function></funcdef>
<paramdef>string <parameter>left operand</parameter></paramdef>
<paramdef>string <parameter>right operand</parameter></paramdef>
- <paramdef>int
+ <paramdef>int
<parameter><optional>scale</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
- Additionne <parameter>left operand</parameter> avec l'opérande
- <parameter>right operand</parameter> et renvoie la somme sous forme de
chaîne de
- caractères. Le paramètre optionnel <parameter>scale</parameter>
est utilisé pour
- définir le nombre de chiffres après la virgule dans le
résultat.
+ <function>bcadd</function> additionne <parameter>left operand</parameter> avec
+ l'opérande <parameter>right operand</parameter> et renvoie la somme sous
+ forme de chaîne de caractères. Le paramètre optionnel
+ <parameter>scale</parameter> est utilisé pour définir le nombre
+ de chiffres après la virgule dans le résultat.
</para>
<para>
Voir aussi <function>bcsub</function>.
</para>
</refsect1>
</refentry>
-
<refentry id="function.bccomp">
<refnamediv>
<refname>bccomp</refname>
@@ -61,25 +59,25 @@
<funcdef>int <function>bccomp</function></funcdef>
<paramdef>string <parameter>left operand</parameter></paramdef>
<paramdef>string <parameter>right operand</parameter></paramdef>
- <paramdef>int
+ <paramdef>int
<parameter><optional>scale</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
- Compare l'opérande <parameter>left operand</parameter> avec
l'opérande
- <parameter>right operand</parameter> et renvoie le résultat sous forme de
valeur
- numérique (integer). Le paramètre optionnel
<parameter>scale</parameter> est
- utilisé pour définir le nombre de chiffres après la virgule
utilisés lors de la
- comparaison. Le résultat est 0 si les deux opérandes sont
égales. Si l'opérande
- <parameter>left operand</parameter> est plus grande que l'opérande
- <parameter>right operand</parameter>, le résultat est 1.
- Si l'opérande <parameter>left operand</parameter> est plus petite que
l'opérande
- <parameter>right operand</parameter>, le résultat est -1.
+ <function>bccomp</function> compare l'opérande <parameter>left
+operand</parameter>
+ avec l'opérande <parameter>right operand</parameter> et renvoie le
+ résultat sous forme de valeur numérique (integer). Le
+paramètre
+ optionnel <parameter>scale</parameter> est utilisé pour définir le
+ nombre de chiffres après la virgule utilisés lors de la
+ comparaison. Le résultat est 0 si les deux opérandes sont
+égales. Si
+ l'opérande <parameter>left operand</parameter> est plus grande que
+ l'opérande <parameter>right operand</parameter>, le résultat est 1.
+ Si l'opérande <parameter>left operand</parameter> est plus petite que
+ l'opérande <parameter>right operand</parameter>, le résultat est
+-1.
</para>
</refsect1>
</refentry>
-
<refentry id="function.bcdiv">
<refnamediv>
<refname>bcdiv</refname>
@@ -92,23 +90,22 @@
<funcdef>string <function>bcdiv</function></funcdef>
<paramdef>string <parameter>left operand</parameter></paramdef>
<paramdef>string <parameter>right operand</parameter></paramdef>
- <paramdef>int
+ <paramdef>int
<parameter><optional>scale</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
- Divise l'opérande <parameter>left operand</parameter> par
l'opérande
- <parameter>right operand</parameter> et renvoie le résultat. Le
paramètre optionnel
- <parameter>scale</parameter> définit le nombre de chiffres après
la virgule dans
- le résultat.
+ <function>bcdiv</function> divise l'opérande <parameter>left
+operand</parameter>
+ par l'opérande <parameter>right operand</parameter> et renvoie le
+ résultat. Le paramètre optionnel <parameter>scale</parameter>
+ définit le nombre de chiffres après la virgule dans le
+résultat.
</para>
<para>
Voir aussi <function>bcmul</function>.
</para>
</refsect1>
</refentry>
-
<refentry id="function.bcmod">
<refnamediv>
<refname>bcmod</refname>
@@ -126,15 +123,14 @@
</funcprototype>
</funcsynopsis>
<para>
- Retourne le reste de la division entre <parameter>left operand</parameter> en
- utilisant <parameter>modulus</parameter>.
+ <function>bcmod</function> retourne le reste de la division entre
+ <parameter>left operand</parameter> en utilisant <parameter>modulus</parameter>.
</para>
<para>
Voir aussi <function>bcdiv</function>.
</para>
</refsect1>
</refentry>
-
<refentry id="function.bcmul">
<refnamediv>
<refname>bcmul</refname>
@@ -147,23 +143,22 @@
<funcdef>string <function>bcmul</function></funcdef>
<paramdef>string <parameter>left operand</parameter></paramdef>
<paramdef>string <parameter>right operand</parameter></paramdef>
- <paramdef>int
+ <paramdef>int
<parameter><optional>scale</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
- Multiplie l'opérande <parameter>left operand</parameter> par
l'opérande
- <parameter>right operand</parameter> et renvoie le résultat. Le
paramètre
- optionnel <parameter>scale</parameter> définit le nombre de chiffres
après la
- virgule dans le résultat.
+ <function>bcmul</function> multiplie l'opérande <parameter>left
+operand</parameter>
+ par l'opérande <parameter>right operand</parameter> et renvoie le
+résultat.
+ Le paramètre optionnel <parameter>scale</parameter> définit le
+nombre
+ de chiffres après la virgule dans le résultat.
</para>
<para>
Voir aussi <function>bcdiv</function>.
</para>
</refsect1>
</refentry>
-
<refentry id="function.bcpow">
<refnamediv>
<refname>bcpow</refname>
@@ -178,27 +173,28 @@
<funcdef>string <function>bcpow</function></funcdef>
<paramdef>string <parameter>x</parameter></paramdef>
<paramdef>string <parameter>y</parameter></paramdef>
- <paramdef>int
+ <paramdef>int
<parameter><optional>scale</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
- Elève <parameter>x</parameter> à la puissance
<parameter>y</parameter>.
- Le paramètre optionnel <parameter>scale</parameter> définit le
nombre de chiffres
- après la virgule dans le résultat.
+ <function>bcpow</function> élève <parameter>x</parameter> à
+ la puissance <parameter>y</parameter>. Le paramètre optionnel
+ <parameter>scale</parameter> définit le nombre de chiffres après
+ la virgule dans le résultat.
</para>
<para>
Voir aussi <function>bcsqrt</function>.
</para>
</refsect1>
</refentry>
-
<refentry id="function.bcscale">
<refnamediv>
<refname>bcscale</refname>
<refpurpose>
- Détermine le nombre de décimales par défaut pour les
fonctions de précision mathématiques.
+ Détermine le nombre de décimales par défaut pour les
+ fonctions de précision mathématiques.
</refpurpose>
</refnamediv>
<refsect1>
@@ -210,13 +206,12 @@
</funcprototype>
</funcsynopsis>
<para>
- Cette fonction définit la précision par défaut pour toutes
les fonctions
- mathématiques sur des nombres de taille arbitraire qui suivent et qui
omettent
- le paramètre <parameter>scale</parameter>.
+ <function>bcscale</function> définit la précision par
+défaut
+ pour toutes les fonctions mathématiques sur des nombres de taille
+ arbitraire qui suivent et qui omettent le paramètre
+<parameter>scale</parameter>.
</para>
</refsect1>
</refentry>
-
<refentry id="function.bcsqrt">
<refnamediv>
<refname>bcsqrt</refname>
@@ -230,20 +225,22 @@
<funcprototype>
<funcdef>string <function>bcsqrt</function></funcdef>
<paramdef>string <parameter>operand</parameter></paramdef>
- <paramdef>int <parameter>scale</parameter></paramdef>
+ <paramdef>int
+ <parameter><optional>scale</optional></parameter>
+ </paramdef>
</funcprototype>
</funcsynopsis>
<para>
- Renvoie la racine carrée de l'opérande
<parameter>operand</parameter>.
- Le paramètre optionnel <parameter>scale</parameter> définit le
nombre
- de chiffres après la virgule dans le résultat.
+ <function>bcsqrt</function> renvoie la racine carrée de l'opérande
+ <parameter>operand</parameter>. Le paramètre optionnel
+ <parameter>scale</parameter> définit le nombre de chiffres après la
+ virgule dans le résultat.
</para>
<para>
Voir aussi <function>bcpow</function>.
</para>
</refsect1>
</refentry>
-
<refentry id="function.bcsub">
<refnamediv>
<refname>bcsub</refname>
@@ -258,25 +255,24 @@
<funcdef>string <function>bcsub</function></funcdef>
<paramdef>string <parameter>left operand</parameter></paramdef>
<paramdef>string <parameter>right operand</parameter></paramdef>
- <paramdef>int
+ <paramdef>int
<parameter><optional>scale</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
- Soustrait l'opérande <parameter>right operand</parameter> de
l'opérande
- <parameter>left operand</parameter> et renvoie le résultat sous forme
de chaîne
- de caractères. Le paramètre optionnel
<parameter>scale</parameter> définit le
- nombre de chiffres après la virgule dans le résultat.
+ <function>bcsub</function> soustrait l'opérande <parameter>right
+operand</parameter>
+ de l'opérande <parameter>left operand</parameter> et renvoie le
+résultat
+ sous forme de chaîne de caractères. Le paramètre optionnel
+ <parameter>scale</parameter> définit le nombre de chiffres après
+ la virgule dans le résultat.
</para>
<para>
Voir aussi <function>bcadd</function>.
</para>
</refsect1>
</refentry>
-
</reference>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Index: phpdoc/fr/functions/calendar.xml
diff -u phpdoc/fr/functions/calendar.xml:1.2 phpdoc/fr/functions/calendar.xml:1.3
--- phpdoc/fr/functions/calendar.xml:1.2 Thu Nov 9 01:15:45 2000
+++ phpdoc/fr/functions/calendar.xml Tue Jan 16 02:38:38 2001
@@ -1,37 +1,35 @@
<reference id="ref.calendar">
- <title>Fonctions de calendrier</title>
+ <title>Calendrier</title>
<titleabbrev>Calendrier</titleabbrev>
-
<partintro>
<para>
- Les fonctions de calendrier ne sont disponibles que si
- l'extension calendrier a été compilée.
- Elle est située dans les sous-dossiers "dl" ou "ext"
- de votre distribution de PHP. Lisez le fichier
- README pour plus de détails.
+ Les fonctions de calendrier ne sont disponibles que si
+ l'extension calendrier a été compilée.
+ Elle est située dans les sous-dossiers "dl" ou "ext"
+ de votre distribution de PHP. Lisez le fichier
+ README pour plus de détails.
</para>
<para>
- L'extension de calendrier propose une série de fonctions
- qui simplifie les conversions entre les différents formats
- de calendrier. La référence est le nombre de jour du
- calendrier Julien. C'est le nombre de jours depuis une date qui
- commence bien au delà des dates les plus reculées
- dont on a besoin (située en 4000 avant J.C.). Pour convertir
- une date d'un calendrier à un autre, il faut d'abord la convertir
- dans ce calendrier, puis convertir le résultat dans le calendrier
- désiré. Attention, le nombre de jour du calendrier Julien
- est un système très différent du calendrier Julien!.
- Pour plus d'informations (en anglais), reportez vous à
- <ulink url="&url.calendar;">&url.calendar;</ulink>.
- Les traductions issues de ces pages seront mises entre guillemets.
+ L'extension de calendrier propose une série de fonctions
+ qui simplifie les conversions entre les différents formats
+ de calendrier. La référence est le nombre de jour du
+ calendrier Julien. C'est le nombre de jours depuis une date qui
+ commence bien au delà des dates les plus reculées
+ dont on a besoin (située en 4000 avant J.C.). Pour convertir
+ une date d'un calendrier à un autre, il faut d'abord la convertir
+ dans ce calendrier, puis convertir le résultat dans le calendrier
+ désiré. Attention, le nombre de jour du calendrier Julien
+ est un système très différent du calendrier Julien!.
+ Pour plus d'informations (en anglais), reportez vous à
+ <ulink url="&url.calendar;">&url.calendar;</ulink>.
+ Les traductions issues de ces pages seront mises entre guillemets.
</para>
</partintro>
-
<refentry id="function.jdtogregorian">
<refnamediv>
<refname>JDToGregorian</refname>
<refpurpose>
- Converti le nombre de jours du calendrier Julien en date grégorienne.
+ Convertit le nombre de jours du calendrier Julien en date
+grégorienne.
</refpurpose>
</refnamediv>
<refsect1>
@@ -40,21 +38,21 @@
<funcdef>string <function>jdtogregorian</function></funcdef>
<paramdef>int <parameter>julianday</parameter></paramdef>
</funcsynopsis>
- <para>
- Converti le nombre de jours du calendrier Julien en une chaîne
contenant une
- date du calendrier grégorien, au format "mois/jour/année".
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.gregoriantojd">
- <refnamediv>
- <refname>GregorianToJD</refname>
- <refpurpose>
- Converti une date grégorienne en nombre de jours du calendrier
julien.
- </refpurpose>
- </refnamediv>
- <refsect1>
+ <para>
+ <function>jdtogregorian</function> convertit le nombre de jours du
+ calendrier Julien en une chaîne contenant une date du calendrier
+ grégorien, au format "mois/jour/année".
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.gregoriantojd">
+ <refnamediv>
+ <refname>GregorianToJD</refname>
+ <refpurpose>
+ Convertit une date grégorienne en nombre de jours du calendrier julien.
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
<title>Description</title>
<funcsynopsis>
<funcdef>int <function>gregoriantojd</function></funcdef>
@@ -63,62 +61,61 @@
<paramdef>int <parameter>year</parameter></paramdef>
</funcsynopsis>
<para>
- Intervalle de validité pour le calendrier grégorien : 4714
avant JC à 9999
- après JC.A.D.
- </para>
- <para>
- Bien qu'il soit possible de manipuler des dates jusqu'en 4714 avant JC,
- une telle utilisation n'est pas significative. En effet, ce calendrier
fut
- créé le 18 octobre 1582 après J.C. (ou 5 octobre
1582 en calendrier grec).
- Certains pays ne l'acceptèrent que bien plus tard. Par exemple,
les
- britanniques n'y passèrent en 1752, les Russes en 1918 et les
Grecs en 1923.
- La plus part des pays européens utilisaient le calendrier Julien
avant le
- Grégorien.
- <example>
- <title>Fonctions calendrier</title>
- <programlisting role="php">
+ Intervalle de validité pour le calendrier grégorien :
+ 4714 avant JC à 9999 après JC.A.D.
+ </para>
+ <para>
+ Bien qu'il soit possible de manipuler des dates jusqu'en 4714 avant JC,
+ une telle utilisation n'est pas significative. En effet, ce calendrier fut
+ créé le 18 octobre 1582 après J.C. (ou 5 octobre 1582
+ en calendrier grec). Certains pays ne l'acceptèrent que bien plus
+ tard. Par exemple, les britanniques n'y passèrent en 1752, les
+ Russes en 1918 et les Grecs en 1923. La plus part des pays européens
+ utilisaient le calendrier Julien avant le Grégorien.
+ <example>
+ <title>Fonctions calendrier</title>
+ <programlisting role="php">
<?php
-$jd = GregorianToJD(10,11,1970);
+$jd = gregoriantojd(10,11,1970);
echo("$jd\n");
-$gregorian = JDToGregorian($jd);
+$gregorian = jdtogregorian($jd);
echo("$gregorian\n");
-?>
-</programlisting>
-</example></para>
-
+?>
+ </programlisting>
+ </example>
+ </para>
</refsect1>
</refentry>
-
<refentry id="function.jdtojulian">
<refnamediv>
- <refname>JDToJulian</refname>
- <refpurpose>
- Converti le nombre de jours du calendrier Julien en date du calendrier
- Julien.
- </refpurpose>
- </refnamediv>
- <refsect1>
+ <refname>JDToJulian</refname>
+ <refpurpose>
+ Convertit le nombre de jours du calendrier Julien en date du calendrier
+ Julien.
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
<title>Description</title>
<funcsynopsis>
<funcdef>string <function>jdtojulian</function></funcdef>
<paramdef>int <parameter>julianday</parameter></paramdef>
</funcsynopsis>
<para>
- Converti le nombre de jours du calendrier Julien en une chaîne
contenant
- la date du calendrier Julien, au format "mois/jour/année".
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.juliantojd">
- <refnamediv>
- <refname>JulianToJD</refname>
- <refpurpose>
- Converti le nombre de jour du calendrier Julien en date du calendrier
- Julien.
- </refpurpose>
- </refnamediv>
- <refsect1>
+ <function>jdtojulian</function> convertit le nombre de jours du calendrier
+ Julien en une chaîne contenant la date du calendrier Julien, au format
+ "mois/jour/année".
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.juliantojd">
+ <refnamediv>
+ <refname>JulianToJD</refname>
+ <refpurpose>
+ Convertit le nombre de jour du calendrier Julien en date du calendrier
+ Julien.
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
<title>Description</title>
<funcsynopsis>
<funcdef>int <function>juliantojd</function></funcdef>
@@ -126,48 +123,49 @@
<paramdef>int <parameter>day</parameter></paramdef>
<paramdef>int <parameter>year</parameter></paramdef>
</funcsynopsis>
- <para>
- Intervalle de validité du calendrier Julien : 4713 avant JC à
9999 après J.C..
- </para>
- <para>
- Bien qu'il soit possible de manipuler des dates jusqu'en 4713 avant JC,
- une telle utilisation n'est pas significative. En effet, ce calendrier fut
- créé en 46 avant JC, et ses détails ne furent
finalisés qu'au plus tôt en 8
- après JC, et probablement pas avant le 4ème siècle
après JC. De plus, le
- début de l'année variait suivant les peuples, certains
n'acceptant pas
- janvier comme premier mois de l'année.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.jdtojewish">
- <refnamediv>
+ <para>
+ Intervalle de validité du calendrier Julien : 4713 avant JC à
+ 9999 après J.C..
+ </para>
+ <para>
+ Bien qu'il soit possible de manipuler des dates jusqu'en 4713 avant JC,
+ une telle utilisation n'est pas significative. En effet, ce calendrier fut
+ créé en 46 avant JC, et ses détails ne furent
+ finalisés qu'au plus tôt en 8 après JC, et probablement
+ pas avant le 4ème siècle après JC. De plus, le
+ début de l'année variait suivant les peuples, certains
+ n'acceptant pas janvier comme premier mois de l'année.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.jdtojewish">
+ <refnamediv>
<refname>JDToJewish</refname>
<refpurpose>
- Converti le nombre de jours du calendrier julien en date du calendrier
- juif.
- </refpurpose>
- </refnamediv>
- <refsect1>
+ Convertit le nombre de jours du calendrier julien en date du calendrier
+ juif.
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
<title>Description</title>
<funcsynopsis>
<funcdef>string <function>jdtojewish</function></funcdef>
<paramdef>int <parameter>julianday</parameter></paramdef>
</funcsynopsis>
- <para>
- Converti le nombre de jours du calendrier julien en date du calendrier juif.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.jewishtojd">
- <refnamediv>
- <refname>JewishToJD</refname>
- <refpurpose>
- Converti une date du calendrier juif en nombre de jours du calendrier
julien.
- </refpurpose>
- </refnamediv>
- <refsect1>
+ <para>
+ <function>jdtojewish</function> convertit le nombre de jours du calendrier
+ julien en date du calendrier juif.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.jewishtojd">
+ <refnamediv>
+ <refname>JewishToJD</refname>
+ <refpurpose>
+ Convertit une date du calendrier juif en nombre de jours du calendrier julien.
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
<title>Description</title>
<funcsynopsis>
<funcdef>int <function>jewishtojd</function></funcdef>
@@ -175,48 +173,47 @@
<paramdef>int <parameter>day</parameter></paramdef>
<paramdef>int <parameter>year</parameter></paramdef>
</funcsynopsis>
- <para>
- Bien qu'il soit possible de manipuler des dates à partir de l'an 1
(3761
- avant JC), une telle utilisation a peu de sens.
- </para>
- <para>
- Le calendrier juif a été utilisé depuis plusieurs
dizaines de siècles, mais
- dans les premiers temps, il n'y avait pas de formule pour déterminer
le début
- du mois. Un nouveau mois commencait quand une nouvelle lune était
observée.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.jdtofrench">
- <refnamediv>
+ <para>
+ Bien qu'il soit possible de manipuler des dates à partir de l'an 1 (3761
+ avant JC), une telle utilisation a peu de sens.
+ </para>
+ <para>
+ Le calendrier juif a été utilisé depuis plusieurs
+ dizaines de siècles, mais dans les premiers temps, il n'y avait
+ pas de formule pour déterminer le début du mois. Un nouveau
+ mois commencait quand une nouvelle lune était observée.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.jdtofrench">
+ <refnamediv>
<refname>JDToFrench</refname>
<refpurpose>
- Converti le nombre de jours du calendrier julien en date du calendrier
- français républicain
- </refpurpose>
- </refnamediv>
- <refsect1>
+ Convertit le nombre de jours du calendrier julien en date du calendrier
+ français républicain
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
<title>Description</title>
<funcsynopsis>
<funcdef>string <function>jdtofrench</function></funcdef>
<paramdef>int <parameter>juliandaycount</parameter></paramdef>
</funcsynopsis>
- <para>
- Converti le nombre de jours du calendrier julien en date du calendrier
- français républicain.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.frenchtojd">
- <refnamediv>
+ <para>
+ <function>jdtofrench</function> convertit le nombre de jours du calendrier
+ julien en date du calendrier français républicain.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.frenchtojd">
+ <refnamediv>
<refname>FrenchToJD</refname>
<refpurpose>
- Converti une date du calendrier français républicain en
nombre de jours
- du calendrier julien.
- </refpurpose>
- </refnamediv>
- <refsect1>
+ Convertit une date du calendrier français républicain en nombre
+ de jours du calendrier julien.
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
<title>Description</title>
<funcsynopsis>
<funcdef>int <function>frenchtojd</function></funcdef>
@@ -224,24 +221,21 @@
<paramdef>int <parameter>day</parameter></paramdef>
<paramdef>int <parameter>year</parameter></paramdef>
</funcsynopsis>
- <para>
- Converti une date du calendrier français républicain en
nombre de jour du
- calendrier julien.
- </para>
- <para>
- Ces fonctions convertissent les dates comprises entre l'an 1 et l'an 14
- (22 September 1792 à 22 September 1806 en calendrier
grégorien). Cela
- couvre plus que la durée d'existence de ce calendrier.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.jdmonthname">
- <refnamediv>
- <refname>JDMonthName</refname>
- <refpurpose>
- Retourne le nom du mois.
- </refpurpose>
+ <para>
+ <function>frenchtojd</function> convertit une date du calendrier
+ français républicain en nombre de jour du calendrier julien.
+ </para>
+ <para>
+ Ces fonctions convertissent les dates comprises entre l'an 1 et l'an 14
+ (22 September 1792 à 22 September 1806 en calendrier grégorien).
+ Cela couvre plus que la durée d'existence de ce calendrier.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.jdmonthname">
+ <refnamediv>
+ <refname>JDMonthName</refname>
+ <refpurpose> Retourne le nom du mois. </refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
@@ -250,107 +244,108 @@
<paramdef>int <parameter>julianday</parameter></paramdef>
<paramdef>int <parameter>mode</parameter></paramdef>
</funcsynopsis>
- <para>
- Retourne une chaîne contenant le nom du mois.
- <parameter>mode</parameter> indique de quel calendrier dépend ce
mois, et
- quel type de nom doit être retourné.
-
+ <para>
+ <function>jdmonthname</function> retourne une chaîne contenant le
+ nom du mois. <parameter>mode</parameter> indique de quel calendrier
+ dépend ce mois, et quel type de nom doit être retourné.
<table>
<title>Modes de calendrier</title>
<tgroup cols="2">
<thead>
- <row>
- <entry>Mode</entry>
- <entry>Signification</entry>
- </row>
+ <row>
+ <entry>Mode</entry>
+ <entry>Signification</entry>
+ </row>
</thead>
<tbody>
- <row>
- <entry>0</entry>
- <entry>Grégorien - abrégé</entry>
- </row>
- <row>
- <entry>1</entry>
- <entry>Grégorien</entry>
- </row>
- <row>
- <entry>2</entry>
- <entry>Julien - abrégé</entry>
- </row>
- <row>
- <entry>3</entry>
- <entry>Julien</entry>
- </row>
- <row>
- <entry>4</entry>
- <entry>Juif</entry>
- </row>
- <row>
- <entry>5</entry>
- <entry>Républicain français</entry>
- </row>
+ <row>
+ <entry>0</entry>
+ <entry>Grégorien - abrégé</entry>
+ </row>
+ <row>
+ <entry>1</entry>
+ <entry>Grégorien</entry>
+ </row>
+ <row>
+ <entry>2</entry>
+ <entry>Julien - abrégé</entry>
+ </row>
+ <row>
+ <entry>3</entry>
+ <entry>Julien</entry>
+ </row>
+ <row>
+ <entry>4</entry>
+ <entry>Juif</entry>
+ </row>
+ <row>
+ <entry>5</entry>
+ <entry>Républicain français</entry>
+ </row>
</tbody>
</tgroup>
- </table></para>
-
- </refsect1>
- </refentry>
-
- <refentry id="function.jddayofweek">
- <refnamediv>
+ </table>
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.jddayofweek">
+ <refnamediv>
<refname>JDDayOfWeek</refname>
<refpurpose>
- Retourne le numéro du jour de la semaine.
- </refpurpose>
- </refnamediv>
- <refsect1>
+ Retourne le numéro du jour de la semaine.
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
<title>Description</title>
<funcsynopsis>
<funcdef>mixed <function>jddayofweek</function></funcdef>
<paramdef>int <parameter>julianday</parameter></paramdef>
<paramdef>int <parameter>mode</parameter></paramdef>
</funcsynopsis>
- <para>
- Retourne le numéro du jour de la semaine. Peut retourner une
chaîne ou
- un entier, en fonction du mode.
-
+ <para>
+ <function>jddayofweek</function> retourne le numéro du jour de
+ la semaine. Peut retourner une chaîne ou un entier, en fonction
+ du mode.
<table>
<title>Modes</title>
<tgroup cols="2">
<thead>
- <row>
- <entry>Mode</entry>
- <entry>Signification</entry>
- </row>
+ <row>
+ <entry>Mode</entry>
+ <entry>Signification</entry>
+ </row>
</thead>
<tbody>
- <row>
- <entry>0</entry> <entry>Retourne le numéro du jour comme un entier
+ <row>
+ <entry>0</entry>
+ <entry>Retourne le numéro du jour comme un entier
(0=dimanche, 1=lundi, etc.)
</entry>
- </row>
- <row>
- <entry>1</entry> <entry>Retourne une chaîne contenant le nom du jour
+ </row>
+ <row>
+ <entry>1</entry>
+ <entry>Retourne une chaîne contenant le nom du jour
(anglais grégorien)
</entry>
- </row>
- <row>
- <entry>2</entry> <entry>Retourne une chaîne contenant le nom
abrégé du
- jour de la semaine (anglais grégorien).
+ </row>
+ <row>
+ <entry>2</entry>
+ <entry>Retourne une chaîne contenant le nom abrégé du
+ jour de la semaine (anglais grégorien).
</entry>
- </row>
+ </row>
</tbody>
</tgroup>
- </table></para>
-
- </refsect1>
- </refentry>
-
+ </table>
+ </para>
+ </refsect1>
+ </refentry>
<refentry id="function.easter-date">
<refnamediv>
<refname>easter_date</refname>
<refpurpose>
- Retourne un timestamp UNIX pour Pâques, à minuit, pour une année
donnée.
+ Retourne un timestamp UNIX pour Pàques, à minuit, pour une
+ année donnée.
</refpurpose>
</refnamediv>
<refsect1>
@@ -360,51 +355,57 @@
<paramdef>int <parameter>year</parameter></paramdef>
</funcsynopsis>
<para>
- Retourne un timestamp UNIX pour Pâques, à minuit, pour une
année donnée.
- Si l'année n'est pas précisée, c'est l'année en
cours qui est utilisée.
+ <function>easter_date</function> retourne un timestamp UNIX pour Pàques,
+ à minuit, pour une année donnée. Si l'année n'est
+ pas précisée, c'est l'année en cours qui est
+ utilisée.
</para>
<para>
- <emphasis>ATTENTION:</emphasis> cette fonction génére une alerte
(Warning) si la
- date tombe hors de la zone de validité des timestamps UNIX
- (i.e. avant 1970 ou après 2037).
+ <emphasis>ATTENTION:</emphasis> <function>easter_date</function>
+ génére une alerte (Warning) si la date tombe hors de la
+ zone de validité des timestamp UNIX (i.e. avant 1970 ou
+ après 2037).
<example>
<title>Exemples avec <function>easter_date</function></title>
- <programlisting>
+ <programlisting role="php">
echo date( "M-d-Y", easter_date(1999) ); /* "04 avril 1999" */
echo date( "M-d-Y", easter_date(2000) ); /* "23 avril 2000" */
echo date( "M-d-Y", easter_date(2001) ); /* "15 avril 2001" */
-</programlisting>
+ </programlisting>
</example>
</para>
<para>
- La date de Pâques a été fixée par le concile de
Nicée, en 325 de notre ère,
- comme étant le dimanche après la première lune pleine qui
suit l'équinoxe de
- printemps. L'équinoxe de printemps est considéré comme
étant toujours le 21
- mars, ce qui réduit le problème au calcul de la date de la lune
pleine qui suit,
- et le dimanche suivant. L'algorithme fut introduit vers 532, par Dionysius
- Exiguus. Avec le calendrier Julien, (pour les années avant 1753) , un
cycle de
- 19 ans suffit pour connaître les date des phases de la lune. Avec le
calendrier
- grégorien, (à partir des années 1753, concu par Clavius
et Lilius, puis introduit
- par le pape Gregoire XIII en Octobre 1582, et en Grande Bretagne et ses
colonies
- en septembre 1752), deux facteurs de corrections ont été
ajoutés pour rendre
- le cycle plus précis.
+ La date de Pàques a été fixée par le concile
+ de Nicée, en 325 de notre ère, comme étant le dimanche
+ après la première lune pleine qui suit l'équinoxe de
+ printemps. L'équinoxe de printemps est considéré
+ comme étant toujours le 21 mars, ce qui réduit le
+ problème au calcul de la date de la lune pleine qui suit, et le
+ dimanche suivant. L'algorithme fut introduit vers 532, par Dionysius
+ Exiguus. Avec le calendrier Julien, (pour les années avant 1753),
+ un cycle de 19 ans suffit pour connaître les date des phases de la
+ lune. Avec le calendrier grégorien, (à partir des années
+ 1753, concu par Clavius et Lilius, puis introduit par le pape Gregoire XIII
+ en Octobre 1582, et en Grande Bretagne et ses colonies en septembre 1752),
+ deux facteurs de corrections ont été ajoutés pour rendre
+ le cycle plus précis.
</para>
<para>
- (Ce code est basé sur le programme en C de Simon Kershaw,
+ (Ce code est basé sur le programme en C de Simon Kershaw,
<[EMAIL PROTECTED]>)
</para>
<para>
- Voir <function>easter_days</function> pour les calculs de date de Pâques avant
- 1970 et apres 2037.
+ Voir <function>easter_days</function> pour les calculs de date de
+ Pàques avant 1970 et apres 2037.
</para>
</refsect1>
</refentry>
-
<refentry id="function.easter-days">
<refnamediv>
<refname>easter_days</refname>
<refpurpose>
- Retourne le nombre de jour entre le 21 Mars et Pâques, pour une année
donnée.
+ Retourne le nombre de jour entre le 21 Mars et Pàques, pour une
+ année donnée.
</refpurpose>
</refnamediv>
<refsect1>
@@ -414,63 +415,70 @@
<paramdef>int <parameter>year</parameter></paramdef>
</funcsynopsis>
<para>
- Retourne le nombre de jour entre le 21 Mars et Pâques, pour une année
donnée.
- Si l'année n'est pas précisée, l'année en cours
est utilisée par défaut.
+ <function>easter_days</function> retourne le nombre de jour entre le 21 Mars
+ et Pàques, pour une année donnée. Si l'année n'est
+ pas précisée, l'année en cours est utilisée par
+ défaut.
</para>
<para>
- Cette fonction peut être utilisée à la place de
<function>easter_date</function>
- pour calculer la date de Pâques, pour les années qui tombent hors de
l'intervalle
- de validité des timestamps UNIX (i.e. avant 1970 ou après 2037).
+ <function>easter_days</function> peut être utilisée à
+ la place de <function>easter_date</function> pour calculer la date de
+ Pàques, pour les années qui tombent hors de l'intervalle
+ de validité des timestamps UNIX (i.e. avant 1970 ou après 2037).
<example>
<title>Exemple <function>easter_date</function></title>
- <programlisting>
+ <programlisting role="php">
+<?php
echo easter_days(1999); /* 14, i.e. 4 Avril */
echo easter_days(1492); /* 32, i.e. 22 Avril */
echo easter_days(1913); /* 2, i.e. 23 Mars */
-</programlisting>
+?>
+ </programlisting>
</example>
</para>
<para>
- La date de Pâques a été fixée par le concile de
Nicée, en 325 de notre ère,
- comme étant le dimanche après la première lune pleine qui
suit l'équinoxe de
- printemps. L'équinoxe de printemps est considéré comme
étant toujours le 21
- mars, ce qui réduit le problème au calcul de la date de la lune
pleine qui suit,
- et le dimanche suivant. L'algorithme fut introduit vers 532, par Dionysius
- Exiguus. Avec le calendrier Julien, (pour les années avant 1753) , un
cycle de
- 19 ans suffit pour connaître les date des phases de la lune. Avec le
calendrier
- grégorien, (à partir des années 1753, concu par Clavius
et Lilius, puis introduit
- par le pape Gregoire XIII en Octobre 1582, et en Grande Bretagne et ses
colonies
- en septembre 1752), deux facteurs de corrections ont été
ajoutés pour rendre
- le cycle plus précis.
+ La date de Pàques a été fixée par le concile
+ de Nicée, en 325 de notre ère, comme étant le dimanche
+ après la première lune pleine qui suit l'équinoxe de
+ printemps. L'équinoxe de printemps est considéré
+ comme étant toujours le 21 mars, ce qui réduit le
+ problème au calcul de la date de la lune pleine qui suit, et le
+ dimanche suivant. L'algorithme fut introduit vers 532, par Dionysius
+ Exiguus. Avec le calendrier Julien, (pour les années avant 1753),
+ un cycle de 19 ans suffit pour connaître les date des phases de la
+ lune. Avec le calendrier grégorien, (à partir des années
+ 1753, concu par Clavius et Lilius, puis introduit par le pape Gregoire XIII
+ en Octobre 1582, et en Grande Bretagne et ses colonies en septembre 1752),
+ deux facteurs de corrections ont été ajoutés pour rendre
+ le cycle plus précis.
</para>
<para>
- (Ce code est basé sur le programme en C de Simon Kershaw,
+ (Ce code est basé sur le programme en C de Simon Kershaw,
<[EMAIL PROTECTED]>)
</para>
<para>
- Voir aussi <function>easter_date</function>.
+ Voir aussi <function>easter_date</function>.
</para>
</refsect1>
</refentry>
-
<refentry id="function.unixtojd">
<refnamediv>
<refname>unixtojd</refname>
- <refpurpose>Converti un timestamp UNIX en nombre de jours Julien</refpurpose>
+ <refpurpose>Convertit un timestamp UNIX en nombre de jours Julien</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>unixtojd</function></funcdef>
- <paramdef>int
+ <paramdef>int
<parameter><optional>timestamp</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
- <function>unixtojd</function> le nombre de jours juliens du
- timestamp UNIX <parameter>timestamp</parameter> (nombre de secondes
+ <function>unixtojd</function> retourne le nombre de jours juliens du
+ timestamp UNIX <parameter>timestamp</parameter> (nombre de secondes
depuis le 1/1/1970), ou pour le jour courant si
<parameter>timestamp</parameter> est omis.
</para>
@@ -479,16 +487,16 @@
</para>
<note>
<para>
- Cette fonction n'est disponible qu'à partir de la version PHP4RC1.
+ <function>unixtojd</function> n'est disponible qu'à partir de la
+ version PHP 4.0RC1.
</para>
</note>
</refsect1>
</refentry>
-
- <refentry id="function.jdtounix">
+ <refentry id="function.jdtounix">
<refnamediv>
<refname>jdtounix</refname>
- <refpurpose>Converti un nombre de jour Julien en timestamp UNIX</refpurpose>
+ <refpurpose>Convertit un nombre de jour Julien en timestamp UNIX</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
@@ -501,23 +509,22 @@
<para>
<function>jdtounix</function> retourne un timestamp UNIX
correspondant au nombre de jour julien <parameter>jday</parameter>
- ou FALSE si <parameter>jday</parameter> n'est pas dans l'intervalle de
- validité de l'époque UNIX. (années grégorienne entre
1970 et 2037 ou 2440588 <=
- <parameter>jday</parameter> <= 2465342 ).
+ ou <literal>FALSE</literal> si <parameter>jday</parameter> n'est pas dans
+l'intervalle de
+ validité de l'époque UNIX. (années grégorienne
+ entre 1970 et 2037 ou 2440588 <= <parameter>jday</parameter> <= 2465342 ).
</para>
<para>
Voir aussi <function>jdtounix</function>.
</para>
<note>
<para>
- Cette fonction n'est disponible qu'à partir de la version PHP4RC1.
+ <function>jdtounix</function> n'est disponible qu'à partir de la
+ version PHP 4.0RC1.
</para>
</note>
</refsect1>
</refentry>
-
</reference>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Index: phpdoc/fr/functions/ccvs.xml
diff -u phpdoc/fr/functions/ccvs.xml:1.2 phpdoc/fr/functions/ccvs.xml:1.3
--- phpdoc/fr/functions/ccvs.xml:1.2 Wed Dec 6 08:15:42 2000
+++ phpdoc/fr/functions/ccvs.xml Tue Jan 16 02:38:38 2001
@@ -6,7 +6,7 @@
fichier.
-->
<reference id="ref.ccvs">
- <title>Fonctions CCVS API</title>
+ <title>Paiement CCVS</title>
<titleabbrev>CCVS</titleabbrev>
<partintro>
<simpara>
Index: phpdoc/fr/functions/classobj.xml
diff -u phpdoc/fr/functions/classobj.xml:1.4 phpdoc/fr/functions/classobj.xml:1.5
--- phpdoc/fr/functions/classobj.xml:1.4 Tue Nov 28 06:24:35 2000
+++ phpdoc/fr/functions/classobj.xml Tue Jan 16 02:38:38 2001
@@ -1,5 +1,5 @@
<reference id="ref.classobj">
- <title>Fonctions Objets</title>
+ <title>Objets</title>
<titleabbrev>Classes et Objets</titleabbrev>
<partintro>
<sect1 id="classobj.partintro">
@@ -14,7 +14,7 @@
</para>
</sect2>
<sect2 id="classobj.example">
- <title>An example of use</title>
+ <title>Exemple d'utilisation</title>
<para>
Dans cet exemple, on définit une classe de base, et une
extension. La classe de base définit un légume, si il est
@@ -44,12 +44,12 @@
} // fin de la classe Legume
// extend la classe de base
class Epinard extends Legume {
- var $cuit = false;
+ var $cuit = <literal>FALSE</literal>;
function Epinard() {
- $this->Legume( true, "green" );
+ $this->Legume( <literal>TRUE</literal>, "green" );
}
function cuisine() {
- $this->cuit = true;
+ $this->cuit = <literal>TRUE</literal>;
}
function est_cuit() {
return $this->cuit;
@@ -93,7 +93,7 @@
}
}
// instantie 2 objets
-$legume = new Legume(true,"blue");
+$legume = new Legume(<literal>TRUE</literal>,"blue");
$feuilles = new Epinard();
// affiche les informations sur ces objets
echo "legume: CLASS ".get_class($legume)."\n";
@@ -122,12 +122,12 @@
</para>
<para>
<informalexample>
- <programlisting>
+ <computeroutput>
[...]
Parentée:
L'objet feuilles n'est pas une sous classe Spinach
L'objet feuilles est une sous-classe de Legume
- </programlisting>
+ </computeroutput>
</informalexample>
</para>
</sect2>
@@ -240,8 +240,8 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>class_exists</function> retourne TRUE si la classe
- <parameter>class_name</parameter> a été définie, et FALSE
sinon.
+ <function>class_exists</function> retourne <literal>TRUE</literal> si la classe
+ <parameter>class_name</parameter> a été définie, et
+<literal>FALSE</literal> sinon.
</para>
</refsect1>
</refentry>
@@ -366,9 +366,9 @@
$this->nom = $nom;
}
function LitPoint() {
- return array("x" => $this->x,
- "y" => $this->y,
- "nom" => $this->nom);
+ return array("x" -> $this->x,
+ "y" -> $this->y,
+ "nom" -> $this->nom);
}
}
$p1 = new Point2D(1.233, 3.445);
@@ -376,16 +376,16 @@
// "$nom" est déclaré, mais non défini
// Array
// (
-// [x] => 1.233
-// [y] => 3.445
+// [x] -> 1.233
+// [y] -> 3.445
// )
$p1->setnom("point #1");
print_r(get_object_vars($p1));
// Array
// (
-// [x] => 1.233
-// [y] => 3.445
-// [nom] => point #1
+// [x] -> 1.233
+// [y] -> 3.445
+// [nom] -> point #1
// )
?>
</programlisting>
@@ -437,9 +437,9 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>is_subclass_of</function> retourne TRUE si l'objet
+ <function>is_subclass_of</function> retourne <literal>TRUE</literal> si l'objet
<parameter>obj</parameter> est une sous-classe de
- <parameter>superclass</parameter>, FALSE sinon.
+ <parameter>superclass</parameter>, <literal>FALSE</literal> sinon.
</para>
<simpara>
Voir aussi <function>get_class</function>,
@@ -464,9 +464,9 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>method_exists</function> retourne TRUE si la méthode
+ <function>method_exists</function> retourne <literal>TRUE</literal> si la
+méthode
<parameter>method_name</parameter> a été définie
- pour la classe <parameter>object</parameter>, et sinon, retourne FALSE.
+ pour la classe <parameter>object</parameter>, et sinon, retourne
+<literal>FALSE</literal>.
</para>
</refsect1>
</refentry>
Index: phpdoc/fr/functions/com.xml
diff -u phpdoc/fr/functions/com.xml:1.2 phpdoc/fr/functions/com.xml:1.3
--- phpdoc/fr/functions/com.xml:1.2 Fri Nov 17 03:47:44 2000
+++ phpdoc/fr/functions/com.xml Tue Jan 16 02:38:38 2001
@@ -4,7 +4,7 @@
<partintro>
<simpara>
Ces fonctions ne sont disponibles que sous les versions Windows de PHP.
- Elles ont été ajoutées dans PHP4.
+ Elles ont été ajoutées dans PHP 4.
</simpara>
</partintro>
<refentry id="function.com-load">
@@ -29,7 +29,7 @@
</funcsynopsis>
<para>
<function>com_load</function> crée un nouveau composant COM, et
- retourne une référence dessus. Retourne FALSE en cas
d'échec.
+ retourne une référence dessus. Retourne <literal>FALSE</literal>
+en cas d'échec.
</para>
</refsect1>
</refentry>
@@ -57,7 +57,7 @@
<para>
<function>com_invoke</function> appelle la méthode
<parameter>function_name</parameter> du composant COM
- <parameter>com_object</parameter>. Retourne FALSE en
+ <parameter>com_object</parameter>. Retourne <literal>FALSE</literal> en
cas d'erreur, sinon retourne le résultat de la fonction
<parameter>function_name</parameter> en cas de succès.
</para>
@@ -104,7 +104,7 @@
<function>com_get</function> retourne la valeur de la propriété
<parameter>property</parameter> du composant COM
<parameter>com_object</parameter>.
- Retourne FALSE en cas d'erreur.
+ Retourne <literal>FALSE</literal> en cas d'erreur.
</para>
</refsect1>
</refentry>
@@ -172,7 +172,7 @@
<para>
Remplace la valeur de la propriété <parameter>property</parameter>
du
composante COM <parameter>com_object</parameter> par
<parameter>value</parameter>.
- Retourne TRUE en cas de succès, et FALSE sinon.
+ Retourne <literal>TRUE</literal> en cas de succès, et
+<literal>FALSE</literal> sinon.
</para>
</refsect1>
</refentry>
Index: phpdoc/fr/functions/cpdf.xml
diff -u phpdoc/fr/functions/cpdf.xml:1.4 phpdoc/fr/functions/cpdf.xml:1.5
--- phpdoc/fr/functions/cpdf.xml:1.4 Tue Nov 28 06:09:38 2000
+++ phpdoc/fr/functions/cpdf.xml Tue Jan 16 02:38:38 2001
@@ -1,5 +1,5 @@
<reference id="ref.cpdf">
- <title>Fonctions ClibPDF</title>
+ <title>ClibPDF</title>
<titleabbrev>ClibPDF</titleabbrev>
<partintro>
<simpara>
@@ -67,7 +67,7 @@
</simpara>
<example>
<title>Exemple simple ClibPDF</title>
- <programlisting>
+ <programlisting role="php">
<?php
$cpdf = cpdf_open(0);
cpdf_page_init($cpdf, 1, 0, 595, 842);
@@ -82,17 +82,17 @@
Header("Content-type: application/pdf");
cpdf_output_buffer($cpdf);
cpdf_close($cpdf);
-?>
+?>
</programlisting>
</example>
<simpara>
La distribution pdflib contient un exemple plus complet, qui
crée des séries de pages avec une horloge. Voici
- cet exemple converti en script PHP qui utilise l'extension ClibPDF :
+ cet exemple convertit en script PHP qui utilise l'extension ClibPDF :
</simpara>
<example>
<title>Exemple pdfclock de la distribution pdflib 2.0</title>
- <programlisting>
+ <programlisting role="php">
<?php
$radius = 200;
$margin = 20;
@@ -164,7 +164,7 @@
Header("Content-type: application/pdf");
cpdf_output_buffer($pdf);
cpdf_close($pdf);
-?>
+?>
</programlisting>
</example>
</partintro>
@@ -542,11 +542,13 @@
Elle doit être terminée avec <function>cpdf_end_text</function>.
<example>
<title>Affichage de texte</title>
- <programlisting>
-<?php cpdf_begin_text($pdf);
+ <programlisting role="php">
+<?php
+cpdf_begin_text($pdf);
cpdf_set_font($pdf, 16, "Helvetica", "WinAnsiEncoding");
cpdf_text($pdf, 100, 100, "Some text");
-cpdf_end_text($pdf) ?>
+cpdf_end_text($pdf)
+?>
</programlisting>
</example>
</para>
@@ -573,11 +575,13 @@
commencée avec <function>cpdf_begin_text</function>.
<example>
<title>Affichage de texte</title>
- <programlisting>
-<?php cpdf_begin_text($pdf);
+ <programlisting role="php">
+<?php
+cpdf_begin_text($pdf);
cpdf_set_font($pdf, 16, "Helvetica", "WinAnsiEncoding");
cpdf_text($pdf, 100, 100, "Some text");
-cpdf_end_text($pdf) ?>
+cpdf_end_text($pdf)
+?>
</programlisting>
</example>
</para>
@@ -1015,11 +1019,15 @@
translations et rotations sur un objet, mais sans affecter les autres.
<example>
<title>Sauver/Restaurer</title>
- <programlisting>
-<?php cpdf_save($pdf);
+ <programlisting role="php">
+<?php
+cpdf_save($pdf);
// plein de transformations, translations, ...
-cpdf_restore($pdf) ?>
-</programlisting></example></para>
+cpdf_restore($pdf)
+?>
+ </programlisting>
+ </example>
+ </para>
<para>
Voir aussi <function>cpdf_save</function>.
</para>
@@ -1864,7 +1872,7 @@
qui pointe sur la page courante.
<example>
<title>Ajouter une mise en relief</title>
- <programlisting>
+ <programlisting role="php">
<?php
$cpdf = cpdf_open(0);
cpdf_page_init($cpdf, 1, 0, 595, 842);
@@ -1876,7 +1884,7 @@
Header("Content-type: application/pdf");
cpdf_output_buffer($cpdf);
cpdf_close($cpdf);
-?>
+?>
</programlisting>
</example>
</para>
Index: phpdoc/fr/functions/curl.xml
diff -u phpdoc/fr/functions/curl.xml:1.2 phpdoc/fr/functions/curl.xml:1.3
--- phpdoc/fr/functions/curl.xml:1.2 Tue Nov 21 03:52:16 2000
+++ phpdoc/fr/functions/curl.xml Tue Jan 16 02:38:38 2001
@@ -49,7 +49,7 @@
curl_exec ($ch);
curl_close ($ch);
fclose ($fp);
-?>
+?>
</programlisting>
</example>
</para>
@@ -92,7 +92,7 @@
curl_setopt ($ch, CURLOPT_HEADER, 0);
curl_exec ($ch);
curl_close ($ch);
-?>
+?>
</programlisting>
</example>
</para>
Index: phpdoc/fr/functions/cybercash.xml
diff -u phpdoc/fr/functions/cybercash.xml:1.3 phpdoc/fr/functions/cybercash.xml:1.4
--- phpdoc/fr/functions/cybercash.xml:1.3 Tue Dec 12 02:48:58 2000
+++ phpdoc/fr/functions/cybercash.xml Tue Jan 16 02:38:38 2001
@@ -1,12 +1,12 @@
<reference id="ref.cybercash">
- <title>Fonctions de paiement Cybercash</title>
+ <title>Paiement Cybercash</title>
<titleabbrev>Cybercash</titleabbrev>
<partintro>
<simpara>
Ces fonctions ne sont disponibles que si PHP a été
compilé avec l'option
<option role="configure">--with-cybercash=[DIR]</option>. Ces
- fonctions ont été ajoutées dans PHP4.
+ fonctions ont été ajoutées dans PHP 4.
</simpara>
</partintro>
<refentry id="function.cybercash-encr">
@@ -26,7 +26,7 @@
</funcsynopsis>
<para>
<function>cybercash_encr</function> retourne un tableau associatif, contenant
- les éléments "errcode" et, si "errcode" vaut FALSE,
+ les éléments "errcode" et, si "errcode" vaut
+<literal>FALSE</literal>,
"outbuff" (string), "outLth" (long) et "macbuff" (string).
</para>
</refsect1>
@@ -48,7 +48,7 @@
</funcsynopsis>
<para>
<function>cybercash_decr</function> retourne un tableau associatif, contenant
- les éléments "errcode" et, si "errcode" vaut FALSE,
+ les éléments "errcode" et, si "errcode" vaut
+<literal>FALSE</literal>,
"outbuff" (string), "outLth" (long) et "macbuff" (string).
</para>
</refsect1>
Index: phpdoc/fr/functions/datetime.xml
diff -u phpdoc/fr/functions/datetime.xml:1.7 phpdoc/fr/functions/datetime.xml:1.8
--- phpdoc/fr/functions/datetime.xml:1.7 Tue Dec 26 02:24:12 2000
+++ phpdoc/fr/functions/datetime.xml Tue Jan 16 02:38:38 2001
@@ -1,5 +1,5 @@
<reference id="ref.datetime">
- <title>Fonctions de dates et heures</title>
+ <title>Dates et heures</title>
<titleabbrev>Date/heure</titleabbrev>
<refentry id="function.checkdate">
<refnamediv>
@@ -17,8 +17,8 @@
</funcprototype>
</funcsynopsis>
<para>
- Retourne TRUE si la date fournie est valide, et sinon FALSE.
- La date est considérée comme valide si :
+ <function>checkdate</function> retourne <literal>TRUE</literal> si la date
+fournie est valide, et sinon <literal>FALSE</literal>.
+ La date est considérée comme valide si :
<itemizedlist>
<listitem>
<simpara>
@@ -43,7 +43,7 @@
<refentry id="function.date">
<refnamediv>
<refname>date</refname>
- <refpurpose>Formate une date/heure locale </refpurpose>
+ <refpurpose>Formate une date/heure locale</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
@@ -59,10 +59,10 @@
</funcprototype>
</funcsynopsis>
<para>
- Retourne une date sous forme d'une chaîne, au format
- donné par la chaîne format. La date est fournie
- sous la forme d'un <parameter>timestamp</parameter>. Par défaut,
- la date courante est utilisée.
+ <function>date</function> retourne une date sous forme d'une chaîne, au
+format
+ donné par la chaîne format. La date est fournie
+ sous la forme d'un <parameter>timestamp</parameter>. Par défaut,
+ la date courante est utilisée.
</para>
<para>
Les caractères suivants sont utilisés pour
@@ -240,10 +240,12 @@
<title>
Exemples avec <function>date</function> et <function>mktime</function>
</title>
- <programlisting>
+ <programlisting role="php">
+<?php
$tomorrow = mktime (0,0,0,date("m") ,date("d")+1,date("Y"));
$lastmonth = mktime (0,0,0,date("m")-1,date("d"), date("Y"));
$nextyear = mktime (0,0,0,date("m"), date("d"), date("Y")+1);
+?>
</programlisting>
</example>
</para>
@@ -266,61 +268,64 @@
<funcsynopsis>
<funcprototype>
<funcdef>array <function>getdate</function></funcdef>
- <paramdef>int <parameter>timestamp</parameter></paramdef>
+ <paramdef>int
+ <parameter><optional>timestamp</optional></parameter>
+ </paramdef>
</funcprototype>
</funcsynopsis>
<para>
- Retourne un tableau associatif contenant les informations de date et heure
- du timestamp, avec les champs suivants :
+ <function>getdate</function> retourne un tableau associatif contenant les
+informations
+ de date et heure du timestamp <parameter>timestamp</parameter> (lorsqu'il est
+fourni),
+ avec les champs suivants :
<itemizedlist>
<listitem>
<simpara>
- "seconds" - secondes
+ "seconds" - secondes
</simpara>
</listitem>
<listitem>
<simpara>
- "minutes" - minutes
+ "minutes" - minutes
</simpara>
</listitem>
<listitem>
<simpara>
- "hours" - heures
+ "hours" - heures
</simpara>
</listitem>
<listitem>
<simpara>
- "mday" - jour du mois
+ "mday" - jour du mois
</simpara>
</listitem>
<listitem>
<simpara>
- "wday" - jour de la semaine, numérique
+ "wday" - jour de la semaine, numérique
</simpara>
</listitem>
<listitem>
<simpara>
- "mon" - mois, numérique
+ "mon" - mois, numérique
</simpara>
</listitem>
<listitem>
<simpara>
- "year" - année, numérique
+ "year" - année, numérique
</simpara>
</listitem>
<listitem>
<simpara>
- "yday" - jour de l'année, numérique; i.e. "299"
+ "yday" - jour de l'année, numérique; i.e. "299"
</simpara>
</listitem>
<listitem>
<simpara>
- "weekday" - jour de la semaine, texte complet (en anglais); i.e. "Friday"
+ "weekday" - jour de la semaine, texte complet (en anglais); i.e. "Friday"
</simpara>
</listitem>
<listitem>
<simpara>
- "month" - mois, texte complet (en anglais); i.e. "January"
+ "month" - mois, texte complet (en anglais); i.e. "January"
</simpara>
</listitem>
</itemizedlist>
@@ -341,8 +346,9 @@
</funcprototype>
</funcsynopsis>
<para>
- C'est une interface vers gettimeofday(2). Elle retourne un tableau associatif
- qui contient les informations retournées par le système :
+ <function>gettimeofday</function> est une interface vers gettimeofday(2). Elle
+ retourne un tableau associatif qui contient les informations retournées
+ par le système :
<itemizedlist>
<listitem>
<simpara>
@@ -380,19 +386,23 @@
<funcprototype>
<funcdef>string <function>gmdate</function></funcdef>
<paramdef>string <parameter>format</parameter></paramdef>
- <paramdef>int <parameter>timestamp</parameter></paramdef>
+ <paramdef>int
+ <parameter><optional>timestamp</optional></parameter>
+ </paramdef>
</funcprototype>
</funcsynopsis>
<para>
- Identique à la fonction <function>date</function>, seulement
- le temps retourné est GMT (Greenwich Mean Time) Par exemple,
+ <function>gmdate</function> est identique à la fonction
+<function>date</function>,
+ hormis le fait que le temps retourné est GMT (Greenwich Mean Time) Par
+exemple,
en Finlande (GMT +0200), la première ligne ci-dessous affiche
"Jan 01 1998 00:00:00", tandis que la seconde "Dec 31 1997 22:00:00".
<example>
<title>Exemple avec <function>gmdate</function></title>
<programlisting role="php">
+<?php
echo date ("M d Y H:i:s", mktime (0,0,0,1,1,1998));
echo gmdate ("M d Y H:i:s", mktime (0,0,0,1,1,1998));
+?>
</programlisting>
</example>
</para>
@@ -442,7 +452,9 @@
<funcprototype>
<funcdef>string <function>gmstrftime</function></funcdef>
<paramdef>string <parameter>format</parameter></paramdef>
- <paramdef>int <parameter>timestamp</parameter></paramdef>
+ <paramdef>int
+ <parameter><optional>timestamp</optional></parameter>
+ </paramdef>
</funcprototype>
</funcsynopsis>
<para>
@@ -636,11 +648,13 @@
"Jan-01-1998".
<example>
<title>Exemple <function>mktime</function></title>
- <programlisting>
+ <programlisting role="php">
+<?php
echo date ("M-d-Y", mktime (0,0,0,12,32,1997));
echo date ("M-d-Y", mktime (0,0,0,13,1,1997));
echo date ("M-d-Y", mktime (0,0,0,1,1,1998));
echo date ("M-d-Y", mktime (0,0,0,1,1,98));
+?>
</programlisting>
</example>
<parameter>year</parameter> peut prendre deux ou quatre chiffres,
@@ -648,7 +662,7 @@
70-99 à 1970-1999 (sur les systèmes oú
time_t sont sur des entiers 32bit signés, comme cela se
fait le plus souvent de nos jours, <parameter>year</parameter>
- est valide dans l'intervalle 1902 and 2037.
+ est valide dans l'intervalle 1902 et 2037.
</para>
<para>
Le dernier jours d'un mois peut être décrit comme
@@ -658,10 +672,12 @@
<example>
<title>Last day of next month</title>
<programlisting role="php">
+<?php
$lastday = mktime (0,0,0,3,0,2000);
echo strftime ("Le dernier jour de Février 2000 est: %d", $lastday);
$lastday = mktime (0,0,0,4,-31,2000);
echo strftime ("Le dernier jour de Février 2000 est: %d", $lastday);
+?>
</programlisting>
</example>
</para>
@@ -737,7 +753,7 @@
</listitem>
<listitem>
<simpara>
- %d - jour du mois en numérique (intervalle 00 à 31)
+ %d - jour du mois en numérique (intervalle 01 à 31)
</simpara>
</listitem>
<listitem>
@@ -954,12 +970,14 @@
<example>
<title>Exemple avec <function>strtotime</function></title>
<programlisting role="php">
+<?php
// l'exemple n'est pas traduit, car cela ne fonctionne qu'en anglais
echo strtotime ("now") . "\n";
echo strtotime ("10 September 2000") . "\n";
echo strtotime ("+1 day") . "\n";
echo strtotime ("+1 week") . "\n";
-echo strtotime ("+1 week 2 days 4 hours 2 seconds") . "\n";
+echo strtotime ("+1 week 2 days 4 hours 2 seconds")."\n";
+?>
</programlisting>
</example>
</para>
Index: phpdoc/fr/functions/dba.xml
diff -u phpdoc/fr/functions/dba.xml:1.4 phpdoc/fr/functions/dba.xml:1.5
--- phpdoc/fr/functions/dba.xml:1.4 Fri Dec 1 09:06:54 2000
+++ phpdoc/fr/functions/dba.xml Tue Jan 16 02:38:38 2001
@@ -1,6 +1,6 @@
<reference id="ref.dba">
- <title>Fonctions dba</title>
- <titleabbrev>dba</titleabbrev>
+ <title>DBA</title>
+ <titleabbrev>DBA</titleabbrev>
<partintro>
<para>
Ces fonctions sont l'interface avec les bases de type Berkeley.
@@ -75,7 +75,7 @@
<para>
<example>
<title>Exemple DBA</title>
- <programlisting>
+ <programlisting role="php">
<?php
$id = dba_open("/tmp/test.db", "n", "db2");
if(!$id) {
@@ -112,11 +112,11 @@
<para>
<example>
<title>Passer en revue une base</title>
- <programlisting>
+ <programlisting role="php">
<?php
# ...ouverture de la base...
$key = dba_firstkey($id);
-while($key != false) {
+while($key != <literal>FALSE</literal>) {
if(...) { # conserver la clé pour faire d'autres opérations plus
tard
$handle_later[] = $key;
}
@@ -185,7 +185,7 @@
<function>dba_open</function>.
</para>
<para>
- <function>dba_delete</function> retourne TRUE ou FALSE, si l'entrée est
+ <function>dba_delete</function> retourne <literal>TRUE</literal> ou
+<literal>FALSE</literal>, si l'entrée est
effacée, ou pas effacée, respectivement.
</para>
<para>
@@ -222,7 +222,7 @@
<function>dba_open</function>.
</para>
<para>
- <function>dba_exists</function> retourne TRUE ou FALSE, si la clé est
+ <function>dba_exists</function> retourne <literal>TRUE</literal> ou
+<literal>FALSE</literal>, si la clé est
trouvée, ou pas, respectivement.
</para>
<para>
@@ -259,7 +259,7 @@
<function>dba_open</function>.
</para>
<para>
- <function>dba_fetch</function> retourne la chaîne associée ou
false,
+ <function>dba_fetch</function> retourne la chaîne associée ou
+<literal>FALSE</literal>,
si la paire clé/valeur n'a pas été trouvée.
</para>
<para>
@@ -292,7 +292,7 @@
<function>dba_open</function>.
</para>
<para>
- <function>dba_firstkey</function> retourne la clé, ou FALSE, suivant
+ <function>dba_firstkey</function> retourne la clé, ou
+<literal>FALSE</literal>, suivant
que la première clé existe ou pas.
</para>
<para>
@@ -335,7 +335,7 @@
<function>dba_open</function>.
</para>
<para>
- <function>dba_insert</function> retourne TRUE ou false, suivant que l'insertion
+ <function>dba_insert</function> retourne <literal>TRUE</literal> ou
+<literal>FALSE</literal>, suivant que l'insertion
a réussi ou échoué.
</para>
<para>
@@ -367,7 +367,7 @@
<function>dba_open</function>.
</para>
<para>
- <function>dba_nextkey</function> retourne la clé, ou FALSE en cas
d'échec.
+ <function>dba_nextkey</function> retourne la clé, ou
+<literal>FALSE</literal> en cas d'échec.
</para>
<para>
Voir aussi: <function>dba_firstkey</function>.
@@ -413,7 +413,7 @@
</para>
<para>
<function>dba_popen</function> retourne un identifiant positif,
- ou FALSE, suivant que la base a été ouverte, ou que
+ ou <literal>FALSE</literal>, suivant que la base a été ouverte,
+ou que
l'accès a échoué.
</para>
<para>
@@ -484,7 +484,7 @@
<function>dba_open</function>.
</para>
<para>
- <function>dba_optimize</function> retourne TRUE ou FALSE, suivant que
+ <function>dba_optimize</function> retourne <literal>TRUE</literal> ou
+<literal>FALSE</literal>, suivant que
l'optimisation a réussi ou échoué.
</para>
<para>
@@ -526,7 +526,7 @@
<function>dba_open</function>.
</para>
<para>
- <function>dba_replace</function> retourne TRUE ou false, suivant que
+ <function>dba_replace</function> retourne <literal>TRUE</literal> ou
+<literal>FALSE</literal>, suivant que
l'opération réussit ou échoue.
</para>
<para>
@@ -559,7 +559,7 @@
<function>dba_open</function>.
</para>
<para>
- <function>dba_sync</function> retourne TRUE ou false, si la
+ <function>dba_sync</function> retourne <literal>TRUE</literal> ou
+<literal>FALSE</literal>, si la
synchronisation réussi, ou échoue, respectivement.
</para>
<para>
Index: phpdoc/fr/functions/dbase.xml
diff -u phpdoc/fr/functions/dbase.xml:1.1 phpdoc/fr/functions/dbase.xml:1.2
--- phpdoc/fr/functions/dbase.xml:1.1 Fri Jul 21 03:27:50 2000
+++ phpdoc/fr/functions/dbase.xml Tue Jan 16 02:38:38 2001
@@ -1,381 +1,371 @@
- <reference id="ref.dbase">
- <title>Fonctions dBase</title>
- <titleabbrev>dBase</titleabbrev>
-
- <partintro>
- <simpara>
- Ces fonctions vous permettront d'accéder aux enregistrements d'une base
au format
- dBase (.dbf).
- </simpara>
- <simpara>
- dBase ne permet pas l'utilisation d'index, de "memo fields", ni le blocage
- de la base. Deux processus de serveurs web différents modifiant la
même fichier
- dBase risque de rendre votre base de données incohérente.
- </simpara>
- <simpara>
- A la différence des bases de données SQL, la définition des
bases de données
- dBase, ne peut pas être changée. Une fois le fichier
créé, la définition de
- la base est définitive. Il n'y a pas d'index qui accélèrent
les recherches ou
- organisent vos données. Les fichiers dBase sont de simples fichiers
séquentiels
- avec des enregistrements de longueur fixe. Les enregistrements sont
ajoutés à la
- fin du fichier et les enregistrements supprimés sont conservés
jusqu'à l'appel de
- <function>dbase_pack</function>.
- </simpara>
- <simpara>
- Nous vous recommandons de ne pas utiliser les fichiers dBase comme base de
données
- de production. Choisissez n'importe quel serveur SQL à la place. MySQL
and
- Postgres sont des choix classiques avec PHP. Le support de dBase ne se justifie
- ici que pour vous permettre d'importer et d'exporter des données de et
vers votre
- base des données web, maintenant que le format du fichier est
communément géré par
- les feuilles et organiseurs Windows. L'import et l'export de données est
l'unique
- chose pour laquelle l'utilisation de dBase est recommandée.
- </simpara>
- </partintro>
-
- <refentry id="function.dbase-create">
- <refnamediv>
- <refname>dbase_create</refname>
- <refpurpose>Crée une base de données dBase.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcdef>int <function>dbase_create</function></funcdef>
- <paramdef>string <parameter>filename</parameter></paramdef>
- <paramdef>array <parameter>fields</parameter></paramdef>
- </funcsynopsis>
- <para>
- <parameter>fields</parameter> est un tableau de tableaux. Chaque tableau
- décrit le format d'un fichier de la base. Chaque champs est
constitué d'un nom,
- d'un caractère de type de champs, d'une longueur et d'une
précision.
- </para>
- <para>
- Les types de champs disponibles sont :
- <variablelist>
- <varlistentry>
- <term>L</term>
- <listitem>
- <simpara>
- Boolean (booléen). Pas de longueur ou de précision pour ces
valeurs.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>M</term>
- <listitem>
- <simpara>
- Memo. (Note importante : les Memos ne sont pas supportés par PHP.)
- Elles n'ont pas de longueur ou de précision.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>D</term>
- <listitem>
- <simpara>
- Date (enregistrée au format 'YYYYMMDD'). Elles n'ont pas de longueur
ou
- de précision.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>N</term>
- <listitem>
- <simpara>
- Number (nombre). Possède une longueur et un précision (le
nombre de
- chiffres après la virgule).
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>C</term>
- <listitem>
- <simpara>
- String (chaîne).
- </simpara>
- </listitem>
- </varlistentry>
- </variablelist>
- </para>
- <para>
- Si la base de données a été créée, un
identifiant de base dbase_identifier est
- retourné, sinon, FALSE est retourné.
- <example>
- <title>Création d'une base dBase</title>
- <programlisting role="php">
-// "database" name
-$dbname = "/tmp/test.dbf";
-
-// database "definition"
-$def =
- array(
- array("date", "D"),
- array("name", "C", 50),
- array("age", "N", 3, 0),
- array("email", "C", 128),
- array("ismember", "L")
- );
-
-// création
-if (!dbase_create($dbname, $def))
- print "<strong>Error!</strong>";
- </programlisting>
- </example>
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.dbase-open">
- <refnamediv>
- <refname>dbase_open</refname>
- <refpurpose>Ouverture d'une base dBase.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcdef>int <function>dbase_open</function></funcdef>
- <paramdef>string <parameter>filename</parameter></paramdef>
- <paramdef>int <parameter>flags</parameter></paramdef>
- </funcsynopsis>
- <para>
- <parameter>flags</parameter> est un flag, comme pour la fonction open().
- (Typiquement; 0 signifie lecture seule, 1 signifie écriture seule, et
- 2 écriture/lecture).
- </para>
- <para>
- Retourne un identifiant de base de données, ou FALSE si la base n'a pas
pu être
- selectionnée.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.dbase-close">
- <refnamediv>
- <refname>dbase_close</refname>
- <refpurpose>Ferme une base dBase.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcdef>bool <function>dbase_close</function></funcdef>
- <paramdef>int <parameter>dbase_identifier</parameter></paramdef>
- </funcsynopsis>
- <para>
- Ferme la base associée à <parameter>dbase_identifier</parameter>.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.dbase-pack">
- <refnamediv>
- <refname>dbase_pack</refname>
- <refpurpose>Compacte une base dBase.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcdef>bool <function>dbase_pack</function></funcdef>
- <paramdef>int <parameter>dbase_identifier</parameter></paramdef>
- </funcsynopsis>
- <para>
- Compacte la base de données spécifiée (effacement
définitif de tous les
- enregistrements marqués pour l'effacement, avec la fonction
- <function>dbase_delete_record</function>).
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.dbase-add-record">
- <refnamediv>
- <refname>dbase_add_record</refname>
- <refpurpose>Ajoute un enregistrement dans une base dBase.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcdef>bool <function>dbase_add_record</function></funcdef>
- <paramdef>int <parameter>dbase_identifier</parameter></paramdef>
- <paramdef>array <parameter>record</parameter></paramdef>
- </funcsynopsis>
- <para>
- Ajoute les données de <parameter>record</parameter> dans la base
spécifiée par
- <parameter>dbase_identifier</parameter>. Si le nombre de colonnes fourni n'est
pas
- celui du nombre de champs dans la base, l'opération échouera, et
FALSE sera
- retourné.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.dbase-replace-record">
- <refnamediv>
- <refname>dbase_replace_record</refname>
- <refpurpose>Remplace un enregistrement dans une base dBase.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcdef>bool <function>dbase_replace_record</function></funcdef>
- <paramdef>int <parameter>dbase_identifier</parameter></paramdef>
- <paramdef>array <parameter>record</parameter></paramdef>
- <paramdef>int <parameter>dbase_record_number</parameter></paramdef>
- </funcsynopsis>
- <simpara>
- Remplace les données associées à l'enregistrement
<parameter>record_number</parameter>
- par les données enregistrées dans <parameter>record</parameter>.
- Si le nombre de colonnes fourni n'est pas celui du nombre de champs dans la
base,
- l'opération échouera, et FALSE sera retourné.
- </simpara>
- <simpara>
- <parameter>dbase_record_number</parameter> est un entier qui peut aller de 1
- jusqu'au nombre maximal d'enregistrement de la base (retourné par
- <function>dbase_numrecords</function>).
- </simpara>
- </refsect1>
- </refentry>
-
- <refentry id="function.dbase-delete-record">
- <refnamediv>
- <refname>dbase_delete_record</refname>
- <refpurpose>Defface un enregistrement dans une base dBase.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcdef>bool <function>dbase_delete_record</function></funcdef>
- <paramdef>int <parameter>dbase_identifier</parameter></paramdef>
- <paramdef>int <parameter>record</parameter></paramdef>
- </funcsynopsis>
- <para>
- Marque l'enregistrement <parameter>record</parameter> pour l'effacement, dans la
- base. Pour effacer réellement l'enregistrement, il faut utiliser aussi
- <function>dbase_pack</function>.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.dbase-get-record">
- <refnamediv>
- <refname>dbase_get_record</refname>
- <refpurpose>Lit un enregistrement dans une base dBase.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcdef>array <function>dbase_get_record</function></funcdef>
- <paramdef>int <parameter>dbase_identifier</parameter></paramdef>
- <paramdef>int <parameter>record</parameter></paramdef>
- </funcsynopsis>
- <para>
- Retourne les données de l'enregistrement <parameter>record</parameter>
dans un
- tableau. Le tableau est indexé à partir de 0, et inclus un membre
nommé
- 'deleted' (effacé), qui sera mis à 1 si l'enregistrement a
été marqué pour
- l'effacement (voir <function>dbase_delete_record</function>).
- </para>
- <para>
- Chaque champs est converti au format approprié PHP. (Les dates sont
laissées au
- format chaîne).
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.dbase-get-record-with-names">
- <refnamediv>
- <refname>dbase_get_record_with_names</refname>
- <refpurpose>
- Lit un enregistrement dans une base, sous la forme d'un tableau associatif.
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcdef>array
- <function>dbase_get_record_with_names</function>
- </funcdef>
- <paramdef>int <parameter>dbase_identifier</parameter></paramdef>
- <paramdef>int <parameter>record</parameter></paramdef>
- </funcsynopsis>
- <para>
- Retourne les données de l'enregistrement <parameter>record</parameter>
dans un
- tableau associatif. Le tableau inclus un membre nommé 'deleted'
(effacé),
- qui sera mis à 1 si l'enregistrement a été marqué
pour l'effacement (voir
- <function>dbase_delete_record</function>).
- </para>
- <para>
- Chaque champs est converti au format approprié PHP. (Les dates sont
- laissées au format chaîne).
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.dbase-numfields">
- <refnamediv>
- <refname>dbase_numfields</refname>
- <refpurpose>
- Compte le nombre de champs d'une base dBase.
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcdef>int <function>dbase_numfields</function></funcdef>
- <paramdef>int <parameter>dbase_identifier</parameter></paramdef>
- </funcsynopsis>
- <para>
- Retourne le nombre de champs (colonnes) de la base de données
spécifiée.
- Les numéros de champs sont numérotés de 0 à
dbase_numfields($db)-1,
- tandis que les numéros d'enregistrements sont numérotés de
1 à
- dbase_numrecords($db).
- <example>
- <title>Utiliser <function>dbase_numfields</function></title>
- <programlisting role="php">
-$rec = dbase_get_record($db, $recno);
-$nf = dbase_numfields($db);
-for ($i=0; $i < $nf; $i++) {
- print $rec[$i]."<br>\n";
-}
- </programlisting>
- </example>
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.dbase-numrecords">
- <refnamediv>
- <refname>dbase_numrecords</refname>
- <refpurpose>
- Compter le nombre d'enregistrements dans une base dBase.
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcdef>int <function>dbase_numrecords</function></funcdef>
- <paramdef>int <parameter>dbase_identifier</parameter></paramdef>
- </funcsynopsis>
- <para>
- Retourne le nombre d'enregistrements (lignes) dans la base
spécifiée.
- Les numéros de champs sont numérotés de 0 à
dbase_numfields($db)-1,
- tandis que les numéros d'enregistrements sont numérotés de
1 à
- dbase_numrecords($db).
- </para>
- </refsect1>
- </refentry>
-
- </reference>
-
-<!-- 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
-sgml-parent-document:nil
-sgml-default-dtd-file:"../../manual.ced"
-sgml-exposed-tags:nil
-sgml-local-catalogs:nil
-sgml-local-ecat-files:nil
-End:
--->
+ <reference id="ref.dbase">
+ <title>dBase</title>
+ <titleabbrev>dBase</titleabbrev>
+ <partintro>
+ <simpara>
+ Ces fonctions vous permettront d'accéder aux enregistrements d'une base
+au format
+ dBase (.dbf).
+ </simpara>
+ <simpara>
+ dBase ne permet pas l'utilisation d'index, de "memo fields", ni le blocage
+ de la base. Deux processus de serveurs web différents modifiant la
+même fichier
+ dBase risque de rendre votre base de données incohérente.
+ </simpara>
+ <simpara>
+ A la différence des bases de données SQL, la définition des
+bases de données
+ dBase, ne peut pas être changée. Une fois le fichier
+créé, la définition de
+ la base est définitive. Il n'y a pas d'index qui accélèrent
+les recherches ou
+ organisent vos données. Les fichiers dBase sont de simples fichiers
+séquentiels
+ avec des enregistrements de longueur fixe. Les enregistrements sont
+ajoutés à la
+ fin du fichier et les enregistrements supprimés sont conservés
+jusqu'à l'appel de
+ <function>dbase_pack</function>.
+ </simpara>
+ <simpara>
+ Nous vous recommandons de ne pas utiliser les fichiers dBase comme base de
+données
+ de production. Choisissez n'importe quel serveur SQL à la place. MySQL et
+ Postgres sont des choix classiques avec PHP. Le support de dBase ne se justifie
+ ici que pour vous permettre d'importer et d'exporter des données de et
+vers votre
+ base des données web, maintenant que le format du fichier est
+communément géré par
+ les feuilles et organiseurs Windows. L'import et l'export de données est
+l'unique
+ chose pour laquelle l'utilisation de dBase est recommandée.
+ </simpara>
+ </partintro>
+ <refentry id="function.dbase-create">
+ <refnamediv>
+ <refname>dbase_create</refname>
+ <refpurpose>Crée une base de données dBase.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcdef>int <function>dbase_create</function></funcdef>
+ <paramdef>string <parameter>filename</parameter></paramdef>
+ <paramdef>array <parameter>fields</parameter></paramdef>
+ </funcsynopsis>
+ <para>
+ <parameter>fields</parameter> est un tableau de tableaux. Chaque tableau
+ décrit le format d'un fichier de la base. Chaque champs est
+constitué d'un nom,
+ d'un caractère de type de champs, d'une longueur et d'une
+précision.
+ </para>
+ <para>
+ Les types de champs disponibles sont :
+ <variablelist>
+ <varlistentry>
+ <term>L</term>
+ <listitem>
+ <simpara>
+ Boolean (booléen). Pas de longueur ou de précision pour ces
+valeurs.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>M</term>
+ <listitem>
+ <simpara>
+ Memo. (Note importante : les Memos ne sont pas supportés par PHP.)
+ Elles n'ont pas de longueur ou de précision.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>D</term>
+ <listitem>
+ <simpara>
+ Date (enregistrée au format 'YYYYMMDD'). Elles n'ont pas de longueur
+ou
+ de précision.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>N</term>
+ <listitem>
+ <simpara>
+ Number (nombre). Possède une longueur et un précision (le
+nombre de
+ chiffres après la virgule).
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>C</term>
+ <listitem>
+ <simpara>
+ String (chaîne).
+ </simpara>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ <para>
+ Si la base de données a été créée, un
+identifiant de base dbase_identifier est
+ retourné, sinon, <literal>FALSE</literal> est retourné.
+ <example>
+ <title>Création d'une base dBase</title>
+ <programlisting role="php">
+<?php
+// "database" name
+$dbname = "/tmp/test.dbf";
+// database "definition"
+$def =
+ array(
+ array("date", "D"),
+ array("name", "C", 50),
+ array("age", "N", 3, 0),
+ array("email", "C", 128),
+ array("ismember", "L")
+ );
+// création
+if (!dbase_create($dbname, $def))
+ print "<strong>Error!</strong>";
+?>
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.dbase-open">
+ <refnamediv>
+ <refname>dbase_open</refname>
+ <refpurpose>Ouverture d'une base dBase.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcdef>int <function>dbase_open</function></funcdef>
+ <paramdef>string <parameter>filename</parameter></paramdef>
+ <paramdef>int <parameter>flags</parameter></paramdef>
+ </funcsynopsis>
+ <para>
+ <parameter>flags</parameter> est un flag, comme pour la fonction open().
+ (Typiquement; 0 signifie lecture seule, 1 signifie écriture seule, et
+ 2 écriture/lecture).
+ </para>
+ <para>
+ Retourne un identifiant de base de données, ou <literal>FALSE</literal>
+si la base n'a pas pu être
+ selectionnée.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.dbase-close">
+ <refnamediv>
+ <refname>dbase_close</refname>
+ <refpurpose>Ferme une base dBase.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcdef>bool <function>dbase_close</function></funcdef>
+ <paramdef>int <parameter>dbase_identifier</parameter></paramdef>
+ </funcsynopsis>
+ <para>
+ Ferme la base associée à <parameter>dbase_identifier</parameter>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.dbase-pack">
+ <refnamediv>
+ <refname>dbase_pack</refname>
+ <refpurpose>Compacte une base dBase.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcdef>bool <function>dbase_pack</function></funcdef>
+ <paramdef>int <parameter>dbase_identifier</parameter></paramdef>
+ </funcsynopsis>
+ <para>
+ Compacte la base de données spécifiée (effacement
+définitif de tous les
+ enregistrements marqués pour l'effacement, avec la fonction
+ <function>dbase_delete_record</function>).
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.dbase-add-record">
+ <refnamediv>
+ <refname>dbase_add_record</refname>
+ <refpurpose>Ajoute un enregistrement dans une base dBase.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcdef>bool <function>dbase_add_record</function></funcdef>
+ <paramdef>int <parameter>dbase_identifier</parameter></paramdef>
+ <paramdef>array <parameter>record</parameter></paramdef>
+ </funcsynopsis>
+ <para>
+ Ajoute les données de <parameter>record</parameter> dans la base
+spécifiée par
+ <parameter>dbase_identifier</parameter>. Si le nombre de colonnes fourni n'est
+pas
+ celui du nombre de champs dans la base, l'opération échouera, et
+<literal>FALSE</literal> sera
+ retourné.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.dbase-replace-record">
+ <refnamediv>
+ <refname>dbase_replace_record</refname>
+ <refpurpose>Remplace un enregistrement dans une base dBase.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcdef>bool <function>dbase_replace_record</function></funcdef>
+ <paramdef>int <parameter>dbase_identifier</parameter></paramdef>
+ <paramdef>array <parameter>record</parameter></paramdef>
+ <paramdef>int <parameter>dbase_record_number</parameter></paramdef>
+ </funcsynopsis>
+ <simpara>
+ Remplace les données associées à l'enregistrement
+<parameter>record_number</parameter>
+ par les données enregistrées dans <parameter>record</parameter>.
+ Si le nombre de colonnes fourni n'est pas celui du nombre de champs dans la base,
+ l'opération échouera, et <literal>FALSE</literal> sera
+retourné.
+ </simpara>
+ <simpara>
+ <parameter>dbase_record_number</parameter> est un entier qui peut aller de 1
+ jusqu'au nombre maximal d'enregistrement de la base (retourné par
+ <function>dbase_numrecords</function>).
+ </simpara>
+ </refsect1>
+ </refentry>
+ <refentry id="function.dbase-delete-record">
+ <refnamediv>
+ <refname>dbase_delete_record</refname>
+ <refpurpose>Defface un enregistrement dans une base dBase.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcdef>bool <function>dbase_delete_record</function></funcdef>
+ <paramdef>int <parameter>dbase_identifier</parameter></paramdef>
+ <paramdef>int <parameter>record</parameter></paramdef>
+ </funcsynopsis>
+ <para>
+ Marque l'enregistrement <parameter>record</parameter> pour l'effacement, dans la
+ base. Pour effacer réellement l'enregistrement, il faut utiliser aussi
+ <function>dbase_pack</function>.
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.dbase-get-record">
+ <refnamediv>
+ <refname>dbase_get_record</refname>
+ <refpurpose>Lit un enregistrement dans une base dBase.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcdef>array <function>dbase_get_record</function></funcdef>
+ <paramdef>int <parameter>dbase_identifier</parameter></paramdef>
+ <paramdef>int <parameter>record</parameter></paramdef>
+ </funcsynopsis>
+ <para>
+ Retourne les données de l'enregistrement <parameter>record</parameter>
+ dans un tableau. Le tableau est indexé à partir de 0, et inclus
+ un membre nommé 'deleted' (effacé), qui sera mis à 1
+ si l'enregistrement a été marqué pour l'effacement
+ (voir <function>dbase_delete_record</function>).
+ </para>
+ <para>
+ Chaque champs est converti au format approprié PHP. (Les dates sont
+ laissées au format chaîne).
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.dbase-get-record-with-names">
+ <refnamediv>
+ <refname>dbase_get_record_with_names</refname>
+ <refpurpose>
+ Lit un enregistrement dans une base, sous la forme d'un tableau associatif.
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcdef>array
+ <function>dbase_get_record_with_names</function>
+ </funcdef>
+ <paramdef>int <parameter>dbase_identifier</parameter></paramdef>
+ <paramdef>int <parameter>record</parameter></paramdef>
+ </funcsynopsis>
+ <para>
+ Retourne les données de l'enregistrement <parameter>record</parameter>
+ dans un tableau associatif. Le tableau inclus un membre nommé 'deleted'
+ (effacé), qui sera mis à 1 si l'enregistrement a
+ été marqué pour l'effacement (voir
+ <function>dbase_delete_record</function>).
+ </para>
+ <para>
+ Chaque champs est converti au format approprié PHP. (Les dates sont
+ laissées au format chaîne).
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.dbase-numfields">
+ <refnamediv>
+ <refname>dbase_numfields</refname>
+ <refpurpose>
+ Compte le nombre de champs d'une base dBase.
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcdef>int <function>dbase_numfields</function></funcdef>
+ <paramdef>int <parameter>dbase_identifier</parameter></paramdef>
+ </funcsynopsis>
+ <para>
+ Retourne le nombre de champs (colonnes) de la base de données
+spécifiée.
+ Les numéros de champs sont numérotés de 0 à
+dbase_numfields($db)-1,
+ tandis que les numéros d'enregistrements sont numérotés de
+1 à
+ dbase_numrecords($db).
+ <example>
+ <title>Utiliser <function>dbase_numfields</function></title>
+ <programlisting role="php">
+<?php
+$rec = dbase_get_record($db, $recno);
+$nf = dbase_numfields($db);
+for ($i=0; $i < $nf; $i++) {
+ print $rec[$i]."<br>\n";
+}
+?>
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+ </refentry>
+ <refentry id="function.dbase-numrecords">
+ <refnamediv>
+ <refname>dbase_numrecords</refname>
+ <refpurpose>
+ Compter le nombre d'enregistrements dans une base dBase.
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcdef>int <function>dbase_numrecords</function></funcdef>
+ <paramdef>int <parameter>dbase_identifier</parameter></paramdef>
+ </funcsynopsis>
+ <para>
+ Retourne le nombre d'enregistrements (lignes) dans la base
+spécifiée.
+ Les numéros de champs sont numérotés de 0 à
+dbase_numfields($db)-1,
+ tandis que les numéros d'enregistrements sont numérotés de
+1 à
+ dbase_numrecords($db).
+ </para>
+ </refsect1>
+ </refentry>
+ </reference>
+<!-- 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
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+-->
Index: phpdoc/fr/functions/dbm.xml
diff -u phpdoc/fr/functions/dbm.xml:1.2 phpdoc/fr/functions/dbm.xml:1.3
--- phpdoc/fr/functions/dbm.xml:1.2 Mon Nov 13 02:50:18 2000
+++ phpdoc/fr/functions/dbm.xml Tue Jan 16 02:38:38 2001
@@ -1,14 +1,13 @@
<reference id="ref.dbm">
- <title>Fonctions dbm</title>
+ <title>DBM</title>
<titleabbrev>DBM</titleabbrev>
-
<partintro>
<simpara>
- Ces fonctions vous permettent d'écrire des lignes dans une
- base de donnée de type dbm. Ce type de base (supporté
- par Berkeley db, gdbm, et quelques librairies systèmes,
- ou certaines librairies du système d'exploitation) enregistre
- les paires clés/valeurs, (contrairement aux enregistrements
+ Ces fonctions vous permettent d'écrire des lignes dans une
+ base de donnée de type dbm. Ce type de base (supporté
+ par Berkeley db, gdbm, et quelques librairies systèmes,
+ ou certaines librairies du système d'exploitation) enregistre
+ les paires clés/valeurs, (contrairement aux enregistrements
par ligne, utilisé par les autres bases de données
relationnelles).
</simpara>
@@ -16,6 +15,7 @@
<example>
<title>dbm</title>
<programlisting role="php">
+<?php
$dbm = dbmopen("dernier", "w");
if (dbmexists($dbm, $userid)) {
$last_seen = dbmfetch($dbm, $userid);
@@ -25,10 +25,11 @@
faire_quelquechose();
dbmreplace($dbm, $userid, time());
dbmclose($dbm);
-</programlisting></example>
+?>
+ </programlisting>
+ </example>
</para>
</partintro>
-
<refentry id="function.dbmopen">
<refnamediv>
<refname>dbmopen</refname>
@@ -44,36 +45,35 @@
</funcprototype>
</funcsynopsis>
<para>
- Le premier argument est le chemin absolu jusqu'au fichier dbm à
- ouvrir. Le deuxième argument est le mode d'ouverture du fichier,
- qui peut prendre les valeurs suivantes : "r", "n", "c" ou "w" qui
- représentent respectivement lecture seule, nouveau (ce qui
- implique lecture/écriture, et qui, probablement, va
- écraser une base existante), création(ce qui
- implique lecture/écriture, et qui, probablement, va
- écraser une base existante), et lecture/écriture.
+ Le premier argument est le chemin absolu jusqu'au fichier dbm à
+ ouvrir. Le deuxième argument est le mode d'ouverture du fichier,
+ qui peut prendre les valeurs suivantes : "r", "n", "c" ou "w" qui
+ représentent respectivement lecture seule, nouveau (ce qui
+ implique lecture/écriture, et qui, probablement, va
+ écraser une base existante), création(ce qui
+ implique lecture/écriture, et qui, probablement, va
+ écraser une base existante), et lecture/écriture.
</para>
<para>
- Retourne un identifiant, qui sera passé à toutes
- les autres fonctions dbm, en cas de succès, ou FALSE en
+ Retourne un identifiant, qui sera passé à toutes
+ les autres fonctions dbm, en cas de succès, ou <literal>FALSE</literal>
+en
cas d'échec.
</para>
<para>
- Si ndbm est utilisé, ndbm va créer les fichiers
- filename.dir et filename.pag. gdbm n'utilise qu'un fichier,
- tout comme les librairie internes, et Berkeley db crée
- le fichier filename.db. Notez que PHP dispose de son propre
- système de verrouillage des fichiers, qui s'additionne
- à celui éventuellement fait par les librairies.
- PHP n'efface jamais les fichiers .lck qu'il crée. Il
- les utilise comme inode fixe, sur lequel faire le verrouillage.
- Pour plus d'informations sur les fichiers dbm, reportez vous
- à vos pages de manuel Unix (man) , ou bien chargez gdbm :
+ Si ndbm est utilisé, ndbm va créer les fichiers
+ filename.dir et filename.pag. gdbm n'utilise qu'un fichier,
+ tout comme les librairie internes, et Berkeley db crée
+ le fichier filename.db. Notez que PHP dispose de son propre
+ système de verrouillage des fichiers, qui s'additionne
+ à celui éventuellement fait par les librairies.
+ PHP n'efface jamais les fichiers .lck qu'il crée. Il
+ les utilise comme inode fixe, sur lequel faire le verrouillage.
+ Pour plus d'informations sur les fichiers dbm, reportez vous
+ à vos pages de manuel Unix (man) , ou bien chargez gdbm :
<filename role="url">ftp://prep.ai.mit.edu/pub/gnu</filename>.
</para>
</refsect1>
</refentry>
-
<refentry id="function.dbmclose">
<refnamediv>
<refname>dbmclose</refname>
@@ -92,7 +92,6 @@
</para>
</refsect1>
</refentry>
-
<refentry id="function.dbmexists">
<refnamediv>
<refname>dbmexists</refname>
@@ -108,12 +107,11 @@
</funcprototype>
</funcsynopsis>
<para>
- Retourne TRUE si il y a une valeur associée à la clé
+ Retourne <literal>TRUE</literal> si il y a une valeur associée à
+la clé
<parameter>key</parameter>.
</para>
</refsect1>
</refentry>
-
<refentry id="function.dbmfetch">
<refnamediv>
<refname>dbmfetch</refname>
@@ -134,7 +132,6 @@
</para>
</refsect1>
</refentry>
-
<refentry id="function.dbminsert">
<refnamediv>
<refname>dbminsert</refname>
@@ -151,18 +148,17 @@
</funcprototype>
</funcsynopsis>
<para>
- Ajoute la valeur <parameter>value</parameter> dans la base de
+ Ajoute la valeur <parameter>value</parameter> dans la base de
données, avec la clé <parameter>key</parameter>.
</para>
<para>
- Retourne -1 si la base a été ouverte en mode lecture
- seule, 0 si l'insertion a été réussie, et 1 si
- la clé key existe déjà. (Pour remplacer la
+ Retourne -1 si la base a été ouverte en mode lecture
+ seule, 0 si l'insertion a été réussie, et 1 si
+ la clé key existe déjà. (Pour remplacer la
valeur, utilisez <function>dbmreplace</function>.)
</para>
</refsect1>
</refentry>
-
<refentry id="function.dbmreplace">
<refnamediv>
<refname>dbmreplace</refname>
@@ -179,16 +175,15 @@
</funcprototype>
</funcsynopsis>
<para>
- Remplace une valeur courante par la valeur <parameter>value</parameter>
+ Remplace une valeur courante par la valeur <parameter>value</parameter>
pour la clé <parameter>key</parameter>, dans une base dbm.
</para>
<para>
- Cette fonction va créer la clé, si elle n'existe pas
+ Cette fonction va créer la clé, si elle n'existe pas
dans la base.
</para>
</refsect1>
</refentry>
-
<refentry id="function.dbmdelete">
<refnamediv>
<refname>dbmdelete</refname>
@@ -204,15 +199,14 @@
</funcprototype>
</funcsynopsis>
<para>
- Efface la valeur de la clé <parameter>key</parameter>,
+ Efface la valeur de la clé <parameter>key</parameter>,
dans la base dbm.
</para>
<para>
- Retourne FALSE si la clé n'existe pas dans cette base.
+ Retourne <literal>FALSE</literal> si la clé n'existe pas dans cette
+base.
</para>
</refsect1>
</refentry>
-
<refentry id="function.dbmfirstkey">
<refnamediv>
<refname>dbmfirstkey</refname>
@@ -227,14 +221,13 @@
</funcprototype>
</funcsynopsis>
<para>
- Retourne la première clé de la base de données.
- Notez bien que les clés ne sont pas dans un ordre défini,
- étant donné que la table est construite comme une table
+ Retourne la première clé de la base de données.
+ Notez bien que les clés ne sont pas dans un ordre défini,
+ étant donné que la table est construite comme une table
de hash.
</para>
</refsect1>
</refentry>
-
<refentry id="function.dbmnextkey">
<refnamediv>
<refname>dbmnextkey</refname>
@@ -250,24 +243,26 @@
</funcprototype>
</funcsynopsis>
<para>
- Retourne la clé après la clé
- <parameter>key</parameter>. En appelant <function>dbmfirstkey</function>,
- puis successivement <function>dbmnextkey</function>, il est
- possible de passer en revue toute les paires clé/valeur
- de la base de données dbm. Par exemple :
- <example>
- <title>Passer en revue une base de données.</title>
- <programlisting>
+ <function>dbmnextkey</function> retourne la clé après la clé
+ <parameter>key</parameter>. En appelant <function>dbmfirstkey</function>,
+ puis successivement <function>dbmnextkey</function>, il est
+ possible de passer en revue toute les paires clé/valeur
+ de la base de données dbm. Par exemple :
+ <example>
+ <title>Passer en revue une base de données.</title>
+ <programlisting role="php">
+<?php
$key = dbmfirstkey($dbm_id);
while ($key) {
echo "$key = " . dbmfetch($dbm_id, $key) . "\n";
$key = dbmnextkey($dbm_id, $key);
}
- </programlisting>
- </example></para>
+?>
+ </programlisting>
+ </example>
+ </para>
</refsect1>
</refentry>
-
<refentry id="function.dblist">
<refnamediv>
<refname>dblist</refname>
@@ -283,9 +278,7 @@
</funcsynopsis>
</refsect1>
</refentry>
-
</reference>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Index: phpdoc/fr/functions/dir.xml
diff -u phpdoc/fr/functions/dir.xml:1.2 phpdoc/fr/functions/dir.xml:1.3
--- phpdoc/fr/functions/dir.xml:1.2 Tue Nov 14 01:44:47 2000
+++ phpdoc/fr/functions/dir.xml Tue Jan 16 02:38:38 2001
@@ -1,7 +1,6 @@
<reference id="ref.dir">
<title>Accès aux dossiers</title>
<titleabbrev>Dossiers</titleabbrev>
-
<refentry id="function.chdir">
<refnamediv>
<refname>chdir</refname>
@@ -16,12 +15,12 @@
</funcprototype>
</funcsynopsis>
<para>
- Change le dossier courant de PHP en <parameter>directory</parameter>.
- Retourne FALSE si l'opération échoue, et TRUE sinon.
+ <function>chdir</function> change le dossier courant de PHP en
+ <parameter>directory</parameter>. <function>chdir</function> retourne
+<literal>FALSE</literal>
+ si l'opération échoue, et <literal>TRUE</literal> sinon.
</para>
</refsect1>
</refentry>
-
<refentry id="function.dir">
<refnamediv>
<refname>dir</refname>
@@ -36,18 +35,19 @@
</funcprototype>
</funcsynopsis>
<para>
- Un mécanisme pseudo-objet permet la lecture d'un dossier.
- L'argument <parameter>directory</parameter> doit être ouvert.
- Deux propriétés sont disponibles une fois le dossier
- ouvert : le pointeur peut être utilisé avec d'autres
- fonctions telles que <function>readdir</function>,
- <function>rewinddir</function> et <function>closedir</function>.
- Le chemin du dossier est le chemin fourni lors de la construction
+ Un mécanisme pseudo-objet permet la lecture d'un dossier.
+ L'argument <parameter>directory</parameter> doit être ouvert.
+ Deux propriétés sont disponibles une fois le dossier
+ ouvert : le pointeur peut être utilisé avec d'autres
+ fonctions telles que <function>readdir</function>,
+ <function>rewinddir</function> et <function>closedir</function>.
+ Le chemin du dossier est le chemin fourni lors de la construction
de l'objet. Trois méthodes permettent de lire, remettre
à zéro et fermer le dossier.
<example>
- <title><function>Dir</function> Example</title>
+ <title>Exemple avec <function>dir</function></title>
<programlisting role="php">
+<?php
$d = dir("/etc");
echo "Pointeur: ".$d->handle."<br>\n";
echo "Chemin: ".$d->path."<br>\n";
@@ -55,12 +55,12 @@
echo $entry."<br>\n";
}
$d->close();
+?>
</programlisting>
</example>
</para>
</refsect1>
</refentry>
-
<refentry id="function.closedir">
<refnamediv>
<refname>closedir</refname>
@@ -75,13 +75,12 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>closedir</function> ferme le pointeur de dossier
- <parameter>dir_handle</parameter>. Le dossier devait avoir
+ <function>closedir</function> ferme le pointeur de dossier
+ <parameter>dir_handle</parameter>. Le dossier devait avoir
été ouvert avec <function>opendir</function>.
</para>
</refsect1>
</refentry>
-
<refentry id="function.getcwd">
<refnamediv>
<refname>getcwd</refname>
@@ -96,11 +95,10 @@
</funcprototype>
</funcsynopsis>
<para>
- Retourne le nom du dossier courant.
+ <function>getcwd</function> retourne le nom du dossier courant.
</para>
</refsect1>
</refentry>
-
<refentry id="function.opendir">
<refnamediv>
<refname>opendir</refname>
@@ -116,15 +114,14 @@
<paramdef>string <parameter>path</parameter></paramdef>
</funcprototype>
</funcsynopsis>
- <para>
- <function>opendir</function> retourne un pointeur sur un dossier
- pour être utilisé avec les fonctions
- <function>closedir</function>, <function>readdir</function>
+ <para>
+ <function>opendir</function> retourne un pointeur sur un dossier
+ pour être utilisé avec les fonctions
+ <function>closedir</function>, <function>readdir</function>
et <function>rewinddir</function>.
</para>
</refsect1>
</refentry>
-
<refentry id="function.readdir">
<refnamediv>
<refname>readdir</refname>
@@ -139,9 +136,9 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>readdir</function> retourne le nom du fichier suivant dans
- le dossier identifié par dir_handle. Les noms sont
- retournés dans n'importe quel ordre.
+ <function>readdir</function> retourne le nom du fichier suivant dans
+ le dossier identifié par dir_handle. Les noms sont
+ retournés dans n'importe quel ordre.
<example>
<title>Liste tous les fichiers du dossier courant</title>
<programlisting role="php">
@@ -152,34 +149,33 @@
while ($file = readdir($handle)) {
echo "$file\n";
}
-closedir($handle);
+closedir($handle);
?>
</programlisting>
</example>
</para>
<para>
Notez que <function>readdir</function> retournera aussi les dossiers "." et
- "..". Si vous ne les voulez pas, supprimez les simplement :
+ "..". Si vous ne les voulez pas, supprimez les simplement :
<example>
<title>
Liste tous les fichiers du dossier courant, sauf . et ..
</title>
<programlisting role="php">
-<?php
-$handle=opendir('.');
-while ($file = readdir($handle)) {
- if ($file != "." && $file != "..") {
- echo "$file\n";
- }
+<?php
+$handle=opendir('.');
+while ($file = readdir($handle)) {
+ if ($file != "." && $file != "..") {
+ echo "$file\n";
+ }
}
-closedir($handle);
+closedir($handle);
?>
</programlisting>
</example>
</para>
</refsect1>
</refentry>
-
<refentry id="function.rewinddir">
<refnamediv>
<refname>rewinddir</refname>
@@ -194,14 +190,12 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>rewinddir</function> retourne à la première
+ <function>rewinddir</function> retourne à la première
entrée du dossier : le prochain fichier lu sera le premier.
</para>
</refsect1>
</refentry>
-
</reference>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Index: phpdoc/fr/functions/dl.xml
diff -u phpdoc/fr/functions/dl.xml:1.2 phpdoc/fr/functions/dl.xml:1.3
--- phpdoc/fr/functions/dl.xml:1.2 Tue Nov 14 01:45:10 2000
+++ phpdoc/fr/functions/dl.xml Tue Jan 16 02:38:38 2001
@@ -1,7 +1,6 @@
<reference id="ref.dl">
<title>Chargement dynamique de fonctions</title>
<titleabbrev>Chargement dynamique</titleabbrev>
-
<refentry id="function.dl">
<refnamediv>
<refname>dl</refname>
@@ -16,15 +15,13 @@
</funcprototype>
</funcsynopsis>
<para>
- Charge l'extension PHP définie dans la bibliothèque
- <parameter>library</parameter>. Voir aussi la directive de configuration
+ Charge l'extension PHP définie dans la bibliothèque
+ <parameter>library</parameter>. Voir aussi la directive de configuration
<link linkend="ini.extension-dir">extension_dir</link>.
</para>
</refsect1>
</refentry>
</reference>
-
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
@@ -41,4 +38,3 @@
sgml-local-ecat-files:nil
End:
-->
-
Index: phpdoc/fr/functions/apache.xml
diff -u phpdoc/fr/functions/apache.xml:1.7 phpdoc/fr/functions/apache.xml:1.8
--- phpdoc/fr/functions/apache.xml:1.7 Thu Dec 14 00:45:01 2000
+++ phpdoc/fr/functions/apache.xml Tue Jan 16 02:38:38 2001
@@ -5,7 +5,7 @@
<refnamediv>
<refname>apache_lookup_uri</refname>
<refpurpose>
- Effectue une requête partielle pour l'URI spécifiée
+ Effectue une requête partielle pour l'URI spécifiée
et renvoie toutes les informations.
</refpurpose>
</refnamediv>
@@ -16,10 +16,10 @@
<paramdef>string <parameter>filename</parameter></paramdef>
</funcsynopsis>
<para>
- <function>apache_lookup_uri</function> effectue une requête partielle
- pour l'URI spécifiée. Cette requête permet de
- récupérer toutes les informations importantes à
- propos de la ressource concernée. Les propriétés
+ <function>apache_lookup_uri</function> effectue une requête partielle
+ pour l'URI spécifiée. Cette requête permet de
+ récupérer toutes les informations importantes à
+ propos de la ressource concernée. Les propriétés
de la classe renvoyée sont les suivantes :
<simplelist>
<member>status</member>
@@ -47,7 +47,7 @@
</para>
<note>
<simpara>
- Note: apache_lookup_uri ne fonctionne que lorsque le PHP est
+ Note: apache_lookup_uri ne fonctionne que lorsque le PHP est
installé sous la forme d'un module Apache.
</simpara>
</note>
@@ -100,7 +100,7 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>getallheaders</function> renvoie un tableau associatif de tous
+ <function>getallheaders</function> renvoie un tableau associatif de tous
les entêtes HTTP correspondants à la requête courante.
<note>
<para>
@@ -116,10 +116,12 @@
Exemple d'utilisation de la fonction <function>getallheaders</function>
</title>
<programlisting role="php">
+<?php
$headers = getallheaders();
while (list($entete, $valeur) = each($headers)) {
echo "$entete: $valeur<br>\n";
}
+?>
</programlisting>
</example>
Cette exemple est un exemple d'affichage de toutes les entêtes
@@ -145,19 +147,19 @@
<paramdef>string <parameter>filename</parameter></paramdef>
</funcsynopsis>
<para>
- <function>virtual</function> est une fonction spécifique au
- serveur Apache. Elle est équivalente à la directive
- "<!--#include virtual...-->" lorsque vous utilisez le module
+ <function>virtual</function> est une fonction spécifique au
+ serveur Apache. Elle est équivalente à la directive
+ "<!--#include virtual...--?>" lorsque vous utilisez le module
include d'Apache. Cette fonction effectue une sous-requête Apache.
- C'est très utile lorsque vous utilisez des scripts CGI, des
- fichiers .shtml ou n'importe quel type de fichier qui doit être
- analysé par le serveur Apache. Il est à noter que lors
- de l'utilisation avec des scripts CGI, ces derniers doivent
- générer une entête valide, c'est-à-dire,
- au minimum une entête "Content-Type". Pour les fichiers PHP, il
- est conseillé d'utiliser les fonctions <function>include</function>
- et <function>require</function>. <function>virtual</function> ne peut pas
- être utilisé pour inclure un fichier qui est lui même
+ C'est très utile lorsque vous utilisez des scripts CGI, des
+ fichiers .shtml ou n'importe quel type de fichier qui doit être
+ analysé par le serveur Apache. Il est à noter que lors
+ de l'utilisation avec des scripts CGI, ces derniers doivent
+ générer une entête valide, c'est-à-dire,
+ au minimum une entête "Content-Type". Pour les fichiers PHP, il
+ est conseillé d'utiliser les fonctions <function>include</function>
+ et <function>require</function>. <function>virtual</function> ne peut pas
+ être utilisé pour inclure un fichier qui est lui même
un fichier PHP.
</para>
</refsect1>
@@ -176,10 +178,10 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>ascii2ebcdic</function> est une fonction spéficique
- à Apache, qui n'est disponible que sur les OS qui gère
- le format EBCDIC (OS/390, BS2000). Elle traduit la chaîne ASCII
- <parameter>ascii_str</parameter> en son équivalent EBCDIC
+ <function>ascii2ebcdic</function> est une fonction spéficique
+ à Apache, qui n'est disponible que sur les OS qui gère
+ le format EBCDIC (OS/390, BS2000). Elle traduit la chaîne ASCII
+ <parameter>ascii_str</parameter> en son équivalent EBCDIC
(avec protection des données binaires) et retourne le résultat.
</para>
<para>
@@ -201,10 +203,10 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>ebcdic2ascii</function> est une fonction spéficique
- à Apache, qui n'est disponible que sur les OS qui gère
- le format EBCDIC (OS/390, BS2000). Elle traduit la chaîne EBCDIC
- <parameter>ebcdic_str</parameter> en son équivalent ASCII
+ <function>ebcdic2ascii</function> est une fonction spéficique
+ à Apache, qui n'est disponible que sur les OS qui gère
+ le format EBCDIC (OS/390, BS2000). Elle traduit la chaîne EBCDIC
+ <parameter>ebcdic_str</parameter> en son équivalent ASCII
(avec protection des données binaires) et retourne le résultat.
</para>
<para>
