cvs: phpdoc /fr/functions network.xml nis.xml oci8.xml openssl.xml oracle.xml outcontrol.xml ovrimos.xml pcre.xml pdf.xml pfpro.xml pgsql.xml
posix.xml pspell.xml
| From: | Damien Seguy | Date: | Fri, 26 Jan 2001 14:44:22 +0000 |
| Subject: | cvs: phpdoc /fr/functions network.xml nis.xml oci8.xml openssl.xml oracle.xml outcontrol.xml ovrimos.xml pcre.xml pdf.xml pfpro.xml pgsql.xml posix.xml pspell.xml |
||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969333980@lists.php.net to get a copy of this message | ||
dams Fri Jan 26 06:44:22 2001 EDT
Modified files:
/phpdoc/fr/functions nis.xml oci8.xml openssl.xml oracle.xml
outcontrol.xml ovrimos.xml pcre.xml pdf.xml
pfpro.xml pgsql.xml posix.xml pspell.xml
network.xml
Log:
Big update (4/5). Almost done.
.
Index: phpdoc/fr/functions/nis.xml diff -u phpdoc/fr/functions/nis.xml:1.3 phpdoc/fr/functions/nis.xml:1.4 --- phpdoc/fr/functions/nis.xml:1.3 Fri Dec 8 02:16:18 2000 +++ phpdoc/fr/functions/nis.xml Fri Jan 26 06:44:21 2001 @@ -1,5 +1,5 @@ <reference id="ref.nis"> - <title>Fonctions NIS</title> + <title>NIS</title> <titleabbrev>NIS</titleabbrev> <partintro> <para> @@ -48,7 +48,7 @@ <?php $domain = yp_get_default_domain(); echo "Le domaine par défaut est : " . $domain; -?> +?> </programlisting> </example> </para> @@ -76,7 +76,7 @@ </funcsynopsis> <para> <function>yp_order</function> retourne le numéro d'ordre d'une - carte ou FALSE. + carte ou <literal>FALSE</literal>. </para> <para> <example> @@ -85,7 +85,7 @@ <?php $number = yp_order($domain,$mapname); echo "Le numéro d'ordre de cette carte est : " . $order; -?> +?> </programlisting> </example> </para> @@ -125,7 +125,7 @@ <?php $number = yp_master($domain, $mapname); echo "Master for this map is: " . $master; -?> +?> </programlisting> </example> </para> @@ -156,7 +156,7 @@ <para> <function>yp_match</function> retourne la valeur associée à la clé passée en argument, pour la carte - spécifiée, ou FALSE. La clé doit exister et + spécifiée, ou <literal>FALSE</literal>. La clé doit exister et être exacte. </para> <para> @@ -166,7 +166,7 @@ <?php $entry = yp_match($domain, "passwd.byname", "joe"); echo "La valeur trouvée est: " . $entry; -?> +?> </programlisting> </example> </para> @@ -200,7 +200,7 @@ </funcsynopsis> <para> <function>yp_first</function> retourne le premier couple - (clé ; valeur) d'une carte donnée, ou FALSE. + (clé ; valeur) d'une carte donnée, ou <literal>FALSE</literal>. </para> <para> <example> @@ -211,7 +211,7 @@ $key = key($entry); echo "La première entrée de cette carte est " . $key . " et sa valeur est " . $entry[$key]; -?> +?> </programlisting> </example> </para> @@ -243,7 +243,7 @@ </funcsynopsis> <para> <function>yp_next</function> retourne le couple (clé ; valeur) - suivant la clé donnée d'une carte donnée ou FALSE. + suivant la clé donnée d'une carte donnée ou <literal>FALSE</literal>. </para> <para> <example> @@ -257,7 +257,7 @@ $key = key($entry); echo "L'entree suivante après joe a la cle " . $key . " et sa valeur " . $entry[$key]; -?> +?> </programlisting> </example> </para> @@ -346,9 +346,10 @@ <programlisting role="php"> <?php echo "Error: " . yp_err_string(); -?> +?> </programlisting> - </example></para> + </example> + </para> <para> Voir aussi : <link linkend="function.yp-errno"> yp_errno</link> </para> Index: phpdoc/fr/functions/oci8.xml diff -u phpdoc/fr/functions/oci8.xml:1.5 phpdoc/fr/functions/oci8.xml:1.6 --- phpdoc/fr/functions/oci8.xml:1.5 Wed Nov 29 05:31:26 2000 +++ phpdoc/fr/functions/oci8.xml Fri Jan 26 06:44:21 2001 @@ -1,5 +1,5 @@ <reference id="ref.oci8"> - <title>Oracle 8 functions</title> + <title>Oracle 8</title> <titleabbrev>OCI8</titleabbrev> <partintro> <para> @@ -53,7 +53,7 @@ </itemizedlist> </para> <para> - Après avoir configuré ces varaibles pour votre utilisateur "serveur + Après avoir configuré ces variables pour votre utilisateur "serveur web", assurez vous aussi d'ajouter cet utilisateur (nobody, www) au group Oracle. </para> @@ -73,7 +73,7 @@ field2 = empty_clob()) returning field2 into :field2"; OCIParse($conn, $sql); $clob = OCINewDescriptor($conn, OCI_D_LOB); -OCIBindByName ($stmt, ":field2", &$clob, -1, OCI_B_CLOB); +OCIBindByName ($stmt, ":field2", &$clob, -1, OCI_B_CLOB); OCIExecute($stmt, OCI_DEFAULT); $clob->save ("some text"); ?> @@ -126,7 +126,7 @@ SQL <parameter>Column-Name</parameter> dans les variables PHP. Méfiez-vous des colonnes Oracle qui sont toutes en majuscule, tandis que dans les SELECT, vous pouvez aussi les écrire en minuscules. - <function>ocidefinebyname</function> s'attend à ce que + <function>ocidefinebyname</function> s'attends à ce que <parameter>Column-Name</parameter> soit en majuscules. Si vous définissez une variable qui n'existe pas dans la commande SELECT, vous ne serez pas prévenu par une erreur. @@ -139,14 +139,14 @@ </para> <example> <title>OCIDefineByName</title> - <programlisting> + <programlisting role="php"> <?php /* Exemple OCIDefineByPos par thies@thieso.net (980219) */ $conn = OCILogon("scott","tiger"); $stmt = OCIParse($conn,"select empno, ename from emp"); /* La définition DOIT être faîte AVANT ociexecute! */ -OCIDefineByName($stmt,"EMPNO",&$empno); -OCIDefineByName($stmt,"ENAME",&$ename); +OCIDefineByName($stmt,"EMPNO",&$empno); +OCIDefineByName($stmt,"ENAME",&$ename); OCIExecute($stmt); while (OCIFetch($stmt)) { echo "empno:".$empno."\n"; @@ -154,7 +154,9 @@ } OCIFreeStatement($stmt); OCILogoff($conn); -?></programlisting></example> +?> + </programlisting> + </example> </refsect1> </refentry> <refentry id="function.ocibindbyname"> @@ -200,7 +202,7 @@ </para> <example> <title>OCIDefineByName</title> - <programlisting> + <programlisting role="php"> <?php /* Exemple OCIBindByPos par thies@thieso.net (980221) Insère 3 lignes dans emp, et utilise ROWID pour mettre à jour @@ -210,14 +212,14 @@ $stmt = OCIParse($conn,"insert into emp (empno, ename) ". "values (:empno,:ename) ". "returning ROWID into :rid"); -$data = array(1111 => "Larry", 2222 => "Bill", 3333 => "Jim"); +$data = array(1111 => "Larry", 2222 => "Bill", 3333 => "Jim"); $rowid = OCINewDescriptor($conn,OCI_D_ROWID); -OCIBindByName($stmt,":empno",&$empno,32); -OCIBindByName($stmt,":ename",&$ename,32); -OCIBindByName($stmt,":rid",&$rowid,-1,OCI_B_ROWID); +OCIBindByName($stmt,":empno",&$empno,32); +OCIBindByName($stmt,":ename",&$ename,32); +OCIBindByName($stmt,":rid",&$rowid,-1,OCI_B_ROWID); $update = OCIParse($conn,"update emp set sal = :sal where ROWID = :rid"); -OCIBindByName($update,":rid",&$rowid,-1,OCI_B_ROWID); -OCIBindByName($update,":sal",&$sal,32); +OCIBindByName($update,":rid",&$rowid,-1,OCI_B_ROWID); +OCIBindByName($update,":sal",&$sal,32); $sal = 10000; while (list($empno,$ename) = each($data)) { OCIExecute($stmt); @@ -228,7 +230,7 @@ OCIFreeStatement($stmt); $stmt = OCIParse($conn,"select * from emp where empno in (1111,2222,3333)"); OCIExecute($stmt); -while (OCIFetchInto($stmt,&$arr,OCI_ASSOC)) { +while (OCIFetchInto($stmt,&$arr,OCI_ASSOC)) { var_dump($arr); } OCIFreeStatement($stmt); @@ -237,7 +239,7 @@ OCIExecute($stmt); OCIFreeStatement($stmt); OCILogoff($conn); -?> +?> </programlisting> </example> </refsect1> @@ -276,7 +278,7 @@ Cet exemple montre comment les connexions sont partagées : <example> <title>OCILogon</title> - <programlisting> + <programlisting role="php"> <?php print "<HTML><PRE>"; $db = ""; @@ -338,7 +340,7 @@ select_data($c2); // Aucune ligne n'est retournée drop_table($c1); print "</PRE></HTML>"; -?> +?> </programlisting> </example> </para> @@ -417,7 +419,7 @@ séparées. <example> <title>OCINLogon</title> - <programlisting> + <programlisting role="php"> <?php print "<HTML><PRE>"; $db = ""; @@ -478,7 +480,7 @@ select_data($c2); drop_table($c1); print "</PRE></HTML>"; -?> +?> </programlisting> </example> </para> @@ -594,7 +596,7 @@ </para> <example> <title>OCINewDescriptor</title> - <programlisting> + <programlisting role="php"> <?php /* Ce script est fait pour être appelé dans un formulaire HTML * Il attends les variables $user, $password, $table, $where, et $commitsize @@ -605,12 +607,12 @@ $conn = OCILogon($user, $password); $stmt = OCIParse($conn,"select rowid from $table $where"); $rowid = OCINewDescriptor($conn,OCI_D_ROWID); - OCIDefineByName($stmt,"ROWID",&$rowid); + OCIDefineByName($stmt,"ROWID",&$rowid); OCIExecute($stmt); while ( OCIFetch($stmt) ) { $nrows = OCIRowCount($stmt); $delete = OCIParse($conn,"delete from $table where ROWID = :rid"); - OCIBindByName($delete,":rid",&$rowid,-1,OCI_B_ROWID); + OCIBindByName($delete,":rid",&$rowid,-1,OCI_B_ROWID); OCIExecute($delete); print "$nrows\n"; if ( ($nrows % $commitsize) == 0 ) { @@ -621,16 +623,17 @@ print "$nrows effacées...\n"; OCIFreeStatement($stmt); OCILogoff($conn); -?> - </programlisting><programlisting> +?> + </programlisting> + <programlisting role="php"> <?php /* Ce script est fait pour être appelé depuis un formulaire HTML. - * Il attend les variables $user, $password, $table, $where, et $commitsize, + * Il attends les variables $user, $password, $table, $where, et $commitsize, * données par le formulaire. Le script efface * les lignes selectionnées avec ROWID est valide les transactions * à chaque jeu de $commitsize lignes. (Attention : il n'y plus d'annulation) */ if(!isset($lob_upload) || $lob_upload == 'none'){ -?> +?> <form action="upload.php3" method="post" enctype="multipart/form-data"> Upload file: <input type="file" name="lob_upload"><br> <input type="submit" value="Upload"> - <input type="reset"> @@ -641,7 +644,7 @@ $conn = OCILogon($user, $password); $lob = OCINewDescriptor($conn, OCI_D_LOB); $stmt = OCIParse($conn,"insert into $table (id, the_blob) values(my_seq.NEXTVAL, EMPTY_BLOB()) returning the_blob into :the_blob"); - OCIBindByName($stmt, ':the_blob', &$lob, -1, OCI_B_BLOB); + OCIBindByName($stmt, ':the_blob', &$lob, -1, OCI_B_BLOB); OCIExecute($stmt); if($lob->savefile($lob_upload)){ OCICommit($conn); @@ -653,8 +656,9 @@ OCIFreeStatement($stmt); OCILogoff($conn); } -?> - </programlisting></example> +?> + </programlisting> + </example> </refsect1> </refentry> <refentry id="function.ocirowcount"> @@ -679,7 +683,7 @@ <para> <example> <title>OCIRowCount</title> - <programlisting> + <programlisting role="php"> <?php print "<HTML><PRE>"; $conn = OCILogon("scott","tiger"); @@ -697,7 +701,7 @@ OCIFreeStatement($stmt); OCILogOff($conn); print "</PRE></HTML>"; -?> +?> </programlisting> </example> </para> @@ -722,7 +726,7 @@ </para> <example> <title>OCINumCols</title> - <programlisting> + <programlisting role="php"> <?php print "<HTML><PRE>\n"; $conn = OCILogon("scott", "tiger"); @@ -731,7 +735,7 @@ while ( OCIFetch($stmt) ) { print "\n"; $ncols = OCINumCols($stmt); - for ( $i = 1; $i <= $ncols; $i++ ) { + for ( $i = 1; $i <= $ncols; $i++ ) { $column_name = OCIColumnName($stmt,$i); $column_value = OCIResult($stmt,$i); print $column_name . ': ' . $column_value . "\n"; @@ -742,7 +746,7 @@ OCILogoff($conn); print "</PRE>"; print "</HTML>\n"; -?> +?> </programlisting> </example> </refsect1> @@ -860,14 +864,14 @@ </para> <example> <title>OCIFetchStatement</title> - <programlisting> + <programlisting role="php"> <?php /* exemple OCIFetchStatement par mbritton@verinet.com (990624) */ $conn = OCILogon("scott","tiger"); $stmt = OCIParse($conn,"select * from emp"); OCIExecute($stmt); $nrows = OCIFetchStatement($stmt,$results); -if ( $nrows > 0 ) { +if ( $nrows > 0 ) { print "<TABLE BORDER=\"1\">\n"; print "<TR>\n"; while ( list( $key, $val ) = each( $results ) ) { @@ -890,7 +894,7 @@ print "$nrows Records Selected<BR>\n"; OCIFreeStatement($stmt); OCILogoff($conn); -?> +?> </programlisting> </example> </refsect1> @@ -910,7 +914,7 @@ </funcprototype> </funcsynopsis> <para> - <function>ocicolumnisnull</function> retourne TRUE si la colonne + <function>ocicolumnisnull</function> retourne <literal>TRUE</literal> si la colonne <parameter>col</parameter> du résultat <parameter>stmt</parameter> est NULL. Vous pouvez utiliser le numéro de colonne (l'indexation des colonnes @@ -940,7 +944,7 @@ <para> <example> <title>OCIColumnName</title> - <programlisting> + <programlisting role="php"> <?php print "<HTML><PRE>\n"; $conn = OCILogon("scott", "tiger"); @@ -967,7 +971,7 @@ OCILogoff($conn); print "</PRE>"; print "</HTML>\n"; -?> +?> </programlisting> </example> </para> @@ -1001,7 +1005,7 @@ <para> <example> <title>OCIColumnSize</title> - <programlisting> + <programlisting role="php"> <?php print "<HTML><PRE>\n"; $conn = OCILogon("scott", "tiger"); @@ -1014,7 +1018,7 @@ print "<TH>Length</TH>"; print "</TR>"; $ncols = OCINumCols($stmt); - for ( $i = 1; $i <= $ncols; $i++ ) { + for ( $i = 1; $i <= $ncols; $i++ ) { $column_name = OCIColumnName($stmt,$i); $column_type = OCIColumnType($stmt,$i); $column_size = OCIColumnSize($stmt,$i); @@ -1029,7 +1033,7 @@ OCILogoff($conn); print "</PRE>"; print "</HTML>\n"; -?> +?> </programlisting> </example> </para> @@ -1060,7 +1064,7 @@ <para> <example> <title>OCIColumnType</title> - <programlisting> + <programlisting role="php"> <?php print "<HTML><PRE>\n"; $conn = OCILogon("scott", "tiger"); @@ -1073,7 +1077,7 @@ print "<TH>Length</TH>"; print "</TR>"; $ncols = OCINumCols($stmt); - for ( $i = 1; $i <= $ncols; $i++ ) { + for ( $i = 1; $i <= $ncols; $i++ ) { $column_name = OCIColumnName($stmt,$i); $column_type = OCIColumnType($stmt,$i); $column_size = OCIColumnSize($stmt,$i); @@ -1087,7 +1091,7 @@ OCILogoff($conn); print "</PRE>"; print "</HTML>\n"; -?> +?> </programlisting> </example> </para> @@ -1115,12 +1119,12 @@ informations de version du serveur <example> <title>OCIServerVersion</title> - <programlisting> + <programlisting role="php"> <?php $conn = OCILogon("scott","tiger"); print "Version du serveur : " . OCIServerVersion($conn); OCILogOff($conn); -?> +?> </programlisting> </example> </para> @@ -1152,11 +1156,12 @@ <listitem><simpara> "BEGIN"</simpara></listitem> <listitem><simpara> "DECLARE"</simpara></listitem> <listitem><simpara> "UNKNOWN"</simpara></listitem> - </orderedlist></para> + </orderedlist> + </para> <para> <example> <title>Exemples</title> - <programlisting> + <programlisting role="php"> <?php print "<HTML><PRE>"; $conn = OCILogon("scott","tiger"); @@ -1167,7 +1172,7 @@ } OCILogoff($conn); print "</PRE></HTML>"; -?> +?> </programlisting> </example> </para> @@ -1198,30 +1203,30 @@ <title> Utiliser un REF CURSOR issue d'une procédure enregistrée. </title> - <programlisting> + <programlisting role="php"> <?php // supposons que votre procédure stoquée info.output retourne un pointeur // de curseur dans : data $conn = OCILogon("scott","tiger"); $curs = OCINewCursor($conn); $stmt = OCIParse($conn,"begin info.output(:data); end;"); -ocibindbyname($stmt,"data",&$curs,-1,OCI_B_CURSOR); +ocibindbyname($stmt,"data",&$curs,-1,OCI_B_CURSOR); ociexecute($stmt); ociexecute($curs); -while (OCIFetchInto($curs,&$data)) { +while (OCIFetchInto($curs,&$data)) { var_dump($data); } OCIFreeCursor($stmt); OCIFreeStatement($curs); OCILogoff($conn); -?> +?> </programlisting> </example> </para> <para> <example> <title>Utiliser un REF CURSOR issue d'une commande SELECT</title> - <programlisting> + <programlisting role="php"> <?php print "<HTML><BODY>"; $conn = OCILogon("scott","tiger"); @@ -1235,14 +1240,14 @@ print "<TH>DEPT #</TH>"; print "<TH># EMPLOYEES</TH>"; print "</TR>"; -while (OCIFetchInto($stmt,&$data,OCI_ASSOC)) { +while (OCIFetchInto($stmt,&$data,OCI_ASSOC)) { print "<TR>"; $dname = $data["DNAME"]; $deptno = $data["DEPTNO"]; print "<TD>$dname</TD>"; print "<TD>$deptno</TD>"; ociexecute($data[ "EMPCNT" ]); - while (OCIFetchInto($data[ "EMPCNT" ],&$subdata,OCI_ASSOC)) { + while (OCIFetchInto($data[ "EMPCNT" ],&$subdata,OCI_ASSOC)) { $num_emps = $subdata["NUM_EMPS"]; print "<TD>$num_emps</TD>"; } @@ -1252,7 +1257,7 @@ print "</BODY></HTML>"; OCIFreeStatement($stmt); OCILogoff($conn); -?> +?> </programlisting> </example> </para> @@ -1274,8 +1279,8 @@ </funcprototype> </funcsynopsis> <para> - <function>ocifreestatement</function> retourne TRUE en cas de succès, - et FALSE en cas d'échec. + <function>ocifreestatement</function> retourne <literal>TRUE</literal> en cas de succès, + et <literal>FALSE</literal> en cas d'échec. </para> </refsect1> </refentry> @@ -1295,8 +1300,8 @@ </funcprototype> </funcsynopsis> <para> - <function>ocifreecursor</function> retourne TRUE en cas de - succès, et FALSE en cas d'échec. + <function>ocifreecursor</function> retourne <literal>TRUE</literal> en cas de + succès, et <literal>FALSE</literal> en cas d'échec. </para> </refsect1> </refentry> @@ -1314,8 +1319,8 @@ </funcprototype> </funcsynopsis> <para> - <function>ocifreedesc</function> retourne TRUE en cas de - succès, et FALSE en cas d'échec. + <function>ocifreedesc</function> retourne <literal>TRUE</literal> en cas de + succès, et <literal>FALSE</literal> en cas d'échec. </para> </refsect1> </refentry> @@ -1336,8 +1341,8 @@ <simpara> <function>ociparse</function> analyse la requête <parameter>query</parameter> sur la connexion - <parameter>conn</parameter>, et retourne TRUE si la requête - <parameter>query</parameter> est valide, et FALSE, si + <parameter>conn</parameter>, et retourne <literal>TRUE</literal> si la requête + <parameter>query</parameter> est valide, et <literal>FALSE</literal>, si ce n'est pas le cas. <parameter>query</parameter> peut être n'importe quelle requête SQL. </simpara> @@ -1359,7 +1364,7 @@ <function>ocierror</function> retourne la dernière erreur trouvée. Si l'option <parameter>stmt|conn</parameter> n'est pas fournie, la dernière erreur rencontrée est retournée. Si aucune erreur n'est trouvée, <function>ocierror</function> - retourne FALSE. + retourne <literal>FALSE</literal>. </simpara> </refsect1> </refentry> Index: phpdoc/fr/functions/openssl.xml diff -u phpdoc/fr/functions/openssl.xml:1.2 phpdoc/fr/functions/openssl.xml:1.3 --- phpdoc/fr/functions/openssl.xml:1.2 Thu Dec 28 00:43:03 2000 +++ phpdoc/fr/functions/openssl.xml Fri Jan 26 06:44:21 2001 @@ -49,7 +49,7 @@ </funcsynopsis> <para> <function>openssl_get_privatekey</function> retourne un identifiant - de clé positif, ou FALSE en cas d'erreur. + de clé positif, ou <literal>FALSE</literal> en cas d'erreur. </para> <para> <function>openssl_get_privatekey</function> analyse la clé privée @@ -75,7 +75,7 @@ </funcsynopsis> <para> <function>openssl_get_publickey</function> retourne un identifiant - de clé positif, ou FALSE en cas d'erreur. + de clé positif, ou <literal>FALSE</literal> en cas d'erreur. </para> <para> <function>openssl_get_publickey</function> extrait la clé publique @@ -101,8 +101,8 @@ </funcprototype> </funcsynopsis> <para> - <function>openssl_open</function> TRUE en cas de succès, et FALSE sinon. - En cas de succès, les données déchiffrées + <function>openssl_open</function> <literal>TRUE</literal> en cas de succès, et <literal>FALSE</literal> sinon. + En cas de succès, les données déchiffrées sont placées dans <parameter>open_data</parameter>. </para> <para> @@ -160,21 +160,21 @@ </funcsynopsis> <para> <function>openssl_seal</function> retourne la longueur des données - scellées en cas de succès, et FALSE sinon. En cas de succès, les données + scellées en cas de succès, et <literal>FALSE</literal> sinon. En cas de succès, les données scellées sont placées dans le paramètre <parameter>sealed_data</parameter>, et les clés d'enveloppe dans <parameter>env_keys</parameter>. </para> <para> <function>openssl_seal</function> scelle (chiffre) les données <parameter>data</parameter> en utilisant l'algorithme RC4 avec une clé - secrètre générée aléatoirement. La clé - est chiffrée avec chaque clé publique associée à - <parameter>pub_key_ids</parameter> et chaque clé ainsi - encryptée est retournée dans <parameter>env_keys</parameter>. - Cela signifique que vous pouvez envoyez des données scellées - à plusieurs destinataires (en supposant que chacun ait recu la - clé publique). Chaque destinataire doit recevoir les données - encryptées et la clé d'enveloppe, qui a été + secrètre générée aléatoirement. La clé + est chiffrée avec chaque clé publique associée à + <parameter>pub_key_ids</parameter> et chaque clé ainsi + encryptée est retournée dans <parameter>env_keys</parameter>. + Cela signifique que vous pouvez envoyez des données scellées + à plusieurs destinataires (en supposant que chacun ait recu la + clé publique). Chaque destinataire doit recevoir les données + encryptées et la clé d'enveloppe, qui a été encryptée avec la clé publique du destinataire. </para> <para> @@ -224,8 +224,8 @@ </funcprototype> </funcsynopsis> <para> - <function>openssl_sign</function> retourne TRUE en cas de succès, et - FALSE sinon. En cas de succès, la signature est placée dans + <function>openssl_sign</function> retourne <literal>TRUE</literal> en cas de succès, et + <literal>FALSE</literal> sinon. En cas de succès, la signature est placée dans <parameter>signature</parameter>. </para> <para> Index: phpdoc/fr/functions/oracle.xml diff -u phpdoc/fr/functions/oracle.xml:1.5 phpdoc/fr/functions/oracle.xml:1.6 --- phpdoc/fr/functions/oracle.xml:1.5 Tue Dec 26 03:26:33 2000 +++ phpdoc/fr/functions/oracle.xml Fri Jan 26 06:44:21 2001 @@ -1,5 +1,5 @@ <reference id="ref.oracle"> - <title>Fonctions Oracle</title> + <title>Oracle</title> <titleabbrev>Oracle</titleabbrev> <refentry id="function.ora-bind"> <refnamediv> @@ -19,8 +19,8 @@ </funcprototype> </funcsynopsis> <para> - <function>ora_bind</function> retourne TRUE si la liaison a pu se faire, et - sinon FALSE. Les erreurs sont accessibles avec les fonctions + <function>ora_bind</function> retourne <literal>TRUE</literal> si la liaison a pu se faire, et + sinon <literal>FALSE</literal>. Les erreurs sont accessibles avec les fonctions <function>ora_error</function> et <function>ora_errorcode</function>. </para> <para> @@ -69,8 +69,8 @@ </funcprototype> </funcsynopsis> <para> - <function>ora_close</function> retourne TRUE si la fermeture a bien eu - lieu, et FALSE sinon. Les erreurs sont accessibles avec les fonctions + <function>ora_close</function> retourne <literal>TRUE</literal> si la fermeture a bien eu + lieu, et <literal>FALSE</literal> sinon. Les erreurs sont accessibles avec les fonctions <function>ora_error</function> et <function>ora_errorcode</function>. </para> <para> @@ -150,7 +150,8 @@ <member><literal>"ROWID"</literal></member> <member><literal>"DATE"</literal></member> <member><literal>"CURSOR"</literal></member> - </simplelist></para> + </simplelist> + </para> </refsect1> </refentry> <refentry id="function.ora-commit"> @@ -167,8 +168,8 @@ </funcprototype> </funcsynopsis> <para> - <function>ora_commit</function> retourne TRUE si la validation a bien eu - lieu, et FALSE sinon. Les erreurs sont accessibles avec les fonctions + <function>ora_commit</function> retourne <literal>TRUE</literal> si la validation a bien eu + lieu, et <literal>FALSE</literal> sinon. Les erreurs sont accessibles avec les fonctions <function>ora_error</function> et <function>ora_errorcode</function>. </para> <para> @@ -194,8 +195,8 @@ </funcprototype> </funcsynopsis> <para> - <function>ora_commitoff</function> retourne TRUE si la - désactivation a bien eu lieu, et FALSE sinon. Les erreurs + <function>ora_commitoff</function> retourne <literal>TRUE</literal> si la + désactivation a bien eu lieu, et <literal>FALSE</literal> sinon. Les erreurs sont accessibles avec les fonctions <function>ora_error</function> et <function>ora_errorcode</function>. </para> @@ -223,8 +224,8 @@ automatique après chaque <function>ora_exec</function>. </para> <para> - <function>ora_commiton</function> retourne TRUE si l'activation a - bien eu lieu, et FALSE sinon. Les erreurs sont accessibles avec les + <function>ora_commiton</function> retourne <literal>TRUE</literal> si l'activation a + bien eu lieu, et <literal>FALSE</literal> sinon. Les erreurs sont accessibles avec les fonctions <function>ora_error</function> et <function>ora_errorcode</function>. </para> </refsect1> @@ -250,7 +251,7 @@ et lire la première ligne du résultat. </para> <para> - <function>ora_do</function> retourne TRUE en cas de succès, et FALSE sinon. Le détails sur les erreurs est accessible avec les fonctions + <function>ora_do</function> retourne <literal>TRUE</literal> en cas de succès, et <literal>FALSE</literal> sinon. Le détails sur les erreurs est accessible avec les fonctions <function>ora_error</function> et <function>ora_errorcode</function>. </para> <para> @@ -335,8 +336,8 @@ <paramdef>int <parameter>cursor</parameter></paramdef> </funcsynopsis> <para> - <function>ora_exec</function> retourne TRUE en cas de succès, et - FALSE en cas d'erreur. L'erreur générée sera alors + <function>ora_exec</function> retourne <literal>TRUE</literal> en cas de succès, et + <literal>FALSE</literal> en cas d'erreur. L'erreur générée sera alors accessible avec les fonctions <function>ora_error</function> et <function>ora_errorcode</function>. </para> @@ -354,8 +355,8 @@ <paramdef>int <parameter>cursor</parameter></paramdef> </funcsynopsis> <para> - <function>ora_fetch</function> retourne TRUE (une ligne a - été lue) ou FALSE (plus de lignes à lire ou + <function>ora_fetch</function> retourne <literal>TRUE</literal> (une ligne a + été lue) ou <literal>FALSE</literal> (plus de lignes à lire ou erreur). Si une erreur survient, sa valeur sera disponible dans les fonctions <function>ora_error</function> et <function>ora_errorcode</function>. @@ -427,10 +428,10 @@ </funcsynopsis> <para> <function>ora_getcolumn</function> retourne la valeur de la - colonne. Si une erreur survient, FALSE est retourné et + colonne. Si une erreur survient, <literal>FALSE</literal> est retourné et <function>ora_errorcode</function> aura une valeur non nulle. - Notez, qu'un test à FALSE, avec cette fonction peut - être TRUE, même sans erreur : en effet, la fonction + Notez, qu'un test à <literal>FALSE</literal>, avec cette fonction peut + être <literal>TRUE</literal>, même sans erreur : en effet, la fonction peut retourner des valeurs telles que (résultat NULL, chaînes vides, nombre 0, la chaîne "0"). </para> @@ -448,8 +449,8 @@ <paramdef>int <parameter>connection</parameter></paramdef> </funcsynopsis> <para> - <function>ora_logoff</function> retourne TRUE si la fermeture a - bien eu lieu, et FALSE sinon. Les erreurs sont accessibles avec + <function>ora_logoff</function> retourne <literal>TRUE</literal> si la fermeture a + bien eu lieu, et <literal>FALSE</literal> sinon. Les erreurs sont accessibles avec les fonctions <function>ora_error</function> et <function>ora_errorcode</function>. </para> @@ -484,8 +485,10 @@ <acronym>TNS</acronym> de la manière suivante : <informalexample> <programlisting role="php"> -$conn = Ora_Logon("user<emphasis>@TNSNAME</emphasis>", "pass"); -</programlisting> +<?php +$conn = ora_logon("user<emphasis>@TNSNAME</emphasis>", "pass"); +?> + </programlisting> </informalexample> </para> <para> @@ -497,9 +500,9 @@ avant de le lancer. </para> <para> - Retourne un index de connexion, en cas de succès, ou - FALSE en cas d'échec. Les erreurs sont accessibles avec - les fonctions <function>ora_error</function> + <function>ora_logon</function> retourne un index de connexion, en cas de + succès, ou <literal>FALSE</literal> en cas d'échec. Les + erreurs sont accessibles avec les fonctions <function>ora_error</function> et <function>ora_errorcode</function>. </para> </refsect1> @@ -590,7 +593,7 @@ <function>ora_open</function> ouvre un pointeur Oracle sur la connexion. </para> <para> - Retourne TRUE si la fermeture a bien eu lieu, et FALSE sinon. + Retourne <literal>TRUE</literal> si la fermeture a bien eu lieu, et <literal>FALSE</literal> sinon. Les erreurs sont accessibles avec les fonctions <function>ora_error</function> et <function>ora_errorcode</function>. </para> @@ -643,7 +646,7 @@ <function>ora_commit</function> pour la définition d'une transaction). </para> <para> - Retourne TRUE si la fermeture a bien eu lieu, et FALSE sinon. Les erreurs sont + Retourne <literal>TRUE</literal> si la fermeture a bien eu lieu, et <literal>FALSE</literal> sinon. Les erreurs sont accessibles avec les fonctions <function>ora_error</function> et <function>ora_errorcode</function>. </para> Index: phpdoc/fr/functions/outcontrol.xml diff -u phpdoc/fr/functions/outcontrol.xml:1.8 phpdoc/fr/functions/outcontrol.xml:1.9 --- phpdoc/fr/functions/outcontrol.xml:1.8 Wed Dec 27 00:54:06 2000 +++ phpdoc/fr/functions/outcontrol.xml Fri Jan 26 06:44:21 2001 @@ -134,7 +134,7 @@ function d($str) { return strip_tags($str); } -?> +?> <?php ob_start("c"); ?> Au clair de la lune, mon ami Pierrot <?php ob_start("d"); ?> @@ -144,7 +144,6 @@ <?php ob_end_flush(); ?> ... Ouvre moi la porte, pour l'amour de Dieu <?php ob_end_flush(); ?> -?> </programlisting> </example> <para> @@ -170,7 +169,7 @@ </funcsynopsis> <para> <function>ob_get_contents</function> retourne le contenu du buffer - de sortie si la bufferisation est active, ou FALSE sinon. + de sortie si la bufferisation est active, ou <literal>FALSE</literal> sinon. </para> <para> Voir aussi <function>ob_start</function> et <function>ob_get_length</function>. @@ -194,7 +193,7 @@ </funcsynopsis> <para> <function>ob_get_length</function> retourne la longueur du contenu - du buffer de sortie si la bufferisation est activée, et FALSE sinon. + du buffer de sortie si la bufferisation est activée, et <literal>FALSE</literal> sinon. </para> <para> Voir aussi <function>ob_start</function> et <function>ob_get_contents</function>. Index: phpdoc/fr/functions/ovrimos.xml diff -u phpdoc/fr/functions/ovrimos.xml:1.3 phpdoc/fr/functions/ovrimos.xml:1.4 --- phpdoc/fr/functions/ovrimos.xml:1.3 Fri Dec 15 06:04:32 2000 +++ phpdoc/fr/functions/ovrimos.xml Fri Jan 26 06:44:21 2001 @@ -1,7 +1,6 @@ <reference id="ref.ovrimos"> <title>Ovrimos SQL</title> <titleabbrev>OvrimosSQL</titleabbrev> - <partintro> <para> Ovrimos SQL Server est une base de données relationnelle client/serveur @@ -39,7 +38,6 @@ Cet exemple effectue une connexion réussie. </para> </partintro> - <refentry id="function.ovrimos-connect"> <refnamediv> <refname>ovrimos_connect</refname> @@ -90,7 +88,6 @@ </para> </refsect1> </refentry> - <refentry id="function.ovrimos-close"> <refnamediv> <refname>ovrimos_close</refname> @@ -114,7 +111,6 @@ </para> </refsect1> </refentry> - <refentry id="function.ovrimos-close-all"> <refnamediv> <refname>ovrimos_close_all</refname> @@ -137,7 +133,6 @@ </para> </refsect1> </refentry> - <refentry id="function.ovrimos-longreadlen"> <refnamediv> <refname>ovrimos_longreadlen</refname> @@ -161,13 +156,13 @@ <para> <function>ovrimos_longreadlen</function> indique le nombre d'octets qui seront lus dans une colonne de grande taille (long varchar et long - varbinary). Par défaut, 0. Indépendemment du fait que cette fonction - requiert <parameter>result_id</parameter>, actuellement cette fonction - affecte ce paramètre pour tous les résultats. Retourne vrai. + varbinary). Par défaut, 0. Indépendemment du fait que + <function>ovrimos_longreadlen</function> requiert <parameter>result_id</parameter>, + actuellement <function>ovrimos_longreadlen</function> affecte ce paramètre + pour tous les résultats. Retourne vrai. </para> </refsect1> </refentry> - <refentry id="function.ovrimos-prepare"> <refnamediv> <refname>ovrimos_prepare</refname> @@ -187,7 +182,7 @@ </para> <para> <function>ovrimos_prepare</function> prépare une requête SQL - et retourne un identifiant de résultat result_id (ou FALSE en cas d'échec). + et retourne un identifiant de résultat result_id (ou <literal>FALSE</literal> en cas d'échec). </para> <para> <example> @@ -197,7 +192,7 @@ $conn=ovrimos_connect ("db_host", "8001", "admin", "password"); if ($conn!=0) { echo "Connection établie!"; - $res=ovrimos_prepare ($conn, "select table_id, table_name + $res=ovrimos_prepare ($conn, "select table_id, table_name from sys.tables where table_id=1"); if ($res != 0) { echo "Préparation faite!"; @@ -221,7 +216,6 @@ </para> </refsect1> </refentry> - <refentry id="function.ovrimos-execute"> <refnamediv> <refname>ovrimos_execute</refname> @@ -233,7 +227,7 @@ <funcprototype> <funcdef>int <function>ovrimos_execute</function></funcdef> <paramdef>int <parameter>result_id</parameter></paramdef> - <paramdef>array + <paramdef>array <parameter><optional>parameters_array</optional></parameter> </paramdef> </funcprototype> @@ -243,16 +237,15 @@ </para> <para> <function>ovrimos_execute</function> exécute une requête préparée. - Retourne true ou false. Si la requête préparée contient des + Retourne <literal>TRUE</literal> ou <literal>FALSE</literal>. Si la requête préparée contient des paramètres (des points d'interrogations dans la requête), un nombre - correct de paramètre doit être passé dans le tableau - <parameter>parameters_array</parameter>. Notez que cette fonction ne + correct de paramètre doit être passé dans le tableau + <parameter>parameters_array</parameter>. Notez que <function>ovrimos_execute</function> ne suit pas les conventions PHP qui placent les noms des paramètres entre crochets. L'auteur n'a pas pu s'y faire. </para> </refsect1> </refentry> - <refentry id="function.ovrimos-cursor"> <refnamediv> <refname>ovrimos_cursor</refname> @@ -270,17 +263,16 @@ <function>ovrimos_cursor</function> sert à lire le nom du curseur </para> <para> - <function>ovrimos_cursor</function> retourne le nom du curseur. + <function>ovrimos_cursor</function> retourne le nom du curseur. Pratique, lorsqu'on veut faire des modifications ou des effacements avec des curseurs déjà positionnés. </para> </refsect1> </refentry> - <refentry id="function.ovrimos-exec"> <refnamediv> <refname>ovrimos_exec</refname> - <refpurpose>Exécute une requête SQL</refpurpose> + <refpurpose>Exécute une requÍte SQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -297,12 +289,11 @@ <para> <function>ovrimos_exec</function> exécute une requête SQL (selection ou modification), et retourne un identifiant de résultat - result_id (ou bien false, en cas d'échec). Evidemment, la requête + result_id (ou bien <literal>FALSE</literal>, en cas d'échec). Evidemment, la requête SQL ne doit pas contenir de paramètres. </para> </refsect1> </refentry> - <refentry id="function.ovrimos-fetch-into"> <refnamediv> <refname>ovrimos_fetch_into</refname> @@ -315,10 +306,10 @@ <funcdef>int <function>ovrimos_fetch_into</function></funcdef> <paramdef>int <parameter>result_id</parameter></paramdef> <paramdef>array <parameter>result_array</parameter></paramdef> - <paramdef>string + <paramdef>string <parameter><optional>how</optional></parameter> </paramdef> - <paramdef>int + <paramdef>int <parameter><optional>rownumber</optional></parameter> </paramdef> </funcprototype> @@ -329,14 +320,14 @@ <para> <function>ovrimos_fetch_into</function> lit une ligne dans le résultat <parameter>result_id</parameter>, qui doit être passé - en référence. La ligne qui sera lue est déterminée par les deux + en référence. La ligne qui sera lue est déterminée par les deux paramètres <parameter><optional>how</optional></parameter> et - <parameter><optional>rownumber</optional></parameter>. + <parameter><optional>rownumber</optional></parameter>. <parameter><optional>how</optional></parameter> peut prendre les valeurs de 'Next' (suivant, valeur par défaut), 'Prev' (précédent), 'First' (premier), 'Last' (dernier), 'Absolute' (position absolue). La casse de <parameter><optional>how</optional></parameter> n'est pas prise en compte. <parameter><optional>rownumber</optional></parameter> - est optionne, sauf dans le cas d''Absolute'. Retourne TRUE ou FALSE. + est optionne, sauf dans le cas d''Absolute'. Retourne <literal>TRUE</literal> ou <literal>FALSE</literal>. </para> <para> <example> @@ -346,13 +337,13 @@ $conn=ovrimos_connect ("neptune", "8001", "admin", "password"); if ($conn!=0) { echo "Connection établie!"; - $res=ovrimos_exec ($conn,"select table_id, table_name from sys.tables"); + $res=ovrimos_exec ($conn,"SELECT table_id, table_name FROM sys.tables"); if ($res != 0) { echo "Requête effectuée!"; - if (ovrimos_fetch_into ($res, &$row)) { + if (ovrimos_fetch_into ($res, &$row)) { list ($table_id, $table_name) = $row; echo "table_id=".$table_id.", table_name=".$table_name."\n"; - if (ovrimos_fetch_into ($res, &$row)) { + if (ovrimos_fetch_into ($res, &$row)) { list ($table_id, $table_name) = $row; echo "table_id=".$table_id.", table_name=".$table_name."\n"; } else { @@ -372,7 +363,6 @@ </para> </refsect1> </refentry> - <refentry id="function.ovrimos-fetch-row"> <refnamediv> <refname>ovrimos_fetch_row</refname> @@ -384,10 +374,10 @@ <funcprototype> <funcdef>int <function>ovrimos_fetch_row</function></funcdef> <paramdef>int <parameter>result_id</parameter></paramdef> - <paramdef>int + <paramdef>int <parameter><optional>how</optional></parameter> </paramdef> - <paramdef>int + <paramdef>int <parameter><optional>row_number</optional></parameter> </paramdef> </funcprototype> @@ -397,7 +387,7 @@ </para> <para> <function>ovrimos_fetch_row</function> lit une ligne dans un résultat. - Les colonnes doivent être lues par un autre appel. Retourne true ou false. + Les colonnes doivent être lues par un autre appel. Retourne <literal>TRUE</literal> ou <literal>FALSE</literal>. </para> <para> <example> @@ -435,7 +425,6 @@ </para> </refsect1> </refentry> - <refentry id="function.ovrimos-result"> <refnamediv> <refname>ovrimos_result</refname> @@ -463,7 +452,6 @@ </para> </refsect1> </refentry> - <refentry id="function.ovrimos-result-all"> <refnamediv> <refname>ovrimos_result_all</refname> @@ -477,7 +465,7 @@ <funcprototype> <funcdef>int <function>ovrimos_result_all</function></funcdef> <paramdef>int <parameter>result_id</parameter></paramdef> - <paramdef>string + <paramdef>string <parameter><optional>format</optional></parameter> </paramdef> </funcprototype> @@ -488,7 +476,7 @@ </para> <para> <function>ovrimos_result_all</function> affiche le résultat de la requête - représentée par <parameter>result_id</parameter>. Retourne TRUE ou FALSE. + représentée par <parameter>result_id</parameter>. Retourne <literal>TRUE</literal> ou <literal>FALSE</literal>. </para> <para> <example> @@ -498,7 +486,7 @@ $conn = ovrimos_connect ("db_host", "8001", "admin", "password"); if ($conn != 0) { echo "Connection établie!"; - $res = ovrimos_prepare ($conn, "select table_id, table_name + $res = ovrimos_prepare ($conn, "select table_id, table_name from sys.tables where table_id = 7"); if ($res != 0) { echo "Préparation faite!"; @@ -522,22 +510,22 @@ </para> <para> <example> - <title><function>Ovrimos_result_all</function> avec meta-information</title> + <title><function>ovrimos_result_all</function> avec meta-information</title> <programlisting role="php"> <?php $conn = ovrimos_connect ("db_host", "8001", "admin", "password"); if ($conn != 0) { echo "Connection établie!"; - $res = ovrimos_exec ($conn, "select table_id, table_name + $res = ovrimos_exec ($conn, "select table_id, table_name from sys.tables where table_id = 1") if ($res != 0) { echo "Requête effectuée! cursor=".ovrimos_cursor ($res)."\n"; $colnb = ovrimos_num_fields ($res); echo "Output columns=".$colnb."\n"; - for ($i=1; $i<=$colnb; $i++) { + for ($i=1; $i<=$colnb; $i++) { $name = ovrimos_field_name ($res, $i); $type = ovrimos_field_type ($res, $i); - $len = ovrimos_field_len ($res, $i); + $len = ovrimos_field_len ($res, $i); echo "Colonne ".$i." nom=".$name." type=".$type." longueur=".$len."\n"; } ovrimos_result_all ($res); @@ -571,7 +559,6 @@ </para> </refsect1> </refentry> - <refentry id="function.ovrimos-num-rows"> <refnamediv> <refname>ovrimos_num_rows</refname> @@ -588,12 +575,11 @@ </funcprototype> </funcsynopsis> <para> - <function>ovrimos_num_rows</function> retourne le nombre de lignes + <function>ovrimos_num_rows</function> retourne le nombre de lignes affectées par une modification </para> </refsect1> </refentry> - <refentry id="function.ovrimos-num-fields"> <refnamediv> <refname>ovrimos_num_fields</refname> @@ -613,7 +599,6 @@ </para> </refsect1> </refentry> - <refentry id="function.ovrimos-field-name"> <refnamediv> <refname>ovrimos_field_name</refname> @@ -639,7 +624,6 @@ </para> </refsect1> </refentry> - <refentry id="function.ovrimos-field-type"> <refnamediv> <refname>ovrimos_field_type</refname> @@ -661,13 +645,12 @@ numérique d'une colonne. </para> <para> - <function>ovrimos_field_type</function> retourne le type numérique + <function>ovrimos_field_type</function> retourne le type numérique d'une colonne, identifiée par son numéro <parameter>field_number</parameter> dans le résultat <parameter>field_number</parameter>. </para> </refsect1> </refentry> - <refentry id="function.ovrimos-field-len"> <refnamediv> <refname>ovrimos_field_len</refname> @@ -687,13 +670,12 @@ d'une colonne. </para> <para> - <function>ovrimos_field_len</function> retourne la taille de la + <function>ovrimos_field_len</function> retourne la taille de la colonne <parameter>field_number</parameter>, dans le résultat <parameter>field_number</parameter>. </para> </refsect1> </refentry> - <refentry id="function.ovrimos-field-num"> <refnamediv> <refname>ovrimos_field_num</refname> @@ -721,7 +703,6 @@ </para> </refsect1> </refentry> - <refentry id="function.ovrimos-free-result"> <refnamediv> <refname>ovrimos_free_result</refname> @@ -740,11 +721,10 @@ </para> <para> <function>ovrimos_free_result</function> libère toutes les ressources prises - par le résultat <parameter>result_id</parameter>. Retourne TRUE. + par le résultat <parameter>result_id</parameter>. Retourne <literal>TRUE</literal>. </para> </refsect1> </refentry> - <refentry id="function.ovrimos-commit"> <refnamediv> <refname>ovrimos_commit</refname> @@ -759,7 +739,7 @@ </funcprototype> </funcsynopsis> <para> - <function>ovrimos_commit</function> sert à exécuter une + <function>ovrimos_commit</function> sert à exécuter une transaction. </para> <para> @@ -768,7 +748,6 @@ </para> </refsect1> </refentry> - <refentry id="function.ovrimos-rollback"> <refnamediv> <refname>ovrimos_rollback</refname> @@ -791,9 +770,7 @@ </para> </refsect1> </refentry> - - </reference> - + </reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml Index: phpdoc/fr/functions/pcre.xml diff -u phpdoc/fr/functions/pcre.xml:1.10 phpdoc/fr/functions/pcre.xml:1.11 --- phpdoc/fr/functions/pcre.xml:1.10 Wed Dec 20 02:11:46 2000 +++ phpdoc/fr/functions/pcre.xml Fri Jan 26 06:44:21 2001 @@ -10,6 +10,8 @@ n'est pas alphanumérique ou n'est pas un antislash (\). Si un délimiteur doit être utilisé dans l'expression, il faudra l'échapper avec un antislash. + Depuis PHP 4.0.4, vous pouvez utiliser les délimiteurs + (), {}, [], et <>, comme en Perl. </para> <para> Le délimiteur final peut être suivi d'options qui @@ -23,6 +25,7 @@ <listitem><simpara>/<\/\w+>/</simpara></listitem> <listitem><simpara>|(\d{3})-\d+|Sm</simpara></listitem> <listitem><simpara>/^(?i)php[34]/</simpara></listitem> + <listitem><simpara>{^\s+(\s+)?$}</simpara></listitem> </itemizedlist> </example> </para> @@ -84,22 +87,25 @@ etc.. </para> <para> - Retourne TRUE si la recherche à réussie, et - FALSE sinon (notamment en cas d'erreur). + Retourne <literal>TRUE</literal> si la recherche à réussie, et + <literal>FALSE</literal> sinon (notamment en cas d'erreur). </para> <para> <example> <title>Extraction d'un numéro de page d'une chaîne.</title> - <programlisting> + <programlisting role="php"> +<?php if (preg_match("/page\s+#(\d+)/i", "Go to page #9.", $parts)) print "La page suivante est $parts[1]"; else print "Page introuvable."; +?> </programlisting> </example> <example> <title>Trouve le mot "web"</title> <programlisting role="php"> +<?php // \b, dans le masque, indique une limite de mot, de façon à ce que le mot // "web" uniquement soit repéré, et pas seulement des parties de mots comme // dans "webbing" ou "cobweb" @@ -113,11 +119,13 @@ } else { print "Un mot n'a pas été trouvé."; } +?> </programlisting> </example> <example> <title>Lire un nom de domaine dans une URL</title> <programlisting role="php"> +<?php // repérer le nom de l'hôte dans l'URL preg_match("/^(http:\/\/)?([^\/]+)/i", "http://www.php.net/index.html", $matches); @@ -125,14 +133,14 @@ // repérer les deux derniers segments du nom de l'hôte preg_match("/[^\.\/]+\.[^\.\/]+$/",$host,$matches); echo "Le nom de domaine est : ".$matches[0]."\n"; +?> </programlisting> </example> Cet exemple va afficher : - <programlisting> + <computeroutput> Le nom de domaine est : php.net - </programlisting> - Voir aussi <function>preg_match_all</function>, - <function>preg_replace</function> + </computeroutput> + Voir aussi <function>preg_match_all</function>, <function>preg_replace</function> et <function>preg_split</function>. </para> </refsect1> @@ -178,18 +186,20 @@ résultats qui satisfont la première parenthèse capturante, etc.. <informalexample> - <programlisting> + <programlisting role="php"> +<?php preg_match_all("|<[^>]+>(.*)</[^>]+>|U", "<b>example: </b><div align=left>a test</div>", $out, PREG_PATTERN_ORDER); print $out[0][0].", ".$out[0][1]."\n"; -print $out[1][0].", ".$out[1][1]."\n" +print $out[1][0].", ".$out[1][1]."\n"; +?> </programlisting> </informalexample> Cet exemple va afficher : <informalexample> - <programlisting> + <computeroutput> <b>exemple: </b>, <div align=left>ceci est un test</div> exemple: , ceci est un test - </programlisting> + </computeroutput> </informalexample> Ainsi, $out[0] est un tableau qui contient les résultats qui satisfont le masque complet, @@ -206,18 +216,20 @@ série de résultat, $matches[1] contient la deuxième série de résultat, etc... <informalexample> - <programlisting> -preg_match_all("|<[^>]+>(.*)</[^>]+>|U", "<b>exemple: </b><div align=left>a test</div>", $out, PREG_SET_ORDER); + <programlisting role="php"> +<?php +preg_match_all("|<[^>]+>(.*)</[^>]+>|U", "<b>exemple: </b><div align=left>un test</div>", $out, PREG_SET_ORDER); print $out[0][0].", ".$out[0][1]."\n"; -print $out[1][0].", ".$out[1][1]."\n" +print $out[1][0].", ".$out[1][1]."\n"; +?> </programlisting> </informalexample> Cet exemple va afficher : <informalexample> - <programlisting> -<b>example: </b>, exemple: -<div align=left>this is a test</div>, this is a test - </programlisting> + <computeroutput> +<b>exemple: </b>, exemple: +<div align=left>un test</div>, un test + </computeroutput> </informalexample> Dans ce cas, $matches[0] est la première série de résultat, et $matches[0][0] contient le texte qui satisfait @@ -235,16 +247,18 @@ </para> <para> Retourne le nombre de résultat qui satisfont le masque - complet, ou FALSE en cas d'échec ou d'erreur. + complet, ou <literal>FALSE</literal> en cas d'échec ou d'erreur. </para> <para> <example> <title> Extraction de tous les numéros de téléphone d'un texte. </title> - <programlisting> + <programlisting role="php"> +<?php preg_match_all("/\(? (\d{3})? \)? (?(1) [\-\s] ) \d{3}-\d{4}/x", - "Call 555-1212 or 1-800-555-1212", $phones); + "Appelez 555-1212 ou 1-800-555-1212", $phones); +?> </programlisting> </example> </para> @@ -252,30 +266,32 @@ <example> <title>Recherche les couples de balises HTML (gourmand)</title> <programlisting role="php"> +<?php // Cet exemple utilise les références arrières (\\2). // Elles indiquent à l'analyseur qu'il doit trouver quelquechose qu'il // a déjà repéré un peu plus tôt (ici, ([\w]+)). -$html = "<b>bold text</b><a href=salut.html>clique moi</a> -preg_match_all ("/(<([\w]+)[^>]*>)(.*)(<\/\\2>)/", $html, $matches); +$html = "<B>Texte en gras</B><a href=salut.html>clique moi</?> +preg_match_all ("/(<([\w]+)[?>]?>)(.*)(<\/\\?>)/", $html, $matches); for ($i=0; $i< count($matches[0]); $i++) { echo "trouvé: ".$matches[0][$i]."\n"; echo "partie 1: ".$matches[1][$i]."\n"; echo "partie 2: ".$matches[3][$i]."\n"; echo "partie 3: ".$matches[4][$i]."\n\n"; } +?> </programlisting> </example> Cet exemple va produire : - <programlisting> -trouvé: <b>bold text</b> -partie 1: <b> -partie 2: bold text -partie 3: </b> -trouvé: <a href=salut.html>clique moi</a> + <computeroutput> +trouvé: <B>bold text</?> +partie 1: <B> +partie 2: Test en gras +partie 3: </B> +trouvé: <a href=salut.html>clique moi</?> partie 1: <a href=salut.html> partie 2: clique moi -partie 3: </a> - </programlisting> +partie 3: </?> + </computeroutput> </para> <simpara> Voir aussi <function>preg_match</function>, @@ -355,37 +371,49 @@ trouvera une erreur d'analyse (parse error) dans cette ligne. </para> <para> + <literal>/F</literal> indique que le paramètre + <parameter>replacement</parameter> doit être considéré comme un nom de fonction. + Cette fonction sera appelée, avec un tableau contenant les éléments trouvés comme + arguments. La fonctoin doit retourner la chaine de remplacement. Cette option + a été ajoutée en PHP 4.0.4. + </para> + <para> <example> <title>Remplacement de plusieurs valeurs</title> - <programlisting> + <programlisting role="php"> +<?php $patterns = array ("/(19|20)(\d{2})-(\d{1,2})-(\d{1,2})/", "/^\s*{(\w+)}\s*=/"); $replace = array ("\\3/\\4/\\1\\2", "$\\1 ="); print preg_replace ($patterns, $replace, "{startDate} = 1999-5-27"); +?> </programlisting> </example> Cet exemple va afficher : - <programlisting> + <computeroutput> $startDate = 5/27/1999 - </programlisting> + </computeroutput> <example> <title>Utilisation de l'option /e </title> - <programlisting> + <programlisting role="php"> +<?php preg_replace("/(<\/?)(\w+)([^>]*>)/e", "'\\1'.strtoupper('\\2').'\\3'", $html_body); +?> </programlisting> - <para> - Cela va mettre en majuscule toutes les balises HTML du texte. - </para> </example> + <para> + Cela va mettre en majuscule toutes les balises HTML du texte. + </para> <example> - <title>Conversion HTML en text</title> + <title>Conversion HTML en texte</title> <programlisting role="php"> +<?php // $document contient un document HTML // Ce script va effacer les balises HTML, les javascript // et les espaces. Il remplace aussi queqlues entitées HTML // courante en leur équivalent texte. -$search = array ("'<script[^>]*?>.*?</script>'si", // Supprime le javascript - "'<[\/\!]*?[^<>]*?>'si", // Supprime les balises HTML +$search = array ("'<script[?>]*?>.*?</script>'si", // Supprime le javascript + "'<[\/\!]*?[^<?>]*?>'si", // Supprime les balises HTML "'([\r\n])[\s]+'", // Supprime les espaces "'&(quot|#34);'i", // Supprime les entitees HTML "'&(amp|#38);'i", @@ -403,7 +431,7 @@ "\"", "&", "<", - ">", + ?>", " ", chr(161), chr(162), @@ -411,6 +439,7 @@ chr(169), "chr(\\1)"); $text = preg_replace ($search, $replace, $document); +?> </programlisting> </example> </para> @@ -472,10 +501,12 @@ <para> <example> <title>Eclatement d'une chaîne de recherche.</title> - <programlisting> + <programlisting role="php"> +<?php // scinde la phrase grâce aux virgules et espacements // ce qui inclus les " ", \r, \t, \n et \f $keywords = preg_split ("/[\s,]+/", "langage hypertexte, programmation"); +?> </programlisting> </example> </para> @@ -483,9 +514,11 @@ Scinder une chaîne en caractères </para> <programlisting role="php"> +<?php $str = 'string'; $chars = preg_split('//', $str, 0, PREG_SPLIT_NO_EMPTY); print_r($chars); +?> </programlisting> <para> Voir aussi <function>preg_match</function>, @@ -527,28 +560,31 @@ </para> <para> Les caractères spéciaux qui seront échappés : - <screen>. \\ + * ? [ ^ ] $ ( ) { } = ! < > | :</screen> + <screen>. \\ + * ? [ ^ ] $ ( ) { } = ! < > | :</screen> </para> <para> <example> - <title></title> + <title>Protège des caractères spéciaux</title> <programlisting role="php"> +<?php $keywords = "$40 pour un g3/400"; $keywords = preg_quote ($keywords, "/"); echo $keywords; // retourne \$40 pour un g3\/400 +?> </programlisting> </example> <example> <title>Mise en italique d'un mot dans un texte</title> <programlisting role="php"> +<?php // Dans cet exemple, preg_quote($word) sert à éviter que les astérisques -// prennent une valeur particulière dans l'exepression -// régulière. +// prennent une valeur particulière dans l'exepression régulière. $textbody = "Ce livre est *très* difficile à trouver."; $word = "*très*"; $textbody = preg_replace ("/".preg_quote($word)."/", - "<i>".$word."</i>", + "<B>".$word."</B>", $textbody); +?> </programlisting> </example> </para> @@ -577,8 +613,10 @@ <example> <title>Exemple avec <function>preg_grep</function></title> <programlisting role="php"> +<?php // recherche les nombres à virgule flottante preg_grep("/^(\d+)?\.\d+$/", $array); +?> </programlisting> </example> </para> @@ -601,15 +639,15 @@ <blockquote> <variablelist> <varlistentry> - <term><emphasis>i</emphasis> (PCRE_CASELESS)</term> - <listitem> - <simpara> - Effectue une recherche insensible à la casse. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><emphasis>m</emphasis> (PCRE_MULTILINE)</term> + <term><emphasis>i</emphasis> (PCRE_CASELESS)</term> + <listitem> + <simpara> + Effectue une recherche insensible à la casse. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><emphasis>m</emphasis> (PCRE_MULTILINE)</term> <listitem> <simpara> Par défaut, PCRE traite la chaîne sujet comme une seule @@ -677,6 +715,7 @@ substitution normale des références arrières dans la chaîne de remplacement, puis l'évalue comme un code PHP, et utilise le résultat pour remplacer la chaîne de recherche. + Cette optoin ne peut pas être utilisée avec <literal>/F modifier</literal>. </simpara> <simpara> Seule <function>preg_replace</function> utilise cette option. Elle est @@ -685,6 +724,22 @@ </listitem> </varlistentry> <varlistentry> + <term><emphasis>F</emphasis></term> + <listitem> + <simpara> + Avec cette option, <function>preg_replace</function> considère le paramètre + de remplacement comme un nom de fonction, qui doit être appelé pour fournir + la chaîne de remplacement. La fonction recoit un tableau d'éléments trouvés. + Cette option ne peut pas être utilisée avec l'option <literal>/e</literal>. + </simpara> + <simpara> + <function>preg_replace</function> seuelement utilise cette option. + Elle est ignorée par les autres fonctions PCRE. Cette option a été ajoutée + en PHP 4.0.4. + </simpara> + </listitem> + </varlistentry> + <varlistentry> <term><emphasis>A</emphasis> (PCRE_ANCHORED)</term> <listitem> <simpara> @@ -778,75 +833,153 @@ </refsect1> <refsect1> <title>Différences avec Perl</title> - <literallayout> + <para> Les différences avec le Perl 5.005 sont présentée ici : - 1. Par défaut, un caractère d'espacement correspond à n'importe quel caractère - que la fonction C isspace() reconnaît, bien qu'il soit possible de recompiler - la bibliothèque PCRE avec d'autres tables de caractères. Normalement, isspace() - retourne TRUE pour les espaces, les retours chariot, les nouvelles lignes, les - formfeed, les tabulations verticales et horizontales. Le Perl 5 n'accepte plus - la tabulation verticale comme caractère d'espacement. La séquence \v qui était - dans la documentation Perl depuis longtemps n'a jamais été reconnue. Cependant, - la tabulation verticale elle-même était reconnue comme un caractère d'espacement - jusqu'à la version 5.002. Avec les version 5.004 et 5.005, l'option \s l'ignore. - 2. PRCE ne tolère pas la répétition de quantificateurs dans les expressions. Perl - le permet, mais cela ne signifie pas ce que vous pourriez penser. Par exemple, - (?!a){3} ne s'interprète pas : les trois caractères suivants ne sont pas des - "a". En fait, cela s'interprète comme : le caractère suivant n'est pas "a" trois - fois. - 3. Les occurrences de sous-masques qui interviennent dans des assertions négatives - sont comptées, mais elles ne sont pas enregistrées dans le vecteur - d'occurrences. Perl modifie ses variables numériques pour toutes les occurrences - de sous masque, avant que l'assertion ne vérifie le masque entier, et - uniquement si les sous masques ne trouvent qu'une seule occurrence. - 4. Bien que les caractères nul soient tolérés dans la chaîne de recherche, ils ne - sont pas acceptés dans le masque, car le masque est utilisé comme une chaîne C - standard, terminée par le caractère nul. Il faut donc utiliser la séquence - d'échappement "\0" dans le masque pour rechercher les caractères nul. - 5. Les séquence d'échappement suivantes ne sont pas supportées par le Perl: \l, - \u, \L, \U, \E, \Q. En fait, elles sont implémentées par la gestion intrinsèque - de chaînes du Perl, et ne font pas partie de ses caractères spéciaux. - 6. L'assertion \G du Perl n'est pas supportée car elle n'est pas pertinente pour - faire des recherches avec des masques uniques. - 7. De manière assez évidente, PCRE n'accepte pas la construction (?{code}) - 8. Au moment de l'écriture de PCRE, Perl 5.005_02 avait quelques comportement - étranges avec la capture des chaînes lorsqu'une partie du masque est redoublée. - Par exemple, "aba" avec le masque /^(a(b)?)+$/ va affecter à $2 la valeur "b", - mais la même manipulation avec "aabbaa" et /^(aa(bb)?)+$/ laissera $2 vide. - Cependant, si le masque est remplacé par /^(aa(b(b))?)+$/ alors $2 (et - d'ailleurs $3) seront correctement affectés. Avec le Perl 5.004, $2 sera - correctement affecté dans les deux cas, et c'est aussi vrai avec PCRE. Si Perl - évolue vers un autre comportement cohérent, PCRE s'adaptera probablement - 9. Une autre différence encore non résolue est le fait qu'en Perl 5.005_02 le - masque /^(a)?(?(1)a|b)+$/ accepte la chaîne "a", tandis que PCRE ne l'accepte - pas. Cependant, que ce soit avec Perl ou PCRE /^(a)?a/ et "a" laisseront $1 - vide. - 10. PCRE propose quelques extensions aux expressions régulières du Perl. - (a) Bien que les assertions avec retour (lookbehind) soit obligée d'apparier - une chaîne de longueur fixe, toutes les assertions avec retour peuvent avoir - une longueur différente. Perl 5.005 leur impose d'avoir toutes la même longueur. - (b) Si PCRE_DOLLAR_ENDONLY est mis, et que PCRE_MULTILINE n'est pas mis, le - méta caractère $ ne s'applique qu'à la fin physqiue de la chaîne, et non - pas avant les caractères de nouvelle ligne. - (c) Si PCRE_EXTRA est mis, un antislash suivi d'une lettre sans signification - spéciale est considérée comme une erreur. - (d) SI PCRE_UNGREEDY est mis, la "gourmandise" des quantificateurs de - répétition est inversées, ce qui est rend non gourmand par défaut, mais si - ils sont suivis de ?, il seront gourmands. - </literallayout> + <orderedlist> + <listitem> + <simpara> + Par défaut, un caractère d'espacement correspond à + n'importe quel caractère que la fonction C isspace() reconnaît, + bien qu'il soit possible de recompiler la bibliothèque PCRE avec + d'autres tables de caractères. Normalement, isspace() retourne + <literal>TRUE</literal> pour les espaces, les retours chariot, les + nouvelles lignes, les formfeed, les tabulations verticales et horizontales. + Le Perl 5 n'accepte plus la tabulation verticale comme caractère + d'espacement. La séquence \v qui était dans la documentation + Perl depuis longtemps n'a jamais été reconnue. Cependant, la + tabulation verticale elle-même était reconnue comme un + caractère d'espacement jusqu'à la version 5.002. Avec les + version 5.004 et 5.005, l'option \s l'ignore. + </simpara> + </listitem> + <listitem> + <simpara> + PRCE ne tolère pas la répétition de quantificateurs + dans les expressions. Perl le permet, mais cela ne signifie pas ce que vous + pourriez penser. Par exemple, (?!a){3} ne s'interprète pas : les trois + caractères suivants ne sont pas des "a". En fait, cela + s'interprète comme : le caractère suivant n'est pas "a" trois fois. + </simpara> + </listitem> + <listitem> + <simpara> + Les occurrences de sous-masques qui interviennent dans des assertions + négatives sont comptées, mais elles ne sont pas + enregistrées dans le vecteur d'occurrences. Perl modifie ses + variables numériques pour toutes les occurrences de sous-masque, + avant que l'assertion ne vérifie le masque entier, et uniquement si + les sous-masques ne trouvent qu'une seule occurrence. + </simpara> + </listitem> + <listitem> + <simpara> + Bien que les caractères nul soient tolérés dans la + chaîne de recherche, ils ne sont pas acceptés dans le masque, + car le masque est utilisé comme une chaîne C standard, + terminée par le caractère nul. Il faut donc utiliser la + séquence d'échappement "\0" dans le masque pour rechercher + les caractères nul. + </simpara> + </listitem> + <listitem> + <simpara> + Les séquence d'échappement suivantes ne sont pas supportées + par le Perl: \l, \u, \L, \U, \E, \Q. En fait, elles sont implémentées + par la gestion intrinsèque de chaînes du Perl, et ne font pas partie + de ses caractères spéciaux. + </simpara> + </listitem> + <listitem> + <simpara> + L'assertion \G du Perl n'est pas supportée car elle n'est pas pertinente + pour faire des recherches avec des masques uniques. + </simpara> + </listitem> + <listitem> + <simpara> + De manière assez évidente, PCRE n'accepte pas la construction (?{code}) + </simpara> + </listitem> + <listitem> + <simpara> + Au moment de l'écriture de PCRE, Perl 5.005_02 avait quelques + comportements étranges avec la capture des chaînes + lorsqu'une partie du masque est redoublée. Par exemple, "aba" avec + le masque /^(a(b)?)+$/ va affecter à $2 la valeur "b", mais la + même manipulation avec "aabbaa" et /^(aa(bb)?)+$/ laissera $2 vide. + Cependant, si le masque est remplacé par /^(aa(b(b))?)+$/ alors $2 (et + d'ailleurs $3) seront correctement affectés. Avec le Perl 5.004, + $2 sera correctement affecté dans les deux cas, et c'est aussi + vrai avec PCRE. Si Perl évolue vers un autre comportement + cohérent, PCRE s'adaptera probablement + </simpara> + </listitem> + <listitem> + <simpara> + Une autre différence encore non résolue est le fait qu'en + Perl 5.005_02 le masque /^(a)?(?(1)a|b)+$/ accepte la chaîne "a", + tandis que PCRE ne l'accepte pas. Cependant, que ce soit avec Perl ou + PCRE /^(a)?a/ et "a" laisseront $1 vide. + </simpara> + </listitem> + <listitem> + <simpara> + PCRE propose quelques extensions aux expressions régulières du Perl. + <orderedlist> + <listitem> + <simpara> + (a) Bien que les assertions avec retour (lookbehind) soit obligée + d'apparier une chaîne de longueur fixe, toutes les assertions avec + retour peuvent avoir une longueur différente. Perl 5.005 leur + impose d'avoir toutes la même longueur. + </simpara> + </listitem> + <listitem> + <simpara> + (b) Si PCRE_DOLLAR_ENDONLY est mis, et que PCRE_MULTILINE n'est pas mis, + le méta caractère $ ne s'applique qu'à la fin + physqiue de la chaîne, et non pas avant les caractères + de nouvelle ligne. + </simpara> + </listitem> + <listitem> + <simpara> + (c) Si PCRE_EXTRA est mis, un antislash suivi d'une lettre sans signification + spéciale est considérée comme une erreur. + </simpara> + </listitem> + <listitem> + <simpara> + (d) SI PCRE_UNGREEDY est mis, la "gourmandise" des quantificateurs de + répétition est inversées, ce qui est rend non + gourmand par défaut, mais si ils sont suivis de ?, il seront + gourmands. + </simpara> + </listitem> + </orderedlist> + </simpara> + </listitem> + </orderedlist> + </para> </refsect1> - <refsect1> + <refsect1 id="regexp.reference"> <title>Détails sur les expressions régulières</title> - <literallayout> - La syntaxe et la sémantique des expressions régulière supportées par PCRE sont - décrites ci-dessous. Les expressions régulières sont aussi décrites dans la - documentation Perl, et dans un grand nombre d'autres livres, avec de nombreux - exemples. Jeffrey Friedl's "Mastering Regular Expressions", édité chez O'Reilly - (ISBN 1-56592-257-3), les décrits en profondeur. Cette description est organisée - comme une documentation de référence. - Une expression régulière est un masque, qui est appliqué sur une chaîne sujet, - de gauche à droite. La plus part des caractères se représentent eux-mêmes. Un - exemple trivial : un masque qui serait + <para> + La syntaxe et la sémantique des expressions régulière + supportées par PCRE sont décrites ci-dessous. Les expressions + régulières sont aussi décrites dans la documentation + Perl, et dans un grand nombre d'autres livres, avec de nombreux exemples. + Jeffrey Friedl's "Mastering Regular Expressions", édité + chez O'Reilly (ISBN 1-56592-257-3), les décrits en profondeur. + Cette description est organisée comme une documentation de + référence. + </para> + <refsect2 id="regexp.reference.intro"> + <title>Just a title</title> + <para> + Une expression régulière est un masque, qui est appliqué + sur une chaîne sujet, de gauche à droite. La plus part des + caractères se représentent eux-mêmes. Un exemple trivial : un masque qui serait Le rapide renard gris Pourra correspondre à une partie de la chaîne sujet qui sera identique au masque. La puissance des expressions régulières provient de leur capacité à autoriser des @@ -854,6 +987,11 @@ dans le masque par des <emphasis>meta</emphasis>-<emphasis>characters</emphasis>, qui ne représentent pas ce qu'ils sont, mais sont interprétés d'une certaine manière. + </para> + </refsect2> + <refsect2 id="regexp.reference.meta"> + <title>Just a title</title> + <para> Il y a deux sortes de méta-caractères : ceux qui sont reconnus n'importe oú dans un masque, hormis entre crochets, et ceux qui sont reconnus entre crochets. A l'extérieur des crochets, les méta caractères sont : @@ -865,8 +1003,8 @@ [ Caractère de début de définition de classe ] Caractère de fin de définition de classe | Caractère de début d'alternative - ( Caractère de début de sous masque - ) Caractère de fin de sous masque + ( Caractère de début de sous-masque + ) Caractère de fin de sous-masque ? Etend le sens de ( mais aussi quantificateur de 0 ou 1 mais aussi quantificateur de minimisation @@ -880,31 +1018,36 @@ - indique un intervalle de caractères ] termine la classe de caractères La section suivante décrit l'utilisation de chaque méta caractères : + </para> + </refsect2> + <refsect2 id="regexp.reference.backslash"> + <title>Just a title</title> + <para> ANTISLASH - Le caractère antislash a de nombreuses utilisations. En premier - lieu, s'il est suivi d'un caractère non alpha numérique, - il ne prendra pas la signification spéciale qui y est - rattachée. Cette utilisation de l'antislash comme - caractère d'échappement s'applique à - l'intérieur et à l'extérieur des classes - de caractères. Par exemple, pour recherche le caractère - étoile "*", il faut écrire dans le masque : "\*". Cela + Le caractère antislash a de nombreuses utilisations. En premier + lieu, s'il est suivi d'un caractère non alpha numérique, + il ne prendra pas la signification spéciale qui y est + rattachée. Cette utilisation de l'antislash comme + caractère d'échappement s'applique à + l'intérieur et à l'extérieur des classes + de caractères. Par exemple, pour recherche le caractère + étoile "*", il faut écrire dans le masque : "\*". Cela s'applique dans tous les cas, que le caractère qui suive - soit un méta-caractère ou non. C'est un moyen sûr - pour s'assurer qu'un caractère sera recherché pour sa valeur + soit un méta-caractère ou non. C'est un moyen sûr + pour s'assurer qu'un caractère sera recherché pour sa valeur litérale, plutot que pour sa valeur spéciale. En particulier, pour rechercher les antislash, il faut écrire : "\\". - Si un masque est utilisé avec l'option PCRE_EXTENDED, les espaces - blancs du masque, mais qui ne sont pas dans une classe de caractères, - et les caractères entre dièses "#", ainsi que les nouvelles - lignes sont ignorées. L'antislash peut être utilisé + Si un masque est utilisé avec l'option PCRE_EXTENDED, les espaces + blancs du masque, mais qui ne sont pas dans une classe de caractères, + et les caractères entre dièses "#", ainsi que les nouvelles + lignes sont ignorées. L'antislash peut être utilisé pour échapper et ainsi rechercher un espace ou un dièse. - La deuxième utilité de l'antislash est de pouvoir coder des - caractères invisibles dans les masques. Il n'y a pas de restriction - sur la place de ces caractères invisibles, hormis pour le + La deuxième utilité de l'antislash est de pouvoir coder des + caractères invisibles dans les masques. Il n'y a pas de restriction + sur la place de ces caractères invisibles, hormis pour le caractère nul qui doit terminer le masque. Lors de la - préparation du masque, il est souvent plus pratique d'utiliser - les séquences d'échappement suivantes, plutôt que + préparation du masque, il est souvent plus pratique d'utiliser + les séquences d'échappement suivantes, plutôt que le caractère binaire qu'elle représente : \a alarme, c'est à dire le caractère BEL (hex 07) \cx "control-x", avec x qui peut être n'importe quel caractère. @@ -1000,6 +1143,11 @@ La différence entre \Z et \z tient au fait que \Z recherche les positions avant les nouvelles lignes et à la fin de la chaîne sujet, tandis que \z ne recherche que la fin de la chaîne. + </para> + </refsect2> + <refsect2 id="regexp.reference.circudollar"> + <title>Just a title</title> + <para> CIRCUMFLEX et DOLLAR En dehors d'une classe de caractère, avec les options par défaut, ^ est une assertion qui n'est vraie que si elle est placée tout au début de la @@ -1032,6 +1180,11 @@ Notez que les méta caractères \A, \Z, et \z peuvent servir à répérer le début et la fin du sujet, et toutes les parties du masque qui commenceront par \A seront toujours ancrées, avec l'option PCRE_MULTILINE ou non. + </para> + </refsect2> + <refsect2 id="regexp.reference.dot"> + <title>Just a title</title> + <para> FULL STOP (PERIOD, DOT) En dehors d'une classe de caractères, un point remplace n'importe quel caractère, même invisible et à l'exception du caractère de nouvelle ligne. Avec l'option @@ -1040,6 +1193,11 @@ Le seul point commun est que les deux ont un comportement particulier vis à vis des caractère de nouvelle ligne. Le point n'a pas de comportement particulier dans une classe de caractères. + </para> + </refsect2> + <refsect2 id="regexp.reference.squarebrackets"> + <title>Just a title</title> + <para> SQUARE BRACKETS Un crochet ouvrant introduit une classe de caractère, et le crochet fermant la conclut. Le crochet fermant n'a pas de signification en lui même. Si le crochet @@ -1090,14 +1248,24 @@ Tous les caractères non alphanumériques autres que \, -, ^ (placé en début de chaîne) et ] n'ont pas de significations particulière, mais ils ne perdront rien à être échappés. + </para> + </refsect2> + <refsect2 id="regexp.reference.verticalbar"> + <title>Just a title</title> + <para> VERTICAL BAR La barre verticale sert à séparer des alternatives. Par exemple, dans le masque dupont|martin recherche soit "dupont", soit " martin ". Le nombre d'alternative n'est pas limité, et il est même possible d'utiliser la chaîne vide. Lors de la recherche, toutes les alternatives sont essayées, de gauche à droit, et la première qui est - acceptée, est utilisée. Si les alternatives sont dans un sous masque, elle ne + acceptée, est utilisée. Si les alternatives sont dans un sous-masque, elle ne réussiront que si le masque principal réussi aussi. + </para> + </refsect2> + <refsect2 id="regexp.reference.internal_options"> + <title>Just a title</title> + <para> INTERNAL OPTION SETTING Les options PCRE_CASELESS, PCRE_MULTILINE, PCRE_DOTALL, et PCRE_EXTENDED peuvent être changée depuis le masque lui-même, avec des séquences mises "(?" et ")". @@ -1112,7 +1280,7 @@ annulera les options PCRE_DOTALL et PCRE_EXTENDED. Si une option apparaît avant et après le signe moins, l'option sera annulée. Le domaine d'application de ces options dépend de la position de la séquence - d'option. Pour toutes les séquences d'options qui sont hors des sous masques + d'option. Pour toutes les séquences d'options qui sont hors des sous-masques (définis plus loin), l'effet est le même que si l'option avait été fixée dès le début de la recherche. Les exemples suivants se comportent tous de la même façons : @@ -1123,11 +1291,11 @@ et sont parfaitement équivalents au masque abc avec l'option PCRE_CASELESS. En d'autres termes, mettre des séquences d'options dans le corps principal du masque revient à appliquer l'option à tout le masque, sauf ordre contraire dans - les sous masques. Si il y a plusieurs séquences d'option qui portent sur la même + les sous-masques. Si il y a plusieurs séquences d'option qui portent sur la même optin, la dernière s'appliquera. Si une option intervient dans un sous-masque, le comportement est différent. C'est un changement de comportement apparu en Perl 5.005. Une option à l'intérieur - d'un sous masque n'affecte que cette partie du masque, ce qui fait que + d'un sous-masque n'affecte que cette partie du masque, ce qui fait que (a(?i)b)c acceptera abc et aBc mais aucune autre chaîne (en supposant que PCRE_CASELESS n'est pas utilisé). Cela signifie que les options permettent d'avoir différente @@ -1142,45 +1310,55 @@ U et X. L'option (?X) est particulière, car elle doit toujours intervenir avant toutes les autres options, même au niveau du masque entier. Il vaut mieux la mettre au début du masque. + </para> + </refsect2> + <refsect2 id="regexp.reference.subpatterns"> + <title>Just a title</title> + <para> SUBPATTERNS - Les sous masques sont délimités par des parenthèses, et peuvent être imbriquées. - Ajouter des sous masques a deux utilités : + Les sous-masques sont délimités par des parenthèses, et peuvent être imbriquées. + Ajouter des sous-masques a deux utilités : 1. Délimiter des alternatives. Par exemple, le masque cat(aract|erpillar|) acceptera les mots "char", "chardon", ou "charmant". Sans les parenthèses, il n'accepterait que "chardon", "mant" ou la chaîne vide. - 2. Le sous masque est considéré comme capturante : Lorsqu'une - chaîne sujet est acceptée par le masque complet, les sous - masques sont transmis à l'appelant grâce à un vecteur - de sous masques. Les parenthèses ouvrantes sont comptées de + 2. Le sous-masque est considéré comme capturante : Lorsqu'une + chaîne sujet est acceptée par le masque complet, les sous + masques sont transmis à l'appelant grâce à un vecteur + de sous-masques. Les parenthèses ouvrantes sont comptées de gauche à droite, (commencant à 1). - Par exemple, soit la chaîne sujet "le roi soleil " qui est + Par exemple, soit la chaîne sujet "le roi soleil " qui est utilisée avec le masque suivant : Le ((roi|prince) (soleil|charmant)) - les sous masques capturé sont "roi soleil ", "roi", et "soleil", numérotés + les sous-masques capturé sont "roi soleil ", "roi", et "soleil", numérotés respectivement 1, 2, et 3. - L'ubiquité des parenthèses n'est pas toujours simple - d'emploi. Il y a des moments oú regrouper des sous masques + L'ubiquité des parenthèses n'est pas toujours simple + d'emploi. Il y a des moments oú regrouper des sous-masques est nécessaire, sans pour autant capturer - la valeur trouvée. Si une parenthèse ouvrante est suivie de "?:", le sous masque + la valeur trouvée. Si une parenthèse ouvrante est suivie de "?:", le sous-masque ne capture pas la chaîne assortie, et ne sera pas compté lors de la numérotation des captures. Par exemple, avec la chaîne "le prince charmant", utilisé avec le masque pattern Le (( ?roi|prince) (soleil|charmant)) les chaînes capturées seront "prince charmant " et "charmant", numérotés respectivement 1 et 2. Le nombre maximal de chaîne capturées est de 99, et le - nombre total de sous masque (capturant ou non) ne doit pas dépasser 200. + nombre total de sous-masque (capturant ou non) ne doit pas dépasser 200. (?i:samedi|dimanche) (?:(?i) samedi | dimanche) De plus, comme les séquences d'options sont valables sur toute une alternative, le masque ci dessus acceptera aussi "DIMANCHE" que "Dimanche". + </para> + </refsect2> + <refsect2 id="regexp.reference.repetitions"> + <title>Just a title</title> + <para> REPETITION les Répétitions sont spécifiées avec des quantificateurs, qui peuvent être placés à la suite des caractères suivants : Un caractère unique, même s'il s'agit d'un méta caractère Une classe de caractères Une référence de retour (Voir section suivante) - Un sous masque avec parenthèses (a moins que ce ne soit une assertion, voir plus + Un sous-masque avec parenthèses (a moins que ce ne soit une assertion, voir plus loin) Les quantificateurs généraux précisent un nombre minimum et maximum de répétitions possibles, donnés par deux nombres entre accolades, et séparés par une virgule. @@ -1204,14 +1382,14 @@ * équivalent à {0,} + équivalent à {1,} ? équivalent à {0,1} - Il est possible de constituer des boucles infinies en créant un sous masque + Il est possible de constituer des boucles infinies en créant un sous-masque sans caractères, mais pourvu d'un quantificateur sans limite supérieure. Par exemple (a?)* Les versions plus anciennes de Perl et PCRE généraient alors une erreur au moment de la compilation. Cependant, étant donné qu'il existe des situations oú ces constructions peuvent être utiles, ces masques sont désormais autorisés. - Cependant, si la répétion du sous masque ne trouve aucun caractère, la boucle est + Cependant, si la répétion du sous-masque ne trouve aucun caractère, la boucle est interrompue. Par défaut, les quantificateurs sont "gourmands", c'est à dire, qu'ils cherchent d'abord à trouve le nombre maximal de répétitions qui autorise le succès de la @@ -1239,7 +1417,7 @@ Perl) alors les quantificateurs sont non gourmand par défaut, mais peuvent être rendu gourmand au cas par cas, en ajoutant un point d'interrogation après. En d'autres termes, cette option inverse le comportement par défaut. - Lorsqu'un sous masque est quantifié avec un nombre minimum de répétition, qui + Lorsqu'un sous-masque est quantifié avec un nombre minimum de répétition, qui soit plus grand que 1, ou avec un maximum de répétition, le masque compilé aura besoin de plus de place de stockage, proportionnellement au minimum et au maximum. @@ -1251,37 +1429,42 @@ n'y aura pas de caractère de nouvelle ligne, mettre l'option PCRE_DOTALL et commencer le masque par.* permet d'optmiser le masque. Alternativement, on peut utiliser ^ pour ancrer explicitement le masque. - Lorsqu'un sous masque capturant est répété, la valeur capturée est la dernière. + Lorsqu'un sous-masque capturant est répété, la valeur capturée est la dernière. Par exemple, après que (inter[net]{3}\s*)+ *)+ ai été appliqué à "internet interne" la valeur de la chaîne capturée est - "interne". Cependant, si il y a des sous masques imbriqués, la valeur capturée + "interne". Cependant, si il y a des sous-masques imbriqués, la valeur capturée correspondante peut l'avoir été lors des précédentes itérations. Par exemple : /(a|(b))+/ accepte "aba" et la deuxième valeur capturée est + </para> + </refsect2> + <refsect2 id="regexp.reference.back_references"> + <title>Just a title</title> + <para> Références arrières (back references) En dehors des classes de caractères, un antislash suivi d'un nombre plus grand que 0 (et possiblement plusieurs chiffres) est une référence arrière (c'est à dire vers la gauche) dans le masque, en supposant qu'il y ait suffisamment de - sous masques capturant précédent. - Cependant, si le nombre décimal suivant l'antislash est plus petit + sous-masques capturant précédent. + Cependant, si le nombre décimal suivant l'antislash est plus petit que 10, il sera toujours considéré comme une référence arrière, et cela générera une erreur si le nombre de capture n'est pas suffisant. En d'autres termes, il faut qu'il existe suffisamment de parenthèses ouvrantes à gauche de la référence, surtout si la référence est inférieure à 10. Reportez vous à la section "antislash" pour avoir de plus amples détails à propos du nombre de chiffres qui suivent l'antislash. - La référence arrière remplace ce qui a été capturé par un sous masque dans le - masque courant, plutôt que remplace le sous masque lui même. Ainsi + La référence arrière remplace ce qui a été capturé par un sous-masque dans le + masque courant, plutôt que remplace le sous-masque lui même. Ainsi (calme|rapide) et \1ment trouvera "calme et calmement " et "rapide et rapidement ", mais pas " calme et rapidement ". Si la recherche tiens compte de la casse, alors la casse de la chaîne capturée sera importante. Par exemple, ((?i)rah)\s+\1 - trouve "rah rah" et "RAH RAH", mais pas "RAH rah", même si le sous masque + trouve "rah rah" et "RAH RAH", mais pas "RAH rah", même si le sous-masque capturant initial ne tenait pas compte de la casse. - Il peut y avoir plusieurs références arrières dans le même sous masque. Si un - sous masque n'a pas été utilisé dans une recherche, alors les références arrières + Il peut y avoir plusieurs références arrières dans le même sous-masque. Si un + sous-masque n'a pas été utilisé dans une recherche, alors les références arrières échoueront. Par exemple (a|(bc))\2 ne réussira jamais si la chaîne sujet commence par "a" plutôt que par "bc". @@ -1292,25 +1475,30 @@ l'option PCRE_EXTENDED est mise, on peut utiliser un espace. Sinon, un commentaire vide fait l'affaire. Une référence arrière qui intervient à l'intérieur de parenthèses auquel - elle fait référence échouera dès que le sous masque sera utilisé. Par exemple, + elle fait référence échouera dès que le sous-masque sera utilisé. Par exemple, (a\1) échouera toujours. Cependant, ces références peuvent être utiles dans les - sous masques répétitifs. Par exemple, le masque + sous-masques répétitifs. Par exemple, le masque (a|b\1)+ - pourra convenir pour "a", "aba", "ababaa" etc. A chaque itération du sous masque, - la référence arrière utilise le résultat du dernier sous masque. Pour que cela + pourra convenir pour "a", "aba", "ababaa" etc. A chaque itération du sous-masque, + la référence arrière utilise le résultat du dernier sous-masque. Pour que cela fonctionne, il faut que la première itération n'ai pas besoin d'utiliser la référence arrière. Cela arrive avec les alternatives, comme dans l'exemple ci dessus, ou avec un quantificateur de minimum 0. + </para> + </refsect2> + <refsect2 id="regexp.reference.assertions"> + <title>Just a title</title> + <para> Les assertions Une assertion est un test sur les caractères suivants ou précédent celui qui est en cours d'étude. Ce test ne consomme par de caractère (ie, on ne déplace pas le pointeur de caractères). Les assertions simples sont codées avec \b, \B, \A, \Z, \z, ^ et $, et sont décrite précédemment. Il existe cependant un type - d'assertion plus complexe, codées sous la forme de sous masques. Il en existe + d'assertion plus complexe, codées sous la forme de sous-masques. Il en existe deux types : ceux qui travaille au dela de la position courante, et ceux qui travaille en deça. \w+(?=;) - Une assertion se comporte comme un sous masque, hormis le fait qu'elle ne + Une assertion se comporte comme un sous-masque, hormis le fait qu'elle ne déplace pas le pointeur de position. Les assertions avant commencent par (?= pour les assertions positives et par (?! pour des assertions négatives. Par exemple : foo(?!bar) @@ -1321,7 +1509,7 @@ quelque chose d'autre que "foo"; il trouve toutes les occurrences de "bar", quelque soit ce qui le précéde, car l'assertion (?!foo) est toujours vraie quand les trois caractères suivants sont "bar". Une assertion arrière est ici nécessaire. - Ces assertions commencent par (?<= pour les assertions positives, et (?<! + Ces assertions commencent par (?<= pour les assertions positives, et (?<! pour les assertions négatives. Par exemple : (?<!foo)bar trouve les occurrences de "bar" qui ne sont pas précédées par "foo". Le contenu @@ -1342,7 +1530,7 @@ L' implémentation des assertions arrières déplace temporairement le pointeur de position vers l'arrière, et cherche à vérifier l'assertion. Si le nombre de caractère est différent, la position ne sera pas correcte, et l'assertion - échouera. La combinaison d'assertions arrières avec des sous masques peut être + échouera. La combinaison d'assertions arrières avec des sous-masques peut être particulièrement pratique à fin des chaînes. Un exemple est donné à la fin de cette section. Plusieurs assertions peuvent intervenir successivement. Par exemple @@ -1353,12 +1541,12 @@ recherche les occurrences de "baz" qui sont précédées par "bar", qui, à son tour, n'est pas précédé par "foo". Les assertions ne sont pas capturantes, et ne peuvent pas être répétées. Si une - assertion contient des sous masques capturants en son sein, ils seront compris - dans le nombre de sous masques capturants du masque entier. La capture est + assertion contient des sous-masques capturants en son sein, ils seront compris + dans le nombre de sous-masques capturants du masque entier. La capture est réalisée pour les assertions positives, mais cela n'a pas de sens pour les assertions négatives. 200 assertions au maximum sont autorisées. - Sous masques uniques (ONCE-ONLY SUBPATTERNS) + sous-masques uniques (ONCE-ONLY SUBPATTERNS) Avec les quantificateurs de répétitions, l'échec d'une recherche conduit normalement à une autre recherche, avec un nombre différent de répétitions, pour voir si le masque ne s'applique pas dans d'autres conditions. Parfois, il @@ -1367,35 +1555,39 @@ d'aller plus loin. Considérons par exemple, le masque \d+foo appliqué à la ligne 123456bar - Après avoir tenté d'utiliser les 6 chiffres suivi de "foo" qui fait échouer, - l'action habituelle sera de réessayer avec 5 chiffres, puis avec 4, et ainsi de - suite jusqu'à l'échec final. Un sous masque évalué une seule fois permettrait - d'indiquer que lorsqu'une partie du masque est trouvée, elle n'a pas besoin - d'être réévaluée à chaque tentative. Ceci conduirait à ce que la recherche - échoue immédiatement après le premier test. Ces assertions ont leur propre - notation, commencant avec (?>comme ceci : + Après avoir tenté d'utiliser les 6 chiffres suivi de "foo" qui + fait échouer, l'action habituelle sera de réessayer avec 5 + chiffres, puis avec 4, et ainsi de suite jusqu'à l'échec final. + Un sous-masque évalué une seule fois permettrait d'indiquer que + lorsqu'une partie du masque est trouvée, elle n'a pas besoin + d'être réévaluée à chaque tentative. Ceci + conduirait à ce que la recherche échoue immédiatement + après le premier test. Ces assertions ont leur propre notation, + commencant avec (?>comme ceci : (?>\d+)bar - Après avoir tenté d'utiliser les 6 chiffres suivi de "foo" qui fait échouer, - l'action habituelle sera de réessayer avec 5 chiffres, puis avec 4, et ainsi de - suite jusqu'à l'échec final. Un sous masque évalué une seule fois permettrait - d'indiquer que lorsqu'une partie du masque est trouvée, elle n'a pas besoin - d'être réévaluée à chaque tentative. Ceci conduirait à ce que la recherche - échoue immédiatement après le premier test. Ces assertions ont leur propre - notation, commencant avec (?>comme ceci : - (?>\d+)bar - Ce type de parenthèses verrouille le sous masque qu'il contient un fois qu'il - a été trouvé, et empêche un échec ultérieur d'y repasser, mais autorise à - revenir plus loin en arrière. - Une autre description est que les sous masques de ce type recherche les chaînes - de caractères, et les ancre le sous masque à l'intérieur de la chaîne. - Les sous masques uniques ne sont pas capturants. Des cas simples comme ceux + Après avoir tenté d'utiliser les 6 chiffres suivi de "foo" + qui fait échouer, l'action habituelle sera de réessayer avec + 5 chiffres, puis avec 4, et ainsi de suite jusqu'à l'échec + final. Un sous-masque évalué une seule fois permettrait + d'indiquer que lorsqu'une partie du masque est trouvée, elle + n'a pas besoin d'être réévaluée à + chaque tentative. Ceci conduirait à ce que la recherche échoue + immédiatement après le premier test. Ces assertions ont leur + propre notation, commencant avec (?>comme ceci : (?>\d+)bar. + Ce type de parenthèses verrouille le sous-masque qu'il contient + un fois qu'il a été trouvé, et empêche un + échec ultérieur d'y repasser, mais autorise à revenir + plus loin en arrière. Une autre description est que les sous-masques + de ce type recherche les chaînes + de caractères, et les ancre le sous-masque à l'intérieur de la chaîne. + Les sous-masques uniques ne sont pas capturants. Des cas simples comme ceux présentés ci dessus peuvent être pris comme des situations maximisantes, qui réservent le maximum de caractères. En effet, alors que \d+ et \d+? ajustent le nombre de chiffres trouvés de manière à laisser la possibilité au masque de réussir, (?>\d+) ne peut retenir que la séquence entière de chiffres. - Cette construction peut contenir un nombre arbitraire de sous masques complexes, + Cette construction peut contenir un nombre arbitraire de sous-masques complexes, et ils peuvent être imbriqués. - Les sous masques uniques ne peuvent être utilisés qu'avec les assertions + Les sous-masques uniques ne peuvent être utilisés qu'avec les assertions arrières, pour effectuer une recherche efficace en fin de chaîne. Considérons un masque simple tel que abcd$ @@ -1415,9 +1607,14 @@ va alors faire un test sur les 4 derniers caractères. Si elle échoue, la recherche est immédiatement interrompue. Pour les chaînes très longues, cette approche fait la différence en terme de performance et de temps de recherche. -Les sous masques conditionnels (CONDITIONAL SUBPATTERNS) - Il est possible de lier un sous masque à un une condition, ou de choisir entre - deux sous masques alternatifs, en fonction du résultat d'une assertion, ou + </para> + </refsect2> + <refsect2 id="regexp.reference.conditional"> + <title>Just a title</title> + <para> +Les sous-masques conditionnels (CONDITIONAL SUBPATTERNS) + Il est possible de lier un sous-masque à un une condition, ou de choisir entre + deux sous-masques alternatifs, en fonction du résultat d'une assertion, ou suivant les résultats de recherche précédents. Les deux formes possibles de sous masques conditionnels sont (?(condition)masque positif) @@ -1426,7 +1623,7 @@ masque négatif est utilisé, si présent. Si il y a plus de deux alternatives, une erreur est générée à la compilation. Il y a deux types de conditions. Si le texte entre les parenthèses est une - séquence de chiffre, alors la condition est satisfaite si le sous masque + séquence de chiffre, alors la condition est satisfaite si le sous-masque correspondant à ce numéro a réussi. Considérons le masque suivant, qui contient des espaces non significatif pour le rendre plus compréhensible (on supposera l'option PCRE_EXTENDED mise) et qui est divisé en trois parties pour simplifier @@ -1451,6 +1648,11 @@ poursuit avec la première alternative, et sinon, avec la seconde. Ce masque recherche des chaînes de la forme dd-aaa-dd ou dd-dd-dd, avec aaa qui sont des lettres, et dd qui sont des chiffres + </para> + </refsect2> + <refsect2 id="regexp.reference.comments"> + <title>Just a title</title> + <para> COMMENTS La séquence (?# marque le début des commentaires, qui se termine à la prochaîne parenthèse fermante. Les parenthèses imbriquées ne sont pas autorisées. @@ -1459,6 +1661,11 @@ Si l'option PCRE_EXTENDED est mise, les caractères dièses # non échappés en dehors d'une classe de caractères introduisent un commentaire qui continuera jusqu'à la prochaîne ligne dans le masque. + </para> + </refsect2> + <refsect2 id="regexp.reference.performances"> + <title>Just a title</title> + <para> PERFORMANCE Certaines séquences de recherches sont plus efficaces que d'autres. Ainsi, il est plus efficace d'utiliser une classe de caractères telle que [aeiou] plutôt @@ -1482,7 +1689,8 @@ avec l'option PCRE_DOTALL, ou en ancrant le masque avec ^.*. Cela évite à PCRE de scanner toute la chaîne pour rechercher un caractère de nouvelle ligne et recommencer la recherche. - </literallayout> + </para> + </refsect2> </refsect1> </refentry> </reference> Index: phpdoc/fr/functions/pdf.xml diff -u phpdoc/fr/functions/pdf.xml:1.4 phpdoc/fr/functions/pdf.xml:1.5 --- phpdoc/fr/functions/pdf.xml:1.4 Fri Dec 8 02:04:55 2000 +++ phpdoc/fr/functions/pdf.xml Fri Jan 26 06:44:21 2001 @@ -1,5 +1,5 @@ <reference id="ref.pdf"> - <title>Fonctions PDF</title> + <title>PDF</title> <titleabbrev>PDF</titleabbrev> <partintro> <simpara> @@ -227,7 +227,7 @@ </simpara> </sect1> <sect1 id="pdf.examples"> - <title>Examples</title> + <title>Exemples</title> <simpara> La plus part des fonctions sont simples d'emploi.Le plus difficile est probablement de créer un fichier PDF simple. L'exemple suivant @@ -239,7 +239,7 @@ <para> <example> <title>Création d'un document PDF avec pdflib</title> - <programlisting> + <programlisting role="php"> <?php $fp = fopen("test.pdf", "w"); $pdf = pdf_open($fp); @@ -259,19 +259,19 @@ pdf_close($pdf); fclose($fp); echo "<A HREF=getpdf.php>finished</A>"; -?> +?> </programlisting> <simpara> Ce script <filename>getpdf.php</filename> retourne simplement le document PDF. </simpara> <informalexample> - <programlisting> + <programlisting role="php"> <?php $fp = fopen("test.pdf", "r"); header("Content-type: application/pdf"); fpassthru($fp); fclose($fp); -?> +?> </programlisting> </informalexample> </example> @@ -285,7 +285,7 @@ <para> <example> <title>Exemple pdfclock issue de la distribution pdflib</title> - <programlisting> + <programlisting role="php"> <?php $pdffilename = "clock.pdf"; $radius = 200; @@ -296,7 +296,7 @@ pdf_set_info($pdf, "Creator", "pdf_clock.php3"); pdf_set_info($pdf, "Author", "Uwe Steinmann"); pdf_set_info($pdf, "Title", "Analog Clock"); -while($pagecount-- > 0) { +while($pagecount-- > 0) { pdf_begin_page($pdf, 2 * ($radius + $margin), 2 * ($radius + $margin)); pdf_set_parameter($pdf, "transition", "wipe"); pdf_set_value($pdf, "duration", 0.5); @@ -358,20 +358,21 @@ $pdf = pdf_close($pdf); fclose($fp); echo "<A HREF=getpdf.php?filename=".$pdffilename.">finished</A>"; -?> +?> </programlisting> <simpara> Ce script <filename>getpdf.php</filename> ne fait que retourner un document PDF. </simpara> - <programlisting> + <programlisting role="php"> <?php $fp = fopen($filename, "r"); header("Content-type: application/pdf"); fpassthru($fp); fclose($fp); -?> +?> </programlisting> - </example></para> + </example> + </para> </sect1> </partintro> <refentry id="function.pdf-set-info"> @@ -398,7 +399,7 @@ Cette fonction peut être appelée avant la création d'une page. <example> <title>Préparer l'entête d'un document PDF</title> - <programlisting> + <programlisting role="php"> <?php $fd = fopen("test.pdf", "w"); $pdfdoc = pdf_open($fd); @@ -411,7 +412,7 @@ pdf_begin_page($pdfdoc, 595, 842); pdf_end_page($pdfdoc); pdf_close($pdfdoc); -?> +?> </programlisting> </example> </para> @@ -890,7 +891,7 @@ <para> <function>pdf_set_text_rendering</function> determine le rendu du texte. Les valeurs possibles pour <parameter>mode</parameter> sont 0=fill text - (texte plein), 1=stroke text (???), 2=fill and stroke text (texte plein + (texte plein), 1=stroke text (???), 2=fill et stroke text (texte plein et stroke), 3=invisible, 4=texte plein, et ajouté au chemin, 5=stroke text, ajouté au chemin, 6=texte plein et stroke, ajouté au chemin, 7=ajouté au chemin. @@ -1149,10 +1150,12 @@ faire des translations ou des rotations sans affecter les autres objets. <example> <title>Sauver et restaurer un environnement PDF</title> - <programlisting> -<?php PDF_save($pdf); + <programlisting role="php"> +<?php +pdf_save($pdf); // tout un lot de rotations, translations, transformations... -PDF_restore($pdf) ?> +pdf_restore($pdf) +?> </programlisting> </example> </para> @@ -1185,7 +1188,7 @@ et avant de commencer à dessiner les objets. <example> <title>Translation</title> - <programlisting> + <programlisting role="php"> <?php PDF_moveto($pdf, 0, 0); PDF_lineto($pdf, 100, 100); PDF_stroke($pdf); @@ -1193,7 +1196,7 @@ PDF_moveto($pdf, 0, 0); PDF_lineto($pdf, 100, 100); PDF_stroke($pdf); -?> +?> </programlisting> </example> </para> @@ -1220,11 +1223,11 @@ dessinée sur un pouce (2.54 cm) de large. <example> <title>Mise à l'échelle</title> - <programlisting> + <programlisting role="php"> <?php PDF_scale($pdf, 72.0, 72.0); PDF_lineto($pdf, 1, 1); PDF_stroke($pdf); -?> +?> </programlisting> </example> </para> @@ -1956,7 +1959,8 @@ <member> 7 : l'ancienne page est simplement remplacée par la nouvelle (valeur par défaut) </member> - </simplelist></para> + </simplelist> + </para> <para> Voir aussi <function>pdf_set_duration</function>.</para> </refsect1> @@ -2004,12 +2008,12 @@ retourne un identifiant d'image PDF : <example> <title>Inclusion d'un image GIF</title> - <programlisting> + <programlisting role="php"> <?php $im = PDF_open_gif($pdf, "test.gif"); pdf_place_image($pdf, $im, 100, 100, 1); pdf_close_image($pdf, $im); -?> +?> </programlisting> </example> </para> @@ -2057,12 +2061,12 @@ </note> <example> <title>Including a PNG image</title> - <programlisting> + <programlisting role="php"> <?php $im = pdf_open_png ($pdf, "test.png"); pdf_place_image ($pdf, $im, 100, 100, 1); pdf_close_image ($pdf, $im); -?> +?> </programlisting> </example> </para> @@ -2099,12 +2103,12 @@ La fonction retourne un identifiant d'image PDF. <example> <title>Insertion d'une image dans un fichier PDF</title> - <programlisting> + <programlisting role="php"> <?php $pim = pdf_open_image_file($pdf, "png", "picture.png"); pdf_place_image($pdf, $pim, 100, 100, 1); pdf_close_image($pdf, $pim); -?> +?> </programlisting> </example> </para> @@ -2142,7 +2146,7 @@ pour le document PDF. La fonction retourne un identifiant PDF d'image. <example> <title>Inclusion d'une image mémoire</title> - <programlisting> + <programlisting role="php"> <?php $im = ImageCreate(100, 100); $col = ImageColorAllocate($im, 80, 45, 190); @@ -2151,7 +2155,7 @@ ImageDestroy($im); pdf_place_image($pdf, $pim, 100, 100, 1); pdf_close_image($pdf, $pim); -?> +?> </programlisting> </example> </para> @@ -2366,7 +2370,7 @@ </note> <example> <title>Affichage multiple d'une image.</title> - <programlisting> + <programlisting role="php"> <?php $im = ImageCreate(100, 100); $col1 = ImageColorAllocate($im, 80, 45, 190); @@ -2376,7 +2380,7 @@ pdf_execute_image($pdf, $pim, 100, 100, 1); pdf_execute_image($pdf, $pim, 200, 200, 2); pdf_close_image($pdf, $pim); -?> +?> </programlisting> </example> </para> Index: phpdoc/fr/functions/pfpro.xml diff -u phpdoc/fr/functions/pfpro.xml:1.3 phpdoc/fr/functions/pfpro.xml:1.4 --- phpdoc/fr/functions/pfpro.xml:1.3 Tue Dec 12 02:49:53 2000 +++ phpdoc/fr/functions/pfpro.xml Fri Jan 26 06:44:21 2001 @@ -1,18 +1,19 @@ <reference id="ref.pfpro"> - <title>Fonctions de paiement Verisign Payflow Pro</title> - <titleabbrev>Verisign Payflow Pro</titleabbrev> + <title>Verisign Payflow Pro Paiement</title> + <titleabbrev>Paiement par Verisign</titleabbrev> <partintro> <simpara> Cette extension vous permet d'effectuer des transactions avec des cartes - de crédits en utilisant les services Verisign Payment Services, anciennement - connu sous le nom de Signio (<ulink url="&url.pfpro;">&url.pfpro;</ulink>). + de crédits en utilisant les services Verisign Payment Services, + anciennement connu sous le nom de Signio + (<ulink url="&url.pfpro;">&url.pfpro;</ulink>). </simpara> <simpara> - Ces fonctions sont utilisables dès que PHP a été compilé avec - l'option <option role="configure">--with-pfpro[=DIR]</option>. Vous - devez aussi utiliser le SDK approprié sur votre plate-forme : il - est disponible <ulink url="&url.pfpro.download;">l'interface du - manager</ulink>, une fois que vous vous êtes inscrit. + Ces fonctions sont utilisables dès que PHP a été + compilé avec l'option <option role="configure">--with-pfpro[=DIR]</option>. + Vous devez aussi utiliser le SDK approprié sur votre plate-forme : il + est disponible <ulink url="&url.pfpro.download;">l'interface du manager</ulink>, + une fois que vous vous êtes inscrit. </simpara> <simpara> Une fois que vous avez téléchargé le SDK vous devez copier les @@ -177,13 +178,13 @@ <programlisting role="php"> <?php pfpro_init(); -$transaction = array(USER => 'monlogin', - PWD => 'mmotdepasse', - TRXTYPE => 'S', - TENDER => 'C', - AMT => 1.50, - ACCT => '4111111111111111', - EXPDATE => '0904' +$transaction = array(USER => 'monlogin', + PWD => 'mmotdepasse', + TRXTYPE => 'S', + TENDER => 'C', + AMT => 1.50, + ACCT => '4111111111111111', + EXPDATE => '0904' ); $response = pfpro_process($transaction); if (!$response) { @@ -196,7 +197,7 @@ echo "\nLa réponse: "; print_r($response); pfpro_cleanup(); -?> +?> </programlisting> </example> </refsect1> @@ -268,7 +269,7 @@ } echo "La réponse brute de Verisign est ".$response; pfpro_cleanup(); -?> +?> </programlisting> </example> </refsect1> Index: phpdoc/fr/functions/pgsql.xml diff -u phpdoc/fr/functions/pgsql.xml:1.8 phpdoc/fr/functions/pgsql.xml:1.9 --- phpdoc/fr/functions/pgsql.xml:1.8 Wed Dec 13 05:57:11 2000 +++ phpdoc/fr/functions/pgsql.xml Fri Jan 26 06:44:21 2001 @@ -1,5 +1,5 @@ <reference id="ref.pgsql"> - <title>Fonctions PostgreSQL</title> + <title>PostgreSQL</title> <titleabbrev>PostgreSQL</titleabbrev> <partintro> <para> @@ -71,7 +71,7 @@ </para> <para> L'ancienne syntaxe : - <command>$conn = pg_connect ("host", "port", "options", "tty", "dbname")</command> + <command>$conn = pg_connect("host", "port", "options", "tty", "dbname")</command> est obsolète. </para> <para> @@ -85,17 +85,17 @@ <title>Utilisation des objets de grande taille (Large Objects)</title> <programlisting role="php"> <?php -$database = pg_Connect ("", "", "", "", "jacarta"); -pg_exec ($database, "begin"); - $oid = pg_locreate ($database); - echo ("$oid\n"); - $handle = pg_loopen ($database, $oid, "w"); - echo ("$handle\n"); - pg_lowrite ($handle, "gaga"); - pg_loclose ($handle); -pg_exec ($database, "commit") -pg_exec ($database, "end") -?> +$database = pg_connect("", "", "", "", "jacarta"); +pg_exec($database, "begin"); + $oid = pg_locreate($database); + echo "$oid\n"; + $handle = pg_loopen($database, $oid, "w"); + echo "$handle\n"; + pg_lowrite($handle, "gaga"); + pg_loclose($handle); + pg_exec($database, "commit") + pg_exec($database, "end") +?> </programlisting> </example> </para> @@ -114,7 +114,7 @@ </funcprototype> </funcsynopsis> <para> - Retourne FALSE si l'index de connexion n'est pas valable, et TRUE sinon. + Retourne <literal>FALSE</literal> si l'index de connexion n'est pas valable, et <literal>TRUE</literal> sinon. Ferme la connexion au serveur PostgreSQL associé à <parameter>connection</parameter>. </para> @@ -155,7 +155,7 @@ $result = pg_exec($conn, "INSERT INTO verlag VALUES ('Auteur')"); $cmdtuples = pg_cmdtuples($result); echo $cmdtuples . " <- tuples modifiés."; -?> +?> </programlisting> </example> </para> @@ -176,20 +176,20 @@ </funcsynopsis> <para> <parameter>conn_string</parameter> retourne un index de - connexion en cas de succès, et FALSE sinon. Ouvre une connexion + connexion en cas de succès, et <literal>FALSE</literal> sinon. Ouvre une connexion à un serveur PostgreSQL. Les arguments doivent être placé entre guillemets. <example> <title>Using pg_connect arguments</title> <programlisting role="php"> <?php -$dbconn = pg_Connect ("dbname=marie"); +$dbconn = pg_connect("dbname=marie"); //connexion à une base de données nommée "marie" -$dbconn2 = pg_Connect ("host=localhost port=5432 dbname=marie"); +$dbconn2 = pg_connect("host=localhost port=5432 dbname=marie"); //connexion à une base de données nommée "marie" sur l'hôte "localhost" sur le port "5432" -$dbconn3 = pg_Connect ("user=agneau password=baaaa dbname=marie "); +$dbconn3 = pg_connect("user=agneau password=baaaa dbname=marie "); //connexion à une base de données nommée "marie" avec l'utilisateur "agneau" et le mot de passe "baaaa" -?> +?> </programlisting> </example> Les arguments disponbiles comptent notamment <parameter>dbname</parameter> @@ -204,7 +204,7 @@ </para> <para> L'ancienne syntaxe - <command>$conn = pg_connect ("host", "port", "options", "tty", "dbname")</command> + <command>$conn = pg_connect("host", "port", "options", "tty", "dbname")</command> est obsolète. </para> <para> @@ -227,7 +227,7 @@ </funcsynopsis> <para> Retourne le nom de la base de donnée PostgreSQL associée - à l'index de connexion connection, ou FALSE si connection n'est + à l'index de connexion connection, ou <literal>FALSE</literal> si connection n'est pas valide. </para> </refsect1> @@ -251,11 +251,11 @@ <function>pg_end_copy</function> synchronise le client PostgreSQL (ici PHP) avec le serveur, après une opération de copie. Il faut utiliser cette fonction, sous peine de recevoir une erreur "out of sync" - (désynchronisé). Retourne TRUE en cas de succès, et - FALSE sinon. + (désynchronisé). Retourne <literal>TRUE</literal> en cas de succès, et + <literal>FALSE</literal> sinon. </para> <para> - Pour plus de détails et un exemple voyez : + Pour plus de détails et un exemple voyez : <function>pg_put_line</function>. </para> </refsect1> @@ -274,8 +274,7 @@ </funcprototype> </funcsynopsis> <para> - Retourne une chaîne contenant le dernier message d'erreur, ou FALSE - en cas d'échec. Il sera impossible d'obtenir des détails sur + Retourne une chaîne contenant le dernier message d'erreur, ou <literal>FALSE</literal> en cas d'échec. Il sera impossible d'obtenir des détails sur l'erreur générée, en utilisant la fonction <function>pg_errormessage</function> si une erreur est survenue dans la dernière action pour laquelle une connexion valide existe. @@ -300,7 +299,7 @@ </funcsynopsis> <para> Retourne un index de résultat, si la requête a été - correctement exécutée, et FALSE en cas d'échec, ou si + correctement exécutée, et <literal>FALSE</literal> en cas d'échec, ou si la connexion connection n'était pas un index de connexion valide. En cas d'erreur, le message d'erreur peut être obtenu grâce à la fonction <function>pg_errormessage</function>, si l'index de connexion @@ -308,7 +307,7 @@ PostgreSQL identifié grâce à l'index de connexion. La réponse retournée par cette fonction est un index de résultat qui devra être utilisé pour accéder - aux lignes de résultat, grâce à d'autres + aux lignes de résultat, grâce à d'autres fonctions PostgreSQL. <note> <simpara> @@ -340,7 +339,7 @@ </funcsynopsis> <para> Retourne un tableau qui contient à la ligne demandée, dans - le résultat identifiée par result, et FALSE , si il ne + le résultat identifiée par result, et <literal>FALSE</literal> , si il ne reste plus de lignes. </para> <para> @@ -374,21 +373,21 @@ <title>PostgreSQL fetch array</title> <programlisting role="php"> <?php -$conn = pg_pconnect ("dbname=publisher"); +$conn = pg_pconnect("dbname=publisher"); if (!$conn) { echo "Erreur de connexion.\n"; exit; } -$result = pg_exec ($conn, "SELECT * FROM authors"); +$result = pg_exec($conn, "SELECT * FROM authors"); if (!$result) { echo "Erreur durant la requete.\n"; exit; } -$arr = pg_fetch_array ($result, 0); +$arr = pg_fetch_array($result, 0); echo $arr[0] . " <- array\n"; -$arr = pg_fetch_array ($result, 1); +$arr = pg_fetch_array($result, 1); echo $arr["author"] . " <- array\n"; -?> +?> </programlisting> </example> </refsect1> @@ -412,7 +411,7 @@ </funcsynopsis> <para> Retourne un objet dont les membres sont les champs de la ligne demandée, - ou FALSE , si il n'y a plus de lignes. + ou <literal>FALSE</literal> , si il n'y a plus de lignes. </para> <para> <function>pg_fetch_object</function> est similaire à @@ -446,37 +445,41 @@ <programlisting role="php"> <?php $database = "verlag"; -$db_conn = pg_connect ("host=localhost port=5432 dbname=$database"); -if (!$db_conn): ?> - <H1>Connexion impossible à la base postgres <?php echo $database ?></H1> <?php +$db_conn = pg_connect("host=localhost port=5432 dbname=$database"); +if (!$db_conn): +?> + <H1>Connexion impossible à la base postgres <?php echo $database ></H1> <?php exit; endif; -$qu = pg_exec ($db_conn, "SELECT * FROM verlag ORDER BY autor"); +$qu = pg_exec($db_conn, "SELECT * FROM verlag ORDER BY autor"); $row = 0; // postgres réclame un compteur de ligne, d'autres bases ne le font pas. -while ($data = pg_fetch_object ($qu, $row)): +while ($data = pg_fetch_object($qu, $row)): echo $data->autor." ("; echo $data->jahr ."): "; echo $data->titel."<BR>"; $row++; -endwhile; ?> +endwhile; +?> <PRE><?php -$fields[] = Array ("autor", "Author"); -$fields[] = Array ("jahr", " Year"); -$fields[] = Array ("titel", " Title"); +$fields[] = array("autor", "Author"); +$fields[] = array("jahr", " Year"); +$fields[] = array("titel", " Title"); $row= 0; // Postgres réclame un compteur de ligne, d'autres bases ne le font pas. -while ($data = pg_fetch_object ($qu, $row)): +while ($data = pg_fetch_object($qu, $row)): echo "----------\n"; - reset ($fields); - while (list (,$item) = each ($fields)): + reset($fields); + while (list(,$item) = each($fields)): echo $item[1].": ".$data->$item[0]."\n"; endwhile; $row++; endwhile; -echo "----------\n"; ?> -</PRE> <?php -pg_freeresult ($qu); -pg_close ($db_conn); -?> +echo "----------\n"; +?> +</PRE> +<?php +pg_freeresult($qu); +pg_close($db_conn); +?> </programlisting> </example> </para> @@ -498,7 +501,7 @@ </funcsynopsis> <para> Retourne un tableau qui contient les données de la ligne demandée, - ou FALSE , si il ne reste plus de lignes. + ou <literal>FALSE</literal> , si il ne reste plus de lignes. </para> <para> <function>pg_fetch_row</function> lit une ligne dans le résultat @@ -508,7 +511,7 @@ </para> <para> Les appels ultérieurs à <function>pg_fetch_row</function> - retourneront la ligne d'après, ou bien FALSE, lorsqu'il n'y aura + retourneront la ligne d'après, ou bien <literal>FALSE</literal>, lorsqu'il n'y aura plus de lignes. </para> <para> @@ -518,14 +521,14 @@ <title>Postgres retourne une ligne</title> <programlisting role="php"> <?php -$conn = pg_pconnect ("dbname=publisher"); +$conn = pg_pconnect("dbname=publisher"); if (!$conn) { - echo "An error occured.\n"; + echo "Une erreur est survenue.\n"; exit; } -$result = pg_Exec ($conn, "SELECT * FROM authors"); +$result = pg_exec($conn, "SELECT * FROM authors"); if (!$result) { - echo "An error occured.\n"; + echo "Une erreur est survenue.\n"; exit; } $num = pg_numrows($result); @@ -536,7 +539,7 @@ } echo "<BR>"; } -?> +?> </programlisting> </example> </para> @@ -816,7 +819,7 @@ <parameter>oid</parameter> est un identifiant d'objet de grande taille qui sera exporté dans le fichier <parameter>filename</parameter>, qui spécifie son chemin. RetourneFALSEsi une erreur survient, - et TRUE en cas de succès. N'oubliez pas que la manipulation d'un + et <literal>TRUE</literal> en cas de succès. N'oubliez pas que la manipulation d'un objet de grande taille dans PostgreSQL doit intervenir dans une transaction. </para> @@ -1056,7 +1059,7 @@ </para> <para> L'ancienne syntaxe - <command>$conn = pg_pconnect ("host", "port", "options", "tty", "dbname")</command> + <command>$conn = pg_pconnect("host", "port", "options", "tty", "dbname")</command> est obsolète. </para> </refsect1> @@ -1101,8 +1104,8 @@ par NULL) au serveur PostgreSQL. Ceci est pratique pour effectuer des insertions très rapides dans une table, initiée par une opération de copie PostgreSQL copy-operation. Le caractère final - NULL est automatiquement ajouté. Retourne TRUE en cas de succès, - et FALSE. + NULL est automatiquement ajouté. Retourne <literal>TRUE</literal> en cas de succès, + et <literal>FALSE</literal>. </para> <note> <para> @@ -1117,14 +1120,14 @@ <title>Insertion à grande vitesse dans une table</title> <programlisting role="php"> <?php - $conn = pg_pconnect ("dbname=foo"); + $conn = pg_pconnect("dbname=foo"); pg_exec($conn, "create table bar (a int4, b char(16), d float8)"); pg_exec($conn, "copy bar from stdin"); pg_put_line($conn, "3\tBonjour le monde\t4.5\n"); pg_put_line($conn, "4\tAu revoir le monde\t7.11\n"); pg_put_line($conn, "\\.\n"); pg_end_copy($conn); -?> +?> </programlisting> </example> </para> @@ -1285,7 +1288,7 @@ Par défaut, c'est la dernière ouverte. </para> <para> - Retourne TRUE si <parameter>filename</parameter> a pu être ouvert en + Retourne <literal>TRUE</literal> si <parameter>filename</parameter> a pu être ouvert en écriture, etFALSEsinon. </para> <para> @@ -1332,7 +1335,7 @@ dernière ouverte. </para> <para> - Retourne toujours TRUE. + Retourne toujours <literal>TRUE</literal>. </para> <para> Voir aussi <function>pg_trace</function>. Index: phpdoc/fr/functions/posix.xml diff -u phpdoc/fr/functions/posix.xml:1.2 phpdoc/fr/functions/posix.xml:1.3 --- phpdoc/fr/functions/posix.xml:1.2 Mon Nov 13 01:53:42 2000 +++ phpdoc/fr/functions/posix.xml Fri Jan 26 06:44:21 2001 @@ -1,20 +1,17 @@ <reference id="ref.posix"> - <title>Fonctions POSIX</title> + <title>POSIX</title> <titleabbrev>POSIX</titleabbrev> - <partintro> <para> Ce module contient une interface avec les documents au standard - IEEE 1003.1 (POSIX.1), qui ne sont pas accessibles autrement. + IEEE 1003.1 (POSIX.1), qui ne sont pas accessibles autrement. Par exemple, POSIX.1 définit les fonctions open(), read(), write() et close(), qui ont été traditionnellement - les fonctions de PHP 3. Certains fonctionnalités + les fonctions de PHP 3. Certains fonctionnalités spécifiques ne sont pas encore disponibles, bien que ce module tâche de remédier à cette situation avec ses fonctions. </para> </partintro> - - <refentry id="function.posix-kill"> <refnamediv> <refname>posix_kill</refname> @@ -30,19 +27,18 @@ </funcprototype> </funcsynopsis> <para> - <function>posix_kill</function> envoie le signal + <function>posix_kill</function> envoie le signal <parameter>sig</parameter> au processus <parameter>pid</parameter>. - Retourne FALSE, si il n'a pas pu envoyer le signal, et TRUE sinon. + Retourne <literal>FALSE</literal>, si il n'a pas pu envoyer le signal, et <literal>TRUE</literal> sinon. </para> <para> - Reportez vous à la page de manuel de kill(2) de votre - système POSIX, qui contient plus de détails sur + Reportez vous à la page de manuel de kill(2) de votre + système POSIX, qui contient plus de détails sur les identifiants négatifs de processus, les pid spéciaux 0 et -1, et le signal numéro 0. </para> </refsect1> </refentry> - <refentry id="function.posix-getpid"> <refnamediv> <refname>posix_getpid</refname> @@ -61,7 +57,6 @@ </para> </refsect1> </refentry> - <refentry id="function.posix-getppid"> <refnamediv> <refname>posix_getppid</refname> @@ -78,7 +73,6 @@ </para> </refsect1> </refentry> - <refentry id="function.posix-getuid"> <refnamediv> <refname>posix_getuid</refname> @@ -95,13 +89,12 @@ </funcprototype> </funcsynopsis> <para> - Retourne l'ID numérique de l'utilisateur du processus courant. - Reportez vous à <function>posix_getpwuid</function> pour + Retourne l'ID numérique de l'utilisateur du processus courant. + Reportez vous à <function>posix_getpwuid</function> pour accéder au nom d'utilisateur. </para> </refsect1> </refentry> - <refentry id="function.posix-geteuid"> <refnamediv> <refname>posix_geteuid</refname> @@ -119,12 +112,11 @@ </funcsynopsis> <para> Retourne l'UID effectif de l'utilisateur du processus courant. - Reportez vous à <function>posix_getpwuid</function> pour + Reportez vous à <function>posix_getpwuid</function> pour obtenir le nom d'utilisateur. </para> </refsect1> </refentry> - <refentry id="function.posix-getgid"> <refnamediv> <refname>posix_getgid</refname> @@ -141,12 +133,11 @@ </funcprototype> </funcsynopsis> <para> - Retourne l'UID du groupe du processus courant. Reportez vous à + Retourne l'UID du groupe du processus courant. Reportez vous à <function>posix_getgrgid</function> pour accéder au nom du groupe. </para> </refsect1> </refentry> - <refentry id="function.posix-getegid"> <refnamediv> <refname>posix_getegid</refname> @@ -163,16 +154,15 @@ </funcprototype> </funcsynopsis> <para> - Retourne l'ID effectif du groupe du processus courant. Reportez vous à - <function>posix_getgrgid</function> pour transformer cette information en nom + Retourne l'ID effectif du groupe du processus courant. Reportez vous à + <function>posix_getgrgid</function> pour transformer cette information en nom de groupe. </para> </refsect1> </refentry> - <refentry id="function.posix-setuid"> <refnamediv> - <refname>posix_setuid</refname> + <refname>posix_setuid</refname> <refpurpose> Fixe l'UID effective du processus courant. </refpurpose> @@ -186,20 +176,19 @@ </funcprototype> </funcsynopsis> <para> - Fixe l'UID effective de l'utilisateur du processus courant. Vous devez + Fixe l'UID effective de l'utilisateur du processus courant. Vous devez avoir les privilèges nécessaires (traditionnellement ceux du root) sur votre système pour faire ceci. </para> <para> - Retourne TRUE en cas de succès, FALSE sinon. + Retourne <literal>TRUE</literal> en cas de succès, <literal>FALSE</literal> sinon. Voir aussi <function>posix_setgid</function>. </para> </refsect1> </refentry> - <refentry id="function.posix-setgid"> <refnamediv> - <refname>posix_setgid</refname> + <refname>posix_setgid</refname> <refpurpose> Fixe le GID effective du processus courant. </refpurpose> @@ -213,17 +202,16 @@ </funcprototype> </funcsynopsis> <para> - Fixe le GID effective du processus courant. - Reportez vous à <function>posix_getgrgid</function> pour transformer - cette information en nom de groupe. L'ordre approprié est d'abord + Fixe le GID effective du processus courant. + Reportez vous à <function>posix_getgrgid</function> pour transformer + cette information en nom de groupe. L'ordre approprié est d'abord <function>posix_setgid</function>, puis <function>posix_setuid</function>. </para> <para> - Retourne TRUE en cas de succès, FALSE sinon. + Retourne <literal>TRUE</literal> en cas de succès, <literal>FALSE</literal> sinon. </para> </refsect1> </refentry> - <refentry id="function.posix-getgroups"> <refnamediv> <refname>posix_getgroups</refname> @@ -240,13 +228,12 @@ </funcprototype> </funcsynopsis> <para> - Retourne un tableau contenant les identifiants du groupe du - processus courant. Reportez vous à + Retourne un tableau contenant les identifiants du groupe du + processus courant. Reportez vous à <function>posix_getgrgid</function> pour pouvoir utiliser ces id. </para> </refsect1> </refentry> - <refentry id="function.posix-getlogin"> <refnamediv> <refname>posix_getlogin</refname> @@ -261,13 +248,12 @@ </funcprototype> </funcsynopsis> <para> - Retourne le nom de login de l'utilisateur qui possède le processus - courant. Reportez vous à <function>posix_getpwnam</function> pour + Retourne le nom de login de l'utilisateur qui possède le processus + courant. Reportez vous à <function>posix_getpwnam</function> pour obtenir plus d'informations sur cet utilisateur. </para> </refsect1> </refentry> - <refentry id="function.posix-getpgrp"> <refnamediv> <refname>posix_getpgrp</refname> @@ -284,14 +270,13 @@ </funcprototype> </funcsynopsis> <para> - Retourne l'identifiant du groupe de processus du processus courant. - Reportez vous à POSIX.1 et à getpgrp(2) dans le manuel + Retourne l'identifiant du groupe de processus du processus courant. + Reportez vous à POSIX.1 et à getpgrp(2) dans le manuel de votre système POSIX pour plus d'informations sur les groupes de processus. </para> </refsect1> </refentry> - <refentry id="function.posix-setsid"> <refnamediv> <refname>posix_setsid</refname> @@ -306,14 +291,13 @@ </funcprototype> </funcsynopsis> <para> - Fait du processus courant un chef de session. Reportez vous à - POSIX.1 et setsid(2) dans le manuel de votre système POSIX - pour plus d'informations sur le contrôle de tâche. Retourne + Fait du processus courant un chef de session. Reportez vous à + POSIX.1 et setsid(2) dans le manuel de votre système POSIX + pour plus d'informations sur le contrôle de tâche. Retourne un identifiant de session. </para> </refsect1> </refentry> - <refentry id="function.posix-setpgid"> <refnamediv> <refname>posix_setpgid</refname> @@ -329,15 +313,14 @@ </funcprototype> </funcsynopsis> <para> - <function>posix_setpgid</function> ajoute le processus - <parameter>pid</parameter> au groupe d'id <parameter>pgid</parameter>. - Reportez vous à POSIX.1 et setsid(2) dans le manuel de votre - système POSIX pour plus d'informations sur le contrôle - de tâche. Retourne TRUE en cas de succès, et FALSE sinon. + <function>posix_setpgid</function> ajoute le processus + <parameter>pid</parameter> au groupe d'id <parameter>pgid</parameter>. + Reportez vous à POSIX.1 et setsid(2) dans le manuel de votre + système POSIX pour plus d'informations sur le contrôle + de tâche. Retourne <literal>TRUE</literal> en cas de succès, et <literal>FALSE</literal> sinon. </para> </refsect1> </refentry> - <refentry id="function.posix-getpgid"> <refnamediv> <refname>posix_getpgid</refname> @@ -352,16 +335,15 @@ </funcprototype> </funcsynopsis> <para> - Retourne l'id du groupe de processus pour le processus + Retourne l'id du groupe de processus pour le processus <parameter>pid</parameter>.</para> <para> - Ceci n'est pas une fonction POSIX, mais elle est répandu sur - les systèmes BSD et System V. Si votre système ne - supporte pas cette fonction, la fonction PHP retournera toujours FALSE. + Ceci n'est pas une fonction POSIX, mais elle est répandu sur + les systèmes BSD et System V. Si votre système ne + supporte pas cette fonction, la fonction PHP retournera toujours <literal>FALSE</literal>. </para> </refsect1> </refentry> - <refentry id="function.posix-getsid"> <refnamediv> <refname>posix_getsid</refname> @@ -377,17 +359,16 @@ </funcsynopsis> <para> Retourne le sid du processus <parameter>pid</parameter>. - Si <parameter>pid</parameter> est à 0, le sid retourné + Si <parameter>pid</parameter> est à 0, le sid retourné sera celui du processus courant. </para> <para> - Ceci n'est pas une fonction POSIX, mais elle est répandu sur - les systèmes BSD et System V. Si votre système ne - supporte pas cette fonction, la fonction PHP retournera toujours FALSE. + Ceci n'est pas une fonction POSIX, mais elle est répandu sur + les systèmes BSD et System V. Si votre système ne + supporte pas cette fonction, la fonction PHP retournera toujours <literal>FALSE</literal>. </para> </refsect1> </refentry> - <refentry id="function.posix-uname"> <refnamediv> <refname>posix_uname</refname> @@ -402,8 +383,8 @@ </funcprototype> </funcsynopsis> <para> - Retourne un tableau associatif avec des informations sur le système. Les - indices du tableau sont : + Retourne un tableau associatif avec des informations sur le système. Les + indices du tableau sont : <itemizedlist> <listitem><simpara> sysname - nom du système d'exploitation (e.g. Linux) @@ -421,16 +402,16 @@ <listitem><simpara> machine - architecture système (e.g. i586) </simpara></listitem> - </itemizedlist></para> + </itemizedlist> + </para> <para> - Posix impose que vous n'ayez pas d'a priori sur le format des - chaînes, c'est à dire que vous ne devez pas vous - attendre à avoir forcément 3 chiffres pour la version, + Posix impose que vous n'ayez pas d'a priori sur le format des + chaînes, c'est à dire que vous ne devez pas vous + attendre à avoir forcément 3 chiffres pour la version, par exemple. </para> </refsect1> </refentry> - <refentry id="function.posix-times"> <refnamediv> <refname>posix_times</refname> @@ -446,7 +427,7 @@ </funcsynopsis> <para> Retourne un tableau avec les informations sur l'utilisation du CPU. - Les indices sont : + Les indices sont : <itemizedlist> <listitem><simpara> ticks - nombre de ticks depuis le dernier démarrage @@ -458,17 +439,17 @@ stime - temps système utilisé par le processus courant. </simpara></listitem> <listitem><simpara> - cutime - temps utilisateur utilisé par le processus courant et + cutime - temps utilisateur utilisé par le processus courant et ses enfants. </simpara></listitem> <listitem><simpara> - cstime - temps système utilisé par le processus courant + cstime - temps système utilisé par le processus courant et ses enfants. </simpara></listitem> - </itemizedlist></para> + </itemizedlist> + </para> </refsect1> </refentry> - <refentry id="function.posix-ctermid"> <refnamediv> <refname>posix_ctermid</refname> @@ -486,7 +467,6 @@ Encore à faire.</para> </refsect1> </refentry> - <refentry id="function.posix-ttyname"> <refnamediv> <refname>posix_ttyname</refname> @@ -504,7 +484,6 @@ Encore à faire.</para> </refsect1> </refentry> - <refentry id="function.posix-isatty"> <refnamediv> <refname>posix_isatty</refname> @@ -524,7 +503,6 @@ Encore à faire.</para> </refsect1> </refentry> - <refentry id="function.posix-getcwd"> <refnamediv> <refname>posix_getcwd</refname> @@ -542,7 +520,6 @@ Encore à faire très rapidement.</para> </refsect1> </refentry> - <refentry id="function.posix-mkfifo"> <refnamediv> <refname>posix_mkfifo</refname> @@ -563,7 +540,6 @@ Encore à faire très rapidement.</para> </refsect1> </refentry> - <refentry id="function.posix-getgrnam"> <refnamediv> <refname>posix_getgrnam</refname> @@ -581,7 +557,6 @@ Encore à faire.</para> </refsect1> </refentry> - <refentry id="function.posix-getgrgid"> <refnamediv> <refname>posix_getgrgid</refname> @@ -599,7 +574,6 @@ Encore à faire.</para> </refsect1> </refentry> - <refentry id="function.posix-getpwnam"> <refnamediv> <refname>posix_getpwnam</refname> @@ -614,12 +588,12 @@ </funcprototype> </funcsynopsis> <para> - Retourne un tableau associatif qui contient des informations à - propos d'un utilisateur, identifié par son nom, passé + Retourne un tableau associatif qui contient des informations à + propos d'un utilisateur, identifié par son nom, passé en paramètre <parameter>username</parameter>. </para> <para> - Les éléments du tableau sont : + Les éléments du tableau sont : <table> <title>Le tableau descriptif d'un utilisateur</title> <tgroup cols="2"> @@ -634,7 +608,7 @@ <entry>name</entry> <entry> Le nom contient le nom de l'utilisateur. Généralement, - c'est un nom court, de moins de 16 caractères, mais ce n'est + c'est un nom court, de moins de 16 caractères, mais ce n'est pas son nom réel et complet. Cette valeur devrait correspondre au paramètre <parameter>username</parameter>, et donc, il est redondant. @@ -643,9 +617,9 @@ <row> <entry>passwd</entry> <entry> - Contient le mot de passe de l'utilisateur, encrypté. - Souvent, dans les systèmes utilisant les mots de passe - "fantômes", un astérisque est retourné. + Contient le mot de passe de l'utilisateur, encrypté. + Souvent, dans les systèmes utilisant les mots de passe + "fantômes", un astérisque est retourné. </entry> </row> <row> @@ -657,8 +631,8 @@ <row> <entry>gid</entry> <entry> - L'ID du groupe de l'utilisateur. Utilisez la fonction - <function>posix_getgrgid</function> pour connaitre le nom du groupe, + L'ID du groupe de l'utilisateur. Utilisez la fonction + <function>posix_getgrgid</function> pour connaitre le nom du groupe, et ses membres. </entry> </row> @@ -666,21 +640,21 @@ <entry>gecos</entry> <entry> GECOS est un terme obsolète qui fait référence - aux données de finger, sur un système Honeywell. Le - champs, cependant, a survécu, et son contenu a - été formalisé par POSIX. Le champs - contient une liste, séparée par des virgules, qui - contient le nom complet de l'utilisateur, son - téléphone professionnel, son numéro de - téléphone bureau, et son numéro de - téléphone personnel. Sur la plus part des + aux données de finger, sur un système Honeywell. Le + champs, cependant, a survécu, et son contenu a + été formalisé par POSIX. Le champs + contient une liste, séparée par des virgules, qui + contient le nom complet de l'utilisateur, son + téléphone professionnel, son numéro de + téléphone bureau, et son numéro de + téléphone personnel. Sur la plus part des sytèmes, seul le nom est disponible. </entry> </row> <row> <entry>dir</entry> <entry> - Cet élément contient le chemin absolu jusqu'au + Cet élément contient le chemin absolu jusqu'au dossier racine de l'utilisateur. </entry> </row> @@ -694,10 +668,9 @@ </tbody> </tgroup> </table> - </para> + </para> </refsect1> </refentry> - <refentry id="function.posix-getpwuid"> <refnamediv> <refname>posix_getpwuid</refname> @@ -712,12 +685,12 @@ </funcprototype> </funcsynopsis> <para> - Retourne un tableau associatif contenant des informations - sur un utilisateur repéré par son UID, + Retourne un tableau associatif contenant des informations + sur un utilisateur repéré par son UID, passé dans le paramètre <parameter>uid</parameter>. </para> <para> - Les éléments du tableau sont : + Les éléments du tableau sont : <table> <title>Le tableau de description d'un utilisateur</title> <tgroup cols="2"> @@ -732,29 +705,29 @@ <entry>name</entry> <entry> Le nom contient le nom de l'utilisateur. Généralement, - c'est un nom court, de moins de 16 caractères, mais ce - n'est pas son nom réel et complet. + c'est un nom court, de moins de 16 caractères, mais ce + n'est pas son nom réel et complet. </entry> </row> <row> <entry>passwd</entry> <entry> Contient le mot de passe de l'utilisateur, encrypté. Souvent, - dans les systèmes utilisant les mots de passes + dans les systèmes utilisant les mots de passes "fantômes", un astérisque est retourné. </entry> </row> <row> <entry>uid</entry> <entry> - Cette valeur devrait correspondre au paramètre + Cette valeur devrait correspondre au paramètre <parameter>uid</parameter>, et donc, il est redondant. </entry> </row> <row> <entry>gid</entry> <entry> - L'ID du groupe de l'utilisateur. Utilisez la fonction + L'ID du groupe de l'utilisateur. Utilisez la fonction <function>posix_getgrgid</function> pour connaître le nom du groupe, et ses membres. </entry> @@ -762,30 +735,30 @@ <row> <entry>gecos</entry> <entry> - GECOS est un terme obsolète qui fait - référence aux données de finger, - sur un système Honeywell. Le champs, cependant, - a survécu, et son contenu a été - formalisé par POSIX. Le champs contient une liste, - séparée par des virgules, qui contient le nom - complet de l'utilisateur, son téléphone - professionne, son numéro de bureau, et son numéro - de téléphone personnel. + GECOS est un terme obsolète qui fait + référence aux données de finger, + sur un système Honeywell. Le champs, cependant, + a survécu, et son contenu a été + formalisé par POSIX. Le champs contient une liste, + séparée par des virgules, qui contient le nom + complet de l'utilisateur, son téléphone + professionne, son numéro de bureau, et son numéro + de téléphone personnel. Sur la plus part des sytèmes, seul le nom est disponible. </entry> </row> <row> <entry>dir</entry> <entry> - Cet élément contient le chemin absolu jusqu'au + Cet élément contient le chemin absolu jusqu'au dossier racine de l'utilisateur. </entry> </row> <row> <entry>shell</entry> <entry> - Cet élément contient le chemin absolu - jusqu'au dossier d'éxécution du shell + Cet élément contient le chemin absolu + jusqu'au dossier d'éxécution du shell de l'utilisateur. </entry> </row> @@ -795,7 +768,6 @@ </para> </refsect1> </refentry> - <refentry id="function.posix-getrlimit"> <refnamediv> <refname>posix_getrlimit</refname> @@ -813,9 +785,7 @@ Encore à faire rapidement.</para> </refsect1> </refentry> - </reference> - <!-- Keep this comment at the end of the file Local variables: mode: sgml Index: phpdoc/fr/functions/pspell.xml diff -u phpdoc/fr/functions/pspell.xml:1.4 phpdoc/fr/functions/pspell.xml:1.5 --- phpdoc/fr/functions/pspell.xml:1.4 Fri Dec 8 02:05:36 2000 +++ phpdoc/fr/functions/pspell.xml Fri Jan 26 06:44:21 2001 @@ -42,11 +42,13 @@ <example> <title>Exemple avec <function>pspell_add_to_personal</function></title> <programlisting role="php"> +<?php $pspell_config = pspell_config_create ("en"); pspell_config_personal ($pspell_config, "/var/dictionaries/custom.pws"); $pspell_link = pspell_new_config ($pspell_config); pspell_add_to_personal ($pspell_link, "Vlad"); pspell_save_wordlist ($pspell_link); +?> </programlisting> </example> </para> @@ -90,18 +92,20 @@ </funcsynopsis> <simpara> <function>pspell_check</function> vérifie l'orthographe d'un mot - et retourne TRUE si l'orthographe est correcte, FALSE sinon. + et retourne <literal>TRUE</literal> si l'orthographe est correcte, <literal>FALSE</literal> sinon. </simpara> <para> <example> <title><function>pspell_check</function></title> <programlisting role="php"> +<?php $pspell_link = pspell_new ("french"); if (pspell_check ($pspell_link, "testt")) { echo "L'orthographe est exacte"; } else { echo "Désolé, mauvaise orthographe"; } +?> </programlisting> </example> </para> @@ -130,12 +134,14 @@ <example> <title>Exemple avec <function>pspell_add_to_personal</function></title> <programlisting role="php"> +<?php $pspell_config = pspell_config_create ("en"); pspell_config_personal ($pspell_config, "/var/dictionaries/custom.pws"); $pspell_link = pspell_new_config ($pspell_config); pspell_add_to_personal ($pspell_link, "Vlad"); pspell_clear_session ($pspell_link); pspell_save_wordlist ($pspell_link); //"Vlad" ne sera pas sauvé +?> </programlisting> </example> </para> @@ -234,10 +240,12 @@ <example> <title>Exemple avec <function>pspell_config_create</function></title> <programlisting role="php"> +<?php $pspell_config = pspell_config_create ("en"); pspell_config_personal ($pspell_config, "/var/dictionaries/custom.pws"); pspell_config_repl ($pspell_config, "/var/dictionaries/custom.repl"); $pspell_link = pspell_new_personal (pspell_config); +?> </programlisting> </example> </para> @@ -266,10 +274,12 @@ <example> <title>Exemple avec <function>pspell_config_ignore</function></title> <programlisting role="php"> +<?php $pspell_config = pspell_config_create ("en"); pspell_config_ignore($pspell_config, 5); $pspell_link = pspell_new_config($pspell_config); pspell_check($pspell_link, "abcd"); // Ce mot ne provoquera pas d'erreur +?> </programlisting> </example> </para> @@ -320,10 +330,12 @@ <example> <title><function>pspell_config_mode</function></title> <programlisting role="php"> +<?php $pspell_config = pspell_config_create ("en"); pspell_config_mode($pspell_config, PSPELL_FAST); $pspell_link = pspell_new_config($pspell_config); pspell_check($pspell_link, "thecat"); +?> </programlisting> </example> </para> @@ -362,10 +374,12 @@ <example> <title>Exemple avec <function>pspell_config_personal</function></title> <programlisting role="php"> +<?php $pspell_config = pspell_config_create ("en"); pspell_config_personal ($pspell_config, "/var/dictionaries/custom.pws"); $pspell_link = pspell_new_config ($pspell_config); pspell_check ($pspell_link, "thecat"); +?> </programlisting> </example> </para> @@ -402,11 +416,13 @@ <example> <title>Exemple avec <function>pspell_config_repl</function></title> <programlisting role="php"> +<?php $pspell_config = pspell_config_create ("en"); pspell_config_personal ($pspell_config, "/var/dictionaries/custom.pws"); pspell_config_repl ($pspell_config, "/var/dictionaries/custom.repl"); $pspell_link = pspell_new_config ($pspell_config); pspell_check ($pspell_link, "thecat"); +?> </programlisting> </example> </para> @@ -443,10 +459,12 @@ <example> <title>Exemple avec <function>pspell_config_runtogether</function></title> <programlisting role="php"> +<?php $pspell_config = pspell_config_create ("en"); -pspell_config_runtogether ($pspell_config, true); +pspell_config_runtogether ($pspell_config, <literal>TRUE</literal>); $pspell_link = pspell_new_config ($pspell_config); pspell_check ($pspell_link, "thecat"); +?> </programlisting> </example> </para> @@ -580,10 +598,12 @@ <example> <title><function>pspell_new</function></title> <programlisting role="php"> -$pspell_link = pspell_new ("en", "", "", "", - (PSPELL_FAST|PSPELL_RUN_TOGETHER)); +<?php +$pspell_link = pspell_new("en", "", "", "", (PSPELL_FAST|PSPELL_RUN_TOGETHER)); +?> </programlisting> - </example> </para> + </example> + </para> </refsect1> </refentry> <refentry id="function.pspell-new-config"> @@ -618,10 +638,12 @@ <example> <title><function>pspell_new_config</function></title> <programlisting role="php"> +<?php $pspell_config = pspell_config_create ("en"); pspell_config_personal ($pspell_config, "/var/dictionaries/custom.pws"); pspell_config_repl ($pspell_config, "/var/dictionaries/custom.repl"); $pspell_link = pspell_new_personal (pspell_config); +?> </programlisting> </example> </para> @@ -737,8 +759,9 @@ <example> <title>Exemple avec <function>pspell_new_personal</function></title> <programlisting role="php"> -$pspell_link = pspell_new_personal ("/var/dictionaries/custom.pws", - "en", "", "", "", PSPELL_FAST|PSPELL_RUN_TOGETHER)); +<?php +$pspell_link = pspell_new_personal ("/var/dictionaries/custom.pws", "en", "", "", "", PSPELL_FAST|PSPELL_RUN_TOGETHER)); +?> </programlisting> </example> </para> @@ -771,11 +794,13 @@ <example> <title>Exemple <function>pspell_add_to_personal</function></title> <programlisting role="php"> +<?php $pspell_config = pspell_config_create ("en"); pspell_config_personal ($pspell_config, "/tmp/dicts/newdict"); $pspell_link = pspell_new_config ($pspell_config); pspell_add_to_personal ($pspell_link, "Vlad"); pspell_save_wordlist ($pspell_link); +?> </programlisting> </example> </para> @@ -816,12 +841,14 @@ <example> <title>Exemple avec <function>pspell_store_replacement</function></title> <programlisting role="php"> +<?php $pspell_config = pspell_config_create ("en"); pspell_config_personal ($pspell_config, "/var/dictionaries/custom.pws"); pspell_config_repl ($pspell_config, "/var/dictionaries/custom.repl"); $pspell_link = pspell_new_config ($pspell_config); pspell_store_replacement ($pspell_link, $misspelled, $correct); pspell_save_wordlist ($pspell_link); +?> </programlisting> </example> </para> @@ -849,6 +876,7 @@ <example> <title><function>pspell_suggest</function></title> <programlisting role="php"> +<?php $pspell_link = pspell_new ("english"); if (!pspell_check ($pspell_link, "testt")){ $suggestions = pspell_suggest ($pspell_link, "testt"); @@ -856,6 +884,7 @@ echo "Orthographes suggerées : " . $suggestions[$i] . "<br>"; } } +?> </programlisting> </example> </para> Index: phpdoc/fr/functions/network.xml diff -u phpdoc/fr/functions/network.xml:1.9 phpdoc/fr/functions/network.xml:1.10 --- phpdoc/fr/functions/network.xml:1.9 Wed Dec 13 05:59:15 2000 +++ phpdoc/fr/functions/network.xml Fri Jan 26 06:44:21 2001 @@ -20,8 +20,8 @@ <simpara> <function>checkdnsrr</function> recherche l'enregistrement DNS de type <parameter>type</parameter> correspondant à l'hôte - <parameter>host</parameter>. Retourne TRUE si un record a été - trouvé, et FALSE en cas d'erreur ou d'échec. + <parameter>host</parameter>. Retourne <literal>TRUE</literal> si un record a été + trouvé, et <literal>FALSE</literal> en cas d'erreur ou d'échec. </simpara> <simpara> <parameter>type</parameter> peut prendre les valeurs suivantes : @@ -172,11 +172,11 @@ <function>feof</function>. </para> <para> - Si l'appel échoue, <function>fsockopen</function> retourne FALSE, + Si l'appel échoue, <function>fsockopen</function> retourne <literal>FALSE</literal>, et si les options <parameter>errno</parameter> et <parameter>errstr</parameter> ont été fournies, elles contiennent désormais les raisons de l'échec. Si l'erreur retournée est 0 et que la - fonction retourne FALSE, c'est une indication d'erreur. C'est probablement + fonction retourne <literal>FALSE</literal>, c'est une indication d'erreur. C'est probablement du à une erreur d'initialisation de la socket. Notez que <parameter>errno</parameter> et <parameter>errstr</parameter> sont passées par référence. @@ -190,8 +190,9 @@ changer de mode en utilisant : <function>socket_set_blocking</function>. <example> <title>Exemple avec <function>fsockopen</function></title> - <programlisting> -$fp = fsockopen("www.php.net", 80, &$errno, &$errstr, 30); + <programlisting role="php"> +<?php +$fp = fsockopen("www.php.net", 80, &$errno, &$errstr, 30); if(!$fp) { echo "$errstr ($errno)<br>\n"; } else { @@ -201,6 +202,7 @@ } fclose($fp); } +?> </programlisting> </example> L'exemple ci-dessous décrit comment lire la date et l'heure grâce à @@ -329,8 +331,8 @@ <simpara> <function>getmxrr</function> effectue une recherche DNS pour obtenir les enregistrements MX de l'hôte <parameter>hostname</parameter>. - Retourne TRUE si des enregistrements sont trouvés, et - FALSE si une erreur est rencontrée, ou si la recherche + Retourne <literal>TRUE</literal> si des enregistrements sont trouvés, et + <literal>FALSE</literal> si une erreur est rencontrée, ou si la recherche échoue. </simpara> <simpara> @@ -457,7 +459,7 @@ <refnamediv> <refname>ip2long</refname> <refpurpose> - Converti une chaîne contenant une adresse (IPv4) + Convertit une chaîne contenant une adresse (IPv4) IP numérique en adresse litérale. </refpurpose> </refnamediv> @@ -478,7 +480,7 @@ <?php $ip = gethostbyname("www.php.net"); $out = "Les URLS suivantes sont équivalentes :<br>\n"; -$out .= "http://www.php.net/, http://".$ip."/, and http://".ip2long($ip)."/<br>\n"; +$out .= "http://www.php.net/, http://".$ip."/, et http://".ip2long($ip)."/<br>\n"; echo $out; ?> </programlisting> @@ -493,7 +495,7 @@ <refnamediv> <refname>long2ip</refname> <refpurpose> - Converti une adresse IP (IPv4) en adresse IP numérique + Convertit une adresse IP (IPv4) en adresse IP numérique </refpurpose> </refnamediv> <refsect1> @@ -724,14 +726,14 @@ <itemizedlist> <listitem> <para> - <parameter>timed_out</parameter> (bool) - La socket a expirée en + <parameter>timed_out</parameter> (bool) - La socket a éxpirée en attendant des données </para> </listitem> <listitem> <para> - <parameter>blocked</parameter> (bool) - La socket a - été bloquée + <parameter>blocked</parameter> (bool) - La socket a été + bloquée </para> </listitem> <listitem> @@ -748,19 +750,16 @@ </listitem> </itemizedlist> <para> - Voir aussi - <function>accept_connect</function>, - <function>bind</function>, - <function>connect</function>, - <function>listen</function>, et - <function>strerror</function>. + Voir aussi <function>accept_connect</function>, + <function>bind</function>, <function>connect</function>, + <function>listen</function> et <function>strerror</function>. </para> </refsect1> </refentry> <refentry id="function.socket-set-blocking"> <refnamediv> <refname>socket_set_blocking</refname> - <refpurpose>Active/desactive le mode bloquant d'une socket.</refpurpose> + <refpurpose>Active/désactive le mode bloquant d'une socket.</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -772,13 +771,13 @@ </funcprototype> </funcsynopsis> <para> - Si <parameter>mode</parameter> est FALSE, la socket est mise en - mode non bloquant, et si il est TRUE, la socket est mise en mode + Si <parameter>mode</parameter> est <literal>FALSE</literal>, la socket est mise en + mode non bloquant, et si il est <literal>TRUE</literal>, la socket est mise en mode bloquant. Cela affecte des appels tels que <function>fgets</function> qui lisent depuis une socket. En mode non bloquant, un appel <function>fgets</function> retournera immediatement toujours - TRUE tandis qu'en mode bloquant, elle va attendre que des - données arrivent pour répondre TRUE. + <literal>TRUE</literal> tandis qu'en mode bloquant, elle va attendre que des + données arrivent pour répondre <literal>TRUE</literal>. </para> </refsect1> </refentry>
Index: phpdoc/fr/functions/nis.xml diff -u phpdoc/fr/functions/nis.xml:1.3 phpdoc/fr/functions/nis.xml:1.4 --- phpdoc/fr/functions/nis.xml:1.3 Fri Dec 8 02:16:18 2000 +++ phpdoc/fr/functions/nis.xml Fri Jan 26 06:44:21 2001 @@ -1,5 +1,5 @@ <reference id="ref.nis"> - <title>Fonctions NIS</title> + <title>NIS</title> <titleabbrev>NIS</titleabbrev> <partintro> <para> @@ -48,7 +48,7 @@ <?php $domain = yp_get_default_domain(); echo "Le domaine par défaut est : " . $domain; -?> +?> </programlisting> </example> </para> @@ -76,7 +76,7 @@ </funcsynopsis> <para> <function>yp_order</function> retourne le numéro d'ordre d'une - carte ou FALSE. + carte ou <literal>FALSE</literal>. </para> <para> <example> @@ -85,7 +85,7 @@ <?php $number = yp_order($domain,$mapname); echo "Le numéro d'ordre de cette carte est : " . $order; -?> +?> </programlisting> </example> </para> @@ -125,7 +125,7 @@ <?php $number = yp_master($domain, $mapname); echo "Master for this map is: " . $master; -?> +?> </programlisting> </example> </para> @@ -156,7 +156,7 @@ <para> <function>yp_match</function> retourne la valeur associée à la clé passée en argument, pour la carte - spécifiée, ou FALSE. La clé doit exister et + spécifiée, ou <literal>FALSE</literal>. La clé doit exister et être exacte. </para> <para> @@ -166,7 +166,7 @@ <?php $entry = yp_match($domain, "passwd.byname", "joe"); echo "La valeur trouvée est: " . $entry; -?> +?> </programlisting> </example> </para> @@ -200,7 +200,7 @@ </funcsynopsis> <para> <function>yp_first</function> retourne le premier couple - (clé ; valeur) d'une carte donnée, ou FALSE. + (clé ; valeur) d'une carte donnée, ou <literal>FALSE</literal>. </para> <para> <example> @@ -211,7 +211,7 @@ $key = key($entry); echo "La première entrée de cette carte est " . $key . " et sa valeur est " . $entry[$key]; -?> +?> </programlisting> </example> </para> @@ -243,7 +243,7 @@ </funcsynopsis> <para> <function>yp_next</function> retourne le couple (clé ; valeur) - suivant la clé donnée d'une carte donnée ou FALSE. + suivant la clé donnée d'une carte donnée ou <literal>FALSE</literal>. </para> <para> <example> @@ -257,7 +257,7 @@ $key = key($entry); echo "L'entree suivante après joe a la cle " . $key . " et sa valeur " . $entry[$key]; -?> +?> </programlisting> </example> </para> @@ -346,9 +346,10 @@ <programlisting role="php"> <?php echo "Error: " . yp_err_string(); -?> +?> </programlisting> - </example></para> + </example> + </para> <para> Voir aussi : <link linkend="function.yp-errno"> yp_errno</link> </para> Index: phpdoc/fr/functions/oci8.xml diff -u phpdoc/fr/functions/oci8.xml:1.5 phpdoc/fr/functions/oci8.xml:1.6 --- phpdoc/fr/functions/oci8.xml:1.5 Wed Nov 29 05:31:26 2000 +++ phpdoc/fr/functions/oci8.xml Fri Jan 26 06:44:21 2001 @@ -1,5 +1,5 @@ <reference id="ref.oci8"> - <title>Oracle 8 functions</title> + <title>Oracle 8</title> <titleabbrev>OCI8</titleabbrev> <partintro> <para> @@ -53,7 +53,7 @@ </itemizedlist> </para> <para> - Après avoir configuré ces varaibles pour votre utilisateur "serveur + Après avoir configuré ces variables pour votre utilisateur "serveur web", assurez vous aussi d'ajouter cet utilisateur (nobody, www) au group Oracle. </para> @@ -73,7 +73,7 @@ field2 = empty_clob()) returning field2 into :field2"; OCIParse($conn, $sql); $clob = OCINewDescriptor($conn, OCI_D_LOB); -OCIBindByName ($stmt, ":field2", &$clob, -1, OCI_B_CLOB); +OCIBindByName ($stmt, ":field2", &$clob, -1, OCI_B_CLOB); OCIExecute($stmt, OCI_DEFAULT); $clob->save ("some text"); ?> @@ -126,7 +126,7 @@ SQL <parameter>Column-Name</parameter> dans les variables PHP. Méfiez-vous des colonnes Oracle qui sont toutes en majuscule, tandis que dans les SELECT, vous pouvez aussi les écrire en minuscules. - <function>ocidefinebyname</function> s'attend à ce que + <function>ocidefinebyname</function> s'attends à ce que <parameter>Column-Name</parameter> soit en majuscules. Si vous définissez une variable qui n'existe pas dans la commande SELECT, vous ne serez pas prévenu par une erreur. @@ -139,14 +139,14 @@ </para> <example> <title>OCIDefineByName</title> - <programlisting> + <programlisting role="php"> <?php /* Exemple OCIDefineByPos par thies@thieso.net (980219) */ $conn = OCILogon("scott","tiger"); $stmt = OCIParse($conn,"select empno, ename from emp"); /* La définition DOIT être faîte AVANT ociexecute! */ -OCIDefineByName($stmt,"EMPNO",&$empno); -OCIDefineByName($stmt,"ENAME",&$ename); +OCIDefineByName($stmt,"EMPNO",&$empno); +OCIDefineByName($stmt,"ENAME",&$ename); OCIExecute($stmt); while (OCIFetch($stmt)) { echo "empno:".$empno."\n"; @@ -154,7 +154,9 @@ } OCIFreeStatement($stmt); OCILogoff($conn); -?></programlisting></example> +?> + </programlisting> + </example> </refsect1> </refentry> <refentry id="function.ocibindbyname"> @@ -200,7 +202,7 @@ </para> <example> <title>OCIDefineByName</title> - <programlisting> + <programlisting role="php"> <?php /* Exemple OCIBindByPos par thies@thieso.net (980221) Insère 3 lignes dans emp, et utilise ROWID pour mettre à jour @@ -210,14 +212,14 @@ $stmt = OCIParse($conn,"insert into emp (empno, ename) ". "values (:empno,:ename) ". "returning ROWID into :rid"); -$data = array(1111 => "Larry", 2222 => "Bill", 3333 => "Jim"); +$data = array(1111 => "Larry", 2222 => "Bill", 3333 => "Jim"); $rowid = OCINewDescriptor($conn,OCI_D_ROWID); -OCIBindByName($stmt,":empno",&$empno,32); -OCIBindByName($stmt,":ename",&$ename,32); -OCIBindByName($stmt,":rid",&$rowid,-1,OCI_B_ROWID); +OCIBindByName($stmt,":empno",&$empno,32); +OCIBindByName($stmt,":ename",&$ename,32); +OCIBindByName($stmt,":rid",&$rowid,-1,OCI_B_ROWID); $update = OCIParse($conn,"update emp set sal = :sal where ROWID = :rid"); -OCIBindByName($update,":rid",&$rowid,-1,OCI_B_ROWID); -OCIBindByName($update,":sal",&$sal,32); +OCIBindByName($update,":rid",&$rowid,-1,OCI_B_ROWID); +OCIBindByName($update,":sal",&$sal,32); $sal = 10000; while (list($empno,$ename) = each($data)) { OCIExecute($stmt); @@ -228,7 +230,7 @@ OCIFreeStatement($stmt); $stmt = OCIParse($conn,"select * from emp where empno in (1111,2222,3333)"); OCIExecute($stmt); -while (OCIFetchInto($stmt,&$arr,OCI_ASSOC)) { +while (OCIFetchInto($stmt,&$arr,OCI_ASSOC)) { var_dump($arr); } OCIFreeStatement($stmt); @@ -237,7 +239,7 @@ OCIExecute($stmt); OCIFreeStatement($stmt); OCILogoff($conn); -?> +?> </programlisting> </example> </refsect1> @@ -276,7 +278,7 @@ Cet exemple montre comment les connexions sont partagées : <example> <title>OCILogon</title> - <programlisting> + <programlisting role="php"> <?php print "<HTML><PRE>"; $db = ""; @@ -338,7 +340,7 @@ select_data($c2); // Aucune ligne n'est retournée drop_table($c1); print "</PRE></HTML>"; -?> +?> </programlisting> </example> </para> @@ -417,7 +419,7 @@ séparées. <example> <title>OCINLogon</title> - <programlisting> + <programlisting role="php"> <?php print "<HTML><PRE>"; $db = ""; @@ -478,7 +480,7 @@ select_data($c2); drop_table($c1); print "</PRE></HTML>"; -?> +?> </programlisting> </example> </para> @@ -594,7 +596,7 @@ </para> <example> <title>OCINewDescriptor</title> - <programlisting> + <programlisting role="php"> <?php /* Ce script est fait pour être appelé dans un formulaire HTML * Il attends les variables $user, $password, $table, $where, et $commitsize @@ -605,12 +607,12 @@ $conn = OCILogon($user, $password); $stmt = OCIParse($conn,"select rowid from $table $where"); $rowid = OCINewDescriptor($conn,OCI_D_ROWID); - OCIDefineByName($stmt,"ROWID",&$rowid); + OCIDefineByName($stmt,"ROWID",&$rowid); OCIExecute($stmt); while ( OCIFetch($stmt) ) { $nrows = OCIRowCount($stmt); $delete = OCIParse($conn,"delete from $table where ROWID = :rid"); - OCIBindByName($delete,":rid",&$rowid,-1,OCI_B_ROWID); + OCIBindByName($delete,":rid",&$rowid,-1,OCI_B_ROWID); OCIExecute($delete); print "$nrows\n"; if ( ($nrows % $commitsize) == 0 ) { @@ -621,16 +623,17 @@ print "$nrows effacées...\n"; OCIFreeStatement($stmt); OCILogoff($conn); -?> - </programlisting><programlisting> +?> + </programlisting> + <programlisting role="php"> <?php /* Ce script est fait pour être appelé depuis un formulaire HTML. - * Il attend les variables $user, $password, $table, $where, et $commitsize, + * Il attends les variables $user, $password, $table, $where, et $commitsize, * données par le formulaire. Le script efface * les lignes selectionnées avec ROWID est valide les transactions * à chaque jeu de $commitsize lignes. (Attention : il n'y plus d'annulation) */ if(!isset($lob_upload) || $lob_upload == 'none'){ -?> +?> <form action="upload.php3" method="post" enctype="multipart/form-data"> Upload file: <input type="file" name="lob_upload"><br> <input type="submit" value="Upload"> - <input type="reset"> @@ -641,7 +644,7 @@ $conn = OCILogon($user, $password); $lob = OCINewDescriptor($conn, OCI_D_LOB); $stmt = OCIParse($conn,"insert into $table (id, the_blob) values(my_seq.NEXTVAL, EMPTY_BLOB()) returning the_blob into :the_blob"); - OCIBindByName($stmt, ':the_blob', &$lob, -1, OCI_B_BLOB); + OCIBindByName($stmt, ':the_blob', &$lob, -1, OCI_B_BLOB); OCIExecute($stmt); if($lob->savefile($lob_upload)){ OCICommit($conn); @@ -653,8 +656,9 @@ OCIFreeStatement($stmt); OCILogoff($conn); } -?> - </programlisting></example> +?> + </programlisting> + </example> </refsect1> </refentry> <refentry id="function.ocirowcount"> @@ -679,7 +683,7 @@ <para> <example> <title>OCIRowCount</title> - <programlisting> + <programlisting role="php"> <?php print "<HTML><PRE>"; $conn = OCILogon("scott","tiger"); @@ -697,7 +701,7 @@ OCIFreeStatement($stmt); OCILogOff($conn); print "</PRE></HTML>"; -?> +?> </programlisting> </example> </para> @@ -722,7 +726,7 @@ </para> <example> <title>OCINumCols</title> - <programlisting> + <programlisting role="php"> <?php print "<HTML><PRE>\n"; $conn = OCILogon("scott", "tiger"); @@ -731,7 +735,7 @@ while ( OCIFetch($stmt) ) { print "\n"; $ncols = OCINumCols($stmt); - for ( $i = 1; $i <= $ncols; $i++ ) { + for ( $i = 1; $i <= $ncols; $i++ ) { $column_name = OCIColumnName($stmt,$i); $column_value = OCIResult($stmt,$i); print $column_name . ': ' . $column_value . "\n"; @@ -742,7 +746,7 @@ OCILogoff($conn); print "</PRE>"; print "</HTML>\n"; -?> +?> </programlisting> </example> </refsect1> @@ -860,14 +864,14 @@ </para> <example> <title>OCIFetchStatement</title> - <programlisting> + <programlisting role="php"> <?php /* exemple OCIFetchStatement par mbritton@verinet.com (990624) */ $conn = OCILogon("scott","tiger"); $stmt = OCIParse($conn,"select * from emp"); OCIExecute($stmt); $nrows = OCIFetchStatement($stmt,$results); -if ( $nrows > 0 ) { +if ( $nrows > 0 ) { print "<TABLE BORDER=\"1\">\n"; print "<TR>\n"; while ( list( $key, $val ) = each( $results ) ) { @@ -890,7 +894,7 @@ print "$nrows Records Selected<BR>\n"; OCIFreeStatement($stmt); OCILogoff($conn); -?> +?> </programlisting> </example> </refsect1> @@ -910,7 +914,7 @@ </funcprototype> </funcsynopsis> <para> - <function>ocicolumnisnull</function> retourne TRUE si la colonne + <function>ocicolumnisnull</function> retourne <literal>TRUE</literal> si la colonne <parameter>col</parameter> du résultat <parameter>stmt</parameter> est NULL. Vous pouvez utiliser le numéro de colonne (l'indexation des colonnes @@ -940,7 +944,7 @@ <para> <example> <title>OCIColumnName</title> - <programlisting> + <programlisting role="php"> <?php print "<HTML><PRE>\n"; $conn = OCILogon("scott", "tiger"); @@ -967,7 +971,7 @@ OCILogoff($conn); print "</PRE>"; print "</HTML>\n"; -?> +?> </programlisting> </example> </para> @@ -1001,7 +1005,7 @@ <para> <example> <title>OCIColumnSize</title> - <programlisting> + <programlisting role="php"> <?php print "<HTML><PRE>\n"; $conn = OCILogon("scott", "tiger"); @@ -1014,7 +1018,7 @@ print "<TH>Length</TH>"; print "</TR>"; $ncols = OCINumCols($stmt); - for ( $i = 1; $i <= $ncols; $i++ ) { + for ( $i = 1; $i <= $ncols; $i++ ) { $column_name = OCIColumnName($stmt,$i); $column_type = OCIColumnType($stmt,$i); $column_size = OCIColumnSize($stmt,$i); @@ -1029,7 +1033,7 @@ OCILogoff($conn); print "</PRE>"; print "</HTML>\n"; -?> +?> </programlisting> </example> </para> @@ -1060,7 +1064,7 @@ <para> <example> <title>OCIColumnType</title> - <programlisting> + <programlisting role="php"> <?php print "<HTML><PRE>\n"; $conn = OCILogon("scott", "tiger"); @@ -1073,7 +1077,7 @@ print "<TH>Length</TH>"; print "</TR>"; $ncols = OCINumCols($stmt); - for ( $i = 1; $i <= $ncols; $i++ ) { + for ( $i = 1; $i <= $ncols; $i++ ) { $column_name = OCIColumnName($stmt,$i); $column_type = OCIColumnType($stmt,$i); $column_size = OCIColumnSize($stmt,$i); @@ -1087,7 +1091,7 @@ OCILogoff($conn); print "</PRE>"; print "</HTML>\n"; -?> +?> </programlisting> </example> </para> @@ -1115,12 +1119,12 @@ informations de version du serveur <example> <title>OCIServerVersion</title> - <programlisting> + <programlisting role="php"> <?php $conn = OCILogon("scott","tiger"); print "Version du serveur : " . OCIServerVersion($conn); OCILogOff($conn); -?> +?> </programlisting> </example> </para> @@ -1152,11 +1156,12 @@ <listitem><simpara> "BEGIN"</simpara></listitem> <listitem><simpara> "DECLARE"</simpara></listitem> <listitem><simpara> "UNKNOWN"</simpara></listitem> - </orderedlist></para> + </orderedlist> + </para> <para> <example> <title>Exemples</title> - <programlisting> + <programlisting role="php"> <?php print "<HTML><PRE>"; $conn = OCILogon("scott","tiger"); @@ -1167,7 +1172,7 @@ } OCILogoff($conn); print "</PRE></HTML>"; -?> +?> </programlisting> </example> </para> @@ -1198,30 +1203,30 @@ <title> Utiliser un REF CURSOR issue d'une procédure enregistrée. </title> - <programlisting> + <programlisting role="php"> <?php // supposons que votre procédure stoquée info.output retourne un pointeur // de curseur dans : data $conn = OCILogon("scott","tiger"); $curs = OCINewCursor($conn); $stmt = OCIParse($conn,"begin info.output(:data); end;"); -ocibindbyname($stmt,"data",&$curs,-1,OCI_B_CURSOR); +ocibindbyname($stmt,"data",&$curs,-1,OCI_B_CURSOR); ociexecute($stmt); ociexecute($curs); -while (OCIFetchInto($curs,&$data)) { +while (OCIFetchInto($curs,&$data)) { var_dump($data); } OCIFreeCursor($stmt); OCIFreeStatement($curs); OCILogoff($conn); -?> +?> </programlisting> </example> </para> <para> <example> <title>Utiliser un REF CURSOR issue d'une commande SELECT</title> - <programlisting> + <programlisting role="php"> <?php print "<HTML><BODY>"; $conn = OCILogon("scott","tiger"); @@ -1235,14 +1240,14 @@ print "<TH>DEPT #</TH>"; print "<TH># EMPLOYEES</TH>"; print "</TR>"; -while (OCIFetchInto($stmt,&$data,OCI_ASSOC)) { +while (OCIFetchInto($stmt,&$data,OCI_ASSOC)) { print "<TR>"; $dname = $data["DNAME"]; $deptno = $data["DEPTNO"]; print "<TD>$dname</TD>"; print "<TD>$deptno</TD>"; ociexecute($data[ "EMPCNT" ]); - while (OCIFetchInto($data[ "EMPCNT" ],&$subdata,OCI_ASSOC)) { + while (OCIFetchInto($data[ "EMPCNT" ],&$subdata,OCI_ASSOC)) { $num_emps = $subdata["NUM_EMPS"]; print "<TD>$num_emps</TD>"; } @@ -1252,7 +1257,7 @@ print "</BODY></HTML>"; OCIFreeStatement($stmt); OCILogoff($conn); -?> +?> </programlisting> </example> </para> @@ -1274,8 +1279,8 @@ </funcprototype> </funcsynopsis> <para> - <function>ocifreestatement</function> retourne TRUE en cas de succès, - et FALSE en cas d'échec. + <function>ocifreestatement</function> retourne <literal>TRUE</literal> en cas de succès, + et <literal>FALSE</literal> en cas d'échec. </para> </refsect1> </refentry> @@ -1295,8 +1300,8 @@ </funcprototype> </funcsynopsis> <para> - <function>ocifreecursor</function> retourne TRUE en cas de - succès, et FALSE en cas d'échec. + <function>ocifreecursor</function> retourne <literal>TRUE</literal> en cas de + succès, et <literal>FALSE</literal> en cas d'échec. </para> </refsect1> </refentry> @@ -1314,8 +1319,8 @@ </funcprototype> </funcsynopsis> <para> - <function>ocifreedesc</function> retourne TRUE en cas de - succès, et FALSE en cas d'échec. + <function>ocifreedesc</function> retourne <literal>TRUE</literal> en cas de + succès, et <literal>FALSE</literal> en cas d'échec. </para> </refsect1> </refentry> @@ -1336,8 +1341,8 @@ <simpara> <function>ociparse</function> analyse la requête <parameter>query</parameter> sur la connexion - <parameter>conn</parameter>, et retourne TRUE si la requête - <parameter>query</parameter> est valide, et FALSE, si + <parameter>conn</parameter>, et retourne <literal>TRUE</literal> si la requête + <parameter>query</parameter> est valide, et <literal>FALSE</literal>, si ce n'est pas le cas. <parameter>query</parameter> peut être n'importe quelle requête SQL. </simpara> @@ -1359,7 +1364,7 @@ <function>ocierror</function> retourne la dernière erreur trouvée. Si l'option <parameter>stmt|conn</parameter> n'est pas fournie, la dernière erreur rencontrée est retournée. Si aucune erreur n'est trouvée, <function>ocierror</function> - retourne FALSE. + retourne <literal>FALSE</literal>. </simpara> </refsect1> </refentry> Index: phpdoc/fr/functions/openssl.xml diff -u phpdoc/fr/functions/openssl.xml:1.2 phpdoc/fr/functions/openssl.xml:1.3 --- phpdoc/fr/functions/openssl.xml:1.2 Thu Dec 28 00:43:03 2000 +++ phpdoc/fr/functions/openssl.xml Fri Jan 26 06:44:21 2001 @@ -49,7 +49,7 @@ </funcsynopsis> <para> <function>openssl_get_privatekey</function> retourne un identifiant - de clé positif, ou FALSE en cas d'erreur. + de clé positif, ou <literal>FALSE</literal> en cas d'erreur. </para> <para> <function>openssl_get_privatekey</function> analyse la clé privée @@ -75,7 +75,7 @@ </funcsynopsis> <para> <function>openssl_get_publickey</function> retourne un identifiant - de clé positif, ou FALSE en cas d'erreur. + de clé positif, ou <literal>FALSE</literal> en cas d'erreur. </para> <para> <function>openssl_get_publickey</function> extrait la clé publique @@ -101,8 +101,8 @@ </funcprototype> </funcsynopsis> <para> - <function>openssl_open</function> TRUE en cas de succès, et FALSE sinon. - En cas de succès, les données déchiffrées + <function>openssl_open</function> <literal>TRUE</literal> en cas de succès, et <literal>FALSE</literal> sinon. + En cas de succès, les données déchiffrées sont placées dans <parameter>open_data</parameter>. </para> <para> @@ -160,21 +160,21 @@ </funcsynopsis> <para> <function>openssl_seal</function> retourne la longueur des données - scellées en cas de succès, et FALSE sinon. En cas de succès, les données + scellées en cas de succès, et <literal>FALSE</literal> sinon. En cas de succès, les données scellées sont placées dans le paramètre <parameter>sealed_data</parameter>, et les clés d'enveloppe dans <parameter>env_keys</parameter>. </para> <para> <function>openssl_seal</function> scelle (chiffre) les données <parameter>data</parameter> en utilisant l'algorithme RC4 avec une clé - secrètre générée aléatoirement. La clé - est chiffrée avec chaque clé publique associée à - <parameter>pub_key_ids</parameter> et chaque clé ainsi - encryptée est retournée dans <parameter>env_keys</parameter>. - Cela signifique que vous pouvez envoyez des données scellées - à plusieurs destinataires (en supposant que chacun ait recu la - clé publique). Chaque destinataire doit recevoir les données - encryptées et la clé d'enveloppe, qui a été + secrètre générée aléatoirement. La clé + est chiffrée avec chaque clé publique associée à + <parameter>pub_key_ids</parameter> et chaque clé ainsi + encryptée est retournée dans <parameter>env_keys</parameter>. + Cela signifique que vous pouvez envoyez des données scellées + à plusieurs destinataires (en supposant que chacun ait recu la + clé publique). Chaque destinataire doit recevoir les données + encryptées et la clé d'enveloppe, qui a été encryptée avec la clé publique du destinataire. </para> <para> @@ -224,8 +224,8 @@ </funcprototype> </funcsynopsis> <para> - <function>openssl_sign</function> retourne TRUE en cas de succès, et - FALSE sinon. En cas de succès, la signature est placée dans + <function>openssl_sign</function> retourne <literal>TRUE</literal> en cas de succès, et + <literal>FALSE</literal> sinon. En cas de succès, la signature est placée dans <parameter>signature</parameter>. </para> <para> Index: phpdoc/fr/functions/oracle.xml diff -u phpdoc/fr/functions/oracle.xml:1.5 phpdoc/fr/functions/oracle.xml:1.6 --- phpdoc/fr/functions/oracle.xml:1.5 Tue Dec 26 03:26:33 2000 +++ phpdoc/fr/functions/oracle.xml Fri Jan 26 06:44:21 2001 @@ -1,5 +1,5 @@ <reference id="ref.oracle"> - <title>Fonctions Oracle</title> + <title>Oracle</title> <titleabbrev>Oracle</titleabbrev> <refentry id="function.ora-bind"> <refnamediv> @@ -19,8 +19,8 @@ </funcprototype> </funcsynopsis> <para> - <function>ora_bind</function> retourne TRUE si la liaison a pu se faire, et - sinon FALSE. Les erreurs sont accessibles avec les fonctions + <function>ora_bind</function> retourne <literal>TRUE</literal> si la liaison a pu se faire, et + sinon <literal>FALSE</literal>. Les erreurs sont accessibles avec les fonctions <function>ora_error</function> et <function>ora_errorcode</function>. </para> <para> @@ -69,8 +69,8 @@ </funcprototype> </funcsynopsis> <para> - <function>ora_close</function> retourne TRUE si la fermeture a bien eu - lieu, et FALSE sinon. Les erreurs sont accessibles avec les fonctions + <function>ora_close</function> retourne <literal>TRUE</literal> si la fermeture a bien eu + lieu, et <literal>FALSE</literal> sinon. Les erreurs sont accessibles avec les fonctions <function>ora_error</function> et <function>ora_errorcode</function>. </para> <para> @@ -150,7 +150,8 @@ <member><literal>"ROWID"</literal></member> <member><literal>"DATE"</literal></member> <member><literal>"CURSOR"</literal></member> - </simplelist></para> + </simplelist> + </para> </refsect1> </refentry> <refentry id="function.ora-commit"> @@ -167,8 +168,8 @@ </funcprototype> </funcsynopsis> <para> - <function>ora_commit</function> retourne TRUE si la validation a bien eu - lieu, et FALSE sinon. Les erreurs sont accessibles avec les fonctions + <function>ora_commit</function> retourne <literal>TRUE</literal> si la validation a bien eu + lieu, et <literal>FALSE</literal> sinon. Les erreurs sont accessibles avec les fonctions <function>ora_error</function> et <function>ora_errorcode</function>. </para> <para> @@ -194,8 +195,8 @@ </funcprototype> </funcsynopsis> <para> - <function>ora_commitoff</function> retourne TRUE si la - désactivation a bien eu lieu, et FALSE sinon. Les erreurs + <function>ora_commitoff</function> retourne <literal>TRUE</literal> si la + désactivation a bien eu lieu, et <literal>FALSE</literal> sinon. Les erreurs sont accessibles avec les fonctions <function>ora_error</function> et <function>ora_errorcode</function>. </para> @@ -223,8 +224,8 @@ automatique après chaque <function>ora_exec</function>. </para> <para> - <function>ora_commiton</function> retourne TRUE si l'activation a - bien eu lieu, et FALSE sinon. Les erreurs sont accessibles avec les + <function>ora_commiton</function> retourne <literal>TRUE</literal> si l'activation a + bien eu lieu, et <literal>FALSE</literal> sinon. Les erreurs sont accessibles avec les fonctions <function>ora_error</function> et <function>ora_errorcode</function>. </para> </refsect1> @@ -250,7 +251,7 @@ et lire la première ligne du résultat. </para> <para> - <function>ora_do</function> retourne TRUE en cas de succès, et FALSE sinon. Le détails sur les erreurs est accessible avec les fonctions + <function>ora_do</function> retourne <literal>TRUE</literal> en cas de succès, et <literal>FALSE</literal> sinon. Le détails sur les erreurs est accessible avec les fonctions <function>ora_error</function> et <function>ora_errorcode</function>. </para> <para> @@ -335,8 +336,8 @@ <paramdef>int <parameter>cursor</parameter></paramdef> </funcsynopsis> <para> - <function>ora_exec</function> retourne TRUE en cas de succès, et - FALSE en cas d'erreur. L'erreur générée sera alors + <function>ora_exec</function> retourne <literal>TRUE</literal> en cas de succès, et + <literal>FALSE</literal> en cas d'erreur. L'erreur générée sera alors accessible avec les fonctions <function>ora_error</function> et <function>ora_errorcode</function>. </para> @@ -354,8 +355,8 @@ <paramdef>int <parameter>cursor</parameter></paramdef> </funcsynopsis> <para> - <function>ora_fetch</function> retourne TRUE (une ligne a - été lue) ou FALSE (plus de lignes à lire ou + <function>ora_fetch</function> retourne <literal>TRUE</literal> (une ligne a + été lue) ou <literal>FALSE</literal> (plus de lignes à lire ou erreur). Si une erreur survient, sa valeur sera disponible dans les fonctions <function>ora_error</function> et <function>ora_errorcode</function>. @@ -427,10 +428,10 @@ </funcsynopsis> <para> <function>ora_getcolumn</function> retourne la valeur de la - colonne. Si une erreur survient, FALSE est retourné et + colonne. Si une erreur survient, <literal>FALSE</literal> est retourné et <function>ora_errorcode</function> aura une valeur non nulle. - Notez, qu'un test à FALSE, avec cette fonction peut - être TRUE, même sans erreur : en effet, la fonction + Notez, qu'un test à <literal>FALSE</literal>, avec cette fonction peut + être <literal>TRUE</literal>, même sans erreur : en effet, la fonction peut retourner des valeurs telles que (résultat NULL, chaînes vides, nombre 0, la chaîne "0"). </para> @@ -448,8 +449,8 @@ <paramdef>int <parameter>connection</parameter></paramdef> </funcsynopsis> <para> - <function>ora_logoff</function> retourne TRUE si la fermeture a - bien eu lieu, et FALSE sinon. Les erreurs sont accessibles avec + <function>ora_logoff</function> retourne <literal>TRUE</literal> si la fermeture a + bien eu lieu, et <literal>FALSE</literal> sinon. Les erreurs sont accessibles avec les fonctions <function>ora_error</function> et <function>ora_errorcode</function>. </para> @@ -484,8 +485,10 @@ <acronym>TNS</acronym> de la manière suivante : <informalexample> <programlisting role="php"> -$conn = Ora_Logon("user<emphasis>@TNSNAME</emphasis>", "pass"); -</programlisting> +<?php +$conn = ora_logon("user<emphasis>@TNSNAME</emphasis>", "pass"); +?> + </programlisting> </informalexample> </para> <para> @@ -497,9 +500,9 @@ avant de le lancer. </para> <para> - Retourne un index de connexion, en cas de succès, ou - FALSE en cas d'échec. Les erreurs sont accessibles avec - les fonctions <function>ora_error</function> + <function>ora_logon</function> retourne un index de connexion, en cas de + succès, ou <literal>FALSE</literal> en cas d'échec. Les + erreurs sont accessibles avec les fonctions <function>ora_error</function> et <function>ora_errorcode</function>. </para> </refsect1> @@ -590,7 +593,7 @@ <function>ora_open</function> ouvre un pointeur Oracle sur la connexion. </para> <para> - Retourne TRUE si la fermeture a bien eu lieu, et FALSE sinon. + Retourne <literal>TRUE</literal> si la fermeture a bien eu lieu, et <literal>FALSE</literal> sinon. Les erreurs sont accessibles avec les fonctions <function>ora_error</function> et <function>ora_errorcode</function>. </para> @@ -643,7 +646,7 @@ <function>ora_commit</function> pour la définition d'une transaction). </para> <para> - Retourne TRUE si la fermeture a bien eu lieu, et FALSE sinon. Les erreurs sont + Retourne <literal>TRUE</literal> si la fermeture a bien eu lieu, et <literal>FALSE</literal> sinon. Les erreurs sont accessibles avec les fonctions <function>ora_error</function> et <function>ora_errorcode</function>. </para> Index: phpdoc/fr/functions/outcontrol.xml diff -u phpdoc/fr/functions/outcontrol.xml:1.8 phpdoc/fr/functions/outcontrol.xml:1.9 --- phpdoc/fr/functions/outcontrol.xml:1.8 Wed Dec 27 00:54:06 2000 +++ phpdoc/fr/functions/outcontrol.xml Fri Jan 26 06:44:21 2001 @@ -134,7 +134,7 @@ function d($str) { return strip_tags($str); } -?> +?> <?php ob_start("c"); ?> Au clair de la lune, mon ami Pierrot <?php ob_start("d"); ?> @@ -144,7 +144,6 @@ <?php ob_end_flush(); ?> ... Ouvre moi la porte, pour l'amour de Dieu <?php ob_end_flush(); ?> -?> </programlisting> </example> <para> @@ -170,7 +169,7 @@ </funcsynopsis> <para> <function>ob_get_contents</function> retourne le contenu du buffer - de sortie si la bufferisation est active, ou FALSE sinon. + de sortie si la bufferisation est active, ou <literal>FALSE</literal> sinon. </para> <para> Voir aussi <function>ob_start</function> et <function>ob_get_length</function>. @@ -194,7 +193,7 @@ </funcsynopsis> <para> <function>ob_get_length</function> retourne la longueur du contenu - du buffer de sortie si la bufferisation est activée, et FALSE sinon. + du buffer de sortie si la bufferisation est activée, et <literal>FALSE</literal> sinon. </para> <para> Voir aussi <function>ob_start</function> et <function>ob_get_contents</function>. Index: phpdoc/fr/functions/ovrimos.xml diff -u phpdoc/fr/functions/ovrimos.xml:1.3 phpdoc/fr/functions/ovrimos.xml:1.4 --- phpdoc/fr/functions/ovrimos.xml:1.3 Fri Dec 15 06:04:32 2000 +++ phpdoc/fr/functions/ovrimos.xml Fri Jan 26 06:44:21 2001 @@ -1,7 +1,6 @@ <reference id="ref.ovrimos"> <title>Ovrimos SQL</title> <titleabbrev>OvrimosSQL</titleabbrev> - <partintro> <para> Ovrimos SQL Server est une base de données relationnelle client/serveur @@ -39,7 +38,6 @@ Cet exemple effectue une connexion réussie. </para> </partintro> - <refentry id="function.ovrimos-connect"> <refnamediv> <refname>ovrimos_connect</refname> @@ -90,7 +88,6 @@ </para> </refsect1> </refentry> - <refentry id="function.ovrimos-close"> <refnamediv> <refname>ovrimos_close</refname> @@ -114,7 +111,6 @@ </para> </refsect1> </refentry> - <refentry id="function.ovrimos-close-all"> <refnamediv> <refname>ovrimos_close_all</refname> @@ -137,7 +133,6 @@ </para> </refsect1> </refentry> - <refentry id="function.ovrimos-longreadlen"> <refnamediv> <refname>ovrimos_longreadlen</refname> @@ -161,13 +156,13 @@ <para> <function>ovrimos_longreadlen</function> indique le nombre d'octets qui seront lus dans une colonne de grande taille (long varchar et long - varbinary). Par défaut, 0. Indépendemment du fait que cette fonction - requiert <parameter>result_id</parameter>, actuellement cette fonction - affecte ce paramètre pour tous les résultats. Retourne vrai. + varbinary). Par défaut, 0. Indépendemment du fait que + <function>ovrimos_longreadlen</function> requiert <parameter>result_id</parameter>, + actuellement <function>ovrimos_longreadlen</function> affecte ce paramètre + pour tous les résultats. Retourne vrai. </para> </refsect1> </refentry> - <refentry id="function.ovrimos-prepare"> <refnamediv> <refname>ovrimos_prepare</refname> @@ -187,7 +182,7 @@ </para> <para> <function>ovrimos_prepare</function> prépare une requête SQL - et retourne un identifiant de résultat result_id (ou FALSE en cas d'échec). + et retourne un identifiant de résultat result_id (ou <literal>FALSE</literal> en cas d'échec). </para> <para> <example> @@ -197,7 +192,7 @@ $conn=ovrimos_connect ("db_host", "8001", "admin", "password"); if ($conn!=0) { echo "Connection établie!"; - $res=ovrimos_prepare ($conn, "select table_id, table_name + $res=ovrimos_prepare ($conn, "select table_id, table_name from sys.tables where table_id=1"); if ($res != 0) { echo "Préparation faite!"; @@ -221,7 +216,6 @@ </para> </refsect1> </refentry> - <refentry id="function.ovrimos-execute"> <refnamediv> <refname>ovrimos_execute</refname> @@ -233,7 +227,7 @@ <funcprototype> <funcdef>int <function>ovrimos_execute</function></funcdef> <paramdef>int <parameter>result_id</parameter></paramdef> - <paramdef>array + <paramdef>array <parameter><optional>parameters_array</optional></parameter> </paramdef> </funcprototype> @@ -243,16 +237,15 @@ </para> <para> <function>ovrimos_execute</function> exécute une requête préparée. - Retourne true ou false. Si la requête préparée contient des + Retourne <literal>TRUE</literal> ou <literal>FALSE</literal>. Si la requête préparée contient des paramètres (des points d'interrogations dans la requête), un nombre - correct de paramètre doit être passé dans le tableau - <parameter>parameters_array</parameter>. Notez que cette fonction ne + correct de paramètre doit être passé dans le tableau + <parameter>parameters_array</parameter>. Notez que <function>ovrimos_execute</function> ne suit pas les conventions PHP qui placent les noms des paramètres entre crochets. L'auteur n'a pas pu s'y faire. </para> </refsect1> </refentry> - <refentry id="function.ovrimos-cursor"> <refnamediv> <refname>ovrimos_cursor</refname> @@ -270,17 +263,16 @@ <function>ovrimos_cursor</function> sert à lire le nom du curseur </para> <para> - <function>ovrimos_cursor</function> retourne le nom du curseur. + <function>ovrimos_cursor</function> retourne le nom du curseur. Pratique, lorsqu'on veut faire des modifications ou des effacements avec des curseurs déjà positionnés. </para> </refsect1> </refentry> - <refentry id="function.ovrimos-exec"> <refnamediv> <refname>ovrimos_exec</refname> - <refpurpose>Exécute une requête SQL</refpurpose> + <refpurpose>Exécute une requÍte SQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -297,12 +289,11 @@ <para> <function>ovrimos_exec</function> exécute une requête SQL (selection ou modification), et retourne un identifiant de résultat - result_id (ou bien false, en cas d'échec). Evidemment, la requête + result_id (ou bien <literal>FALSE</literal>, en cas d'échec). Evidemment, la requête SQL ne doit pas contenir de paramètres. </para> </refsect1> </refentry> - <refentry id="function.ovrimos-fetch-into"> <refnamediv> <refname>ovrimos_fetch_into</refname> @@ -315,10 +306,10 @@ <funcdef>int <function>ovrimos_fetch_into</function></funcdef> <paramdef>int <parameter>result_id</parameter></paramdef> <paramdef>array <parameter>result_array</parameter></paramdef> - <paramdef>string + <paramdef>string <parameter><optional>how</optional></parameter> </paramdef> - <paramdef>int + <paramdef>int <parameter><optional>rownumber</optional></parameter> </paramdef> </funcprototype> @@ -329,14 +320,14 @@ <para> <function>ovrimos_fetch_into</function> lit une ligne dans le résultat <parameter>result_id</parameter>, qui doit être passé - en référence. La ligne qui sera lue est déterminée par les deux + en référence. La ligne qui sera lue est déterminée par les deux paramètres <parameter><optional>how</optional></parameter> et - <parameter><optional>rownumber</optional></parameter>. + <parameter><optional>rownumber</optional></parameter>. <parameter><optional>how</optional></parameter> peut prendre les valeurs de 'Next' (suivant, valeur par défaut), 'Prev' (précédent), 'First' (premier), 'Last' (dernier), 'Absolute' (position absolue). La casse de <parameter><optional>how</optional></parameter> n'est pas prise en compte. <parameter><optional>rownumber</optional></parameter> - est optionne, sauf dans le cas d''Absolute'. Retourne TRUE ou FALSE. + est optionne, sauf dans le cas d''Absolute'. Retourne <literal>TRUE</literal> ou <literal>FALSE</literal>. </para> <para> <example> @@ -346,13 +337,13 @@ $conn=ovrimos_connect ("neptune", "8001", "admin", "password"); if ($conn!=0) { echo "Connection établie!"; - $res=ovrimos_exec ($conn,"select table_id, table_name from sys.tables"); + $res=ovrimos_exec ($conn,"SELECT table_id, table_name FROM sys.tables"); if ($res != 0) { echo "Requête effectuée!"; - if (ovrimos_fetch_into ($res, &$row)) { + if (ovrimos_fetch_into ($res, &$row)) { list ($table_id, $table_name) = $row; echo "table_id=".$table_id.", table_name=".$table_name."\n"; - if (ovrimos_fetch_into ($res, &$row)) { + if (ovrimos_fetch_into ($res, &$row)) { list ($table_id, $table_name) = $row; echo "table_id=".$table_id.", table_name=".$table_name."\n"; } else { @@ -372,7 +363,6 @@ </para> </refsect1> </refentry> - <refentry id="function.ovrimos-fetch-row"> <refnamediv> <refname>ovrimos_fetch_row</refname> @@ -384,10 +374,10 @@ <funcprototype> <funcdef>int <function>ovrimos_fetch_row</function></funcdef> <paramdef>int <parameter>result_id</parameter></paramdef> - <paramdef>int + <paramdef>int <parameter><optional>how</optional></parameter> </paramdef> - <paramdef>int + <paramdef>int <parameter><optional>row_number</optional></parameter> </paramdef> </funcprototype> @@ -397,7 +387,7 @@ </para> <para> <function>ovrimos_fetch_row</function> lit une ligne dans un résultat. - Les colonnes doivent être lues par un autre appel. Retourne true ou false. + Les colonnes doivent être lues par un autre appel. Retourne <literal>TRUE</literal> ou <literal>FALSE</literal>. </para> <para> <example> @@ -435,7 +425,6 @@ </para> </refsect1> </refentry> - <refentry id="function.ovrimos-result"> <refnamediv> <refname>ovrimos_result</refname> @@ -463,7 +452,6 @@ </para> </refsect1> </refentry> - <refentry id="function.ovrimos-result-all"> <refnamediv> <refname>ovrimos_result_all</refname> @@ -477,7 +465,7 @@ <funcprototype> <funcdef>int <function>ovrimos_result_all</function></funcdef> <paramdef>int <parameter>result_id</parameter></paramdef> - <paramdef>string + <paramdef>string <parameter><optional>format</optional></parameter> </paramdef> </funcprototype> @@ -488,7 +476,7 @@ </para> <para> <function>ovrimos_result_all</function> affiche le résultat de la requête - représentée par <parameter>result_id</parameter>. Retourne TRUE ou FALSE. + représentée par <parameter>result_id</parameter>. Retourne <literal>TRUE</literal> ou <literal>FALSE</literal>. </para> <para> <example> @@ -498,7 +486,7 @@ $conn = ovrimos_connect ("db_host", "8001", "admin", "password"); if ($conn != 0) { echo "Connection établie!"; - $res = ovrimos_prepare ($conn, "select table_id, table_name + $res = ovrimos_prepare ($conn, "select table_id, table_name from sys.tables where table_id = 7"); if ($res != 0) { echo "Préparation faite!"; @@ -522,22 +510,22 @@ </para> <para> <example> - <title><function>Ovrimos_result_all</function> avec meta-information</title> + <title><function>ovrimos_result_all</function> avec meta-information</title> <programlisting role="php"> <?php $conn = ovrimos_connect ("db_host", "8001", "admin", "password"); if ($conn != 0) { echo "Connection établie!"; - $res = ovrimos_exec ($conn, "select table_id, table_name + $res = ovrimos_exec ($conn, "select table_id, table_name from sys.tables where table_id = 1") if ($res != 0) { echo "Requête effectuée! cursor=".ovrimos_cursor ($res)."\n"; $colnb = ovrimos_num_fields ($res); echo "Output columns=".$colnb."\n"; - for ($i=1; $i<=$colnb; $i++) { + for ($i=1; $i<=$colnb; $i++) { $name = ovrimos_field_name ($res, $i); $type = ovrimos_field_type ($res, $i); - $len = ovrimos_field_len ($res, $i); + $len = ovrimos_field_len ($res, $i); echo "Colonne ".$i." nom=".$name." type=".$type." longueur=".$len."\n"; } ovrimos_result_all ($res); @@ -571,7 +559,6 @@ </para> </refsect1> </refentry> - <refentry id="function.ovrimos-num-rows"> <refnamediv> <refname>ovrimos_num_rows</refname> @@ -588,12 +575,11 @@ </funcprototype> </funcsynopsis> <para> - <function>ovrimos_num_rows</function> retourne le nombre de lignes + <function>ovrimos_num_rows</function> retourne le nombre de lignes affectées par une modification </para> </refsect1> </refentry> - <refentry id="function.ovrimos-num-fields"> <refnamediv> <refname>ovrimos_num_fields</refname> @@ -613,7 +599,6 @@ </para> </refsect1> </refentry> - <refentry id="function.ovrimos-field-name"> <refnamediv> <refname>ovrimos_field_name</refname> @@ -639,7 +624,6 @@ </para> </refsect1> </refentry> - <refentry id="function.ovrimos-field-type"> <refnamediv> <refname>ovrimos_field_type</refname> @@ -661,13 +645,12 @@ numérique d'une colonne. </para> <para> - <function>ovrimos_field_type</function> retourne le type numérique + <function>ovrimos_field_type</function> retourne le type numérique d'une colonne, identifiée par son numéro <parameter>field_number</parameter> dans le résultat <parameter>field_number</parameter>. </para> </refsect1> </refentry> - <refentry id="function.ovrimos-field-len"> <refnamediv> <refname>ovrimos_field_len</refname> @@ -687,13 +670,12 @@ d'une colonne. </para> <para> - <function>ovrimos_field_len</function> retourne la taille de la + <function>ovrimos_field_len</function> retourne la taille de la colonne <parameter>field_number</parameter>, dans le résultat <parameter>field_number</parameter>. </para> </refsect1> </refentry> - <refentry id="function.ovrimos-field-num"> <refnamediv> <refname>ovrimos_field_num</refname> @@ -721,7 +703,6 @@ </para> </refsect1> </refentry> - <refentry id="function.ovrimos-free-result"> <refnamediv> <refname>ovrimos_free_result</refname> @@ -740,11 +721,10 @@ </para> <para> <function>ovrimos_free_result</function> libère toutes les ressources prises - par le résultat <parameter>result_id</parameter>. Retourne TRUE. + par le résultat <parameter>result_id</parameter>. Retourne <literal>TRUE</literal>. </para> </refsect1> </refentry> - <refentry id="function.ovrimos-commit"> <refnamediv> <refname>ovrimos_commit</refname> @@ -759,7 +739,7 @@ </funcprototype> </funcsynopsis> <para> - <function>ovrimos_commit</function> sert à exécuter une + <function>ovrimos_commit</function> sert à exécuter une transaction. </para> <para> @@ -768,7 +748,6 @@ </para> </refsect1> </refentry> - <refentry id="function.ovrimos-rollback"> <refnamediv> <refname>ovrimos_rollback</refname> @@ -791,9 +770,7 @@ </para> </refsect1> </refentry> - - </reference> - + </reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml Index: phpdoc/fr/functions/pcre.xml diff -u phpdoc/fr/functions/pcre.xml:1.10 phpdoc/fr/functions/pcre.xml:1.11 --- phpdoc/fr/functions/pcre.xml:1.10 Wed Dec 20 02:11:46 2000 +++ phpdoc/fr/functions/pcre.xml Fri Jan 26 06:44:21 2001 @@ -10,6 +10,8 @@ n'est pas alphanumérique ou n'est pas un antislash (\). Si un délimiteur doit être utilisé dans l'expression, il faudra l'échapper avec un antislash. + Depuis PHP 4.0.4, vous pouvez utiliser les délimiteurs + (), {}, [], et <>, comme en Perl. </para> <para> Le délimiteur final peut être suivi d'options qui @@ -23,6 +25,7 @@ <listitem><simpara>/<\/\w+>/</simpara></listitem> <listitem><simpara>|(\d{3})-\d+|Sm</simpara></listitem> <listitem><simpara>/^(?i)php[34]/</simpara></listitem> + <listitem><simpara>{^\s+(\s+)?$}</simpara></listitem> </itemizedlist> </example> </para> @@ -84,22 +87,25 @@ etc.. </para> <para> - Retourne TRUE si la recherche à réussie, et - FALSE sinon (notamment en cas d'erreur). + Retourne <literal>TRUE</literal> si la recherche à réussie, et + <literal>FALSE</literal> sinon (notamment en cas d'erreur). </para> <para> <example> <title>Extraction d'un numéro de page d'une chaîne.</title> - <programlisting> + <programlisting role="php"> +<?php if (preg_match("/page\s+#(\d+)/i", "Go to page #9.", $parts)) print "La page suivante est $parts[1]"; else print "Page introuvable."; +?> </programlisting> </example> <example> <title>Trouve le mot "web"</title> <programlisting role="php"> +<?php // \b, dans le masque, indique une limite de mot, de façon à ce que le mot // "web" uniquement soit repéré, et pas seulement des parties de mots comme // dans "webbing" ou "cobweb" @@ -113,11 +119,13 @@ } else { print "Un mot n'a pas été trouvé."; } +?> </programlisting> </example> <example> <title>Lire un nom de domaine dans une URL</title> <programlisting role="php"> +<?php // repérer le nom de l'hôte dans l'URL preg_match("/^(http:\/\/)?([^\/]+)/i", "http://www.php.net/index.html", $matches); @@ -125,14 +133,14 @@ // repérer les deux derniers segments du nom de l'hôte preg_match("/[^\.\/]+\.[^\.\/]+$/",$host,$matches); echo "Le nom de domaine est : ".$matches[0]."\n"; +?> </programlisting> </example> Cet exemple va afficher : - <programlisting> + <computeroutput> Le nom de domaine est : php.net - </programlisting> - Voir aussi <function>preg_match_all</function>, - <function>preg_replace</function> + </computeroutput> + Voir aussi <function>preg_match_all</function>, <function>preg_replace</function> et <function>preg_split</function>. </para> </refsect1> @@ -178,18 +186,20 @@ résultats qui satisfont la première parenthèse capturante, etc.. <informalexample> - <programlisting> + <programlisting role="php"> +<?php preg_match_all("|<[^>]+>(.*)</[^>]+>|U", "<b>example: </b><div align=left>a test</div>", $out, PREG_PATTERN_ORDER); print $out[0][0].", ".$out[0][1]."\n"; -print $out[1][0].", ".$out[1][1]."\n" +print $out[1][0].", ".$out[1][1]."\n"; +?> </programlisting> </informalexample> Cet exemple va afficher : <informalexample> - <programlisting> + <computeroutput> <b>exemple: </b>, <div align=left>ceci est un test</div> exemple: , ceci est un test - </programlisting> + </computeroutput> </informalexample> Ainsi, $out[0] est un tableau qui contient les résultats qui satisfont le masque complet, @@ -206,18 +216,20 @@ série de résultat, $matches[1] contient la deuxième série de résultat, etc... <informalexample> - <programlisting> -preg_match_all("|<[^>]+>(.*)</[^>]+>|U", "<b>exemple: </b><div align=left>a test</div>", $out, PREG_SET_ORDER); + <programlisting role="php"> +<?php +preg_match_all("|<[^>]+>(.*)</[^>]+>|U", "<b>exemple: </b><div align=left>un test</div>", $out, PREG_SET_ORDER); print $out[0][0].", ".$out[0][1]."\n"; -print $out[1][0].", ".$out[1][1]."\n" +print $out[1][0].", ".$out[1][1]."\n"; +?> </programlisting> </informalexample> Cet exemple va afficher : <informalexample> - <programlisting> -<b>example: </b>, exemple: -<div align=left>this is a test</div>, this is a test - </programlisting> + <computeroutput> +<b>exemple: </b>, exemple: +<div align=left>un test</div>, un test + </computeroutput> </informalexample> Dans ce cas, $matches[0] est la première série de résultat, et $matches[0][0] contient le texte qui satisfait @@ -235,16 +247,18 @@ </para> <para> Retourne le nombre de résultat qui satisfont le masque - complet, ou FALSE en cas d'échec ou d'erreur. + complet, ou <literal>FALSE</literal> en cas d'échec ou d'erreur. </para> <para> <example> <title> Extraction de tous les numéros de téléphone d'un texte. </title> - <programlisting> + <programlisting role="php"> +<?php preg_match_all("/\(? (\d{3})? \)? (?(1) [\-\s] ) \d{3}-\d{4}/x", - "Call 555-1212 or 1-800-555-1212", $phones); + "Appelez 555-1212 ou 1-800-555-1212", $phones); +?> </programlisting> </example> </para> @@ -252,30 +266,32 @@ <example> <title>Recherche les couples de balises HTML (gourmand)</title> <programlisting role="php"> +<?php // Cet exemple utilise les références arrières (\\2). // Elles indiquent à l'analyseur qu'il doit trouver quelquechose qu'il // a déjà repéré un peu plus tôt (ici, ([\w]+)). -$html = "<b>bold text</b><a href=salut.html>clique moi</a> -preg_match_all ("/(<([\w]+)[^>]*>)(.*)(<\/\\2>)/", $html, $matches); +$html = "<B>Texte en gras</B><a href=salut.html>clique moi</?> +preg_match_all ("/(<([\w]+)[?>]?>)(.*)(<\/\\?>)/", $html, $matches); for ($i=0; $i< count($matches[0]); $i++) { echo "trouvé: ".$matches[0][$i]."\n"; echo "partie 1: ".$matches[1][$i]."\n"; echo "partie 2: ".$matches[3][$i]."\n"; echo "partie 3: ".$matches[4][$i]."\n\n"; } +?> </programlisting> </example> Cet exemple va produire : - <programlisting> -trouvé: <b>bold text</b> -partie 1: <b> -partie 2: bold text -partie 3: </b> -trouvé: <a href=salut.html>clique moi</a> + <computeroutput> +trouvé: <B>bold text</?> +partie 1: <B> +partie 2: Test en gras +partie 3: </B> +trouvé: <a href=salut.html>clique moi</?> partie 1: <a href=salut.html> partie 2: clique moi -partie 3: </a> - </programlisting> +partie 3: </?> + </computeroutput> </para> <simpara> Voir aussi <function>preg_match</function>, @@ -355,37 +371,49 @@ trouvera une erreur d'analyse (parse error) dans cette ligne. </para> <para> + <literal>/F</literal> indique que le paramètre + <parameter>replacement</parameter> doit être considéré comme un nom de fonction. + Cette fonction sera appelée, avec un tableau contenant les éléments trouvés comme + arguments. La fonctoin doit retourner la chaine de remplacement. Cette option + a été ajoutée en PHP 4.0.4. + </para> + <para> <example> <title>Remplacement de plusieurs valeurs</title> - <programlisting> + <programlisting role="php"> +<?php $patterns = array ("/(19|20)(\d{2})-(\d{1,2})-(\d{1,2})/", "/^\s*{(\w+)}\s*=/"); $replace = array ("\\3/\\4/\\1\\2", "$\\1 ="); print preg_replace ($patterns, $replace, "{startDate} = 1999-5-27"); +?> </programlisting> </example> Cet exemple va afficher : - <programlisting> + <computeroutput> $startDate = 5/27/1999 - </programlisting> + </computeroutput> <example> <title>Utilisation de l'option /e </title> - <programlisting> + <programlisting role="php"> +<?php preg_replace("/(<\/?)(\w+)([^>]*>)/e", "'\\1'.strtoupper('\\2').'\\3'", $html_body); +?> </programlisting> - <para> - Cela va mettre en majuscule toutes les balises HTML du texte. - </para> </example> + <para> + Cela va mettre en majuscule toutes les balises HTML du texte. + </para> <example> - <title>Conversion HTML en text</title> + <title>Conversion HTML en texte</title> <programlisting role="php"> +<?php // $document contient un document HTML // Ce script va effacer les balises HTML, les javascript // et les espaces. Il remplace aussi queqlues entitées HTML // courante en leur équivalent texte. -$search = array ("'<script[^>]*?>.*?</script>'si", // Supprime le javascript - "'<[\/\!]*?[^<>]*?>'si", // Supprime les balises HTML +$search = array ("'<script[?>]*?>.*?</script>'si", // Supprime le javascript + "'<[\/\!]*?[^<?>]*?>'si", // Supprime les balises HTML "'([\r\n])[\s]+'", // Supprime les espaces "'&(quot|#34);'i", // Supprime les entitees HTML "'&(amp|#38);'i", @@ -403,7 +431,7 @@ "\"", "&", "<", - ">", + ?>", " ", chr(161), chr(162), @@ -411,6 +439,7 @@ chr(169), "chr(\\1)"); $text = preg_replace ($search, $replace, $document); +?> </programlisting> </example> </para> @@ -472,10 +501,12 @@ <para> <example> <title>Eclatement d'une chaîne de recherche.</title> - <programlisting> + <programlisting role="php"> +<?php // scinde la phrase grâce aux virgules et espacements // ce qui inclus les " ", \r, \t, \n et \f $keywords = preg_split ("/[\s,]+/", "langage hypertexte, programmation"); +?> </programlisting> </example> </para> @@ -483,9 +514,11 @@ Scinder une chaîne en caractères </para> <programlisting role="php"> +<?php $str = 'string'; $chars = preg_split('//', $str, 0, PREG_SPLIT_NO_EMPTY); print_r($chars); +?> </programlisting> <para> Voir aussi <function>preg_match</function>, @@ -527,28 +560,31 @@ </para> <para> Les caractères spéciaux qui seront échappés : - <screen>. \\ + * ? [ ^ ] $ ( ) { } = ! < > | :</screen> + <screen>. \\ + * ? [ ^ ] $ ( ) { } = ! < > | :</screen> </para> <para> <example> - <title></title> + <title>Protège des caractères spéciaux</title> <programlisting role="php"> +<?php $keywords = "$40 pour un g3/400"; $keywords = preg_quote ($keywords, "/"); echo $keywords; // retourne \$40 pour un g3\/400 +?> </programlisting> </example> <example> <title>Mise en italique d'un mot dans un texte</title> <programlisting role="php"> +<?php // Dans cet exemple, preg_quote($word) sert à éviter que les astérisques -// prennent une valeur particulière dans l'exepression -// régulière. +// prennent une valeur particulière dans l'exepression régulière. $textbody = "Ce livre est *très* difficile à trouver."; $word = "*très*"; $textbody = preg_replace ("/".preg_quote($word)."/", - "<i>".$word."</i>", + "<B>".$word."</B>", $textbody); +?> </programlisting> </example> </para> @@ -577,8 +613,10 @@ <example> <title>Exemple avec <function>preg_grep</function></title> <programlisting role="php"> +<?php // recherche les nombres à virgule flottante preg_grep("/^(\d+)?\.\d+$/", $array); +?> </programlisting> </example> </para> @@ -601,15 +639,15 @@ <blockquote> <variablelist> <varlistentry> - <term><emphasis>i</emphasis> (PCRE_CASELESS)</term> - <listitem> - <simpara> - Effectue une recherche insensible à la casse. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><emphasis>m</emphasis> (PCRE_MULTILINE)</term> + <term><emphasis>i</emphasis> (PCRE_CASELESS)</term> + <listitem> + <simpara> + Effectue une recherche insensible à la casse. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><emphasis>m</emphasis> (PCRE_MULTILINE)</term> <listitem> <simpara> Par défaut, PCRE traite la chaîne sujet comme une seule @@ -677,6 +715,7 @@ substitution normale des références arrières dans la chaîne de remplacement, puis l'évalue comme un code PHP, et utilise le résultat pour remplacer la chaîne de recherche. + Cette optoin ne peut pas être utilisée avec <literal>/F modifier</literal>. </simpara> <simpara> Seule <function>preg_replace</function> utilise cette option. Elle est @@ -685,6 +724,22 @@ </listitem> </varlistentry> <varlistentry> + <term><emphasis>F</emphasis></term> + <listitem> + <simpara> + Avec cette option, <function>preg_replace</function> considère le paramètre + de remplacement comme un nom de fonction, qui doit être appelé pour fournir + la chaîne de remplacement. La fonction recoit un tableau d'éléments trouvés. + Cette option ne peut pas être utilisée avec l'option <literal>/e</literal>. + </simpara> + <simpara> + <function>preg_replace</function> seuelement utilise cette option. + Elle est ignorée par les autres fonctions PCRE. Cette option a été ajoutée + en PHP 4.0.4. + </simpara> + </listitem> + </varlistentry> + <varlistentry> <term><emphasis>A</emphasis> (PCRE_ANCHORED)</term> <listitem> <simpara> @@ -778,75 +833,153 @@ </refsect1> <refsect1> <title>Différences avec Perl</title> - <literallayout> + <para> Les différences avec le Perl 5.005 sont présentée ici : - 1. Par défaut, un caractère d'espacement correspond à n'importe quel caractère - que la fonction C isspace() reconnaît, bien qu'il soit possible de recompiler - la bibliothèque PCRE avec d'autres tables de caractères. Normalement, isspace() - retourne TRUE pour les espaces, les retours chariot, les nouvelles lignes, les - formfeed, les tabulations verticales et horizontales. Le Perl 5 n'accepte plus - la tabulation verticale comme caractère d'espacement. La séquence \v qui était - dans la documentation Perl depuis longtemps n'a jamais été reconnue. Cependant, - la tabulation verticale elle-même était reconnue comme un caractère d'espacement - jusqu'à la version 5.002. Avec les version 5.004 et 5.005, l'option \s l'ignore. - 2. PRCE ne tolère pas la répétition de quantificateurs dans les expressions. Perl - le permet, mais cela ne signifie pas ce que vous pourriez penser. Par exemple, - (?!a){3} ne s'interprète pas : les trois caractères suivants ne sont pas des - "a". En fait, cela s'interprète comme : le caractère suivant n'est pas "a" trois - fois. - 3. Les occurrences de sous-masques qui interviennent dans des assertions négatives - sont comptées, mais elles ne sont pas enregistrées dans le vecteur - d'occurrences. Perl modifie ses variables numériques pour toutes les occurrences - de sous masque, avant que l'assertion ne vérifie le masque entier, et - uniquement si les sous masques ne trouvent qu'une seule occurrence. - 4. Bien que les caractères nul soient tolérés dans la chaîne de recherche, ils ne - sont pas acceptés dans le masque, car le masque est utilisé comme une chaîne C - standard, terminée par le caractère nul. Il faut donc utiliser la séquence - d'échappement "\0" dans le masque pour rechercher les caractères nul. - 5. Les séquence d'échappement suivantes ne sont pas supportées par le Perl: \l, - \u, \L, \U, \E, \Q. En fait, elles sont implémentées par la gestion intrinsèque - de chaînes du Perl, et ne font pas partie de ses caractères spéciaux. - 6. L'assertion \G du Perl n'est pas supportée car elle n'est pas pertinente pour - faire des recherches avec des masques uniques. - 7. De manière assez évidente, PCRE n'accepte pas la construction (?{code}) - 8. Au moment de l'écriture de PCRE, Perl 5.005_02 avait quelques comportement - étranges avec la capture des chaînes lorsqu'une partie du masque est redoublée. - Par exemple, "aba" avec le masque /^(a(b)?)+$/ va affecter à $2 la valeur "b", - mais la même manipulation avec "aabbaa" et /^(aa(bb)?)+$/ laissera $2 vide. - Cependant, si le masque est remplacé par /^(aa(b(b))?)+$/ alors $2 (et - d'ailleurs $3) seront correctement affectés. Avec le Perl 5.004, $2 sera - correctement affecté dans les deux cas, et c'est aussi vrai avec PCRE. Si Perl - évolue vers un autre comportement cohérent, PCRE s'adaptera probablement - 9. Une autre différence encore non résolue est le fait qu'en Perl 5.005_02 le - masque /^(a)?(?(1)a|b)+$/ accepte la chaîne "a", tandis que PCRE ne l'accepte - pas. Cependant, que ce soit avec Perl ou PCRE /^(a)?a/ et "a" laisseront $1 - vide. - 10. PCRE propose quelques extensions aux expressions régulières du Perl. - (a) Bien que les assertions avec retour (lookbehind) soit obligée d'apparier - une chaîne de longueur fixe, toutes les assertions avec retour peuvent avoir - une longueur différente. Perl 5.005 leur impose d'avoir toutes la même longueur. - (b) Si PCRE_DOLLAR_ENDONLY est mis, et que PCRE_MULTILINE n'est pas mis, le - méta caractère $ ne s'applique qu'à la fin physqiue de la chaîne, et non - pas avant les caractères de nouvelle ligne. - (c) Si PCRE_EXTRA est mis, un antislash suivi d'une lettre sans signification - spéciale est considérée comme une erreur. - (d) SI PCRE_UNGREEDY est mis, la "gourmandise" des quantificateurs de - répétition est inversées, ce qui est rend non gourmand par défaut, mais si - ils sont suivis de ?, il seront gourmands. - </literallayout> + <orderedlist> + <listitem> + <simpara> + Par défaut, un caractère d'espacement correspond à + n'importe quel caractère que la fonction C isspace() reconnaît, + bien qu'il soit possible de recompiler la bibliothèque PCRE avec + d'autres tables de caractères. Normalement, isspace() retourne + <literal>TRUE</literal> pour les espaces, les retours chariot, les + nouvelles lignes, les formfeed, les tabulations verticales et horizontales. + Le Perl 5 n'accepte plus la tabulation verticale comme caractère + d'espacement. La séquence \v qui était dans la documentation + Perl depuis longtemps n'a jamais été reconnue. Cependant, la + tabulation verticale elle-même était reconnue comme un + caractère d'espacement jusqu'à la version 5.002. Avec les + version 5.004 et 5.005, l'option \s l'ignore. + </simpara> + </listitem> + <listitem> + <simpara> + PRCE ne tolère pas la répétition de quantificateurs + dans les expressions. Perl le permet, mais cela ne signifie pas ce que vous + pourriez penser. Par exemple, (?!a){3} ne s'interprète pas : les trois + caractères suivants ne sont pas des "a". En fait, cela + s'interprète comme : le caractère suivant n'est pas "a" trois fois. + </simpara> + </listitem> + <listitem> + <simpara> + Les occurrences de sous-masques qui interviennent dans des assertions + négatives sont comptées, mais elles ne sont pas + enregistrées dans le vecteur d'occurrences. Perl modifie ses + variables numériques pour toutes les occurrences de sous-masque, + avant que l'assertion ne vérifie le masque entier, et uniquement si + les sous-masques ne trouvent qu'une seule occurrence. + </simpara> + </listitem> + <listitem> + <simpara> + Bien que les caractères nul soient tolérés dans la + chaîne de recherche, ils ne sont pas acceptés dans le masque, + car le masque est utilisé comme une chaîne C standard, + terminée par le caractère nul. Il faut donc utiliser la + séquence d'échappement "\0" dans le masque pour rechercher + les caractères nul. + </simpara> + </listitem> + <listitem> + <simpara> + Les séquence d'échappement suivantes ne sont pas supportées + par le Perl: \l, \u, \L, \U, \E, \Q. En fait, elles sont implémentées + par la gestion intrinsèque de chaînes du Perl, et ne font pas partie + de ses caractères spéciaux. + </simpara> + </listitem> + <listitem> + <simpara> + L'assertion \G du Perl n'est pas supportée car elle n'est pas pertinente + pour faire des recherches avec des masques uniques. + </simpara> + </listitem> + <listitem> + <simpara> + De manière assez évidente, PCRE n'accepte pas la construction (?{code}) + </simpara> + </listitem> + <listitem> + <simpara> + Au moment de l'écriture de PCRE, Perl 5.005_02 avait quelques + comportements étranges avec la capture des chaînes + lorsqu'une partie du masque est redoublée. Par exemple, "aba" avec + le masque /^(a(b)?)+$/ va affecter à $2 la valeur "b", mais la + même manipulation avec "aabbaa" et /^(aa(bb)?)+$/ laissera $2 vide. + Cependant, si le masque est remplacé par /^(aa(b(b))?)+$/ alors $2 (et + d'ailleurs $3) seront correctement affectés. Avec le Perl 5.004, + $2 sera correctement affecté dans les deux cas, et c'est aussi + vrai avec PCRE. Si Perl évolue vers un autre comportement + cohérent, PCRE s'adaptera probablement + </simpara> + </listitem> + <listitem> + <simpara> + Une autre différence encore non résolue est le fait qu'en + Perl 5.005_02 le masque /^(a)?(?(1)a|b)+$/ accepte la chaîne "a", + tandis que PCRE ne l'accepte pas. Cependant, que ce soit avec Perl ou + PCRE /^(a)?a/ et "a" laisseront $1 vide. + </simpara> + </listitem> + <listitem> + <simpara> + PCRE propose quelques extensions aux expressions régulières du Perl. + <orderedlist> + <listitem> + <simpara> + (a) Bien que les assertions avec retour (lookbehind) soit obligée + d'apparier une chaîne de longueur fixe, toutes les assertions avec + retour peuvent avoir une longueur différente. Perl 5.005 leur + impose d'avoir toutes la même longueur. + </simpara> + </listitem> + <listitem> + <simpara> + (b) Si PCRE_DOLLAR_ENDONLY est mis, et que PCRE_MULTILINE n'est pas mis, + le méta caractère $ ne s'applique qu'à la fin + physqiue de la chaîne, et non pas avant les caractères + de nouvelle ligne. + </simpara> + </listitem> + <listitem> + <simpara> + (c) Si PCRE_EXTRA est mis, un antislash suivi d'une lettre sans signification + spéciale est considérée comme une erreur. + </simpara> + </listitem> + <listitem> + <simpara> + (d) SI PCRE_UNGREEDY est mis, la "gourmandise" des quantificateurs de + répétition est inversées, ce qui est rend non + gourmand par défaut, mais si ils sont suivis de ?, il seront + gourmands. + </simpara> + </listitem> + </orderedlist> + </simpara> + </listitem> + </orderedlist> + </para> </refsect1> - <refsect1> + <refsect1 id="regexp.reference"> <title>Détails sur les expressions régulières</title> - <literallayout> - La syntaxe et la sémantique des expressions régulière supportées par PCRE sont - décrites ci-dessous. Les expressions régulières sont aussi décrites dans la - documentation Perl, et dans un grand nombre d'autres livres, avec de nombreux - exemples. Jeffrey Friedl's "Mastering Regular Expressions", édité chez O'Reilly - (ISBN 1-56592-257-3), les décrits en profondeur. Cette description est organisée - comme une documentation de référence. - Une expression régulière est un masque, qui est appliqué sur une chaîne sujet, - de gauche à droite. La plus part des caractères se représentent eux-mêmes. Un - exemple trivial : un masque qui serait + <para> + La syntaxe et la sémantique des expressions régulière + supportées par PCRE sont décrites ci-dessous. Les expressions + régulières sont aussi décrites dans la documentation + Perl, et dans un grand nombre d'autres livres, avec de nombreux exemples. + Jeffrey Friedl's "Mastering Regular Expressions", édité + chez O'Reilly (ISBN 1-56592-257-3), les décrits en profondeur. + Cette description est organisée comme une documentation de + référence. + </para> + <refsect2 id="regexp.reference.intro"> + <title>Just a title</title> + <para> + Une expression régulière est un masque, qui est appliqué + sur une chaîne sujet, de gauche à droite. La plus part des + caractères se représentent eux-mêmes. Un exemple trivial : un masque qui serait Le rapide renard gris Pourra correspondre à une partie de la chaîne sujet qui sera identique au masque. La puissance des expressions régulières provient de leur capacité à autoriser des @@ -854,6 +987,11 @@ dans le masque par des <emphasis>meta</emphasis>-<emphasis>characters</emphasis>, qui ne représentent pas ce qu'ils sont, mais sont interprétés d'une certaine manière. + </para> + </refsect2> + <refsect2 id="regexp.reference.meta"> + <title>Just a title</title> + <para> Il y a deux sortes de méta-caractères : ceux qui sont reconnus n'importe oú dans un masque, hormis entre crochets, et ceux qui sont reconnus entre crochets. A l'extérieur des crochets, les méta caractères sont : @@ -865,8 +1003,8 @@ [ Caractère de début de définition de classe ] Caractère de fin de définition de classe | Caractère de début d'alternative - ( Caractère de début de sous masque - ) Caractère de fin de sous masque + ( Caractère de début de sous-masque + ) Caractère de fin de sous-masque ? Etend le sens de ( mais aussi quantificateur de 0 ou 1 mais aussi quantificateur de minimisation @@ -880,31 +1018,36 @@ - indique un intervalle de caractères ] termine la classe de caractères La section suivante décrit l'utilisation de chaque méta caractères : + </para> + </refsect2> + <refsect2 id="regexp.reference.backslash"> + <title>Just a title</title> + <para> ANTISLASH - Le caractère antislash a de nombreuses utilisations. En premier - lieu, s'il est suivi d'un caractère non alpha numérique, - il ne prendra pas la signification spéciale qui y est - rattachée. Cette utilisation de l'antislash comme - caractère d'échappement s'applique à - l'intérieur et à l'extérieur des classes - de caractères. Par exemple, pour recherche le caractère - étoile "*", il faut écrire dans le masque : "\*". Cela + Le caractère antislash a de nombreuses utilisations. En premier + lieu, s'il est suivi d'un caractère non alpha numérique, + il ne prendra pas la signification spéciale qui y est + rattachée. Cette utilisation de l'antislash comme + caractère d'échappement s'applique à + l'intérieur et à l'extérieur des classes + de caractères. Par exemple, pour recherche le caractère + étoile "*", il faut écrire dans le masque : "\*". Cela s'applique dans tous les cas, que le caractère qui suive - soit un méta-caractère ou non. C'est un moyen sûr - pour s'assurer qu'un caractère sera recherché pour sa valeur + soit un méta-caractère ou non. C'est un moyen sûr + pour s'assurer qu'un caractère sera recherché pour sa valeur litérale, plutot que pour sa valeur spéciale. En particulier, pour rechercher les antislash, il faut écrire : "\\". - Si un masque est utilisé avec l'option PCRE_EXTENDED, les espaces - blancs du masque, mais qui ne sont pas dans une classe de caractères, - et les caractères entre dièses "#", ainsi que les nouvelles - lignes sont ignorées. L'antislash peut être utilisé + Si un masque est utilisé avec l'option PCRE_EXTENDED, les espaces + blancs du masque, mais qui ne sont pas dans une classe de caractères, + et les caractères entre dièses "#", ainsi que les nouvelles + lignes sont ignorées. L'antislash peut être utilisé pour échapper et ainsi rechercher un espace ou un dièse. - La deuxième utilité de l'antislash est de pouvoir coder des - caractères invisibles dans les masques. Il n'y a pas de restriction - sur la place de ces caractères invisibles, hormis pour le + La deuxième utilité de l'antislash est de pouvoir coder des + caractères invisibles dans les masques. Il n'y a pas de restriction + sur la place de ces caractères invisibles, hormis pour le caractère nul qui doit terminer le masque. Lors de la - préparation du masque, il est souvent plus pratique d'utiliser - les séquences d'échappement suivantes, plutôt que + préparation du masque, il est souvent plus pratique d'utiliser + les séquences d'échappement suivantes, plutôt que le caractère binaire qu'elle représente : \a alarme, c'est à dire le caractère BEL (hex 07) \cx "control-x", avec x qui peut être n'importe quel caractère. @@ -1000,6 +1143,11 @@ La différence entre \Z et \z tient au fait que \Z recherche les positions avant les nouvelles lignes et à la fin de la chaîne sujet, tandis que \z ne recherche que la fin de la chaîne. + </para> + </refsect2> + <refsect2 id="regexp.reference.circudollar"> + <title>Just a title</title> + <para> CIRCUMFLEX et DOLLAR En dehors d'une classe de caractère, avec les options par défaut, ^ est une assertion qui n'est vraie que si elle est placée tout au début de la @@ -1032,6 +1180,11 @@ Notez que les méta caractères \A, \Z, et \z peuvent servir à répérer le début et la fin du sujet, et toutes les parties du masque qui commenceront par \A seront toujours ancrées, avec l'option PCRE_MULTILINE ou non. + </para> + </refsect2> + <refsect2 id="regexp.reference.dot"> + <title>Just a title</title> + <para> FULL STOP (PERIOD, DOT) En dehors d'une classe de caractères, un point remplace n'importe quel caractère, même invisible et à l'exception du caractère de nouvelle ligne. Avec l'option @@ -1040,6 +1193,11 @@ Le seul point commun est que les deux ont un comportement particulier vis à vis des caractère de nouvelle ligne. Le point n'a pas de comportement particulier dans une classe de caractères. + </para> + </refsect2> + <refsect2 id="regexp.reference.squarebrackets"> + <title>Just a title</title> + <para> SQUARE BRACKETS Un crochet ouvrant introduit une classe de caractère, et le crochet fermant la conclut. Le crochet fermant n'a pas de signification en lui même. Si le crochet @@ -1090,14 +1248,24 @@ Tous les caractères non alphanumériques autres que \, -, ^ (placé en début de chaîne) et ] n'ont pas de significations particulière, mais ils ne perdront rien à être échappés. + </para> + </refsect2> + <refsect2 id="regexp.reference.verticalbar"> + <title>Just a title</title> + <para> VERTICAL BAR La barre verticale sert à séparer des alternatives. Par exemple, dans le masque dupont|martin recherche soit "dupont", soit " martin ". Le nombre d'alternative n'est pas limité, et il est même possible d'utiliser la chaîne vide. Lors de la recherche, toutes les alternatives sont essayées, de gauche à droit, et la première qui est - acceptée, est utilisée. Si les alternatives sont dans un sous masque, elle ne + acceptée, est utilisée. Si les alternatives sont dans un sous-masque, elle ne réussiront que si le masque principal réussi aussi. + </para> + </refsect2> + <refsect2 id="regexp.reference.internal_options"> + <title>Just a title</title> + <para> INTERNAL OPTION SETTING Les options PCRE_CASELESS, PCRE_MULTILINE, PCRE_DOTALL, et PCRE_EXTENDED peuvent être changée depuis le masque lui-même, avec des séquences mises "(?" et ")". @@ -1112,7 +1280,7 @@ annulera les options PCRE_DOTALL et PCRE_EXTENDED. Si une option apparaît avant et après le signe moins, l'option sera annulée. Le domaine d'application de ces options dépend de la position de la séquence - d'option. Pour toutes les séquences d'options qui sont hors des sous masques + d'option. Pour toutes les séquences d'options qui sont hors des sous-masques (définis plus loin), l'effet est le même que si l'option avait été fixée dès le début de la recherche. Les exemples suivants se comportent tous de la même façons : @@ -1123,11 +1291,11 @@ et sont parfaitement équivalents au masque abc avec l'option PCRE_CASELESS. En d'autres termes, mettre des séquences d'options dans le corps principal du masque revient à appliquer l'option à tout le masque, sauf ordre contraire dans - les sous masques. Si il y a plusieurs séquences d'option qui portent sur la même + les sous-masques. Si il y a plusieurs séquences d'option qui portent sur la même optin, la dernière s'appliquera. Si une option intervient dans un sous-masque, le comportement est différent. C'est un changement de comportement apparu en Perl 5.005. Une option à l'intérieur - d'un sous masque n'affecte que cette partie du masque, ce qui fait que + d'un sous-masque n'affecte que cette partie du masque, ce qui fait que (a(?i)b)c acceptera abc et aBc mais aucune autre chaîne (en supposant que PCRE_CASELESS n'est pas utilisé). Cela signifie que les options permettent d'avoir différente @@ -1142,45 +1310,55 @@ U et X. L'option (?X) est particulière, car elle doit toujours intervenir avant toutes les autres options, même au niveau du masque entier. Il vaut mieux la mettre au début du masque. + </para> + </refsect2> + <refsect2 id="regexp.reference.subpatterns"> + <title>Just a title</title> + <para> SUBPATTERNS - Les sous masques sont délimités par des parenthèses, et peuvent être imbriquées. - Ajouter des sous masques a deux utilités : + Les sous-masques sont délimités par des parenthèses, et peuvent être imbriquées. + Ajouter des sous-masques a deux utilités : 1. Délimiter des alternatives. Par exemple, le masque cat(aract|erpillar|) acceptera les mots "char", "chardon", ou "charmant". Sans les parenthèses, il n'accepterait que "chardon", "mant" ou la chaîne vide. - 2. Le sous masque est considéré comme capturante : Lorsqu'une - chaîne sujet est acceptée par le masque complet, les sous - masques sont transmis à l'appelant grâce à un vecteur - de sous masques. Les parenthèses ouvrantes sont comptées de + 2. Le sous-masque est considéré comme capturante : Lorsqu'une + chaîne sujet est acceptée par le masque complet, les sous + masques sont transmis à l'appelant grâce à un vecteur + de sous-masques. Les parenthèses ouvrantes sont comptées de gauche à droite, (commencant à 1). - Par exemple, soit la chaîne sujet "le roi soleil " qui est + Par exemple, soit la chaîne sujet "le roi soleil " qui est utilisée avec le masque suivant : Le ((roi|prince) (soleil|charmant)) - les sous masques capturé sont "roi soleil ", "roi", et "soleil", numérotés + les sous-masques capturé sont "roi soleil ", "roi", et "soleil", numérotés respectivement 1, 2, et 3. - L'ubiquité des parenthèses n'est pas toujours simple - d'emploi. Il y a des moments oú regrouper des sous masques + L'ubiquité des parenthèses n'est pas toujours simple + d'emploi. Il y a des moments oú regrouper des sous-masques est nécessaire, sans pour autant capturer - la valeur trouvée. Si une parenthèse ouvrante est suivie de "?:", le sous masque + la valeur trouvée. Si une parenthèse ouvrante est suivie de "?:", le sous-masque ne capture pas la chaîne assortie, et ne sera pas compté lors de la numérotation des captures. Par exemple, avec la chaîne "le prince charmant", utilisé avec le masque pattern Le (( ?roi|prince) (soleil|charmant)) les chaînes capturées seront "prince charmant " et "charmant", numérotés respectivement 1 et 2. Le nombre maximal de chaîne capturées est de 99, et le - nombre total de sous masque (capturant ou non) ne doit pas dépasser 200. + nombre total de sous-masque (capturant ou non) ne doit pas dépasser 200. (?i:samedi|dimanche) (?:(?i) samedi | dimanche) De plus, comme les séquences d'options sont valables sur toute une alternative, le masque ci dessus acceptera aussi "DIMANCHE" que "Dimanche". + </para> + </refsect2> + <refsect2 id="regexp.reference.repetitions"> + <title>Just a title</title> + <para> REPETITION les Répétitions sont spécifiées avec des quantificateurs, qui peuvent être placés à la suite des caractères suivants : Un caractère unique, même s'il s'agit d'un méta caractère Une classe de caractères Une référence de retour (Voir section suivante) - Un sous masque avec parenthèses (a moins que ce ne soit une assertion, voir plus + Un sous-masque avec parenthèses (a moins que ce ne soit une assertion, voir plus loin) Les quantificateurs généraux précisent un nombre minimum et maximum de répétitions possibles, donnés par deux nombres entre accolades, et séparés par une virgule. @@ -1204,14 +1382,14 @@ * équivalent à {0,} + équivalent à {1,} ? équivalent à {0,1} - Il est possible de constituer des boucles infinies en créant un sous masque + Il est possible de constituer des boucles infinies en créant un sous-masque sans caractères, mais pourvu d'un quantificateur sans limite supérieure. Par exemple (a?)* Les versions plus anciennes de Perl et PCRE généraient alors une erreur au moment de la compilation. Cependant, étant donné qu'il existe des situations oú ces constructions peuvent être utiles, ces masques sont désormais autorisés. - Cependant, si la répétion du sous masque ne trouve aucun caractère, la boucle est + Cependant, si la répétion du sous-masque ne trouve aucun caractère, la boucle est interrompue. Par défaut, les quantificateurs sont "gourmands", c'est à dire, qu'ils cherchent d'abord à trouve le nombre maximal de répétitions qui autorise le succès de la @@ -1239,7 +1417,7 @@ Perl) alors les quantificateurs sont non gourmand par défaut, mais peuvent être rendu gourmand au cas par cas, en ajoutant un point d'interrogation après. En d'autres termes, cette option inverse le comportement par défaut. - Lorsqu'un sous masque est quantifié avec un nombre minimum de répétition, qui + Lorsqu'un sous-masque est quantifié avec un nombre minimum de répétition, qui soit plus grand que 1, ou avec un maximum de répétition, le masque compilé aura besoin de plus de place de stockage, proportionnellement au minimum et au maximum. @@ -1251,37 +1429,42 @@ n'y aura pas de caractère de nouvelle ligne, mettre l'option PCRE_DOTALL et commencer le masque par.* permet d'optmiser le masque. Alternativement, on peut utiliser ^ pour ancrer explicitement le masque. - Lorsqu'un sous masque capturant est répété, la valeur capturée est la dernière. + Lorsqu'un sous-masque capturant est répété, la valeur capturée est la dernière. Par exemple, après que (inter[net]{3}\s*)+ *)+ ai été appliqué à "internet interne" la valeur de la chaîne capturée est - "interne". Cependant, si il y a des sous masques imbriqués, la valeur capturée + "interne". Cependant, si il y a des sous-masques imbriqués, la valeur capturée correspondante peut l'avoir été lors des précédentes itérations. Par exemple : /(a|(b))+/ accepte "aba" et la deuxième valeur capturée est + </para> + </refsect2> + <refsect2 id="regexp.reference.back_references"> + <title>Just a title</title> + <para> Références arrières (back references) En dehors des classes de caractères, un antislash suivi d'un nombre plus grand que 0 (et possiblement plusieurs chiffres) est une référence arrière (c'est à dire vers la gauche) dans le masque, en supposant qu'il y ait suffisamment de - sous masques capturant précédent. - Cependant, si le nombre décimal suivant l'antislash est plus petit + sous-masques capturant précédent. + Cependant, si le nombre décimal suivant l'antislash est plus petit que 10, il sera toujours considéré comme une référence arrière, et cela générera une erreur si le nombre de capture n'est pas suffisant. En d'autres termes, il faut qu'il existe suffisamment de parenthèses ouvrantes à gauche de la référence, surtout si la référence est inférieure à 10. Reportez vous à la section "antislash" pour avoir de plus amples détails à propos du nombre de chiffres qui suivent l'antislash. - La référence arrière remplace ce qui a été capturé par un sous masque dans le - masque courant, plutôt que remplace le sous masque lui même. Ainsi + La référence arrière remplace ce qui a été capturé par un sous-masque dans le + masque courant, plutôt que remplace le sous-masque lui même. Ainsi (calme|rapide) et \1ment trouvera "calme et calmement " et "rapide et rapidement ", mais pas " calme et rapidement ". Si la recherche tiens compte de la casse, alors la casse de la chaîne capturée sera importante. Par exemple, ((?i)rah)\s+\1 - trouve "rah rah" et "RAH RAH", mais pas "RAH rah", même si le sous masque + trouve "rah rah" et "RAH RAH", mais pas "RAH rah", même si le sous-masque capturant initial ne tenait pas compte de la casse. - Il peut y avoir plusieurs références arrières dans le même sous masque. Si un - sous masque n'a pas été utilisé dans une recherche, alors les références arrières + Il peut y avoir plusieurs références arrières dans le même sous-masque. Si un + sous-masque n'a pas été utilisé dans une recherche, alors les références arrières échoueront. Par exemple (a|(bc))\2 ne réussira jamais si la chaîne sujet commence par "a" plutôt que par "bc". @@ -1292,25 +1475,30 @@ l'option PCRE_EXTENDED est mise, on peut utiliser un espace. Sinon, un commentaire vide fait l'affaire. Une référence arrière qui intervient à l'intérieur de parenthèses auquel - elle fait référence échouera dès que le sous masque sera utilisé. Par exemple, + elle fait référence échouera dès que le sous-masque sera utilisé. Par exemple, (a\1) échouera toujours. Cependant, ces références peuvent être utiles dans les - sous masques répétitifs. Par exemple, le masque + sous-masques répétitifs. Par exemple, le masque (a|b\1)+ - pourra convenir pour "a", "aba", "ababaa" etc. A chaque itération du sous masque, - la référence arrière utilise le résultat du dernier sous masque. Pour que cela + pourra convenir pour "a", "aba", "ababaa" etc. A chaque itération du sous-masque, + la référence arrière utilise le résultat du dernier sous-masque. Pour que cela fonctionne, il faut que la première itération n'ai pas besoin d'utiliser la référence arrière. Cela arrive avec les alternatives, comme dans l'exemple ci dessus, ou avec un quantificateur de minimum 0. + </para> + </refsect2> + <refsect2 id="regexp.reference.assertions"> + <title>Just a title</title> + <para> Les assertions Une assertion est un test sur les caractères suivants ou précédent celui qui est en cours d'étude. Ce test ne consomme par de caractère (ie, on ne déplace pas le pointeur de caractères). Les assertions simples sont codées avec \b, \B, \A, \Z, \z, ^ et $, et sont décrite précédemment. Il existe cependant un type - d'assertion plus complexe, codées sous la forme de sous masques. Il en existe + d'assertion plus complexe, codées sous la forme de sous-masques. Il en existe deux types : ceux qui travaille au dela de la position courante, et ceux qui travaille en deça. \w+(?=;) - Une assertion se comporte comme un sous masque, hormis le fait qu'elle ne + Une assertion se comporte comme un sous-masque, hormis le fait qu'elle ne déplace pas le pointeur de position. Les assertions avant commencent par (?= pour les assertions positives et par (?! pour des assertions négatives. Par exemple : foo(?!bar) @@ -1321,7 +1509,7 @@ quelque chose d'autre que "foo"; il trouve toutes les occurrences de "bar", quelque soit ce qui le précéde, car l'assertion (?!foo) est toujours vraie quand les trois caractères suivants sont "bar". Une assertion arrière est ici nécessaire. - Ces assertions commencent par (?<= pour les assertions positives, et (?<! + Ces assertions commencent par (?<= pour les assertions positives, et (?<! pour les assertions négatives. Par exemple : (?<!foo)bar trouve les occurrences de "bar" qui ne sont pas précédées par "foo". Le contenu @@ -1342,7 +1530,7 @@ L' implémentation des assertions arrières déplace temporairement le pointeur de position vers l'arrière, et cherche à vérifier l'assertion. Si le nombre de caractère est différent, la position ne sera pas correcte, et l'assertion - échouera. La combinaison d'assertions arrières avec des sous masques peut être + échouera. La combinaison d'assertions arrières avec des sous-masques peut être particulièrement pratique à fin des chaînes. Un exemple est donné à la fin de cette section. Plusieurs assertions peuvent intervenir successivement. Par exemple @@ -1353,12 +1541,12 @@ recherche les occurrences de "baz" qui sont précédées par "bar", qui, à son tour, n'est pas précédé par "foo". Les assertions ne sont pas capturantes, et ne peuvent pas être répétées. Si une - assertion contient des sous masques capturants en son sein, ils seront compris - dans le nombre de sous masques capturants du masque entier. La capture est + assertion contient des sous-masques capturants en son sein, ils seront compris + dans le nombre de sous-masques capturants du masque entier. La capture est réalisée pour les assertions positives, mais cela n'a pas de sens pour les assertions négatives. 200 assertions au maximum sont autorisées. - Sous masques uniques (ONCE-ONLY SUBPATTERNS) + sous-masques uniques (ONCE-ONLY SUBPATTERNS) Avec les quantificateurs de répétitions, l'échec d'une recherche conduit normalement à une autre recherche, avec un nombre différent de répétitions, pour voir si le masque ne s'applique pas dans d'autres conditions. Parfois, il @@ -1367,35 +1555,39 @@ d'aller plus loin. Considérons par exemple, le masque \d+foo appliqué à la ligne 123456bar - Après avoir tenté d'utiliser les 6 chiffres suivi de "foo" qui fait échouer, - l'action habituelle sera de réessayer avec 5 chiffres, puis avec 4, et ainsi de - suite jusqu'à l'échec final. Un sous masque évalué une seule fois permettrait - d'indiquer que lorsqu'une partie du masque est trouvée, elle n'a pas besoin - d'être réévaluée à chaque tentative. Ceci conduirait à ce que la recherche - échoue immédiatement après le premier test. Ces assertions ont leur propre - notation, commencant avec (?>comme ceci : + Après avoir tenté d'utiliser les 6 chiffres suivi de "foo" qui + fait échouer, l'action habituelle sera de réessayer avec 5 + chiffres, puis avec 4, et ainsi de suite jusqu'à l'échec final. + Un sous-masque évalué une seule fois permettrait d'indiquer que + lorsqu'une partie du masque est trouvée, elle n'a pas besoin + d'être réévaluée à chaque tentative. Ceci + conduirait à ce que la recherche échoue immédiatement + après le premier test. Ces assertions ont leur propre notation, + commencant avec (?>comme ceci : (?>\d+)bar - Après avoir tenté d'utiliser les 6 chiffres suivi de "foo" qui fait échouer, - l'action habituelle sera de réessayer avec 5 chiffres, puis avec 4, et ainsi de - suite jusqu'à l'échec final. Un sous masque évalué une seule fois permettrait - d'indiquer que lorsqu'une partie du masque est trouvée, elle n'a pas besoin - d'être réévaluée à chaque tentative. Ceci conduirait à ce que la recherche - échoue immédiatement après le premier test. Ces assertions ont leur propre - notation, commencant avec (?>comme ceci : - (?>\d+)bar - Ce type de parenthèses verrouille le sous masque qu'il contient un fois qu'il - a été trouvé, et empêche un échec ultérieur d'y repasser, mais autorise à - revenir plus loin en arrière. - Une autre description est que les sous masques de ce type recherche les chaînes - de caractères, et les ancre le sous masque à l'intérieur de la chaîne. - Les sous masques uniques ne sont pas capturants. Des cas simples comme ceux + Après avoir tenté d'utiliser les 6 chiffres suivi de "foo" + qui fait échouer, l'action habituelle sera de réessayer avec + 5 chiffres, puis avec 4, et ainsi de suite jusqu'à l'échec + final. Un sous-masque évalué une seule fois permettrait + d'indiquer que lorsqu'une partie du masque est trouvée, elle + n'a pas besoin d'être réévaluée à + chaque tentative. Ceci conduirait à ce que la recherche échoue + immédiatement après le premier test. Ces assertions ont leur + propre notation, commencant avec (?>comme ceci : (?>\d+)bar. + Ce type de parenthèses verrouille le sous-masque qu'il contient + un fois qu'il a été trouvé, et empêche un + échec ultérieur d'y repasser, mais autorise à revenir + plus loin en arrière. Une autre description est que les sous-masques + de ce type recherche les chaînes + de caractères, et les ancre le sous-masque à l'intérieur de la chaîne. + Les sous-masques uniques ne sont pas capturants. Des cas simples comme ceux présentés ci dessus peuvent être pris comme des situations maximisantes, qui réservent le maximum de caractères. En effet, alors que \d+ et \d+? ajustent le nombre de chiffres trouvés de manière à laisser la possibilité au masque de réussir, (?>\d+) ne peut retenir que la séquence entière de chiffres. - Cette construction peut contenir un nombre arbitraire de sous masques complexes, + Cette construction peut contenir un nombre arbitraire de sous-masques complexes, et ils peuvent être imbriqués. - Les sous masques uniques ne peuvent être utilisés qu'avec les assertions + Les sous-masques uniques ne peuvent être utilisés qu'avec les assertions arrières, pour effectuer une recherche efficace en fin de chaîne. Considérons un masque simple tel que abcd$ @@ -1415,9 +1607,14 @@ va alors faire un test sur les 4 derniers caractères. Si elle échoue, la recherche est immédiatement interrompue. Pour les chaînes très longues, cette approche fait la différence en terme de performance et de temps de recherche. -Les sous masques conditionnels (CONDITIONAL SUBPATTERNS) - Il est possible de lier un sous masque à un une condition, ou de choisir entre - deux sous masques alternatifs, en fonction du résultat d'une assertion, ou + </para> + </refsect2> + <refsect2 id="regexp.reference.conditional"> + <title>Just a title</title> + <para> +Les sous-masques conditionnels (CONDITIONAL SUBPATTERNS) + Il est possible de lier un sous-masque à un une condition, ou de choisir entre + deux sous-masques alternatifs, en fonction du résultat d'une assertion, ou suivant les résultats de recherche précédents. Les deux formes possibles de sous masques conditionnels sont (?(condition)masque positif) @@ -1426,7 +1623,7 @@ masque négatif est utilisé, si présent. Si il y a plus de deux alternatives, une erreur est générée à la compilation. Il y a deux types de conditions. Si le texte entre les parenthèses est une - séquence de chiffre, alors la condition est satisfaite si le sous masque + séquence de chiffre, alors la condition est satisfaite si le sous-masque correspondant à ce numéro a réussi. Considérons le masque suivant, qui contient des espaces non significatif pour le rendre plus compréhensible (on supposera l'option PCRE_EXTENDED mise) et qui est divisé en trois parties pour simplifier @@ -1451,6 +1648,11 @@ poursuit avec la première alternative, et sinon, avec la seconde. Ce masque recherche des chaînes de la forme dd-aaa-dd ou dd-dd-dd, avec aaa qui sont des lettres, et dd qui sont des chiffres + </para> + </refsect2> + <refsect2 id="regexp.reference.comments"> + <title>Just a title</title> + <para> COMMENTS La séquence (?# marque le début des commentaires, qui se termine à la prochaîne parenthèse fermante. Les parenthèses imbriquées ne sont pas autorisées. @@ -1459,6 +1661,11 @@ Si l'option PCRE_EXTENDED est mise, les caractères dièses # non échappés en dehors d'une classe de caractères introduisent un commentaire qui continuera jusqu'à la prochaîne ligne dans le masque. + </para> + </refsect2> + <refsect2 id="regexp.reference.performances"> + <title>Just a title</title> + <para> PERFORMANCE Certaines séquences de recherches sont plus efficaces que d'autres. Ainsi, il est plus efficace d'utiliser une classe de caractères telle que [aeiou] plutôt @@ -1482,7 +1689,8 @@ avec l'option PCRE_DOTALL, ou en ancrant le masque avec ^.*. Cela évite à PCRE de scanner toute la chaîne pour rechercher un caractère de nouvelle ligne et recommencer la recherche. - </literallayout> + </para> + </refsect2> </refsect1> </refentry> </reference> Index: phpdoc/fr/functions/pdf.xml diff -u phpdoc/fr/functions/pdf.xml:1.4 phpdoc/fr/functions/pdf.xml:1.5 --- phpdoc/fr/functions/pdf.xml:1.4 Fri Dec 8 02:04:55 2000 +++ phpdoc/fr/functions/pdf.xml Fri Jan 26 06:44:21 2001 @@ -1,5 +1,5 @@ <reference id="ref.pdf"> - <title>Fonctions PDF</title> + <title>PDF</title> <titleabbrev>PDF</titleabbrev> <partintro> <simpara> @@ -227,7 +227,7 @@ </simpara> </sect1> <sect1 id="pdf.examples"> - <title>Examples</title> + <title>Exemples</title> <simpara> La plus part des fonctions sont simples d'emploi.Le plus difficile est probablement de créer un fichier PDF simple. L'exemple suivant @@ -239,7 +239,7 @@ <para> <example> <title>Création d'un document PDF avec pdflib</title> - <programlisting> + <programlisting role="php"> <?php $fp = fopen("test.pdf", "w"); $pdf = pdf_open($fp); @@ -259,19 +259,19 @@ pdf_close($pdf); fclose($fp); echo "<A HREF=getpdf.php>finished</A>"; -?> +?> </programlisting> <simpara> Ce script <filename>getpdf.php</filename> retourne simplement le document PDF. </simpara> <informalexample> - <programlisting> + <programlisting role="php"> <?php $fp = fopen("test.pdf", "r"); header("Content-type: application/pdf"); fpassthru($fp); fclose($fp); -?> +?> </programlisting> </informalexample> </example> @@ -285,7 +285,7 @@ <para> <example> <title>Exemple pdfclock issue de la distribution pdflib</title> - <programlisting> + <programlisting role="php"> <?php $pdffilename = "clock.pdf"; $radius = 200; @@ -296,7 +296,7 @@ pdf_set_info($pdf, "Creator", "pdf_clock.php3"); pdf_set_info($pdf, "Author", "Uwe Steinmann"); pdf_set_info($pdf, "Title", "Analog Clock"); -while($pagecount-- > 0) { +while($pagecount-- > 0) { pdf_begin_page($pdf, 2 * ($radius + $margin), 2 * ($radius + $margin)); pdf_set_parameter($pdf, "transition", "wipe"); pdf_set_value($pdf, "duration", 0.5); @@ -358,20 +358,21 @@ $pdf = pdf_close($pdf); fclose($fp); echo "<A HREF=getpdf.php?filename=".$pdffilename.">finished</A>"; -?> +?> </programlisting> <simpara> Ce script <filename>getpdf.php</filename> ne fait que retourner un document PDF. </simpara> - <programlisting> + <programlisting role="php"> <?php $fp = fopen($filename, "r"); header("Content-type: application/pdf"); fpassthru($fp); fclose($fp); -?> +?> </programlisting> - </example></para> + </example> + </para> </sect1> </partintro> <refentry id="function.pdf-set-info"> @@ -398,7 +399,7 @@ Cette fonction peut être appelée avant la création d'une page. <example> <title>Préparer l'entête d'un document PDF</title> - <programlisting> + <programlisting role="php"> <?php $fd = fopen("test.pdf", "w"); $pdfdoc = pdf_open($fd); @@ -411,7 +412,7 @@ pdf_begin_page($pdfdoc, 595, 842); pdf_end_page($pdfdoc); pdf_close($pdfdoc); -?> +?> </programlisting> </example> </para> @@ -890,7 +891,7 @@ <para> <function>pdf_set_text_rendering</function> determine le rendu du texte. Les valeurs possibles pour <parameter>mode</parameter> sont 0=fill text - (texte plein), 1=stroke text (???), 2=fill and stroke text (texte plein + (texte plein), 1=stroke text (???), 2=fill et stroke text (texte plein et stroke), 3=invisible, 4=texte plein, et ajouté au chemin, 5=stroke text, ajouté au chemin, 6=texte plein et stroke, ajouté au chemin, 7=ajouté au chemin. @@ -1149,10 +1150,12 @@ faire des translations ou des rotations sans affecter les autres objets. <example> <title>Sauver et restaurer un environnement PDF</title> - <programlisting> -<?php PDF_save($pdf); + <programlisting role="php"> +<?php +pdf_save($pdf); // tout un lot de rotations, translations, transformations... -PDF_restore($pdf) ?> +pdf_restore($pdf) +?> </programlisting> </example> </para> @@ -1185,7 +1188,7 @@ et avant de commencer à dessiner les objets. <example> <title>Translation</title> - <programlisting> + <programlisting role="php"> <?php PDF_moveto($pdf, 0, 0); PDF_lineto($pdf, 100, 100); PDF_stroke($pdf); @@ -1193,7 +1196,7 @@ PDF_moveto($pdf, 0, 0); PDF_lineto($pdf, 100, 100); PDF_stroke($pdf); -?> +?> </programlisting> </example> </para> @@ -1220,11 +1223,11 @@ dessinée sur un pouce (2.54 cm) de large. <example> <title>Mise à l'échelle</title> - <programlisting> + <programlisting role="php"> <?php PDF_scale($pdf, 72.0, 72.0); PDF_lineto($pdf, 1, 1); PDF_stroke($pdf); -?> +?> </programlisting> </example> </para> @@ -1956,7 +1959,8 @@ <member> 7 : l'ancienne page est simplement remplacée par la nouvelle (valeur par défaut) </member> - </simplelist></para> + </simplelist> + </para> <para> Voir aussi <function>pdf_set_duration</function>.</para> </refsect1> @@ -2004,12 +2008,12 @@ retourne un identifiant d'image PDF : <example> <title>Inclusion d'un image GIF</title> - <programlisting> + <programlisting role="php"> <?php $im = PDF_open_gif($pdf, "test.gif"); pdf_place_image($pdf, $im, 100, 100, 1); pdf_close_image($pdf, $im); -?> +?> </programlisting> </example> </para> @@ -2057,12 +2061,12 @@ </note> <example> <title>Including a PNG image</title> - <programlisting> + <programlisting role="php"> <?php $im = pdf_open_png ($pdf, "test.png"); pdf_place_image ($pdf, $im, 100, 100, 1); pdf_close_image ($pdf, $im); -?> +?> </programlisting> </example> </para> @@ -2099,12 +2103,12 @@ La fonction retourne un identifiant d'image PDF. <example> <title>Insertion d'une image dans un fichier PDF</title> - <programlisting> + <programlisting role="php"> <?php $pim = pdf_open_image_file($pdf, "png", "picture.png"); pdf_place_image($pdf, $pim, 100, 100, 1); pdf_close_image($pdf, $pim); -?> +?> </programlisting> </example> </para> @@ -2142,7 +2146,7 @@ pour le document PDF. La fonction retourne un identifiant PDF d'image. <example> <title>Inclusion d'une image mémoire</title> - <programlisting> + <programlisting role="php"> <?php $im = ImageCreate(100, 100); $col = ImageColorAllocate($im, 80, 45, 190); @@ -2151,7 +2155,7 @@ ImageDestroy($im); pdf_place_image($pdf, $pim, 100, 100, 1); pdf_close_image($pdf, $pim); -?> +?> </programlisting> </example> </para> @@ -2366,7 +2370,7 @@ </note> <example> <title>Affichage multiple d'une image.</title> - <programlisting> + <programlisting role="php"> <?php $im = ImageCreate(100, 100); $col1 = ImageColorAllocate($im, 80, 45, 190); @@ -2376,7 +2380,7 @@ pdf_execute_image($pdf, $pim, 100, 100, 1); pdf_execute_image($pdf, $pim, 200, 200, 2); pdf_close_image($pdf, $pim); -?> +?> </programlisting> </example> </para> Index: phpdoc/fr/functions/pfpro.xml diff -u phpdoc/fr/functions/pfpro.xml:1.3 phpdoc/fr/functions/pfpro.xml:1.4 --- phpdoc/fr/functions/pfpro.xml:1.3 Tue Dec 12 02:49:53 2000 +++ phpdoc/fr/functions/pfpro.xml Fri Jan 26 06:44:21 2001 @@ -1,18 +1,19 @@ <reference id="ref.pfpro"> - <title>Fonctions de paiement Verisign Payflow Pro</title> - <titleabbrev>Verisign Payflow Pro</titleabbrev> + <title>Verisign Payflow Pro Paiement</title> + <titleabbrev>Paiement par Verisign</titleabbrev> <partintro> <simpara> Cette extension vous permet d'effectuer des transactions avec des cartes - de crédits en utilisant les services Verisign Payment Services, anciennement - connu sous le nom de Signio (<ulink url="&url.pfpro;">&url.pfpro;</ulink>). + de crédits en utilisant les services Verisign Payment Services, + anciennement connu sous le nom de Signio + (<ulink url="&url.pfpro;">&url.pfpro;</ulink>). </simpara> <simpara> - Ces fonctions sont utilisables dès que PHP a été compilé avec - l'option <option role="configure">--with-pfpro[=DIR]</option>. Vous - devez aussi utiliser le SDK approprié sur votre plate-forme : il - est disponible <ulink url="&url.pfpro.download;">l'interface du - manager</ulink>, une fois que vous vous êtes inscrit. + Ces fonctions sont utilisables dès que PHP a été + compilé avec l'option <option role="configure">--with-pfpro[=DIR]</option>. + Vous devez aussi utiliser le SDK approprié sur votre plate-forme : il + est disponible <ulink url="&url.pfpro.download;">l'interface du manager</ulink>, + une fois que vous vous êtes inscrit. </simpara> <simpara> Une fois que vous avez téléchargé le SDK vous devez copier les @@ -177,13 +178,13 @@ <programlisting role="php"> <?php pfpro_init(); -$transaction = array(USER => 'monlogin', - PWD => 'mmotdepasse', - TRXTYPE => 'S', - TENDER => 'C', - AMT => 1.50, - ACCT => '4111111111111111', - EXPDATE => '0904' +$transaction = array(USER => 'monlogin', + PWD => 'mmotdepasse', + TRXTYPE => 'S', + TENDER => 'C', + AMT => 1.50, + ACCT => '4111111111111111', + EXPDATE => '0904' ); $response = pfpro_process($transaction); if (!$response) { @@ -196,7 +197,7 @@ echo "\nLa réponse: "; print_r($response); pfpro_cleanup(); -?> +?> </programlisting> </example> </refsect1> @@ -268,7 +269,7 @@ } echo "La réponse brute de Verisign est ".$response; pfpro_cleanup(); -?> +?> </programlisting> </example> </refsect1> Index: phpdoc/fr/functions/pgsql.xml diff -u phpdoc/fr/functions/pgsql.xml:1.8 phpdoc/fr/functions/pgsql.xml:1.9 --- phpdoc/fr/functions/pgsql.xml:1.8 Wed Dec 13 05:57:11 2000 +++ phpdoc/fr/functions/pgsql.xml Fri Jan 26 06:44:21 2001 @@ -1,5 +1,5 @@ <reference id="ref.pgsql"> - <title>Fonctions PostgreSQL</title> + <title>PostgreSQL</title> <titleabbrev>PostgreSQL</titleabbrev> <partintro> <para> @@ -71,7 +71,7 @@ </para> <para> L'ancienne syntaxe : - <command>$conn = pg_connect ("host", "port", "options", "tty", "dbname")</command> + <command>$conn = pg_connect("host", "port", "options", "tty", "dbname")</command> est obsolète. </para> <para> @@ -85,17 +85,17 @@ <title>Utilisation des objets de grande taille (Large Objects)</title> <programlisting role="php"> <?php -$database = pg_Connect ("", "", "", "", "jacarta"); -pg_exec ($database, "begin"); - $oid = pg_locreate ($database); - echo ("$oid\n"); - $handle = pg_loopen ($database, $oid, "w"); - echo ("$handle\n"); - pg_lowrite ($handle, "gaga"); - pg_loclose ($handle); -pg_exec ($database, "commit") -pg_exec ($database, "end") -?> +$database = pg_connect("", "", "", "", "jacarta"); +pg_exec($database, "begin"); + $oid = pg_locreate($database); + echo "$oid\n"; + $handle = pg_loopen($database, $oid, "w"); + echo "$handle\n"; + pg_lowrite($handle, "gaga"); + pg_loclose($handle); + pg_exec($database, "commit") + pg_exec($database, "end") +?> </programlisting> </example> </para> @@ -114,7 +114,7 @@ </funcprototype> </funcsynopsis> <para> - Retourne FALSE si l'index de connexion n'est pas valable, et TRUE sinon. + Retourne <literal>FALSE</literal> si l'index de connexion n'est pas valable, et <literal>TRUE</literal> sinon. Ferme la connexion au serveur PostgreSQL associé à <parameter>connection</parameter>. </para> @@ -155,7 +155,7 @@ $result = pg_exec($conn, "INSERT INTO verlag VALUES ('Auteur')"); $cmdtuples = pg_cmdtuples($result); echo $cmdtuples . " <- tuples modifiés."; -?> +?> </programlisting> </example> </para> @@ -176,20 +176,20 @@ </funcsynopsis> <para> <parameter>conn_string</parameter> retourne un index de - connexion en cas de succès, et FALSE sinon. Ouvre une connexion + connexion en cas de succès, et <literal>FALSE</literal> sinon. Ouvre une connexion à un serveur PostgreSQL. Les arguments doivent être placé entre guillemets. <example> <title>Using pg_connect arguments</title> <programlisting role="php"> <?php -$dbconn = pg_Connect ("dbname=marie"); +$dbconn = pg_connect("dbname=marie"); //connexion à une base de données nommée "marie" -$dbconn2 = pg_Connect ("host=localhost port=5432 dbname=marie"); +$dbconn2 = pg_connect("host=localhost port=5432 dbname=marie"); //connexion à une base de données nommée "marie" sur l'hôte "localhost" sur le port "5432" -$dbconn3 = pg_Connect ("user=agneau password=baaaa dbname=marie "); +$dbconn3 = pg_connect("user=agneau password=baaaa dbname=marie "); //connexion à une base de données nommée "marie" avec l'utilisateur "agneau" et le mot de passe "baaaa" -?> +?> </programlisting> </example> Les arguments disponbiles comptent notamment <parameter>dbname</parameter> @@ -204,7 +204,7 @@ </para> <para> L'ancienne syntaxe - <command>$conn = pg_connect ("host", "port", "options", "tty", "dbname")</command> + <command>$conn = pg_connect("host", "port", "options", "tty", "dbname")</command> est obsolète. </para> <para> @@ -227,7 +227,7 @@ </funcsynopsis> <para> Retourne le nom de la base de donnée PostgreSQL associée - à l'index de connexion connection, ou FALSE si connection n'est + à l'index de connexion connection, ou <literal>FALSE</literal> si connection n'est pas valide. </para> </refsect1> @@ -251,11 +251,11 @@ <function>pg_end_copy</function> synchronise le client PostgreSQL (ici PHP) avec le serveur, après une opération de copie. Il faut utiliser cette fonction, sous peine de recevoir une erreur "out of sync" - (désynchronisé). Retourne TRUE en cas de succès, et - FALSE sinon. + (désynchronisé). Retourne <literal>TRUE</literal> en cas de succès, et + <literal>FALSE</literal> sinon. </para> <para> - Pour plus de détails et un exemple voyez : + Pour plus de détails et un exemple voyez : <function>pg_put_line</function>. </para> </refsect1> @@ -274,8 +274,7 @@ </funcprototype> </funcsynopsis> <para> - Retourne une chaîne contenant le dernier message d'erreur, ou FALSE - en cas d'échec. Il sera impossible d'obtenir des détails sur + Retourne une chaîne contenant le dernier message d'erreur, ou <literal>FALSE</literal> en cas d'échec. Il sera impossible d'obtenir des détails sur l'erreur générée, en utilisant la fonction <function>pg_errormessage</function> si une erreur est survenue dans la dernière action pour laquelle une connexion valide existe. @@ -300,7 +299,7 @@ </funcsynopsis> <para> Retourne un index de résultat, si la requête a été - correctement exécutée, et FALSE en cas d'échec, ou si + correctement exécutée, et <literal>FALSE</literal> en cas d'échec, ou si la connexion connection n'était pas un index de connexion valide. En cas d'erreur, le message d'erreur peut être obtenu grâce à la fonction <function>pg_errormessage</function>, si l'index de connexion @@ -308,7 +307,7 @@ PostgreSQL identifié grâce à l'index de connexion. La réponse retournée par cette fonction est un index de résultat qui devra être utilisé pour accéder - aux lignes de résultat, grâce à d'autres + aux lignes de résultat, grâce à d'autres fonctions PostgreSQL. <note> <simpara> @@ -340,7 +339,7 @@ </funcsynopsis> <para> Retourne un tableau qui contient à la ligne demandée, dans - le résultat identifiée par result, et FALSE , si il ne + le résultat identifiée par result, et <literal>FALSE</literal> , si il ne reste plus de lignes. </para> <para> @@ -374,21 +373,21 @@ <title>PostgreSQL fetch array</title> <programlisting role="php"> <?php -$conn = pg_pconnect ("dbname=publisher"); +$conn = pg_pconnect("dbname=publisher"); if (!$conn) { echo "Erreur de connexion.\n"; exit; } -$result = pg_exec ($conn, "SELECT * FROM authors"); +$result = pg_exec($conn, "SELECT * FROM authors"); if (!$result) { echo "Erreur durant la requete.\n"; exit; } -$arr = pg_fetch_array ($result, 0); +$arr = pg_fetch_array($result, 0); echo $arr[0] . " <- array\n"; -$arr = pg_fetch_array ($result, 1); +$arr = pg_fetch_array($result, 1); echo $arr["author"] . " <- array\n"; -?> +?> </programlisting> </example> </refsect1> @@ -412,7 +411,7 @@ </funcsynopsis> <para> Retourne un objet dont les membres sont les champs de la ligne demandée, - ou FALSE , si il n'y a plus de lignes. + ou <literal>FALSE</literal> , si il n'y a plus de lignes. </para> <para> <function>pg_fetch_object</function> est similaire à @@ -446,37 +445,41 @@ <programlisting role="php"> <?php $database = "verlag"; -$db_conn = pg_connect ("host=localhost port=5432 dbname=$database"); -if (!$db_conn): ?> - <H1>Connexion impossible à la base postgres <?php echo $database ?></H1> <?php +$db_conn = pg_connect("host=localhost port=5432 dbname=$database"); +if (!$db_conn): +?> + <H1>Connexion impossible à la base postgres <?php echo $database ></H1> <?php exit; endif; -$qu = pg_exec ($db_conn, "SELECT * FROM verlag ORDER BY autor"); +$qu = pg_exec($db_conn, "SELECT * FROM verlag ORDER BY autor"); $row = 0; // postgres réclame un compteur de ligne, d'autres bases ne le font pas. -while ($data = pg_fetch_object ($qu, $row)): +while ($data = pg_fetch_object($qu, $row)): echo $data->autor." ("; echo $data->jahr ."): "; echo $data->titel."<BR>"; $row++; -endwhile; ?> +endwhile; +?> <PRE><?php -$fields[] = Array ("autor", "Author"); -$fields[] = Array ("jahr", " Year"); -$fields[] = Array ("titel", " Title"); +$fields[] = array("autor", "Author"); +$fields[] = array("jahr", " Year"); +$fields[] = array("titel", " Title"); $row= 0; // Postgres réclame un compteur de ligne, d'autres bases ne le font pas. -while ($data = pg_fetch_object ($qu, $row)): +while ($data = pg_fetch_object($qu, $row)): echo "----------\n"; - reset ($fields); - while (list (,$item) = each ($fields)): + reset($fields); + while (list(,$item) = each($fields)): echo $item[1].": ".$data->$item[0]."\n"; endwhile; $row++; endwhile; -echo "----------\n"; ?> -</PRE> <?php -pg_freeresult ($qu); -pg_close ($db_conn); -?> +echo "----------\n"; +?> +</PRE> +<?php +pg_freeresult($qu); +pg_close($db_conn); +?> </programlisting> </example> </para> @@ -498,7 +501,7 @@ </funcsynopsis> <para> Retourne un tableau qui contient les données de la ligne demandée, - ou FALSE , si il ne reste plus de lignes. + ou <literal>FALSE</literal> , si il ne reste plus de lignes. </para> <para> <function>pg_fetch_row</function> lit une ligne dans le résultat @@ -508,7 +511,7 @@ </para> <para> Les appels ultérieurs à <function>pg_fetch_row</function> - retourneront la ligne d'après, ou bien FALSE, lorsqu'il n'y aura + retourneront la ligne d'après, ou bien <literal>FALSE</literal>, lorsqu'il n'y aura plus de lignes. </para> <para> @@ -518,14 +521,14 @@ <title>Postgres retourne une ligne</title> <programlisting role="php"> <?php -$conn = pg_pconnect ("dbname=publisher"); +$conn = pg_pconnect("dbname=publisher"); if (!$conn) { - echo "An error occured.\n"; + echo "Une erreur est survenue.\n"; exit; } -$result = pg_Exec ($conn, "SELECT * FROM authors"); +$result = pg_exec($conn, "SELECT * FROM authors"); if (!$result) { - echo "An error occured.\n"; + echo "Une erreur est survenue.\n"; exit; } $num = pg_numrows($result); @@ -536,7 +539,7 @@ } echo "<BR>"; } -?> +?> </programlisting> </example> </para> @@ -816,7 +819,7 @@ <parameter>oid</parameter> est un identifiant d'objet de grande taille qui sera exporté dans le fichier <parameter>filename</parameter>, qui spécifie son chemin. RetourneFALSEsi une erreur survient, - et TRUE en cas de succès. N'oubliez pas que la manipulation d'un + et <literal>TRUE</literal> en cas de succès. N'oubliez pas que la manipulation d'un objet de grande taille dans PostgreSQL doit intervenir dans une transaction. </para> @@ -1056,7 +1059,7 @@ </para> <para> L'ancienne syntaxe - <command>$conn = pg_pconnect ("host", "port", "options", "tty", "dbname")</command> + <command>$conn = pg_pconnect("host", "port", "options", "tty", "dbname")</command> est obsolète. </para> </refsect1> @@ -1101,8 +1104,8 @@ par NULL) au serveur PostgreSQL. Ceci est pratique pour effectuer des insertions très rapides dans une table, initiée par une opération de copie PostgreSQL copy-operation. Le caractère final - NULL est automatiquement ajouté. Retourne TRUE en cas de succès, - et FALSE. + NULL est automatiquement ajouté. Retourne <literal>TRUE</literal> en cas de succès, + et <literal>FALSE</literal>. </para> <note> <para> @@ -1117,14 +1120,14 @@ <title>Insertion à grande vitesse dans une table</title> <programlisting role="php"> <?php - $conn = pg_pconnect ("dbname=foo"); + $conn = pg_pconnect("dbname=foo"); pg_exec($conn, "create table bar (a int4, b char(16), d float8)"); pg_exec($conn, "copy bar from stdin"); pg_put_line($conn, "3\tBonjour le monde\t4.5\n"); pg_put_line($conn, "4\tAu revoir le monde\t7.11\n"); pg_put_line($conn, "\\.\n"); pg_end_copy($conn); -?> +?> </programlisting> </example> </para> @@ -1285,7 +1288,7 @@ Par défaut, c'est la dernière ouverte. </para> <para> - Retourne TRUE si <parameter>filename</parameter> a pu être ouvert en + Retourne <literal>TRUE</literal> si <parameter>filename</parameter> a pu être ouvert en écriture, etFALSEsinon. </para> <para> @@ -1332,7 +1335,7 @@ dernière ouverte. </para> <para> - Retourne toujours TRUE. + Retourne toujours <literal>TRUE</literal>. </para> <para> Voir aussi <function>pg_trace</function>. Index: phpdoc/fr/functions/posix.xml diff -u phpdoc/fr/functions/posix.xml:1.2 phpdoc/fr/functions/posix.xml:1.3 --- phpdoc/fr/functions/posix.xml:1.2 Mon Nov 13 01:53:42 2000 +++ phpdoc/fr/functions/posix.xml Fri Jan 26 06:44:21 2001 @@ -1,20 +1,17 @@ <reference id="ref.posix"> - <title>Fonctions POSIX</title> + <title>POSIX</title> <titleabbrev>POSIX</titleabbrev> - <partintro> <para> Ce module contient une interface avec les documents au standard - IEEE 1003.1 (POSIX.1), qui ne sont pas accessibles autrement. + IEEE 1003.1 (POSIX.1), qui ne sont pas accessibles autrement. Par exemple, POSIX.1 définit les fonctions open(), read(), write() et close(), qui ont été traditionnellement - les fonctions de PHP 3. Certains fonctionnalités + les fonctions de PHP 3. Certains fonctionnalités spécifiques ne sont pas encore disponibles, bien que ce module tâche de remédier à cette situation avec ses fonctions. </para> </partintro> - - <refentry id="function.posix-kill"> <refnamediv> <refname>posix_kill</refname> @@ -30,19 +27,18 @@ </funcprototype> </funcsynopsis> <para> - <function>posix_kill</function> envoie le signal + <function>posix_kill</function> envoie le signal <parameter>sig</parameter> au processus <parameter>pid</parameter>. - Retourne FALSE, si il n'a pas pu envoyer le signal, et TRUE sinon. + Retourne <literal>FALSE</literal>, si il n'a pas pu envoyer le signal, et <literal>TRUE</literal> sinon. </para> <para> - Reportez vous à la page de manuel de kill(2) de votre - système POSIX, qui contient plus de détails sur + Reportez vous à la page de manuel de kill(2) de votre + système POSIX, qui contient plus de détails sur les identifiants négatifs de processus, les pid spéciaux 0 et -1, et le signal numéro 0. </para> </refsect1> </refentry> - <refentry id="function.posix-getpid"> <refnamediv> <refname>posix_getpid</refname> @@ -61,7 +57,6 @@ </para> </refsect1> </refentry> - <refentry id="function.posix-getppid"> <refnamediv> <refname>posix_getppid</refname> @@ -78,7 +73,6 @@ </para> </refsect1> </refentry> - <refentry id="function.posix-getuid"> <refnamediv> <refname>posix_getuid</refname> @@ -95,13 +89,12 @@ </funcprototype> </funcsynopsis> <para> - Retourne l'ID numérique de l'utilisateur du processus courant. - Reportez vous à <function>posix_getpwuid</function> pour + Retourne l'ID numérique de l'utilisateur du processus courant. + Reportez vous à <function>posix_getpwuid</function> pour accéder au nom d'utilisateur. </para> </refsect1> </refentry> - <refentry id="function.posix-geteuid"> <refnamediv> <refname>posix_geteuid</refname> @@ -119,12 +112,11 @@ </funcsynopsis> <para> Retourne l'UID effectif de l'utilisateur du processus courant. - Reportez vous à <function>posix_getpwuid</function> pour + Reportez vous à <function>posix_getpwuid</function> pour obtenir le nom d'utilisateur. </para> </refsect1> </refentry> - <refentry id="function.posix-getgid"> <refnamediv> <refname>posix_getgid</refname> @@ -141,12 +133,11 @@ </funcprototype> </funcsynopsis> <para> - Retourne l'UID du groupe du processus courant. Reportez vous à + Retourne l'UID du groupe du processus courant. Reportez vous à <function>posix_getgrgid</function> pour accéder au nom du groupe. </para> </refsect1> </refentry> - <refentry id="function.posix-getegid"> <refnamediv> <refname>posix_getegid</refname> @@ -163,16 +154,15 @@ </funcprototype> </funcsynopsis> <para> - Retourne l'ID effectif du groupe du processus courant. Reportez vous à - <function>posix_getgrgid</function> pour transformer cette information en nom + Retourne l'ID effectif du groupe du processus courant. Reportez vous à + <function>posix_getgrgid</function> pour transformer cette information en nom de groupe. </para> </refsect1> </refentry> - <refentry id="function.posix-setuid"> <refnamediv> - <refname>posix_setuid</refname> + <refname>posix_setuid</refname> <refpurpose> Fixe l'UID effective du processus courant. </refpurpose> @@ -186,20 +176,19 @@ </funcprototype> </funcsynopsis> <para> - Fixe l'UID effective de l'utilisateur du processus courant. Vous devez + Fixe l'UID effective de l'utilisateur du processus courant. Vous devez avoir les privilèges nécessaires (traditionnellement ceux du root) sur votre système pour faire ceci. </para> <para> - Retourne TRUE en cas de succès, FALSE sinon. + Retourne <literal>TRUE</literal> en cas de succès, <literal>FALSE</literal> sinon. Voir aussi <function>posix_setgid</function>. </para> </refsect1> </refentry> - <refentry id="function.posix-setgid"> <refnamediv> - <refname>posix_setgid</refname> + <refname>posix_setgid</refname> <refpurpose> Fixe le GID effective du processus courant. </refpurpose> @@ -213,17 +202,16 @@ </funcprototype> </funcsynopsis> <para> - Fixe le GID effective du processus courant. - Reportez vous à <function>posix_getgrgid</function> pour transformer - cette information en nom de groupe. L'ordre approprié est d'abord + Fixe le GID effective du processus courant. + Reportez vous à <function>posix_getgrgid</function> pour transformer + cette information en nom de groupe. L'ordre approprié est d'abord <function>posix_setgid</function>, puis <function>posix_setuid</function>. </para> <para> - Retourne TRUE en cas de succès, FALSE sinon. + Retourne <literal>TRUE</literal> en cas de succès, <literal>FALSE</literal> sinon. </para> </refsect1> </refentry> - <refentry id="function.posix-getgroups"> <refnamediv> <refname>posix_getgroups</refname> @@ -240,13 +228,12 @@ </funcprototype> </funcsynopsis> <para> - Retourne un tableau contenant les identifiants du groupe du - processus courant. Reportez vous à + Retourne un tableau contenant les identifiants du groupe du + processus courant. Reportez vous à <function>posix_getgrgid</function> pour pouvoir utiliser ces id. </para> </refsect1> </refentry> - <refentry id="function.posix-getlogin"> <refnamediv> <refname>posix_getlogin</refname> @@ -261,13 +248,12 @@ </funcprototype> </funcsynopsis> <para> - Retourne le nom de login de l'utilisateur qui possède le processus - courant. Reportez vous à <function>posix_getpwnam</function> pour + Retourne le nom de login de l'utilisateur qui possède le processus + courant. Reportez vous à <function>posix_getpwnam</function> pour obtenir plus d'informations sur cet utilisateur. </para> </refsect1> </refentry> - <refentry id="function.posix-getpgrp"> <refnamediv> <refname>posix_getpgrp</refname> @@ -284,14 +270,13 @@ </funcprototype> </funcsynopsis> <para> - Retourne l'identifiant du groupe de processus du processus courant. - Reportez vous à POSIX.1 et à getpgrp(2) dans le manuel + Retourne l'identifiant du groupe de processus du processus courant. + Reportez vous à POSIX.1 et à getpgrp(2) dans le manuel de votre système POSIX pour plus d'informations sur les groupes de processus. </para> </refsect1> </refentry> - <refentry id="function.posix-setsid"> <refnamediv> <refname>posix_setsid</refname> @@ -306,14 +291,13 @@ </funcprototype> </funcsynopsis> <para> - Fait du processus courant un chef de session. Reportez vous à - POSIX.1 et setsid(2) dans le manuel de votre système POSIX - pour plus d'informations sur le contrôle de tâche. Retourne + Fait du processus courant un chef de session. Reportez vous à + POSIX.1 et setsid(2) dans le manuel de votre système POSIX + pour plus d'informations sur le contrôle de tâche. Retourne un identifiant de session. </para> </refsect1> </refentry> - <refentry id="function.posix-setpgid"> <refnamediv> <refname>posix_setpgid</refname> @@ -329,15 +313,14 @@ </funcprototype> </funcsynopsis> <para> - <function>posix_setpgid</function> ajoute le processus - <parameter>pid</parameter> au groupe d'id <parameter>pgid</parameter>. - Reportez vous à POSIX.1 et setsid(2) dans le manuel de votre - système POSIX pour plus d'informations sur le contrôle - de tâche. Retourne TRUE en cas de succès, et FALSE sinon. + <function>posix_setpgid</function> ajoute le processus + <parameter>pid</parameter> au groupe d'id <parameter>pgid</parameter>. + Reportez vous à POSIX.1 et setsid(2) dans le manuel de votre + système POSIX pour plus d'informations sur le contrôle + de tâche. Retourne <literal>TRUE</literal> en cas de succès, et <literal>FALSE</literal> sinon. </para> </refsect1> </refentry> - <refentry id="function.posix-getpgid"> <refnamediv> <refname>posix_getpgid</refname> @@ -352,16 +335,15 @@ </funcprototype> </funcsynopsis> <para> - Retourne l'id du groupe de processus pour le processus + Retourne l'id du groupe de processus pour le processus <parameter>pid</parameter>.</para> <para> - Ceci n'est pas une fonction POSIX, mais elle est répandu sur - les systèmes BSD et System V. Si votre système ne - supporte pas cette fonction, la fonction PHP retournera toujours FALSE. + Ceci n'est pas une fonction POSIX, mais elle est répandu sur + les systèmes BSD et System V. Si votre système ne + supporte pas cette fonction, la fonction PHP retournera toujours <literal>FALSE</literal>. </para> </refsect1> </refentry> - <refentry id="function.posix-getsid"> <refnamediv> <refname>posix_getsid</refname> @@ -377,17 +359,16 @@ </funcsynopsis> <para> Retourne le sid du processus <parameter>pid</parameter>. - Si <parameter>pid</parameter> est à 0, le sid retourné + Si <parameter>pid</parameter> est à 0, le sid retourné sera celui du processus courant. </para> <para> - Ceci n'est pas une fonction POSIX, mais elle est répandu sur - les systèmes BSD et System V. Si votre système ne - supporte pas cette fonction, la fonction PHP retournera toujours FALSE. + Ceci n'est pas une fonction POSIX, mais elle est répandu sur + les systèmes BSD et System V. Si votre système ne + supporte pas cette fonction, la fonction PHP retournera toujours <literal>FALSE</literal>. </para> </refsect1> </refentry> - <refentry id="function.posix-uname"> <refnamediv> <refname>posix_uname</refname> @@ -402,8 +383,8 @@ </funcprototype> </funcsynopsis> <para> - Retourne un tableau associatif avec des informations sur le système. Les - indices du tableau sont : + Retourne un tableau associatif avec des informations sur le système. Les + indices du tableau sont : <itemizedlist> <listitem><simpara> sysname - nom du système d'exploitation (e.g. Linux) @@ -421,16 +402,16 @@ <listitem><simpara> machine - architecture système (e.g. i586) </simpara></listitem> - </itemizedlist></para> + </itemizedlist> + </para> <para> - Posix impose que vous n'ayez pas d'a priori sur le format des - chaînes, c'est à dire que vous ne devez pas vous - attendre à avoir forcément 3 chiffres pour la version, + Posix impose que vous n'ayez pas d'a priori sur le format des + chaînes, c'est à dire que vous ne devez pas vous + attendre à avoir forcément 3 chiffres pour la version, par exemple. </para> </refsect1> </refentry> - <refentry id="function.posix-times"> <refnamediv> <refname>posix_times</refname> @@ -446,7 +427,7 @@ </funcsynopsis> <para> Retourne un tableau avec les informations sur l'utilisation du CPU. - Les indices sont : + Les indices sont : <itemizedlist> <listitem><simpara> ticks - nombre de ticks depuis le dernier démarrage @@ -458,17 +439,17 @@ stime - temps système utilisé par le processus courant. </simpara></listitem> <listitem><simpara> - cutime - temps utilisateur utilisé par le processus courant et + cutime - temps utilisateur utilisé par le processus courant et ses enfants. </simpara></listitem> <listitem><simpara> - cstime - temps système utilisé par le processus courant + cstime - temps système utilisé par le processus courant et ses enfants. </simpara></listitem> - </itemizedlist></para> + </itemizedlist> + </para> </refsect1> </refentry> - <refentry id="function.posix-ctermid"> <refnamediv> <refname>posix_ctermid</refname> @@ -486,7 +467,6 @@ Encore à faire.</para> </refsect1> </refentry> - <refentry id="function.posix-ttyname"> <refnamediv> <refname>posix_ttyname</refname> @@ -504,7 +484,6 @@ Encore à faire.</para> </refsect1> </refentry> - <refentry id="function.posix-isatty"> <refnamediv> <refname>posix_isatty</refname> @@ -524,7 +503,6 @@ Encore à faire.</para> </refsect1> </refentry> - <refentry id="function.posix-getcwd"> <refnamediv> <refname>posix_getcwd</refname> @@ -542,7 +520,6 @@ Encore à faire très rapidement.</para> </refsect1> </refentry> - <refentry id="function.posix-mkfifo"> <refnamediv> <refname>posix_mkfifo</refname> @@ -563,7 +540,6 @@ Encore à faire très rapidement.</para> </refsect1> </refentry> - <refentry id="function.posix-getgrnam"> <refnamediv> <refname>posix_getgrnam</refname> @@ -581,7 +557,6 @@ Encore à faire.</para> </refsect1> </refentry> - <refentry id="function.posix-getgrgid"> <refnamediv> <refname>posix_getgrgid</refname> @@ -599,7 +574,6 @@ Encore à faire.</para> </refsect1> </refentry> - <refentry id="function.posix-getpwnam"> <refnamediv> <refname>posix_getpwnam</refname> @@ -614,12 +588,12 @@ </funcprototype> </funcsynopsis> <para> - Retourne un tableau associatif qui contient des informations à - propos d'un utilisateur, identifié par son nom, passé + Retourne un tableau associatif qui contient des informations à + propos d'un utilisateur, identifié par son nom, passé en paramètre <parameter>username</parameter>. </para> <para> - Les éléments du tableau sont : + Les éléments du tableau sont : <table> <title>Le tableau descriptif d'un utilisateur</title> <tgroup cols="2"> @@ -634,7 +608,7 @@ <entry>name</entry> <entry> Le nom contient le nom de l'utilisateur. Généralement, - c'est un nom court, de moins de 16 caractères, mais ce n'est + c'est un nom court, de moins de 16 caractères, mais ce n'est pas son nom réel et complet. Cette valeur devrait correspondre au paramètre <parameter>username</parameter>, et donc, il est redondant. @@ -643,9 +617,9 @@ <row> <entry>passwd</entry> <entry> - Contient le mot de passe de l'utilisateur, encrypté. - Souvent, dans les systèmes utilisant les mots de passe - "fantômes", un astérisque est retourné. + Contient le mot de passe de l'utilisateur, encrypté. + Souvent, dans les systèmes utilisant les mots de passe + "fantômes", un astérisque est retourné. </entry> </row> <row> @@ -657,8 +631,8 @@ <row> <entry>gid</entry> <entry> - L'ID du groupe de l'utilisateur. Utilisez la fonction - <function>posix_getgrgid</function> pour connaitre le nom du groupe, + L'ID du groupe de l'utilisateur. Utilisez la fonction + <function>posix_getgrgid</function> pour connaitre le nom du groupe, et ses membres. </entry> </row> @@ -666,21 +640,21 @@ <entry>gecos</entry> <entry> GECOS est un terme obsolète qui fait référence - aux données de finger, sur un système Honeywell. Le - champs, cependant, a survécu, et son contenu a - été formalisé par POSIX. Le champs - contient une liste, séparée par des virgules, qui - contient le nom complet de l'utilisateur, son - téléphone professionnel, son numéro de - téléphone bureau, et son numéro de - téléphone personnel. Sur la plus part des + aux données de finger, sur un système Honeywell. Le + champs, cependant, a survécu, et son contenu a + été formalisé par POSIX. Le champs + contient une liste, séparée par des virgules, qui + contient le nom complet de l'utilisateur, son + téléphone professionnel, son numéro de + téléphone bureau, et son numéro de + téléphone personnel. Sur la plus part des sytèmes, seul le nom est disponible. </entry> </row> <row> <entry>dir</entry> <entry> - Cet élément contient le chemin absolu jusqu'au + Cet élément contient le chemin absolu jusqu'au dossier racine de l'utilisateur. </entry> </row> @@ -694,10 +668,9 @@ </tbody> </tgroup> </table> - </para> + </para> </refsect1> </refentry> - <refentry id="function.posix-getpwuid"> <refnamediv> <refname>posix_getpwuid</refname> @@ -712,12 +685,12 @@ </funcprototype> </funcsynopsis> <para> - Retourne un tableau associatif contenant des informations - sur un utilisateur repéré par son UID, + Retourne un tableau associatif contenant des informations + sur un utilisateur repéré par son UID, passé dans le paramètre <parameter>uid</parameter>. </para> <para> - Les éléments du tableau sont : + Les éléments du tableau sont : <table> <title>Le tableau de description d'un utilisateur</title> <tgroup cols="2"> @@ -732,29 +705,29 @@ <entry>name</entry> <entry> Le nom contient le nom de l'utilisateur. Généralement, - c'est un nom court, de moins de 16 caractères, mais ce - n'est pas son nom réel et complet. + c'est un nom court, de moins de 16 caractères, mais ce + n'est pas son nom réel et complet. </entry> </row> <row> <entry>passwd</entry> <entry> Contient le mot de passe de l'utilisateur, encrypté. Souvent, - dans les systèmes utilisant les mots de passes + dans les systèmes utilisant les mots de passes "fantômes", un astérisque est retourné. </entry> </row> <row> <entry>uid</entry> <entry> - Cette valeur devrait correspondre au paramètre + Cette valeur devrait correspondre au paramètre <parameter>uid</parameter>, et donc, il est redondant. </entry> </row> <row> <entry>gid</entry> <entry> - L'ID du groupe de l'utilisateur. Utilisez la fonction + L'ID du groupe de l'utilisateur. Utilisez la fonction <function>posix_getgrgid</function> pour connaître le nom du groupe, et ses membres. </entry> @@ -762,30 +735,30 @@ <row> <entry>gecos</entry> <entry> - GECOS est un terme obsolète qui fait - référence aux données de finger, - sur un système Honeywell. Le champs, cependant, - a survécu, et son contenu a été - formalisé par POSIX. Le champs contient une liste, - séparée par des virgules, qui contient le nom - complet de l'utilisateur, son téléphone - professionne, son numéro de bureau, et son numéro - de téléphone personnel. + GECOS est un terme obsolète qui fait + référence aux données de finger, + sur un système Honeywell. Le champs, cependant, + a survécu, et son contenu a été + formalisé par POSIX. Le champs contient une liste, + séparée par des virgules, qui contient le nom + complet de l'utilisateur, son téléphone + professionne, son numéro de bureau, et son numéro + de téléphone personnel. Sur la plus part des sytèmes, seul le nom est disponible. </entry> </row> <row> <entry>dir</entry> <entry> - Cet élément contient le chemin absolu jusqu'au + Cet élément contient le chemin absolu jusqu'au dossier racine de l'utilisateur. </entry> </row> <row> <entry>shell</entry> <entry> - Cet élément contient le chemin absolu - jusqu'au dossier d'éxécution du shell + Cet élément contient le chemin absolu + jusqu'au dossier d'éxécution du shell de l'utilisateur. </entry> </row> @@ -795,7 +768,6 @@ </para> </refsect1> </refentry> - <refentry id="function.posix-getrlimit"> <refnamediv> <refname>posix_getrlimit</refname> @@ -813,9 +785,7 @@ Encore à faire rapidement.</para> </refsect1> </refentry> - </reference> - <!-- Keep this comment at the end of the file Local variables: mode: sgml Index: phpdoc/fr/functions/pspell.xml diff -u phpdoc/fr/functions/pspell.xml:1.4 phpdoc/fr/functions/pspell.xml:1.5 --- phpdoc/fr/functions/pspell.xml:1.4 Fri Dec 8 02:05:36 2000 +++ phpdoc/fr/functions/pspell.xml Fri Jan 26 06:44:21 2001 @@ -42,11 +42,13 @@ <example> <title>Exemple avec <function>pspell_add_to_personal</function></title> <programlisting role="php"> +<?php $pspell_config = pspell_config_create ("en"); pspell_config_personal ($pspell_config, "/var/dictionaries/custom.pws"); $pspell_link = pspell_new_config ($pspell_config); pspell_add_to_personal ($pspell_link, "Vlad"); pspell_save_wordlist ($pspell_link); +?> </programlisting> </example> </para> @@ -90,18 +92,20 @@ </funcsynopsis> <simpara> <function>pspell_check</function> vérifie l'orthographe d'un mot - et retourne TRUE si l'orthographe est correcte, FALSE sinon. + et retourne <literal>TRUE</literal> si l'orthographe est correcte, <literal>FALSE</literal> sinon. </simpara> <para> <example> <title><function>pspell_check</function></title> <programlisting role="php"> +<?php $pspell_link = pspell_new ("french"); if (pspell_check ($pspell_link, "testt")) { echo "L'orthographe est exacte"; } else { echo "Désolé, mauvaise orthographe"; } +?> </programlisting> </example> </para> @@ -130,12 +134,14 @@ <example> <title>Exemple avec <function>pspell_add_to_personal</function></title> <programlisting role="php"> +<?php $pspell_config = pspell_config_create ("en"); pspell_config_personal ($pspell_config, "/var/dictionaries/custom.pws"); $pspell_link = pspell_new_config ($pspell_config); pspell_add_to_personal ($pspell_link, "Vlad"); pspell_clear_session ($pspell_link); pspell_save_wordlist ($pspell_link); //"Vlad" ne sera pas sauvé +?> </programlisting> </example> </para> @@ -234,10 +240,12 @@ <example> <title>Exemple avec <function>pspell_config_create</function></title> <programlisting role="php"> +<?php $pspell_config = pspell_config_create ("en"); pspell_config_personal ($pspell_config, "/var/dictionaries/custom.pws"); pspell_config_repl ($pspell_config, "/var/dictionaries/custom.repl"); $pspell_link = pspell_new_personal (pspell_config); +?> </programlisting> </example> </para> @@ -266,10 +274,12 @@ <example> <title>Exemple avec <function>pspell_config_ignore</function></title> <programlisting role="php"> +<?php $pspell_config = pspell_config_create ("en"); pspell_config_ignore($pspell_config, 5); $pspell_link = pspell_new_config($pspell_config); pspell_check($pspell_link, "abcd"); // Ce mot ne provoquera pas d'erreur +?> </programlisting> </example> </para> @@ -320,10 +330,12 @@ <example> <title><function>pspell_config_mode</function></title> <programlisting role="php"> +<?php $pspell_config = pspell_config_create ("en"); pspell_config_mode($pspell_config, PSPELL_FAST); $pspell_link = pspell_new_config($pspell_config); pspell_check($pspell_link, "thecat"); +?> </programlisting> </example> </para> @@ -362,10 +374,12 @@ <example> <title>Exemple avec <function>pspell_config_personal</function></title> <programlisting role="php"> +<?php $pspell_config = pspell_config_create ("en"); pspell_config_personal ($pspell_config, "/var/dictionaries/custom.pws"); $pspell_link = pspell_new_config ($pspell_config); pspell_check ($pspell_link, "thecat"); +?> </programlisting> </example> </para> @@ -402,11 +416,13 @@ <example> <title>Exemple avec <function>pspell_config_repl</function></title> <programlisting role="php"> +<?php $pspell_config = pspell_config_create ("en"); pspell_config_personal ($pspell_config, "/var/dictionaries/custom.pws"); pspell_config_repl ($pspell_config, "/var/dictionaries/custom.repl"); $pspell_link = pspell_new_config ($pspell_config); pspell_check ($pspell_link, "thecat"); +?> </programlisting> </example> </para> @@ -443,10 +459,12 @@ <example> <title>Exemple avec <function>pspell_config_runtogether</function></title> <programlisting role="php"> +<?php $pspell_config = pspell_config_create ("en"); -pspell_config_runtogether ($pspell_config, true); +pspell_config_runtogether ($pspell_config, <literal>TRUE</literal>); $pspell_link = pspell_new_config ($pspell_config); pspell_check ($pspell_link, "thecat"); +?> </programlisting> </example> </para> @@ -580,10 +598,12 @@ <example> <title><function>pspell_new</function></title> <programlisting role="php"> -$pspell_link = pspell_new ("en", "", "", "", - (PSPELL_FAST|PSPELL_RUN_TOGETHER)); +<?php +$pspell_link = pspell_new("en", "", "", "", (PSPELL_FAST|PSPELL_RUN_TOGETHER)); +?> </programlisting> - </example> </para> + </example> + </para> </refsect1> </refentry> <refentry id="function.pspell-new-config"> @@ -618,10 +638,12 @@ <example> <title><function>pspell_new_config</function></title> <programlisting role="php"> +<?php $pspell_config = pspell_config_create ("en"); pspell_config_personal ($pspell_config, "/var/dictionaries/custom.pws"); pspell_config_repl ($pspell_config, "/var/dictionaries/custom.repl"); $pspell_link = pspell_new_personal (pspell_config); +?> </programlisting> </example> </para> @@ -737,8 +759,9 @@ <example> <title>Exemple avec <function>pspell_new_personal</function></title> <programlisting role="php"> -$pspell_link = pspell_new_personal ("/var/dictionaries/custom.pws", - "en", "", "", "", PSPELL_FAST|PSPELL_RUN_TOGETHER)); +<?php +$pspell_link = pspell_new_personal ("/var/dictionaries/custom.pws", "en", "", "", "", PSPELL_FAST|PSPELL_RUN_TOGETHER)); +?> </programlisting> </example> </para> @@ -771,11 +794,13 @@ <example> <title>Exemple <function>pspell_add_to_personal</function></title> <programlisting role="php"> +<?php $pspell_config = pspell_config_create ("en"); pspell_config_personal ($pspell_config, "/tmp/dicts/newdict"); $pspell_link = pspell_new_config ($pspell_config); pspell_add_to_personal ($pspell_link, "Vlad"); pspell_save_wordlist ($pspell_link); +?> </programlisting> </example> </para> @@ -816,12 +841,14 @@ <example> <title>Exemple avec <function>pspell_store_replacement</function></title> <programlisting role="php"> +<?php $pspell_config = pspell_config_create ("en"); pspell_config_personal ($pspell_config, "/var/dictionaries/custom.pws"); pspell_config_repl ($pspell_config, "/var/dictionaries/custom.repl"); $pspell_link = pspell_new_config ($pspell_config); pspell_store_replacement ($pspell_link, $misspelled, $correct); pspell_save_wordlist ($pspell_link); +?> </programlisting> </example> </para> @@ -849,6 +876,7 @@ <example> <title><function>pspell_suggest</function></title> <programlisting role="php"> +<?php $pspell_link = pspell_new ("english"); if (!pspell_check ($pspell_link, "testt")){ $suggestions = pspell_suggest ($pspell_link, "testt"); @@ -856,6 +884,7 @@ echo "Orthographes suggerées : " . $suggestions[$i] . "<br>"; } } +?> </programlisting> </example> </para> Index: phpdoc/fr/functions/network.xml diff -u phpdoc/fr/functions/network.xml:1.9 phpdoc/fr/functions/network.xml:1.10 --- phpdoc/fr/functions/network.xml:1.9 Wed Dec 13 05:59:15 2000 +++ phpdoc/fr/functions/network.xml Fri Jan 26 06:44:21 2001 @@ -20,8 +20,8 @@ <simpara> <function>checkdnsrr</function> recherche l'enregistrement DNS de type <parameter>type</parameter> correspondant à l'hôte - <parameter>host</parameter>. Retourne TRUE si un record a été - trouvé, et FALSE en cas d'erreur ou d'échec. + <parameter>host</parameter>. Retourne <literal>TRUE</literal> si un record a été + trouvé, et <literal>FALSE</literal> en cas d'erreur ou d'échec. </simpara> <simpara> <parameter>type</parameter> peut prendre les valeurs suivantes : @@ -172,11 +172,11 @@ <function>feof</function>. </para> <para> - Si l'appel échoue, <function>fsockopen</function> retourne FALSE, + Si l'appel échoue, <function>fsockopen</function> retourne <literal>FALSE</literal>, et si les options <parameter>errno</parameter> et <parameter>errstr</parameter> ont été fournies, elles contiennent désormais les raisons de l'échec. Si l'erreur retournée est 0 et que la - fonction retourne FALSE, c'est une indication d'erreur. C'est probablement + fonction retourne <literal>FALSE</literal>, c'est une indication d'erreur. C'est probablement du à une erreur d'initialisation de la socket. Notez que <parameter>errno</parameter> et <parameter>errstr</parameter> sont passées par référence. @@ -190,8 +190,9 @@ changer de mode en utilisant : <function>socket_set_blocking</function>. <example> <title>Exemple avec <function>fsockopen</function></title> - <programlisting> -$fp = fsockopen("www.php.net", 80, &$errno, &$errstr, 30); + <programlisting role="php"> +<?php +$fp = fsockopen("www.php.net", 80, &$errno, &$errstr, 30); if(!$fp) { echo "$errstr ($errno)<br>\n"; } else { @@ -201,6 +202,7 @@ } fclose($fp); } +?> </programlisting> </example> L'exemple ci-dessous décrit comment lire la date et l'heure grâce à @@ -329,8 +331,8 @@ <simpara> <function>getmxrr</function> effectue une recherche DNS pour obtenir les enregistrements MX de l'hôte <parameter>hostname</parameter>. - Retourne TRUE si des enregistrements sont trouvés, et - FALSE si une erreur est rencontrée, ou si la recherche + Retourne <literal>TRUE</literal> si des enregistrements sont trouvés, et + <literal>FALSE</literal> si une erreur est rencontrée, ou si la recherche échoue. </simpara> <simpara> @@ -457,7 +459,7 @@ <refnamediv> <refname>ip2long</refname> <refpurpose> - Converti une chaîne contenant une adresse (IPv4) + Convertit une chaîne contenant une adresse (IPv4) IP numérique en adresse litérale. </refpurpose> </refnamediv> @@ -478,7 +480,7 @@ <?php $ip = gethostbyname("www.php.net"); $out = "Les URLS suivantes sont équivalentes :<br>\n"; -$out .= "http://www.php.net/, http://".$ip."/, and http://".ip2long($ip)."/<br>\n"; +$out .= "http://www.php.net/, http://".$ip."/, et http://".ip2long($ip)."/<br>\n"; echo $out; ?> </programlisting> @@ -493,7 +495,7 @@ <refnamediv> <refname>long2ip</refname> <refpurpose> - Converti une adresse IP (IPv4) en adresse IP numérique + Convertit une adresse IP (IPv4) en adresse IP numérique </refpurpose> </refnamediv> <refsect1> @@ -724,14 +726,14 @@ <itemizedlist> <listitem> <para> - <parameter>timed_out</parameter> (bool) - La socket a expirée en + <parameter>timed_out</parameter> (bool) - La socket a éxpirée en attendant des données </para> </listitem> <listitem> <para> - <parameter>blocked</parameter> (bool) - La socket a - été bloquée + <parameter>blocked</parameter> (bool) - La socket a été + bloquée </para> </listitem> <listitem> @@ -748,19 +750,16 @@ </listitem> </itemizedlist> <para> - Voir aussi - <function>accept_connect</function>, - <function>bind</function>, - <function>connect</function>, - <function>listen</function>, et - <function>strerror</function>. + Voir aussi <function>accept_connect</function>, + <function>bind</function>, <function>connect</function>, + <function>listen</function> et <function>strerror</function>. </para> </refsect1> </refentry> <refentry id="function.socket-set-blocking"> <refnamediv> <refname>socket_set_blocking</refname> - <refpurpose>Active/desactive le mode bloquant d'une socket.</refpurpose> + <refpurpose>Active/désactive le mode bloquant d'une socket.</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -772,13 +771,13 @@ </funcprototype> </funcsynopsis> <para> - Si <parameter>mode</parameter> est FALSE, la socket est mise en - mode non bloquant, et si il est TRUE, la socket est mise en mode + Si <parameter>mode</parameter> est <literal>FALSE</literal>, la socket est mise en + mode non bloquant, et si il est <literal>TRUE</literal>, la socket est mise en mode bloquant. Cela affecte des appels tels que <function>fgets</function> qui lisent depuis une socket. En mode non bloquant, un appel <function>fgets</function> retournera immediatement toujours - TRUE tandis qu'en mode bloquant, elle va attendre que des - données arrivent pour répondre TRUE. + <literal>TRUE</literal> tandis qu'en mode bloquant, elle va attendre que des + données arrivent pour répondre <literal>TRUE</literal>. </para> </refsect1> </refentry>