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 [EMAIL PROTECTED] (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 [EMAIL PROTECTED] (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 [EMAIL PROTECTED] (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>
