cvs: phpdoc /fr/functions apache.xml 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

From: Date: Tue, 16 Jan 2001 10:38:40 +0000
Subject: cvs: phpdoc /fr/functions apache.xml 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
Groups: php.doc 
Request: Send a blank email to phpdoc+get-969333685@lists.php.net to get a copy of this message
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&eacute;rer et traiter des donn&eacute;es en groupe. </simpara> <simpara> - Les tableaus simples et multi-dimensionnels sont support&eacute;s et peuvent + Les tableaux simples et multi-dimensionnels sont support&eacute;s et peuvent &ecirc;tre cr&eacute;&eacute; par l'utilisateur, ou par une fonction. Il y a des fonctions sp&eacute;cifiques qui remplissent des tableaux &agrave; partir de r&eacute;sultats de requ&ecirc;tes, et de nombreuses fonctions retournent @@ -40,7 +40,7 @@ <para> <function>array</function> retourne un tableau cr&eacute;&eacute; avec les param&egrave;tres pass&eacute;s. On peut attribuer un index particulier - &agrave; une valeur avec l'op&eacute;rateur <literal>=&gt;</literal>. + &agrave; une valeur avec l'op&eacute;rateur <literal>=?&gt;</literal>. </para> <para> <note> @@ -52,7 +52,7 @@ </note> </para> <para> - La syntaxe "index =&gt; values", s&eacute;par&eacute;s par des virgules, + La syntaxe "index =&gt; valeur", s&eacute;par&eacute;s par des virgules, d&eacute;finit les index et leur valeur. Un index peut &ecirc;tre une cha&icirc;ne ou un nombre. Si l'index est omis, un index num&eacute;rique sera automatiquement g&eacute;n&eacute;r&eacute; (commen&ccedil;ant &agrave; @@ -67,11 +67,13 @@ <example> <title>Exemple avec <function>array</function></title> <programlisting role="php"> +&lt;?php $fruits = array ( - "fruits" =&gt; array ("a"=&gt;"orange", "b"=&gt;"banane", "c"=&gt;"pomme"), - "numbers" =&gt; array (1, 2, 3, 4, 5, 6), - "holes" =&gt; array ("premier", 5 =&gt; "deuxi&egrave;me", "troisi&egrave;me") + "fruits" =&gt; array ("a" =&gt; "orange", "b" =&gt; "banane", "c" =&gt; "pomme"), + "numbres" =&gt; array (1, 2, 3, 4, 5, 6), + "trous" =&gt; array ("premier", 5 =&gt; "deuxi&egrave;me", "troisi&egrave;me") ); +?&gt; </programlisting> </example> </para> @@ -79,13 +81,15 @@ <example> <title>Index automatique d'un tableau avec <function>array</function></title> <programlisting role="php"> +&lt;?php $array = array( 1, 1, 1, 1, 1, 8=>1, 4=>1, 19, 3=>13); print_r($array); +?&gt; </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&eacute;fini deux fois, et conserve finalement sa derni&egrave;re valeur de 13. L'index '4' est d&eacute;fini apr&egrave;s @@ -108,20 +112,22 @@ <example> <title>Tableau d'index commencant &agrave; 1</title> <programlisting role="php"> - $firstquarter = array(1 => 'Janvier', 'F&eacute;vrier', 'Mars'); - print_r($firstquarter); +&lt;?php + $firstquarter = array(1 => 'Janvier', 'F&eacute;vrier', 'Mars'); + print_r($firstquarter); +?&gt; </programlisting> </example> qui affichera : <informalexample> - <programlisting> + <computeroutput> Array ( [1] => 'Janvier' [2] => 'F&eacute;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"> +&lt;?php $array = array(1, "bonjour", 1, "monde", "bonjour"); array_count_values($array); // retourne array(1=>2, "bonjour"=>2, "monde"=>1) +?&gt; </programlisting> </example> <note> @@ -191,9 +199,11 @@ <example> <title>Exemple avec <function>array_diff</function></title> <programlisting role="php"> +&lt;?php $array1 = array ("a" =&gt; "vert", "rouge", "bleu"); $array2 = array ("b" =&gt; "vert", "jaune", "rouge"); $result = array_diff ($array1, $array2); +?&gt; </programlisting> </example> </para> @@ -228,8 +238,10 @@ <example> <title>Exemple avec <function>array_flip</function></title> <programlisting role="php"> +&lt;?php $trans = array_flip ($trans); $original = strtr ($str, $trans); +?&gt; </programlisting> </example> <note> @@ -267,15 +279,16 @@ <example> <title>Exemple avec <function>array_intersect</function></title> <programlisting role="php"> +&lt;?php $array1 = array ("a" =&gt; "vert", "rouge", "bleu"); $array2 = array ("b" =&gt; "vert", "jaune", "rouge"); $result = array_intersect ($array1, $array2); +?&gt; </programlisting> </example> </para> <para> - <varname>$result</varname> contient <literal>array ("a" - =&gt; "vert", "rouge");</literal> + <varname>$result</varname> contient <literal>array ("a" =&gt; "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"> +&lt;?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) +?&gt; </programlisting> </example> </para> @@ -330,6 +345,7 @@ les utilisateurs de PHP 3 </title> <programlisting role="php"> +&lt;?php function array_keys ($arr, $term="") { $t = array(); while (list($k,$v) = each($arr)) { @@ -339,6 +355,7 @@ } return $t; } +?&gt; </programlisting> </example> </para> @@ -380,9 +397,11 @@ <example> <title>Exemple avec <function>array_merge</function></title> <programlisting role="php"> +&lt;?php $array1 = array ("couleur" => "rouge", 2, 4); $array2 = array ("a", "b", "couleur" => "vert", "forme" => "trap&eacute;zo&iuml;de"); array_merge ($array1, $array2); +?&gt; </programlisting> <para> Le r&eacute;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" =&gt; array ("favorie" =&gt; "red"), 5); -$ar2 = array (10, "couleur" =&gt; array ("favorie" =&gt; "vert", "rouge")); +&lt;?php +$ar1 = array ("couleur" =&gt; array ("favorie" ?&gt; "rouge"), 5); +$ar2 = array (10, "couleur" ?&gt; array ("favorie" ?&gt; "vert", "rouge")); $result = array_merge_recursive ($ar1, $ar2); +?&gt; </programlisting> </example> </para> <para> - Le r&eacute;sultat sera <literal>array ("couleur" =&gt; array - ("favorie" =&gt; array ("rouge", "vert"), "bleu"), 5, 10)</literal>. + Le r&eacute;sultat sera + <literal>array("couleur" =&gt; array("favorie" =&gt; array ("rouge", "vert"), "bleu"), 5, 10)</literal>. </para> <para> Voir aussi <function>array_merge</function>. @@ -526,15 +547,17 @@ &agrave; SORT_ASC et SORT_REGULAR. </para> <para> - Retourne TRUE en cas de succ&egrave;s, FALSE sinon. + Retourne <literal>TRUE</literal> en cas de succ&egrave;s, <literal>FALSE</literal> sinon. </para> <para> <example> <title>Trier plusieurs tableaux</title> <programlisting role="php"> +&lt;?php $ar1 = array ("10", 100, 100, "a"); $ar2 = array (1, 3, "2", 1); array_multisort ($ar1, $ar2); +?&gt; </programlisting> </example> </para> @@ -549,9 +572,11 @@ <example> <title>Classer un tableau multidimensionnel</title> <programlisting role="php"> +&lt;?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); +?&gt; </programlisting> </example> </para> @@ -596,6 +621,7 @@ <example> <title>Exemple avec <function>array_pad</function></title> <programlisting role="php"> +&lt;?php $input = array (12, 10, 9); $result = array_pad ($input, 5, 0); // Le r&eacute;sultat est array (12, 10, 9, 0, 0) @@ -603,6 +629,7 @@ // Le r&eacute;sultat est array (-1, -1, -1, -1, 12, 10, 9) $result = array_pad ($input, 2, "noop"); // pas compl&eacute;t&eacute; +?&gt; </programlisting> </example> </para> @@ -632,8 +659,10 @@ <example> <title>Exemple avec <function>array_pop</function></title> <programlisting role="php"> +&lt;?php $stack = array ("orange", "pomme", "framboise"); $fruit = array_pop ($stack); +?&gt; </programlisting> <para> Apr&egrave;s ceci, $stack n'a plus que 2 &eacute;l&eacute;ments: "orange" et "pomme", @@ -679,7 +708,9 @@ La longueur du tableau <parameter>array</parameter> augmente d'autant. Cela a le m&ecirc;me effet que : <programlisting role="php"> +&lt;?php $array[] = $var; +?&gt; </programlisting> repet&eacute; pour chaque <parameter>var</parameter>. </para> @@ -690,8 +721,10 @@ <example> <title>Exemple avec <function>array_push</function></title> <programlisting role="php"> +&lt;?php $stack = array (1, 2); array_push($stack, "+", 3); +?&gt; </programlisting> </example> Cet exemple fait que $stack a 4 &eacute;l&eacute;ments: 1, 2, "+", @@ -734,8 +767,10 @@ <example> <title>Exemple avec <function>array_reverse</function></title> <programlisting role="php"> +&lt;?php $input = array ("php", 4.0, array ("rouge", "vert")); $result = array_reverse ($input); +?&gt; </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"> +&lt;?php srand ((double) microtime() * 10000000); $input = array ("Neo", "Morpheus", "Trinit&eacute;e", "Cypher", "Tank"); $rand_keys = array_rand ($input, 2); print $input[$rand_keys[0]]."\n"; print $input[$rand_keys[1]]."\n"; +?&gt; </programlisting> </example> </para> @@ -820,8 +857,10 @@ <example> <title>Exemple avec <function>array_shift</function></title> <programlisting role="php"> +&lt;?php $args = array ("-v", "-f"); $opt = array_shift ($args); +?&gt; </programlisting> </example> Cet exemple aura pour r&eacute;sultat que $args ne contiendra plus que "-f", @@ -884,11 +923,13 @@ <example> <title>Exemple avec <function>array_slice</function></title> <programlisting role="php"> +&lt;?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" +?&gt; </programlisting> </example> </para> @@ -954,42 +995,49 @@ count(<literal>count($input)</literal>) &agrave; la place de length. </para> <para> - Si <parameter>replacement</parameter> est pr&eacute;cis&eacute;, alors les - &eacute;l&eacute;ments supprim&eacute;s sont remplac&eacute;s par les - &eacute;l&eacute;ments de ce tableau. Si <parameter>loffset</parameter> - et <parameter>length</parameter> sont tels que la taille du tableau ne change pas, - alors les &eacute;l&eacute;ments du tableau de remplacement replacement sont - ins&eacute;r&eacute;s &agrave; partir de l'offset <parameter>offset</parameter>. + Si <parameter>replacement</parameter> est pr&eacute;cis&eacute;, alors les + &eacute;l&eacute;ments supprim&eacute;s sont remplac&eacute;s par les + &eacute;l&eacute;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 &eacute;l&eacute;ments du tableau de remplacement replacement sont + ins&eacute;r&eacute;s &agrave; partir de l'offset <parameter>offset</parameter>. + </para> + <para> Conseil : si le tableau de remplacement ne contient qu'un seul - &eacute;l&eacute;ment, il n'est pas obligatoire de forcer le type &agrave; - array avec <literal>array()</literal>, &agrave; moins que cette variable ne soit + &eacute;l&eacute;ment, il n'est pas obligatoire de forcer le type en + tableau avec <function>array</function>, &agrave; moins que cette variable ne soit elle m&ecirc;me un tableau. </para> <para> Les codes suivants sont &eacute;quivalents : <programlisting role="php"> +&lt;?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) +?&gt; </programlisting> </para> <para> - Retourne le tableau des &eacute;l&eacute;ments supprim&eacute;s. + <function>array_splice</function> retourne le tableau des &eacute;l&eacute;ments + supprim&eacute;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") +&lt;?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") +?&gt; </programlisting> </example> </para> @@ -997,7 +1045,8 @@ Voir aussi <function>array_slice</function>. <note> <para> - <function>array_splice</function> a &eacute;t&eacute; ajout&eacute;e dans PHP 4.0. + <function>array_splice</function> a &eacute;t&eacute; ajout&eacute;e + dans PHP 4.0. </para> </note> </para> @@ -1026,14 +1075,16 @@ <example> <title>Exemple avec <function>array_unique</function></title> <programlisting role="php"> +&lt;?php $input = array ("a" =&gt; "vert", "rouge", "b" =&gt; "vert", "bleu", "rouge"); $result = array_unique ($input); +?&gt; </programlisting> </example> </para> <para> - <varname>$result</varname> contient<literal>array ("a" =&gt; - "vert", "rouge", "bleu");</literal>. + <varname>$result</varname> contient + <literal>array ("a" =&gt; "vert", "rouge", "bleu");</literal>. </para> </refsect1> </refentry> @@ -1073,8 +1124,10 @@ <example> <title>Exemples avec <function>array_unshift</function></title> <programlisting role="php"> +&lt;?php $queue = array("p1", "p3"); array_unshift($queue, "p4", "p5", "p6"); +?&gt; </programlisting> </example> Le r&eacute;sultat de cet exemple est que $queue aura 5 &eacute;l&eacute;ments, @@ -1113,8 +1166,10 @@ <example> <title>Exemples avec <function>array_values</function></title> <programlisting role="php"> +&lt;?php $array = array("taille" => "XL", "couleur" => "or"); array_values($array); // // retourne array("XL", "or") +?&gt; </programlisting> </example> <note> @@ -1128,6 +1183,7 @@ PHP 3 </title> <programlisting role="php"> +&lt;?php function array_values ($arr) { $t = array(); while (list($k, $v) = each ($arr)) { @@ -1135,7 +1191,8 @@ return $t; } } - </programlisting> +?&gt; + </programlisting> </example> </para> </note> @@ -1160,17 +1217,17 @@ </funcprototype> </funcsynopsis> <simpara> - Ex&eacute;cute la fonction <parameter>func</parameter> avec chaque - &eacute;l&eacute;ment du tableau <parameter>arr</parameter>.Les - &eacute;l&eacute;ments sont pass&eacute;s en tant que premier argument de la - fonction <parameter>func</parameter>; + <function>array_walk</function> ex&eacute;cute la fonction <parameter>func</parameter> + avec chaque &eacute;l&eacute;ment du tableau <parameter>arr</parameter>. Les + &eacute;l&eacute;ments sont pass&eacute;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&eacute;n&eacute;r&eacute;e pour chaque appel de <parameter>func</parameter>. - Ces alertes sont supprim&eacute;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&eacute;n&eacute;r&eacute;e pour chaque appel de <parameter>func</parameter>. + Ces alertes sont supprim&eacute;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"> +&lt;?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' ); +?&gt; </programlisting> </example> </para> @@ -1237,11 +1296,13 @@ <example> <title>Exemple avec <function>arsort</function></title> <programlisting role="php"> +&lt;?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"; } +?&gt; </programlisting> </example> Cet exemple va afficher: @@ -1281,11 +1342,13 @@ <example> <title>Exemple avec <function>asort</function></title> <programlisting role="php"> +&lt;?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"; } +?&gt; </programlisting> </example> Cet exemple va afficher: @@ -1324,10 +1387,10 @@ </funcprototype> </funcsynopsis> <para> - <function>compact</function> accepte diff&eacute;rents param&egrave;tres. Les - param&egrave;tres peuvent &ecirc;tre des variables contenant des cha&icirc;nes, - ou un tableau de cha&icirc;ne, qui peut contenir d'autres tableau de noms, que - <function>compact</function> traitera r&eacute;cursivement. + <function>compact</function> accepte diff&eacute;rents param&egrave;tres. Les + param&egrave;tres peuvent &ecirc;tre des variables contenant des cha&icirc;nes, + ou un tableau de cha&icirc;ne, qui peut contenir d'autres tableau de noms, que + <function>compact</function> traitera r&eacute;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"> +&lt;?php $ville = "San Francisco"; $etat = "CA"; $evenement = "SIGGRAPH"; $location_vars = array("ville", "etat"); $result = compact("evenement", $location_vars); +?&gt; </programlisting> <para> Apr&egrave;s cette op&eacute;ration, $result sera le tableau suivant : @@ -1376,9 +1441,9 @@ </funcprototype> </funcsynopsis> <para> - Retourne le nombre d'&eacute;l&eacute;ment dans <parameter>var</parameter>, qui - est g&eacute;n&eacute;ralement un tableau (et tout le reste n'aura qu'un - &eacute;l&eacute;ment). + <function>count</function> retourne le nombre d'&eacute;l&eacute;ment dans + <parameter>var</parameter>, qui est g&eacute;n&eacute;ralement un tableau + (et tout le reste n'aura qu'un &eacute;l&eacute;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"> +&lt;?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 &eacute;l&eacute;ments assign&eacute;s +?&gt; </programlisting> </example> </para> @@ -1437,19 +1504,19 @@ </funcprototype> </funcsynopsis> <para> -Chaque tableau entretien un pointeur interne, qui est initialis&eacute; lors -lorsque le premier &eacute;l&eacute;ment est ins&eacute;r&eacute; dans le tableau. + Chaque tableau entretien un pointeur interne, qui est initialis&eacute; lors + lorsque le premier &eacute;l&eacute;ment est ins&eacute;r&eacute; dans le tableau. </para> <para> - La fonction <function>current</function> ne fait que retourner + <function>current</function> ne fait que retourner l'&eacute;l&eacute;ment courant point&eacute; par le pointeur interne. <function>current</function> ne d&eacute;place pas le pointeur. Si le pointeur est au dela du dernier &eacute;l&eacute;ment de la liste, - <function>current</function> retourne FALSE. + <function>current</function> retourne <literal>FALSE</literal>. <warning> <para> Si le tableau des &eacute;l&eacute;ments vides ou des z&eacute;ros (0 ou "", - la cha&icirc;ne vide) alors <function>current</function> retournera FALSE pour ces + la cha&icirc;ne vide) alors <function>current</function> retournera <literal>FALSE</literal> pour ces &eacute;l&eacute;ments. Il est donc impossible de determiner si vous &ecirc;tes r&eacute;ellement &agrave; 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&eacute;/valeur) courante du tableau - <parameter>array</parameter> et avance le pointeur de tableau. Cette paire - est retourn&eacute;e dans un tableau de 4 &eacute;l&eacute;ments, avec les - cl&eacute;s <emphasis>0</emphasis>, <emphasis>1</emphasis>, + <function>each</function> retourne la paire (cl&eacute;/valeur) courante + du tableau <parameter>array</parameter> et avance le pointeur de tableau. + Cette paire est retourn&eacute;e dans un tableau de 4 &eacute;l&eacute;ments, + avec les cl&eacute;s <emphasis>0</emphasis>, <emphasis>1</emphasis>, <emphasis>key</emphasis>, et <emphasis>value</emphasis>. Les &eacute;l&eacute;ments <emphasis>0</emphasis> et <emphasis>key</emphasis> contiennent le nom de la cl&eacute; et, et <emphasis>1</emphasis> et @@ -1492,14 +1559,16 @@ </para> <para> Si le pointeur interne de fichier est au del&agrave; 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"> +&lt;?php $foo = array ("bob", "fred", "jussi", "jouni", "egon", "marliese"); $bar = each ($foo); +?&gt; </programlisting> <para> <literal>$bar</literal> contient maintenant les paires suivantes: @@ -1510,9 +1579,11 @@ <listitem><simpara>value => 'bob'</simpara></listitem> </itemizedlist> <programlisting role="php"> +&lt;?php $foo = array ("Robert" => "Bob", "Seppo" => "Sepi"); $bar = each ($foo); - </programlisting> +?&gt; + </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"> +&lt;?php echo "Valeurs transmises par la m&eacute;thode POST:&lt;br&gt;"; reset ($HTTP_POST_VARS); while (list ($key, $val) = each ($HTTP_POST_VARS)) { echo "$key => $val&lt;br&gt;"; } +?&gt; </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 &agrave; exporter un tableau vers la table des symboles. - Elle prend un tableau associatif <parameter>var_array</parameter> et cr&eacute;e - les variables dont les noms sont les index de ce tableau, et leur affecte la - valeur associ&eacute;e. Pour chaque paire cl&eacute;/valeur, <function>extract</function> - cr&eacute;e une variable, avec les param&egrave;tres - <parameter>extract_type</parameter> et <parameter>prefix</parameter>. + <function>extract</function> sert &agrave; exporter un tableau vers la table des symboles. + Elle prend un tableau associatif <parameter>var_array</parameter> et cr&eacute;e + les variables dont les noms sont les index de ce tableau, et leur affecte la + valeur associ&eacute;e. Pour chaque paire cl&eacute;/valeur, <function>extract</function> + cr&eacute;e une variable, avec les param&egrave;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&eacute;rifie l'existence de la variable avant de la cr&eacute;er. La mani&egrave;re de traiter les collisions est @@ -1618,80 +1697,80 @@ <varlistentry> <term>EXTR_OVERWRITE</term> <listitem> - <simpara> - Lors d'une collision, r&eacute;&eacute;crire la variable existante. - </simpara> + <simpara> + Lors d'une collision, r&eacute;&eacute;crire la variable existante. + </simpara> </listitem> </varlistentry> <varlistentry> <term>EXTR_SKIP</term> <listitem> - <simpara> - Lors d'une collision, ne pas r&eacute;&eacute;crire la variable existante - </simpara> + <simpara> + Lors d'une collision, ne pas r&eacute;&eacute;crire la variable existante + </simpara> </listitem> </varlistentry> <varlistentry> <term>EXTR_PREFIX_SAME</term> <listitem> - <simpara> - Lors d'une collision, ajouter le pr&eacute;fixe <parameter>prefix</parameter>, - et cr&eacute;er une nouvelle variable. - </simpara> + <simpara> + Lors d'une collision, ajouter le pr&eacute;fixe <parameter>prefix</parameter>, + et cr&eacute;er une nouvelle variable. + </simpara> </listitem> </varlistentry> <varlistentry> <term>EXTR_PREFIX_ALL</term> <listitem> - <simpara> - Ajouter le pr&eacute;fixe <parameter>prefix</parameter>, et cr&eacute;er - une nouvelle variable. - </simpara> + <simpara> + Ajouter le pr&eacute;fixe <parameter>prefix</parameter>, et cr&eacute;er + une nouvelle variable. + </simpara> </listitem> </varlistentry> </variablelist> </para> <para> - Si <parameter>extract_type</parameter> est omis, extract() utilise - EXTR_OVERWRITE par d&eacute;fault. + Si <parameter>extract_type</parameter> est omis, extract() utilise + EXTR_OVERWRITE par d&eacute;fault. </para> <para> - Notez que <parameter>prefix</parameter> n'est n&eacute;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&eacute;cessaire que pour + les valeurs de <parameter>extract_type</parameter> suivantes : + EXTR_PREFIX_SAME et EXTR_PREFIX_ALL. </para> <para> - <function>extract</function> v&eacute;rifie que les cl&eacute;s constitue - un nom de variable valide, et si c'est le cas, proc&egrave;de &agrave; son - exportation. + <function>extract</function> v&eacute;rifie que les cl&eacute;s constitue + un nom de variable valide, et si c'est le cas, proc&egrave;de &agrave; son + exportation. </para> <para> - Une utilisation possible de <function>extract</function> est l'exportation vers la table des - symboles de tableau de variables retourn&eacute; 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&eacute; + 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"> &lt;?php /* Supposons que $var_array est un tableau retourn&eacute; 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"; -?> +?&gt; </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 &eacute;t&eacute; r&eacute;&eacute;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&egrave;me param&egrave;tre <parameter>strict</parameter> est optionel. S'il + vaut <literal>TRUE</literal> alors <function>in_array</function> + v&eacute;rifiera aussi les types du param&egrave;tre <parameter>needle</parameter> + dans <parameter>haystack</parameter>. + </para> + <para> <example> <title>Exemple avec <function>in_array</function></title> <programlisting role="php"> +&lt;?php $os = array("Mac", "NT", "Irix", "Linux"); if (in_array("Irix", $os)) print "Irix trouve"; +?&gt; </programlisting> </example> + </para> + <para> + <example> + <title><function>in_array</function> avec le param&egrave;tre <parameter>strict</parameter></title> + <programlisting role="php"> +&lt;?php +$a = array('1.10', 12.4, 1.13); +if (in_array('12.4', $a, <literal>TRUE</literal>)) + echo &quot;'12.4' trouv&eacute; avec une recherche stricte\n&quot;; +if (in_array(1.13, $a, <literal>TRUE</literal>)) + echo &quot;1.13 trouv&eacute; avec une recherche stricte\n&quot;; +?&gt; + </programlisting> + L'affichage sera : + <computeroutput> +1.13 trouv&eacute; avec une recherche stricte + </computeroutput> + </example> <note> <para> <function>in_array</function> a &eacute;t&eacute; ajout&eacute;e dans PHP 4.0. @@ -1785,11 +1891,13 @@ <example> <title>Exemple avec <function>krsort</function></title> <programlisting role="php"> +&lt;?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"; } +?&gt; </programlisting> </example> Cet exemple va afficher : @@ -1828,12 +1936,14 @@ <example> <title>Exemple avec <function>ksort</function></title> <programlisting role="php"> +&lt;?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 -&gt; $val\n"; + echo "$key =&gt; $val\n"; } +?&gt; </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&eacute;ritable fonction, mais une construction syntaxique, qui permet d'assigner une s&eacute;rie de variable en une seule ligne. <example> <title>Exemple avec <function>list</function></title> <programlisting role="php"> +&lt;?php &lt;table> &lt;tr> &lt;th>Employee name&lt;/th> @@ -1896,8 +2007,9 @@ " &lt;td>$salary&lt;/td>\n". " &lt;/tr>\n"); } -?> +?&gt; &lt;/table> +?&gt; </programlisting> </example> </para> @@ -1933,6 +2045,7 @@ <example> <title>Exemple avec <function>natsort</function></title> <programlisting role="php"> +&lt;?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); +?&gt; </programlisting> </example> </para> @@ -1948,7 +2062,7 @@ </para> <para> <informalexample> - <programlisting> + <computeroutput> Tri Standard Array ( @@ -1965,10 +2079,10 @@ [1] =&gt; img10.png [0] =&gt; img12.png ) - </programlisting> +?&gt; + </computeroutput> </informalexample> - Pour plus de d&eacute;tails, rendez vous sur le site de : - Martin Pool's + Pour plus de d&eacute;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'&eacute;l&eacute;ment suivant du tableau, - ou FALSE si il n'y a plus d'&eacute;l&eacute;ments. Le pointeur de interne de + ou <literal>FALSE</literal> si il n'y a plus d'&eacute;l&eacute;ments. Le pointeur de interne de tableau est avanc&eacute; d'un &eacute;l&eacute;ment. </para> <para> @@ -2041,11 +2155,11 @@ <function>current</function>, mais avec une diff&eacute;rence : il avance le pointeur interne de tableau d'un &eacute;l&eacute;ment avant de retourner la valeur qu'il pointe. Lorsque le pointeur d&eacute;passe le dernier - &eacute;l&eacute;ment, <function>next</function> retourne false. + &eacute;l&eacute;ment, <function>next</function> retourne <literal>FALSE</literal>. <warning> <para> Si le tableau contient des &eacute;l&eacute;ments vides ou des z&eacute;ros, - <function>next</function> retournera FALSE pour ces &eacute;l&eacute;ments. + <function>next</function> retournera <literal>FALSE</literal> pour ces &eacute;l&eacute;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 &agrave; la derni&egrave;re - place qu'il occupait, ou bien retourne FALSE si il ne reste plus - d'&eacute;l&eacute;ments. + <function>prev</function> repositionne le pointeur interne de tableau &agrave; + la derni&egrave;re place qu'il occupait, ou bien retourne <literal>FALSE</literal> si il + ne reste plus d'&eacute;l&eacute;ments. <warning> <para> - Si le tableau contient des &eacute;l&eacute;ments vides, - <function>prev</function> retournera FALSE pour ces - &eacute;l&eacute;ments aussi. Pour passer en revue tous les + Si le tableau contient des &eacute;l&eacute;ments vides, + <function>prev</function> retournera <literal>FALSE</literal> pour ces + &eacute;l&eacute;ments aussi. Pour passer en revue tous les &eacute;l&eacute;ments, utilisez plut&ocirc;t <function>each</function>. </para> </warning> @@ -2192,11 +2306,13 @@ <example> <title>Exemple avec <function>rsort</function></title> <programlisting role="php"> +&lt;?php $fruits = array("papaye","orange","banane","ananas"); rsort($fruits); for (reset($fruits); list($key,$value) = each($fruits); ) { echo "fruits[$key] = ", $value, "\n"; } +?&gt; </programlisting> </example> Cet exemple va afficher: @@ -2235,19 +2351,21 @@ <example> <title>Exemple avec <function>shuffle</function></title> <programlisting role="php"> +&lt;?php $numbers = range (1,20); srand (time()); shuffle ($numbers); while (list(, $number) = each ($numbers)) { echo "$number "; } +?&gt; </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'&eacute;l&eacute;ment d'un tableau. + <function>sizeof</function> retourne le nombre d'&eacute;l&eacute;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"> +&lt;?php $fruits = array("papaye","orange","banane","ananas"); sort($fruits); for(reset($fruits); $key = key($fruits); next($fruits)) { echo "fruits[$key] = ".$fruits[$key]."\n"; } +?&gt; </programlisting> </example> Cet exemple va afficher : @@ -2363,6 +2483,7 @@ <example> <title>Exemple avec <function>uksort</function></title> <programlisting role="php"> +&lt;?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"; } +?&gt; </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&eacute;finie par l'utilisateur + Trie les valeurs d'un tableau en utilisant une fonction de comparaison d&eacute;finie + par l'utilisateur </refpurpose> </refnamediv> <refsect1> @@ -2413,14 +2536,15 @@ cette m&eacute;thode. </para> <para> - La fonction de comparaison doit retourner un entier, qui sera inf&eacute;rieur, - &eacute;gal ou sup&eacute;rieur &agrave; z&eacute;ro suivant que le premier - argument est consid&eacute;r&eacute; comme plus petit, &eacute;gal ou plus - grand que le second argument. Si les deux arguments sont &eacute;gaux, leur - ordre est ind&eacute;fini. + La fonction de comparaison <parameter>cmp_function</parameter> doit retourner un entier, + qui sera inf&eacute;rieur, &eacute;gal ou sup&eacute;rieur &agrave; z&eacute;ro + suivant que le premier argument est consid&eacute;r&eacute; comme plus petit, + &eacute;gal ou plus grand que le second argument. Si les deux arguments sont + &eacute;gaux, leur ordre est ind&eacute;fini. <example> <title>Exemple avec <function>usort</function></title> - <programlisting> + <programlisting role="php"> +&lt;?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"; } +?&gt; </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&eacute;rifier l'orthographe d'un mot, + Les fonctions Aspell vous permettent de v&eacute;rifier l'orthographe d'un mot, et d'offrir des suggestions de corrections. Plusieurs langues sont disponibles, comme le fran&ccedil;, l'allemand, le su&eacute;dois et le danois. </simpara> <note> <simpara> - aspell fonctionne avec de tr&egrave;s vielles versions (jusqu'&agrave; la - version .27.* ou presque) de la librairie aspell. Ce module, et ces versions - d'Aspell ne sont plus support&eacute;es. Si vous voulez utiliser les - possibilit&eacute;s de v&eacute;rifications d'orthographe en PHP, - utilisez plut&ocirc;t <link linkend="ref.pspell">pspell</link>. - Ce module utilise la librairie pspell qui fonctionne avec les + aspell fonctionne avec de tr&egrave;s vielles versions (jusqu'&agrave; la + version .27.* ou presque) de la librairie aspell. Ce module, et ces versions + d'Aspell ne sont plus support&eacute;es. Si vous voulez utiliser les + possibilit&eacute;s de v&eacute;rifications d'orthographe en PHP, + utilisez plut&ocirc;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 &agrave; : + Vous avez besoin de la librairie Aspell, disponible &agrave; : <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&eacute;rieure dans les fonctions aspell. </simpara> <para> <example> <title>aspell_new</title> - <programlisting> + <programlisting role="php"> +&lt;?php $aspell_link=aspell_new("english"); +?&gt; </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&eacute;rifie l'orthographe d'un mot et retourne TRUE - si l'orthographe est correcte, et FALSE sinon. + <function>aspell_check</function> v&eacute;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"> +&lt;?php $aspell_link=aspell_new("english"); if (aspell_check($aspell_link,"testt")) { echo "L'orthographe est correcte."; } else { echo "D&eacute;sol&eacute;, l'orthographe est incorrecte."; } +?&gt; </programlisting> </example> </para> </refsect1> </refentry> - <refentry id="function.aspell-check-raw"> <refnamediv> - <refname>aspell_check-raw</refname> + <refname>aspell_check-raw</refname> <refpurpose> - V&eacute;rifie un mot sans en changer la casse et sans essayer de supprimer + V&eacute;rifie un mot sans en changer la casse et sans essayer de supprimer les espaces aux extr&eacute;mit&eacute;s. </refpurpose> </refnamediv> @@ -106,27 +106,28 @@ </funcprototype> </funcsynopsis> <simpara> - <function>aspell_check_raw</function> v&eacute;rifie l'orthographe - d'un mot sans en changer la casse, et sans essayer de supprimer les - espaces aux extr&eacute;mit&eacute;s. Elle retourne true si l'orthographe - est bonne, et false sinon. + <function>aspell_check_raw</function> v&eacute;rifie l'orthographe + d'un mot sans en changer la casse, et sans essayer de supprimer les + espaces aux extr&eacute;mit&eacute;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"> +&lt;?php $aspell_link=aspell_new("french"); if (aspell_check_raw($aspell_link,"testt")) { echo "L'orthographe est OK"; } else { echo "Attention : faute d'orthographe"; } +?&gt; </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&eacute;. </simpara> <para> <example> <title>aspell_suggest</title> - <programlisting> + <programlisting role="php"> +&lt;?php $aspell_link=aspell_new("french"); - if (!aspell_check($aspell_link,"testt")) { $suggestions=aspell_suggest($aspell_link,"testt"); - for($i=0; $i &lt; count($suggestions); $i++) { - echo "Orthographes envisageables : " . $suggestions[$i] . "&lt;br>"; + echo "Orthographes envisageables : " . $suggestions[$i] . "&lt;br>"; } } +?&gt; </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&eacute;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 &eacute;t&eacute; activ&eacute;e lors de la + Ces fonctions ne sont disponibles que si l'option de configuration + <option role="configure">--enable-bcmath</option> a &eacute;t&eacute; activ&eacute;e lors de la compilation. </simpara> <note> <para> Suite aux changement de licence, la librairie BCMATH - est d&eacute;sormais distribu&eacute;e s&eacute;paremment. - Vous pouvez t&eacute;l&eacute;charger l'archive &agrave; + est d&eacute;sormais distribu&eacute;e s&eacute;paremment. + Vous pouvez t&eacute;l&eacute;charger l'archive &agrave; <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&eacute;rande - <parameter>right operand</parameter> et renvoie la somme sous forme de cha&icirc;ne de - caract&egrave;res. Le param&egrave;tre optionnel <parameter>scale</parameter> est utilis&eacute; pour - d&eacute;finir le nombre de chiffres apr&egrave;s la virgule dans le r&eacute;sultat. + <function>bcadd</function> additionne <parameter>left operand</parameter> avec + l'op&eacute;rande <parameter>right operand</parameter> et renvoie la somme sous + forme de cha&icirc;ne de caract&egrave;res. Le param&egrave;tre optionnel + <parameter>scale</parameter> est utilis&eacute; pour d&eacute;finir le nombre + de chiffres apr&egrave;s la virgule dans le r&eacute;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&eacute;rande <parameter>left operand</parameter> avec l'op&eacute;rande - <parameter>right operand</parameter> et renvoie le r&eacute;sultat sous forme de valeur - num&eacute;rique (integer). Le param&egrave;tre optionnel <parameter>scale</parameter> est - utilis&eacute; pour d&eacute;finir le nombre de chiffres apr&egrave;s la virgule utilis&eacute;s lors de la - comparaison. Le r&eacute;sultat est 0 si les deux op&eacute;randes sont &eacute;gales. Si l'op&eacute;rande - <parameter>left operand</parameter> est plus grande que l'op&eacute;rande - <parameter>right operand</parameter>, le r&eacute;sultat est 1. - Si l'op&eacute;rande <parameter>left operand</parameter> est plus petite que l'op&eacute;rande - <parameter>right operand</parameter>, le r&eacute;sultat est -1. + <function>bccomp</function> compare l'op&eacute;rande <parameter>left operand</parameter> + avec l'op&eacute;rande <parameter>right operand</parameter> et renvoie le + r&eacute;sultat sous forme de valeur num&eacute;rique (integer). Le param&egrave;tre + optionnel <parameter>scale</parameter> est utilis&eacute; pour d&eacute;finir le + nombre de chiffres apr&egrave;s la virgule utilis&eacute;s lors de la + comparaison. Le r&eacute;sultat est 0 si les deux op&eacute;randes sont &eacute;gales. Si + l'op&eacute;rande <parameter>left operand</parameter> est plus grande que + l'op&eacute;rande <parameter>right operand</parameter>, le r&eacute;sultat est 1. + Si l'op&eacute;rande <parameter>left operand</parameter> est plus petite que + l'op&eacute;rande <parameter>right operand</parameter>, le r&eacute;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&eacute;rande <parameter>left operand</parameter> par l'op&eacute;rande - <parameter>right operand</parameter> et renvoie le r&eacute;sultat. Le param&egrave;tre optionnel - <parameter>scale</parameter> d&eacute;finit le nombre de chiffres apr&egrave;s la virgule dans - le r&eacute;sultat. + <function>bcdiv</function> divise l'op&eacute;rande <parameter>left operand</parameter> + par l'op&eacute;rande <parameter>right operand</parameter> et renvoie le + r&eacute;sultat. Le param&egrave;tre optionnel <parameter>scale</parameter> + d&eacute;finit le nombre de chiffres apr&egrave;s la virgule dans le r&eacute;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&eacute;rande <parameter>left operand</parameter> par l'op&eacute;rande - <parameter>right operand</parameter> et renvoie le r&eacute;sultat. Le param&egrave;tre - optionnel <parameter>scale</parameter> d&eacute;finit le nombre de chiffres apr&egrave;s la - virgule dans le r&eacute;sultat. + <function>bcmul</function> multiplie l'op&eacute;rande <parameter>left operand</parameter> + par l'op&eacute;rande <parameter>right operand</parameter> et renvoie le r&eacute;sultat. + Le param&egrave;tre optionnel <parameter>scale</parameter> d&eacute;finit le nombre + de chiffres apr&egrave;s la virgule dans le r&eacute;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&egrave;ve <parameter>x</parameter> &agrave; la puissance <parameter>y</parameter>. - Le param&egrave;tre optionnel <parameter>scale</parameter> d&eacute;finit le nombre de chiffres - apr&egrave;s la virgule dans le r&eacute;sultat. + <function>bcpow</function> &eacute;l&egrave;ve <parameter>x</parameter> &agrave; + la puissance <parameter>y</parameter>. Le param&egrave;tre optionnel + <parameter>scale</parameter> d&eacute;finit le nombre de chiffres apr&egrave;s + la virgule dans le r&eacute;sultat. </para> <para> Voir aussi <function>bcsqrt</function>. </para> </refsect1> </refentry> - <refentry id="function.bcscale"> <refnamediv> <refname>bcscale</refname> <refpurpose> - D&eacute;termine le nombre de d&eacute;cimales par d&eacute;faut pour les fonctions de pr&eacute;cision math&eacute;matiques. + D&eacute;termine le nombre de d&eacute;cimales par d&eacute;faut pour les + fonctions de pr&eacute;cision math&eacute;matiques. </refpurpose> </refnamediv> <refsect1> @@ -210,13 +206,12 @@ </funcprototype> </funcsynopsis> <para> - Cette fonction d&eacute;finit la pr&eacute;cision par d&eacute;faut pour toutes les fonctions - math&eacute;matiques sur des nombres de taille arbitraire qui suivent et qui omettent - le param&egrave;tre <parameter>scale</parameter>. + <function>bcscale</function> d&eacute;finit la pr&eacute;cision par d&eacute;faut + pour toutes les fonctions math&eacute;matiques sur des nombres de taille + arbitraire qui suivent et qui omettent le param&egrave;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&eacute;e de l'op&eacute;rande <parameter>operand</parameter>. - Le param&egrave;tre optionnel <parameter>scale</parameter> d&eacute;finit le nombre - de chiffres apr&egrave;s la virgule dans le r&eacute;sultat. + <function>bcsqrt</function> renvoie la racine carr&eacute;e de l'op&eacute;rande + <parameter>operand</parameter>. Le param&egrave;tre optionnel + <parameter>scale</parameter> d&eacute;finit le nombre de chiffres apr&egrave;s la + virgule dans le r&eacute;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&eacute;rande <parameter>right operand</parameter> de l'op&eacute;rande - <parameter>left operand</parameter> et renvoie le r&eacute;sultat sous forme de cha&icirc;ne - de caract&egrave;res. Le param&egrave;tre optionnel <parameter>scale</parameter> d&eacute;finit le - nombre de chiffres apr&egrave;s la virgule dans le r&eacute;sultat. + <function>bcsub</function> soustrait l'op&eacute;rande <parameter>right operand</parameter> + de l'op&eacute;rande <parameter>left operand</parameter> et renvoie le r&eacute;sultat + sous forme de cha&icirc;ne de caract&egrave;res. Le param&egrave;tre optionnel + <parameter>scale</parameter> d&eacute;finit le nombre de chiffres apr&egrave;s + la virgule dans le r&eacute;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 &eacute;t&eacute; compil&eacute;e. - Elle est situ&eacute;e dans les sous-dossiers "dl" ou "ext" - de votre distribution de PHP. Lisez le fichier - README pour plus de d&eacute;tails. + Les fonctions de calendrier ne sont disponibles que si + l'extension calendrier a &eacute;t&eacute; compil&eacute;e. + Elle est situ&eacute;e dans les sous-dossiers "dl" ou "ext" + de votre distribution de PHP. Lisez le fichier + README pour plus de d&eacute;tails. </para> <para> - L'extension de calendrier propose une s&eacute;rie de fonctions - qui simplifie les conversions entre les diff&eacute;rents formats - de calendrier. La r&eacute;f&eacute;rence est le nombre de jour du - calendrier Julien. C'est le nombre de jours depuis une date qui - commence bien au del&agrave; des dates les plus recul&eacute;es - dont on a besoin (situ&eacute;e en 4000 avant J.C.). Pour convertir - une date d'un calendrier &agrave; un autre, il faut d'abord la convertir - dans ce calendrier, puis convertir le r&eacute;sultat dans le calendrier - d&eacute;sir&eacute;. Attention, le nombre de jour du calendrier Julien - est un syst&egrave;me tr&egrave;s diff&eacute;rent du calendrier Julien!. - Pour plus d'informations (en anglais), reportez vous &agrave; - <ulink url="&url.calendar;">&url.calendar;</ulink>. - Les traductions issues de ces pages seront mises entre guillemets. + L'extension de calendrier propose une s&eacute;rie de fonctions + qui simplifie les conversions entre les diff&eacute;rents formats + de calendrier. La r&eacute;f&eacute;rence est le nombre de jour du + calendrier Julien. C'est le nombre de jours depuis une date qui + commence bien au del&agrave; des dates les plus recul&eacute;es + dont on a besoin (situ&eacute;e en 4000 avant J.C.). Pour convertir + une date d'un calendrier &agrave; un autre, il faut d'abord la convertir + dans ce calendrier, puis convertir le r&eacute;sultat dans le calendrier + d&eacute;sir&eacute;. Attention, le nombre de jour du calendrier Julien + est un syst&egrave;me tr&egrave;s diff&eacute;rent du calendrier Julien!. + Pour plus d'informations (en anglais), reportez vous &agrave; + <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&eacute;gorienne. + Convertit le nombre de jours du calendrier Julien en date gr&eacute;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&icirc;ne contenant une - date du calendrier gr&eacute;gorien, au format "mois/jour/ann&eacute;e". - </para> - </refsect1> - </refentry> - - <refentry id="function.gregoriantojd"> - <refnamediv> - <refname>GregorianToJD</refname> - <refpurpose> - Converti une date gr&eacute;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&icirc;ne contenant une date du calendrier + gr&eacute;gorien, au format "mois/jour/ann&eacute;e". + </para> + </refsect1> + </refentry> + <refentry id="function.gregoriantojd"> + <refnamediv> + <refname>GregorianToJD</refname> + <refpurpose> + Convertit une date gr&eacute;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&eacute; pour le calendrier gr&eacute;gorien : 4714 avant JC &agrave; 9999 - apr&egrave;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&eacute;&eacute; le 18 octobre 1582 apr&egrave;s J.C. (ou 5 octobre 1582 en calendrier grec). - Certains pays ne l'accept&egrave;rent que bien plus tard. Par exemple, les - britanniques n'y pass&egrave;rent en 1752, les Russes en 1918 et les Grecs en 1923. - La plus part des pays europ&eacute;ens utilisaient le calendrier Julien avant le - Gr&eacute;gorien. - <example> - <title>Fonctions calendrier</title> - <programlisting role="php"> + Intervalle de validit&eacute; pour le calendrier gr&eacute;gorien : + 4714 avant JC &agrave; 9999 apr&egrave;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&eacute;&eacute; le 18 octobre 1582 apr&egrave;s J.C. (ou 5 octobre 1582 + en calendrier grec). Certains pays ne l'accept&egrave;rent que bien plus + tard. Par exemple, les britanniques n'y pass&egrave;rent en 1752, les + Russes en 1918 et les Grecs en 1923. La plus part des pays europ&eacute;ens + utilisaient le calendrier Julien avant le Gr&eacute;gorien. + <example> + <title>Fonctions calendrier</title> + <programlisting role="php"> &lt;?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> - +?&gt; + </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&icirc;ne contenant - la date du calendrier Julien, au format "mois/jour/ann&eacute;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&icirc;ne contenant la date du calendrier Julien, au format + "mois/jour/ann&eacute;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&eacute; du calendrier Julien : 4713 avant JC &agrave; 9999 apr&egrave;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&eacute;&eacute; en 46 avant JC, et ses d&eacute;tails ne furent finalis&eacute;s qu'au plus t&ocirc;t en 8 - apr&egrave;s JC, et probablement pas avant le 4&egrave;me si&egrave;cle apr&egrave;s JC. De plus, le - d&eacute;but de l'ann&eacute;e variait suivant les peuples, certains n'acceptant pas - janvier comme premier mois de l'ann&eacute;e. - </para> - </refsect1> - </refentry> - - <refentry id="function.jdtojewish"> - <refnamediv> + <para> + Intervalle de validit&eacute; du calendrier Julien : 4713 avant JC &agrave; + 9999 apr&egrave;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&eacute;&eacute; en 46 avant JC, et ses d&eacute;tails ne furent + finalis&eacute;s qu'au plus t&ocirc;t en 8 apr&egrave;s JC, et probablement + pas avant le 4&egrave;me si&egrave;cle apr&egrave;s JC. De plus, le + d&eacute;but de l'ann&eacute;e variait suivant les peuples, certains + n'acceptant pas janvier comme premier mois de l'ann&eacute;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 &agrave; partir de l'an 1 (3761 - avant JC), une telle utilisation a peu de sens. - </para> - <para> - Le calendrier juif a &eacute;t&eacute; utilis&eacute; depuis plusieurs dizaines de si&egrave;cles, mais - dans les premiers temps, il n'y avait pas de formule pour d&eacute;terminer le d&eacute;but - du mois. Un nouveau mois commencait quand une nouvelle lune &eacute;tait observ&eacute;e. - </para> - </refsect1> - </refentry> - - <refentry id="function.jdtofrench"> - <refnamediv> + <para> + Bien qu'il soit possible de manipuler des dates &agrave; partir de l'an 1 (3761 + avant JC), une telle utilisation a peu de sens. + </para> + <para> + Le calendrier juif a &eacute;t&eacute; utilis&eacute; depuis plusieurs + dizaines de si&egrave;cles, mais dans les premiers temps, il n'y avait + pas de formule pour d&eacute;terminer le d&eacute;but du mois. Un nouveau + mois commencait quand une nouvelle lune &eacute;tait observ&eacute;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&ccedil;ais r&eacute;publicain - </refpurpose> - </refnamediv> - <refsect1> + Convertit le nombre de jours du calendrier julien en date du calendrier + fran&ccedil;ais r&eacute;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&ccedil;ais r&eacute;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&ccedil;ais r&eacute;publicain. + </para> + </refsect1> + </refentry> + <refentry id="function.frenchtojd"> + <refnamediv> <refname>FrenchToJD</refname> <refpurpose> - Converti une date du calendrier fran&ccedil;ais r&eacute;publicain en nombre de jours - du calendrier julien. - </refpurpose> - </refnamediv> - <refsect1> + Convertit une date du calendrier fran&ccedil;ais r&eacute;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&ccedil;ais r&eacute;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 &agrave; 22 September 1806 en calendrier gr&eacute;gorien). Cela - couvre plus que la dur&eacute;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&ccedil;ais r&eacute;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 &agrave; 22 September 1806 en calendrier gr&eacute;gorien). + Cela couvre plus que la dur&eacute;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&icirc;ne contenant le nom du mois. - <parameter>mode</parameter> indique de quel calendrier d&eacute;pend ce mois, et - quel type de nom doit &ecirc;tre retourn&eacute;. - + <para> + <function>jdmonthname</function> retourne une cha&icirc;ne contenant le + nom du mois. <parameter>mode</parameter> indique de quel calendrier + d&eacute;pend ce mois, et quel type de nom doit &ecirc;tre retourn&eacute;. <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&eacute;gorien - abr&eacute;g&eacute;</entry> - </row> - <row> - <entry>1</entry> - <entry>Gr&eacute;gorien</entry> - </row> - <row> - <entry>2</entry> - <entry>Julien - abr&eacute;g&eacute;</entry> - </row> - <row> - <entry>3</entry> - <entry>Julien</entry> - </row> - <row> - <entry>4</entry> - <entry>Juif</entry> - </row> - <row> - <entry>5</entry> - <entry>R&eacute;publicain fran&ccedil;ais</entry> - </row> + <row> + <entry>0</entry> + <entry>Gr&eacute;gorien - abr&eacute;g&eacute;</entry> + </row> + <row> + <entry>1</entry> + <entry>Gr&eacute;gorien</entry> + </row> + <row> + <entry>2</entry> + <entry>Julien - abr&eacute;g&eacute;</entry> + </row> + <row> + <entry>3</entry> + <entry>Julien</entry> + </row> + <row> + <entry>4</entry> + <entry>Juif</entry> + </row> + <row> + <entry>5</entry> + <entry>R&eacute;publicain fran&ccedil;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&eacute;ro du jour de la semaine. - </refpurpose> - </refnamediv> - <refsect1> + Retourne le num&eacute;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&eacute;ro du jour de la semaine. Peut retourner une cha&icirc;ne ou - un entier, en fonction du mode. - + <para> + <function>jddayofweek</function> retourne le num&eacute;ro du jour de + la semaine. Peut retourner une cha&icirc;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&eacute;ro du jour comme un entier + <row> + <entry>0</entry> + <entry>Retourne le num&eacute;ro du jour comme un entier (0=dimanche, 1=lundi, etc.) </entry> - </row> - <row> - <entry>1</entry> <entry>Retourne une cha&icirc;ne contenant le nom du jour + </row> + <row> + <entry>1</entry> + <entry>Retourne une cha&icirc;ne contenant le nom du jour (anglais gr&eacute;gorien) </entry> - </row> - <row> - <entry>2</entry> <entry>Retourne une cha&icirc;ne contenant le nom abr&eacute;g&eacute; du - jour de la semaine (anglais gr&eacute;gorien). + </row> + <row> + <entry>2</entry> + <entry>Retourne une cha&icirc;ne contenant le nom abr&eacute;g&eacute; du + jour de la semaine (anglais gr&eacute;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, &agrave; minuit, pour une ann&eacute;e donn&eacute;e. + Retourne un timestamp UNIX pour P&agrave;ques, &agrave; minuit, pour une + ann&eacute;e donn&eacute;e. </refpurpose> </refnamediv> <refsect1> @@ -360,51 +355,57 @@ <paramdef>int <parameter>year</parameter></paramdef> </funcsynopsis> <para> - Retourne un timestamp UNIX pour Pâques, &agrave; minuit, pour une ann&eacute;e donn&eacute;e. - Si l'ann&eacute;e n'est pas pr&eacute;cis&eacute;e, c'est l'ann&eacute;e en cours qui est utilis&eacute;e. + <function>easter_date</function> retourne un timestamp UNIX pour P&agrave;ques, + &agrave; minuit, pour une ann&eacute;e donn&eacute;e. Si l'ann&eacute;e n'est + pas pr&eacute;cis&eacute;e, c'est l'ann&eacute;e en cours qui est + utilis&eacute;e. </para> <para> - <emphasis>ATTENTION:</emphasis> cette fonction g&eacute;n&eacute;re une alerte (Warning) si la - date tombe hors de la zone de validit&eacute; des timestamps UNIX - (i.e. avant 1970 ou apr&egrave;s 2037). + <emphasis>ATTENTION:</emphasis> <function>easter_date</function> + g&eacute;n&eacute;re une alerte (Warning) si la date tombe hors de la + zone de validit&eacute; des timestamp UNIX (i.e. avant 1970 ou + apr&egrave;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 &eacute;t&eacute; fix&eacute;e par le concile de Nic&eacute;e, en 325 de notre &egrave;re, - comme &eacute;tant le dimanche apr&egrave;s la premi&egrave;re lune pleine qui suit l'&eacute;quinoxe de - printemps. L'&eacute;quinoxe de printemps est consid&eacute;r&eacute; comme &eacute;tant toujours le 21 - mars, ce qui r&eacute;duit le probl&egrave;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&eacute;es avant 1753) , un cycle de - 19 ans suffit pour conna&icirc;tre les date des phases de la lune. Avec le calendrier - gr&eacute;gorien, (&agrave; partir des ann&eacute;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 &eacute;t&eacute; ajout&eacute;s pour rendre - le cycle plus pr&eacute;cis. + La date de P&agrave;ques a &eacute;t&eacute; fix&eacute;e par le concile + de Nic&eacute;e, en 325 de notre &egrave;re, comme &eacute;tant le dimanche + apr&egrave;s la premi&egrave;re lune pleine qui suit l'&eacute;quinoxe de + printemps. L'&eacute;quinoxe de printemps est consid&eacute;r&eacute; + comme &eacute;tant toujours le 21 mars, ce qui r&eacute;duit le + probl&egrave;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&eacute;es avant 1753), + un cycle de 19 ans suffit pour conna&icirc;tre les date des phases de la + lune. Avec le calendrier gr&eacute;gorien, (&agrave; partir des ann&eacute;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 &eacute;t&eacute; ajout&eacute;s pour rendre + le cycle plus pr&eacute;cis. </para> <para> - (Ce code est bas&eacute; sur le programme en C de Simon Kershaw, + (Ce code est bas&eacute; sur le programme en C de Simon Kershaw, &lt;webmaster@ely.anglican.org>) </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&agrave;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&eacute;e donn&eacute;e. + Retourne le nombre de jour entre le 21 Mars et P&agrave;ques, pour une + ann&eacute;e donn&eacute;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&eacute;e donn&eacute;e. - Si l'ann&eacute;e n'est pas pr&eacute;cis&eacute;e, l'ann&eacute;e en cours est utilis&eacute;e par d&eacute;faut. + <function>easter_days</function> retourne le nombre de jour entre le 21 Mars + et P&agrave;ques, pour une ann&eacute;e donn&eacute;e. Si l'ann&eacute;e n'est + pas pr&eacute;cis&eacute;e, l'ann&eacute;e en cours est utilis&eacute;e par + d&eacute;faut. </para> <para> - Cette fonction peut &ecirc;tre utilis&eacute;e &agrave; la place de <function>easter_date</function> - pour calculer la date de Pâques, pour les ann&eacute;es qui tombent hors de l'intervalle - de validit&eacute; des timestamps UNIX (i.e. avant 1970 ou apr&egrave;s 2037). + <function>easter_days</function> peut &ecirc;tre utilis&eacute;e &agrave; + la place de <function>easter_date</function> pour calculer la date de + P&agrave;ques, pour les ann&eacute;es qui tombent hors de l'intervalle + de validit&eacute; des timestamps UNIX (i.e. avant 1970 ou apr&egrave;s 2037). <example> <title>Exemple <function>easter_date</function></title> - <programlisting> + <programlisting role="php"> +&lt;?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> +?&gt; + </programlisting> </example> </para> <para> - La date de Pâques a &eacute;t&eacute; fix&eacute;e par le concile de Nic&eacute;e, en 325 de notre &egrave;re, - comme &eacute;tant le dimanche apr&egrave;s la premi&egrave;re lune pleine qui suit l'&eacute;quinoxe de - printemps. L'&eacute;quinoxe de printemps est consid&eacute;r&eacute; comme &eacute;tant toujours le 21 - mars, ce qui r&eacute;duit le probl&egrave;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&eacute;es avant 1753) , un cycle de - 19 ans suffit pour conna&icirc;tre les date des phases de la lune. Avec le calendrier - gr&eacute;gorien, (&agrave; partir des ann&eacute;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 &eacute;t&eacute; ajout&eacute;s pour rendre - le cycle plus pr&eacute;cis. + La date de P&agrave;ques a &eacute;t&eacute; fix&eacute;e par le concile + de Nic&eacute;e, en 325 de notre &egrave;re, comme &eacute;tant le dimanche + apr&egrave;s la premi&egrave;re lune pleine qui suit l'&eacute;quinoxe de + printemps. L'&eacute;quinoxe de printemps est consid&eacute;r&eacute; + comme &eacute;tant toujours le 21 mars, ce qui r&eacute;duit le + probl&egrave;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&eacute;es avant 1753), + un cycle de 19 ans suffit pour conna&icirc;tre les date des phases de la + lune. Avec le calendrier gr&eacute;gorien, (&agrave; partir des ann&eacute;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 &eacute;t&eacute; ajout&eacute;s pour rendre + le cycle plus pr&eacute;cis. </para> <para> - (Ce code est bas&eacute; sur le programme en C de Simon Kershaw, + (Ce code est bas&eacute; sur le programme en C de Simon Kershaw, &lt;webmaster@ely.anglican.org>) </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'&agrave; partir de la version PHP4RC1. + <function>unixtojd</function> n'est disponible qu'&agrave; 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&eacute; de l'&eacute;poque UNIX. (ann&eacute;es gr&eacute;gorienne entre 1970 et 2037 ou 2440588 &lt;= - <parameter>jday</parameter> &lt;= 2465342 ). + ou <literal>FALSE</literal> si <parameter>jday</parameter> n'est pas dans l'intervalle de + validit&eacute; de l'&eacute;poque UNIX. (ann&eacute;es gr&eacute;gorienne + entre 1970 et 2037 ou 2440588 &lt;= <parameter>jday</parameter> &lt;= 2465342 ). </para> <para> Voir aussi <function>jdtounix</function>. </para> <note> <para> - Cette fonction n'est disponible qu'&agrave; partir de la version PHP4RC1. + <function>jdtounix</function> n'est disponible qu'&agrave; 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&eacute;finit une classe de base, et une extension. La classe de base d&eacute;finit un l&eacute;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-&gt;Legume( true, &quot;green&quot; ); + $this-&gt;Legume( <literal>TRUE</literal>, &quot;green&quot; ); } function cuisine() { - $this-&gt;cuit = true; + $this-&gt;cuit = <literal>TRUE</literal>; } function est_cuit() { return $this-&gt;cuit; @@ -93,7 +93,7 @@ } } // instantie 2 objets -$legume = new Legume(true,&quot;blue&quot;); +$legume = new Legume(<literal>TRUE</literal>,&quot;blue&quot;); $feuilles = new Epinard(); // affiche les informations sur ces objets echo &quot;legume: CLASS &quot;.get_class($legume).&quot;\n&quot;; @@ -122,12 +122,12 @@ </para> <para> <informalexample> - <programlisting> + <computeroutput> [...] Parent&eacute;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 &eacute;t&eacute; d&eacute;finie, et FALSE sinon. + <function>class_exists</function> retourne <literal>TRUE</literal> si la classe + <parameter>class_name</parameter> a &eacute;t&eacute; d&eacute;finie, et <literal>FALSE</literal> sinon. </para> </refsect1> </refentry> @@ -366,9 +366,9 @@ $this-&gt;nom = $nom; } function LitPoint() { - return array("x" =&gt; $this-&gt;x, - "y" =&gt; $this-&gt;y, - "nom" =&gt; $this-&gt;nom); + return array("x" -&gt; $this-&gt;x, + "y" -&gt; $this-&gt;y, + "nom" -&gt; $this-&gt;nom); } } $p1 = new Point2D(1.233, 3.445); @@ -376,16 +376,16 @@ // "$nom" est d&eacute;clar&eacute;, mais non d&eacute;fini // Array // ( -// [x] =&gt; 1.233 -// [y] =&gt; 3.445 +// [x] -&gt; 1.233 +// [y] -&gt; 3.445 // ) $p1-&gt;setnom("point #1"); print_r(get_object_vars($p1)); // Array // ( -// [x] =&gt; 1.233 -// [y] =&gt; 3.445 -// [nom] =&gt; point #1 +// [x] -&gt; 1.233 +// [y] -&gt; 3.445 +// [nom] -&gt; point #1 // ) ?&gt; </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&eacute;thode + <function>method_exists</function> retourne <literal>TRUE</literal> si la m&eacute;thode <parameter>method_name</parameter> a &eacute;t&eacute; d&eacute;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 &eacute;t&eacute; ajout&eacute;es dans PHP4. + Elles ont &eacute;t&eacute; ajout&eacute;es dans PHP 4. </simpara> </partintro> <refentry id="function.com-load"> @@ -29,7 +29,7 @@ </funcsynopsis> <para> <function>com_load</function> cr&eacute;e un nouveau composant COM, et - retourne une r&eacute;f&eacute;rence dessus. Retourne FALSE en cas d'&eacute;chec. + retourne une r&eacute;f&eacute;rence dessus. Retourne <literal>FALSE</literal> en cas d'&eacute;chec. </para> </refsect1> </refentry> @@ -57,7 +57,7 @@ <para> <function>com_invoke</function> appelle la m&eacute;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&eacute;sultat de la fonction <parameter>function_name</parameter> en cas de succ&egrave;s. </para> @@ -104,7 +104,7 @@ <function>com_get</function> retourne la valeur de la propri&eacute;t&eacute; <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&eacute;t&eacute; <parameter>property</parameter> du composante COM <parameter>com_object</parameter> par <parameter>value</parameter>. - Retourne TRUE en cas de succ&egrave;s, et FALSE sinon. + Retourne <literal>TRUE</literal> en cas de succ&egrave;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"> &lt;?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); -?> +?&gt; </programlisting> </example> <simpara> La distribution pdflib contient un exemple plus complet, qui cr&eacute;e des s&eacute;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"> &lt;?php $radius = 200; $margin = 20; @@ -164,7 +164,7 @@ Header("Content-type: application/pdf"); cpdf_output_buffer($pdf); cpdf_close($pdf); -?> +?&gt; </programlisting> </example> </partintro> @@ -542,11 +542,13 @@ Elle doit &ecirc;tre termin&eacute;e avec <function>cpdf_end_text</function>. <example> <title>Affichage de texte</title> - <programlisting> -&lt;?php cpdf_begin_text($pdf); + <programlisting role="php"> +&lt;?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) +?&gt; </programlisting> </example> </para> @@ -573,11 +575,13 @@ commenc&eacute;e avec <function>cpdf_begin_text</function>. <example> <title>Affichage de texte</title> - <programlisting> -&lt;?php cpdf_begin_text($pdf); + <programlisting role="php"> +&lt;?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) +?&gt; </programlisting> </example> </para> @@ -1015,11 +1019,15 @@ translations et rotations sur un objet, mais sans affecter les autres. <example> <title>Sauver/Restaurer</title> - <programlisting> -&lt;?php cpdf_save($pdf); + <programlisting role="php"> +&lt;?php +cpdf_save($pdf); // plein de transformations, translations, ... -cpdf_restore($pdf) ?> -</programlisting></example></para> +cpdf_restore($pdf) +?&gt; + </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"> &lt;?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); -?> +?&gt; </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); -?> +?&gt; </programlisting> </example> </para> @@ -92,7 +92,7 @@ curl_setopt ($ch, CURLOPT_HEADER, 0); curl_exec ($ch); curl_close ($ch); -?> +?&gt; </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 &eacute;t&eacute; compil&eacute; avec l'option <option role="configure">--with-cybercash=[DIR]</option>. Ces - fonctions ont &eacute;t&eacute; ajout&eacute;es dans PHP4. + fonctions ont &eacute;t&eacute; ajout&eacute;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 &eacute;l&eacute;ments "errcode" et, si "errcode" vaut FALSE, + les &eacute;l&eacute;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 &eacute;l&eacute;ments "errcode" et, si "errcode" vaut FALSE, + les &eacute;l&eacute;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&eacute;r&eacute;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&eacute;r&eacute;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&icirc;ne, au format - donn&eacute; par la cha&icirc;ne format. La date est fournie - sous la forme d'un <parameter>timestamp</parameter>. Par d&eacute;faut, - la date courante est utilis&eacute;e. + <function>date</function> retourne une date sous forme d'une cha&icirc;ne, au format + donn&eacute; par la cha&icirc;ne format. La date est fournie + sous la forme d'un <parameter>timestamp</parameter>. Par d&eacute;faut, + la date courante est utilis&eacute;e. </para> <para> Les caract&egrave;res suivants sont utilis&eacute;s pour @@ -240,10 +240,12 @@ <title> Exemples avec <function>date</function> et <function>mktime</function> </title> - <programlisting> + <programlisting role="php"> +&lt;?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); +?&gt; </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&eacute;rique + "wday" - jour de la semaine, num&eacute;rique </simpara> </listitem> <listitem> <simpara> - "mon" - mois, num&eacute;rique + "mon" - mois, num&eacute;rique </simpara> </listitem> <listitem> <simpara> - "year" - ann&eacute;e, num&eacute;rique + "year" - ann&eacute;e, num&eacute;rique </simpara> </listitem> <listitem> <simpara> - "yday" - jour de l'ann&eacute;e, num&eacute;rique; i.e. "299" + "yday" - jour de l'ann&eacute;e, num&eacute;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&eacute;es par le syst&egrave;me : + <function>gettimeofday</function> est une interface vers gettimeofday(2). Elle + retourne un tableau associatif qui contient les informations retourn&eacute;es + par le syst&egrave;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 &agrave; la fonction <function>date</function>, seulement - le temps retourn&eacute; est GMT (Greenwich Mean Time) Par exemple, + <function>gmdate</function> est identique &agrave; la fonction <function>date</function>, + hormis le fait que le temps retourn&eacute; est GMT (Greenwich Mean Time) Par exemple, en Finlande (GMT +0200), la premi&egrave;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"> +&lt;?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)); +?&gt; </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"> +&lt;?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)); +?&gt; </programlisting> </example> <parameter>year</parameter> peut prendre deux ou quatre chiffres, @@ -648,7 +662,7 @@ 70-99 &agrave; 1970-1999 (sur les syst&egrave;mes o&uacute; time_t sont sur des entiers 32bit sign&eacute;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 &ecirc;tre d&eacute;crit comme @@ -658,10 +672,12 @@ <example> <title>Last day of next month</title> <programlisting role="php"> +&lt;?php $lastday = mktime (0,0,0,3,0,2000); echo strftime ("Le dernier jour de F&eacute;vrier 2000 est: %d", $lastday); $lastday = mktime (0,0,0,4,-31,2000); echo strftime ("Le dernier jour de F&eacute;vrier 2000 est: %d", $lastday); +?&gt; </programlisting> </example> </para> @@ -737,7 +753,7 @@ </listitem> <listitem> <simpara> - %d - jour du mois en num&eacute;rique (intervalle 00 &agrave; 31) + %d - jour du mois en num&eacute;rique (intervalle 01 &agrave; 31) </simpara> </listitem> <listitem> @@ -954,12 +970,14 @@ <example> <title>Exemple avec <function>strtotime</function></title> <programlisting role="php"> +&lt;?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"; +?&gt; </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"> &lt;?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"> &lt;?php # ...ouverture de la base... $key = dba_firstkey($id); -while($key != false) { +while($key != <literal>FALSE</literal>) { if(...) { # conserver la cl&eacute; pour faire d'autres op&eacute;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&eacute;e est + <function>dba_delete</function> retourne <literal>TRUE</literal> ou <literal>FALSE</literal>, si l'entr&eacute;e est effac&eacute;e, ou pas effac&eacute;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&eacute; est + <function>dba_exists</function> retourne <literal>TRUE</literal> ou <literal>FALSE</literal>, si la cl&eacute; est trouv&eacute;e, ou pas, respectivement. </para> <para> @@ -259,7 +259,7 @@ <function>dba_open</function>. </para> <para> - <function>dba_fetch</function> retourne la cha&icirc;ne associ&eacute;e ou false, + <function>dba_fetch</function> retourne la cha&icirc;ne associ&eacute;e ou <literal>FALSE</literal>, si la paire cl&eacute;/valeur n'a pas &eacute;t&eacute; trouv&eacute;e. </para> <para> @@ -292,7 +292,7 @@ <function>dba_open</function>. </para> <para> - <function>dba_firstkey</function> retourne la cl&eacute;, ou FALSE, suivant + <function>dba_firstkey</function> retourne la cl&eacute;, ou <literal>FALSE</literal>, suivant que la premi&egrave;re cl&eacute; 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&eacute;ussi ou &eacute;chou&eacute;. </para> <para> @@ -367,7 +367,7 @@ <function>dba_open</function>. </para> <para> - <function>dba_nextkey</function> retourne la cl&eacute;, ou FALSE en cas d'&eacute;chec. + <function>dba_nextkey</function> retourne la cl&eacute;, ou <literal>FALSE</literal> en cas d'&eacute;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 &eacute;t&eacute; ouverte, ou que + ou <literal>FALSE</literal>, suivant que la base a &eacute;t&eacute; ouverte, ou que l'acc&egrave;s a &eacute;chou&eacute;. </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&eacute;ussi ou &eacute;chou&eacute;. </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&eacute;ration r&eacute;ussit ou &eacute;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&eacute;ussi, ou &eacute;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&eacute;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&eacute;rents modifiant la m&ecirc;me fichier - dBase risque de rendre votre base de donn&eacute;es incoh&eacute;rente. - </simpara> - <simpara> - A la diff&eacute;rence des bases de donn&eacute;es SQL, la d&eacute;finition des bases de donn&eacute;es - dBase, ne peut pas &ecirc;tre chang&eacute;e. Une fois le fichier cr&eacute;&eacute;, la d&eacute;finition de - la base est d&eacute;finitive. Il n'y a pas d'index qui acc&eacute;l&egrave;rent les recherches ou - organisent vos donn&eacute;es. Les fichiers dBase sont de simples fichiers s&eacute;quentiels - avec des enregistrements de longueur fixe. Les enregistrements sont ajout&eacute;s &agrave; la - fin du fichier et les enregistrements supprim&eacute;s sont conserv&eacute;s jusqu'&agrave; l'appel de - <function>dbase_pack</function>. - </simpara> - <simpara> - Nous vous recommandons de ne pas utiliser les fichiers dBase comme base de donn&eacute;es - de production. Choisissez n'importe quel serveur SQL &agrave; 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&eacute;es de et vers votre - base des donn&eacute;es web, maintenant que le format du fichier est commun&eacute;ment g&eacute;r&eacute; par - les feuilles et organiseurs Windows. L'import et l'export de donn&eacute;es est l'unique - chose pour laquelle l'utilisation de dBase est recommand&eacute;e. - </simpara> - </partintro> - - <refentry id="function.dbase-create"> - <refnamediv> - <refname>dbase_create</refname> - <refpurpose>Cr&eacute;e une base de donn&eacute;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&eacute;crit le format d'un fichier de la base. Chaque champs est constitu&eacute; d'un nom, - d'un caract&egrave;re de type de champs, d'une longueur et d'une pr&eacute;cision. - </para> - <para> - Les types de champs disponibles sont : - <variablelist> - <varlistentry> - <term>L</term> - <listitem> - <simpara> - Boolean (bool&eacute;en). Pas de longueur ou de pr&eacute;cision pour ces valeurs. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>M</term> - <listitem> - <simpara> - Memo. (Note importante : les Memos ne sont pas support&eacute;s par PHP.) - Elles n'ont pas de longueur ou de pr&eacute;cision. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>D</term> - <listitem> - <simpara> - Date (enregistr&eacute;e au format 'YYYYMMDD'). Elles n'ont pas de longueur ou - de pr&eacute;cision. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>N</term> - <listitem> - <simpara> - Number (nombre). Poss&egrave;de une longueur et un pr&eacute;cision (le nombre de - chiffres apr&egrave;s la virgule). - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>C</term> - <listitem> - <simpara> - String (cha&icirc;ne). - </simpara> - </listitem> - </varlistentry> - </variablelist> - </para> - <para> - Si la base de donn&eacute;es a &eacute;t&eacute; cr&eacute;&eacute;e, un identifiant de base dbase_identifier est - retourn&eacute;, sinon, FALSE est retourn&eacute;. - <example> - <title>Cr&eacute;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&eacute;ation -if (!dbase_create($dbname, $def)) - print "&lt;strong>Error!&lt;/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 &eacute;criture seule, et - 2 &eacute;criture/lecture). - </para> - <para> - Retourne un identifiant de base de donn&eacute;es, ou FALSE si la base n'a pas pu &ecirc;tre - selectionn&eacute;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&eacute;e &agrave; <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&eacute;es sp&eacute;cifi&eacute;e (effacement d&eacute;finitif de tous les - enregistrements marqu&eacute;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&eacute;es de <parameter>record</parameter> dans la base sp&eacute;cifi&eacute;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&eacute;ration &eacute;chouera, et FALSE sera - retourn&eacute;. - </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&eacute;es associ&eacute;es &agrave; l'enregistrement <parameter>record_number</parameter> - par les donn&eacute;es enregistr&eacute;es dans <parameter>record</parameter>. - Si le nombre de colonnes fourni n'est pas celui du nombre de champs dans la base, - l'op&eacute;ration &eacute;chouera, et FALSE sera retourn&eacute;. - </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&eacute; 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&eacute;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&eacute;es de l'enregistrement <parameter>record</parameter> dans un - tableau. Le tableau est index&eacute; &agrave; partir de 0, et inclus un membre nomm&eacute; - 'deleted' (effac&eacute;), qui sera mis &agrave; 1 si l'enregistrement a &eacute;t&eacute; marqu&eacute; pour - l'effacement (voir <function>dbase_delete_record</function>). - </para> - <para> - Chaque champs est converti au format appropri&eacute; PHP. (Les dates sont laiss&eacute;es au - format cha&icirc;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&eacute;es de l'enregistrement <parameter>record</parameter> dans un - tableau associatif. Le tableau inclus un membre nomm&eacute; 'deleted' (effac&eacute;), - qui sera mis &agrave; 1 si l'enregistrement a &eacute;t&eacute; marqu&eacute; pour l'effacement (voir - <function>dbase_delete_record</function>). - </para> - <para> - Chaque champs est converti au format appropri&eacute; PHP. (Les dates sont - laiss&eacute;es au format cha&icirc;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&eacute;es sp&eacute;cifi&eacute;e. - Les num&eacute;ros de champs sont num&eacute;rot&eacute;s de 0 &agrave; dbase_numfields($db)-1, - tandis que les num&eacute;ros d'enregistrements sont num&eacute;rot&eacute;s de 1 &agrave; - 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 &lt; $nf; $i++) { - print $rec[$i]."&lt;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&eacute;cifi&eacute;e. - Les num&eacute;ros de champs sont num&eacute;rot&eacute;s de 0 &agrave; dbase_numfields($db)-1, - tandis que les num&eacute;ros d'enregistrements sont num&eacute;rot&eacute;s de 1 &agrave; - 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&eacute;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&eacute;rents modifiant la m&ecirc;me fichier + dBase risque de rendre votre base de donn&eacute;es incoh&eacute;rente. + </simpara> + <simpara> + A la diff&eacute;rence des bases de donn&eacute;es SQL, la d&eacute;finition des bases de donn&eacute;es + dBase, ne peut pas &ecirc;tre chang&eacute;e. Une fois le fichier cr&eacute;&eacute;, la d&eacute;finition de + la base est d&eacute;finitive. Il n'y a pas d'index qui acc&eacute;l&egrave;rent les recherches ou + organisent vos donn&eacute;es. Les fichiers dBase sont de simples fichiers s&eacute;quentiels + avec des enregistrements de longueur fixe. Les enregistrements sont ajout&eacute;s &agrave; la + fin du fichier et les enregistrements supprim&eacute;s sont conserv&eacute;s jusqu'&agrave; l'appel de + <function>dbase_pack</function>. + </simpara> + <simpara> + Nous vous recommandons de ne pas utiliser les fichiers dBase comme base de donn&eacute;es + de production. Choisissez n'importe quel serveur SQL &agrave; 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&eacute;es de et vers votre + base des donn&eacute;es web, maintenant que le format du fichier est commun&eacute;ment g&eacute;r&eacute; par + les feuilles et organiseurs Windows. L'import et l'export de donn&eacute;es est l'unique + chose pour laquelle l'utilisation de dBase est recommand&eacute;e. + </simpara> + </partintro> + <refentry id="function.dbase-create"> + <refnamediv> + <refname>dbase_create</refname> + <refpurpose>Cr&eacute;e une base de donn&eacute;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&eacute;crit le format d'un fichier de la base. Chaque champs est constitu&eacute; d'un nom, + d'un caract&egrave;re de type de champs, d'une longueur et d'une pr&eacute;cision. + </para> + <para> + Les types de champs disponibles sont : + <variablelist> + <varlistentry> + <term>L</term> + <listitem> + <simpara> + Boolean (bool&eacute;en). Pas de longueur ou de pr&eacute;cision pour ces valeurs. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term>M</term> + <listitem> + <simpara> + Memo. (Note importante : les Memos ne sont pas support&eacute;s par PHP.) + Elles n'ont pas de longueur ou de pr&eacute;cision. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term>D</term> + <listitem> + <simpara> + Date (enregistr&eacute;e au format 'YYYYMMDD'). Elles n'ont pas de longueur ou + de pr&eacute;cision. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term>N</term> + <listitem> + <simpara> + Number (nombre). Poss&egrave;de une longueur et un pr&eacute;cision (le nombre de + chiffres apr&egrave;s la virgule). + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term>C</term> + <listitem> + <simpara> + String (cha&icirc;ne). + </simpara> + </listitem> + </varlistentry> + </variablelist> + </para> + <para> + Si la base de donn&eacute;es a &eacute;t&eacute; cr&eacute;&eacute;e, un identifiant de base dbase_identifier est + retourn&eacute;, sinon, <literal>FALSE</literal> est retourn&eacute;. + <example> + <title>Cr&eacute;ation d'une base dBase</title> + <programlisting role="php"> +&lt;?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&eacute;ation +if (!dbase_create($dbname, $def)) + print "&lt;strong>Error!&lt;/strong>"; +?&gt; + </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 &eacute;criture seule, et + 2 &eacute;criture/lecture). + </para> + <para> + Retourne un identifiant de base de donn&eacute;es, ou <literal>FALSE</literal> si la base n'a pas pu &ecirc;tre + selectionn&eacute;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&eacute;e &agrave; <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&eacute;es sp&eacute;cifi&eacute;e (effacement d&eacute;finitif de tous les + enregistrements marqu&eacute;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&eacute;es de <parameter>record</parameter> dans la base sp&eacute;cifi&eacute;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&eacute;ration &eacute;chouera, et <literal>FALSE</literal> sera + retourn&eacute;. + </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&eacute;es associ&eacute;es &agrave; l'enregistrement <parameter>record_number</parameter> + par les donn&eacute;es enregistr&eacute;es dans <parameter>record</parameter>. + Si le nombre de colonnes fourni n'est pas celui du nombre de champs dans la base, + l'op&eacute;ration &eacute;chouera, et <literal>FALSE</literal> sera retourn&eacute;. + </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&eacute; 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&eacute;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&eacute;es de l'enregistrement <parameter>record</parameter> + dans un tableau. Le tableau est index&eacute; &agrave; partir de 0, et inclus + un membre nomm&eacute; 'deleted' (effac&eacute;), qui sera mis &agrave; 1 + si l'enregistrement a &eacute;t&eacute; marqu&eacute; pour l'effacement + (voir <function>dbase_delete_record</function>). + </para> + <para> + Chaque champs est converti au format appropri&eacute; PHP. (Les dates sont + laiss&eacute;es au format cha&icirc;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&eacute;es de l'enregistrement <parameter>record</parameter> + dans un tableau associatif. Le tableau inclus un membre nomm&eacute; 'deleted' + (effac&eacute;), qui sera mis &agrave; 1 si l'enregistrement a + &eacute;t&eacute; marqu&eacute; pour l'effacement (voir + <function>dbase_delete_record</function>). + </para> + <para> + Chaque champs est converti au format appropri&eacute; PHP. (Les dates sont + laiss&eacute;es au format cha&icirc;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&eacute;es sp&eacute;cifi&eacute;e. + Les num&eacute;ros de champs sont num&eacute;rot&eacute;s de 0 &agrave; dbase_numfields($db)-1, + tandis que les num&eacute;ros d'enregistrements sont num&eacute;rot&eacute;s de 1 &agrave; + dbase_numrecords($db). + <example> + <title>Utiliser <function>dbase_numfields</function></title> + <programlisting role="php"> +&lt;?php +$rec = dbase_get_record($db, $recno); +$nf = dbase_numfields($db); +for ($i=0; $i &lt; $nf; $i++) { + print $rec[$i]."&lt;br>\n"; +} +?&gt; + </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&eacute;cifi&eacute;e. + Les num&eacute;ros de champs sont num&eacute;rot&eacute;s de 0 &agrave; dbase_numfields($db)-1, + tandis que les num&eacute;ros d'enregistrements sont num&eacute;rot&eacute;s de 1 &agrave; + 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'&eacute;crire des lignes dans une - base de donn&eacute;e de type dbm. Ce type de base (support&eacute; - par Berkeley db, gdbm, et quelques librairies syst&egrave;mes, - ou certaines librairies du syst&egrave;me d'exploitation) enregistre - les paires cl&eacute;s/valeurs, (contrairement aux enregistrements + Ces fonctions vous permettent d'&eacute;crire des lignes dans une + base de donn&eacute;e de type dbm. Ce type de base (support&eacute; + par Berkeley db, gdbm, et quelques librairies syst&egrave;mes, + ou certaines librairies du syst&egrave;me d'exploitation) enregistre + les paires cl&eacute;s/valeurs, (contrairement aux enregistrements par ligne, utilis&eacute; par les autres bases de donn&eacute;es relationnelles). </simpara> @@ -16,6 +15,7 @@ <example> <title>dbm</title> <programlisting role="php"> +&lt;?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> +?&gt; + </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 &agrave; - ouvrir. Le deuxi&egrave;me argument est le mode d'ouverture du fichier, - qui peut prendre les valeurs suivantes : "r", "n", "c" ou "w" qui - repr&eacute;sentent respectivement lecture seule, nouveau (ce qui - implique lecture/&eacute;criture, et qui, probablement, va - &eacute;craser une base existante), cr&eacute;ation(ce qui - implique lecture/&eacute;criture, et qui, probablement, va - &eacute;craser une base existante), et lecture/&eacute;criture. + Le premier argument est le chemin absolu jusqu'au fichier dbm &agrave; + ouvrir. Le deuxi&egrave;me argument est le mode d'ouverture du fichier, + qui peut prendre les valeurs suivantes : "r", "n", "c" ou "w" qui + repr&eacute;sentent respectivement lecture seule, nouveau (ce qui + implique lecture/&eacute;criture, et qui, probablement, va + &eacute;craser une base existante), cr&eacute;ation(ce qui + implique lecture/&eacute;criture, et qui, probablement, va + &eacute;craser une base existante), et lecture/&eacute;criture. </para> <para> - Retourne un identifiant, qui sera pass&eacute; &agrave; toutes - les autres fonctions dbm, en cas de succ&egrave;s, ou FALSE en + Retourne un identifiant, qui sera pass&eacute; &agrave; toutes + les autres fonctions dbm, en cas de succ&egrave;s, ou <literal>FALSE</literal> en cas d'&eacute;chec. </para> <para> - Si ndbm est utilis&eacute;, ndbm va cr&eacute;er les fichiers - filename.dir et filename.pag. gdbm n'utilise qu'un fichier, - tout comme les librairie internes, et Berkeley db cr&eacute;e - le fichier filename.db. Notez que PHP dispose de son propre - syst&egrave;me de verrouillage des fichiers, qui s'additionne - &agrave; celui &eacute;ventuellement fait par les librairies. - PHP n'efface jamais les fichiers .lck qu'il cr&eacute;e. Il - les utilise comme inode fixe, sur lequel faire le verrouillage. - Pour plus d'informations sur les fichiers dbm, reportez vous - &agrave; vos pages de manuel Unix (man) , ou bien chargez gdbm : + Si ndbm est utilis&eacute;, ndbm va cr&eacute;er les fichiers + filename.dir et filename.pag. gdbm n'utilise qu'un fichier, + tout comme les librairie internes, et Berkeley db cr&eacute;e + le fichier filename.db. Notez que PHP dispose de son propre + syst&egrave;me de verrouillage des fichiers, qui s'additionne + &agrave; celui &eacute;ventuellement fait par les librairies. + PHP n'efface jamais les fichiers .lck qu'il cr&eacute;e. Il + les utilise comme inode fixe, sur lequel faire le verrouillage. + Pour plus d'informations sur les fichiers dbm, reportez vous + &agrave; 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&eacute;e &agrave; la cl&eacute; + Retourne <literal>TRUE</literal> si il y a une valeur associ&eacute;e &agrave; la cl&eacute; <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&eacute;es, avec la cl&eacute; <parameter>key</parameter>. </para> <para> - Retourne -1 si la base a &eacute;t&eacute; ouverte en mode lecture - seule, 0 si l'insertion a &eacute;t&eacute; r&eacute;ussie, et 1 si - la cl&eacute; key existe d&eacute;j&agrave;. (Pour remplacer la + Retourne -1 si la base a &eacute;t&eacute; ouverte en mode lecture + seule, 0 si l'insertion a &eacute;t&eacute; r&eacute;ussie, et 1 si + la cl&eacute; key existe d&eacute;j&agrave;. (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&eacute; <parameter>key</parameter>, dans une base dbm. </para> <para> - Cette fonction va cr&eacute;er la cl&eacute;, si elle n'existe pas + Cette fonction va cr&eacute;er la cl&eacute;, 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&eacute; <parameter>key</parameter>, + Efface la valeur de la cl&eacute; <parameter>key</parameter>, dans la base dbm. </para> <para> - Retourne FALSE si la cl&eacute; n'existe pas dans cette base. + Retourne <literal>FALSE</literal> si la cl&eacute; 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&egrave;re cl&eacute; de la base de donn&eacute;es. - Notez bien que les cl&eacute;s ne sont pas dans un ordre d&eacute;fini, - &eacute;tant donn&eacute; que la table est construite comme une table + Retourne la premi&egrave;re cl&eacute; de la base de donn&eacute;es. + Notez bien que les cl&eacute;s ne sont pas dans un ordre d&eacute;fini, + &eacute;tant donn&eacute; 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&eacute; apr&egrave;s la cl&eacute; - <parameter>key</parameter>. En appelant <function>dbmfirstkey</function>, - puis successivement <function>dbmnextkey</function>, il est - possible de passer en revue toute les paires cl&eacute;/valeur - de la base de donn&eacute;es dbm. Par exemple : - <example> - <title>Passer en revue une base de donn&eacute;es.</title> - <programlisting> + <function>dbmnextkey</function> retourne la cl&eacute; apr&egrave;s la cl&eacute; + <parameter>key</parameter>. En appelant <function>dbmfirstkey</function>, + puis successivement <function>dbmnextkey</function>, il est + possible de passer en revue toute les paires cl&eacute;/valeur + de la base de donn&eacute;es dbm. Par exemple : + <example> + <title>Passer en revue une base de donn&eacute;es.</title> + <programlisting role="php"> +&lt;?php $key = dbmfirstkey($dbm_id); while ($key) { echo "$key = " . dbmfetch($dbm_id, $key) . "\n"; $key = dbmnextkey($dbm_id, $key); } - </programlisting> - </example></para> +?&gt; + </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&egrave;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&eacute;ration &eacute;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&eacute;ration &eacute;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&eacute;canisme pseudo-objet permet la lecture d'un dossier. - L'argument <parameter>directory</parameter> doit &ecirc;tre ouvert. - Deux propri&eacute;t&eacute;s sont disponibles une fois le dossier - ouvert : le pointeur peut &ecirc;tre utilis&eacute; 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&eacute;canisme pseudo-objet permet la lecture d'un dossier. + L'argument <parameter>directory</parameter> doit &ecirc;tre ouvert. + Deux propri&eacute;t&eacute;s sont disponibles une fois le dossier + ouvert : le pointeur peut &ecirc;tre utilis&eacute; 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&eacute;thodes permettent de lire, remettre &agrave; z&eacute;ro et fermer le dossier. <example> - <title><function>Dir</function> Example</title> + <title>Exemple avec <function>dir</function></title> <programlisting role="php"> +&lt;?php $d = dir("/etc"); echo "Pointeur: ".$d->handle."&lt;br>\n"; echo "Chemin: ".$d->path."&lt;br>\n"; @@ -55,12 +55,12 @@ echo $entry."&lt;br>\n"; } $d->close(); +?&gt; </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 &eacute;t&eacute; 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 &ecirc;tre utilis&eacute; avec les fonctions - <function>closedir</function>, <function>readdir</function> + <para> + <function>opendir</function> retourne un pointeur sur un dossier + pour &ecirc;tre utilis&eacute; 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&eacute; par dir_handle. Les noms sont - retourn&eacute;s dans n'importe quel ordre. + <function>readdir</function> retourne le nom du fichier suivant dans + le dossier identifi&eacute; par dir_handle. Les noms sont + retourn&eacute;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); ?&gt; </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"> -&lt;?php -$handle=opendir('.'); -while ($file = readdir($handle)) { - if ($file != "." && $file != "..") { - echo "$file\n"; - } +&lt;?php +$handle=opendir('.'); +while ($file = readdir($handle)) { + if ($file != "." && $file != "..") { + echo "$file\n"; + } } -closedir($handle); +closedir($handle); ?&gt; </programlisting> </example> </para> </refsect1> </refentry> - <refentry id="function.rewinddir"> <refnamediv> <refname>rewinddir</refname> @@ -194,14 +190,12 @@ </funcprototype> </funcsynopsis> <para> - <function>rewinddir</function> retourne &agrave; la premi&egrave;re + <function>rewinddir</function> retourne &agrave; la premi&egrave;re entr&eacute;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&eacute;finie dans la biblioth&egrave;que - <parameter>library</parameter>. Voir aussi la directive de configuration + Charge l'extension PHP d&eacute;finie dans la biblioth&egrave;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&ecirc;te partielle pour l'URI sp&eacute;cifi&eacute;e + Effectue une requ&ecirc;te partielle pour l'URI sp&eacute;cifi&eacute;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&ecirc;te partielle - pour l'URI sp&eacute;cifi&eacute;e. Cette requ&ecirc;te permet de - r&eacute;cup&eacute;rer toutes les informations importantes &agrave; - propos de la ressource concern&eacute;e. Les propri&eacute;t&eacute;s + <function>apache_lookup_uri</function> effectue une requ&ecirc;te partielle + pour l'URI sp&eacute;cifi&eacute;e. Cette requ&ecirc;te permet de + r&eacute;cup&eacute;rer toutes les informations importantes &agrave; + propos de la ressource concern&eacute;e. Les propri&eacute;t&eacute;s de la classe renvoy&eacute;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&eacute; 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&ecirc;tes HTTP correspondants &agrave; la requ&ecirc;te courante. <note> <para> @@ -116,10 +116,12 @@ Exemple d'utilisation de la fonction <function>getallheaders</function> </title> <programlisting role="php"> +&lt;?php $headers = getallheaders(); while (list($entete, $valeur) = each($headers)) { echo "$entete: $valeur&lt;br&gt;\n"; } +?&gt; </programlisting> </example> Cette exemple est un exemple d'affichage de toutes les ent&ecirc;tes @@ -145,19 +147,19 @@ <paramdef>string <parameter>filename</parameter></paramdef> </funcsynopsis> <para> - <function>virtual</function> est une fonction sp&eacute;cifique au - serveur Apache. Elle est &eacute;quivalente &agrave; la directive - "&lt;!--#include virtual...--&gt;" lorsque vous utilisez le module + <function>virtual</function> est une fonction sp&eacute;cifique au + serveur Apache. Elle est &eacute;quivalente &agrave; la directive + "&lt;!--#include virtual...--?&gt;" lorsque vous utilisez le module include d'Apache. Cette fonction effectue une sous-requ&ecirc;te Apache. - C'est tr&egrave;s utile lorsque vous utilisez des scripts CGI, des - fichiers .shtml ou n'importe quel type de fichier qui doit &ecirc;tre - analys&eacute; par le serveur Apache. Il est &agrave; noter que lors - de l'utilisation avec des scripts CGI, ces derniers doivent - g&eacute;n&eacute;rer une ent&ecirc;te valide, c'est-&agrave;-dire, - au minimum une ent&ecirc;te "Content-Type". Pour les fichiers PHP, il - est conseill&eacute; d'utiliser les fonctions <function>include</function> - et <function>require</function>. <function>virtual</function> ne peut pas - &ecirc;tre utilis&eacute; pour inclure un fichier qui est lui m&ecirc;me + C'est tr&egrave;s utile lorsque vous utilisez des scripts CGI, des + fichiers .shtml ou n'importe quel type de fichier qui doit &ecirc;tre + analys&eacute; par le serveur Apache. Il est &agrave; noter que lors + de l'utilisation avec des scripts CGI, ces derniers doivent + g&eacute;n&eacute;rer une ent&ecirc;te valide, c'est-&agrave;-dire, + au minimum une ent&ecirc;te "Content-Type". Pour les fichiers PHP, il + est conseill&eacute; d'utiliser les fonctions <function>include</function> + et <function>require</function>. <function>virtual</function> ne peut pas + &ecirc;tre utilis&eacute; pour inclure un fichier qui est lui m&ecirc;me un fichier PHP. </para> </refsect1> @@ -176,10 +178,10 @@ </funcprototype> </funcsynopsis> <para> - <function>ascii2ebcdic</function> est une fonction sp&eacute;ficique - &agrave; Apache, qui n'est disponible que sur les OS qui g&egrave;re - le format EBCDIC (OS/390, BS2000). Elle traduit la cha&icirc;ne ASCII - <parameter>ascii_str</parameter> en son &eacute;quivalent EBCDIC + <function>ascii2ebcdic</function> est une fonction sp&eacute;ficique + &agrave; Apache, qui n'est disponible que sur les OS qui g&egrave;re + le format EBCDIC (OS/390, BS2000). Elle traduit la cha&icirc;ne ASCII + <parameter>ascii_str</parameter> en son &eacute;quivalent EBCDIC (avec protection des donn&eacute;es binaires) et retourne le r&eacute;sultat. </para> <para> @@ -201,10 +203,10 @@ </funcprototype> </funcsynopsis> <para> - <function>ebcdic2ascii</function> est une fonction sp&eacute;ficique - &agrave; Apache, qui n'est disponible que sur les OS qui g&egrave;re - le format EBCDIC (OS/390, BS2000). Elle traduit la cha&icirc;ne EBCDIC - <parameter>ebcdic_str</parameter> en son &eacute;quivalent ASCII + <function>ebcdic2ascii</function> est une fonction sp&eacute;ficique + &agrave; Apache, qui n'est disponible que sur les OS qui g&egrave;re + le format EBCDIC (OS/390, BS2000). Elle traduit la cha&icirc;ne EBCDIC + <parameter>ebcdic_str</parameter> en son &eacute;quivalent ASCII (avec protection des donn&eacute;es binaires) et retourne le r&eacute;sultat. </para> <para>
« previous php.doc (#969333685) next »