dams Tue Jan 23 02:48:27 2001 EDT
Modified files:
/phpdoc/fr/functions recode.xml regex.xml satellite.xml sem.xml
sesam.xml session.xml strings.xml zlib.xml
readline.xml
Log:
=> to =>
Updating translation
Going on with function's update (3/5)
Index: phpdoc/fr/functions/recode.xml
diff -u phpdoc/fr/functions/recode.xml:1.4 phpdoc/fr/functions/recode.xml:1.5
--- phpdoc/fr/functions/recode.xml:1.4 Wed Nov 29 05:32:54 2000
+++ phpdoc/fr/functions/recode.xml Tue Jan 23 02:48:27 2001
@@ -1,5 +1,5 @@
<reference id="ref.recode">
- <title>Fonction GNU Recode</title>
+ <title>Recode (GNU)</title>
<titleabbrev>GNU Recode</titleabbrev>
<partintro>
<para>
@@ -35,8 +35,8 @@
</funcsynopsis>
<para>
Recode la chaîne <parameter>string</parameter> en fonction de la
- requête <parameter>request</parameter>. Retourne FALSE, en cas
- d'échec, et TRUE sinon.
+ requête <parameter>request</parameter>. Retourne <literal>FALSE</literal>,
+en cas
+ d'échec, et <literal>TRUE</literal> sinon.
</para>
<para>
Une requête simple de recodage peut être "lat1..iso646-de".
@@ -96,7 +96,7 @@
<parameter>input</parameter> dans le fichier identifié par
<parameter>output</parameter> en fonction de la requête de
recodage <parameter>request</parameter>.
- Retourne FALSE, en cas d'échec, et TRUE sinon.</para>
+ Retourne <literal>FALSE</literal>, en cas d'échec, et
+<literal>TRUE</literal> sinon.</para>
<para>
<function>recode_file</function> ne gère pas encore les fichiers
distants (URLs). Les deux fichiers doivent faire référence
@@ -106,9 +106,11 @@
<example>
<title>Exemple simple avec <function>recode_file</function></title>
<programlisting role="php">
-$input = fopen ('input.txt', 'r');
-$output = fopen ('output.txt', 'w');
-recode_file ("us..flat", $input, $output);
+<?php
+$input = fopen('input.txt', 'r');
+$output = fopen('output.txt', 'w');
+recode_file("us..flat", $input, $output);
+?>
</programlisting>
</example>
</para>
Index: phpdoc/fr/functions/regex.xml
diff -u phpdoc/fr/functions/regex.xml:1.3 phpdoc/fr/functions/regex.xml:1.4
--- phpdoc/fr/functions/regex.xml:1.3 Thu Dec 28 00:47:48 2000
+++ phpdoc/fr/functions/regex.xml Tue Jan 23 02:48:27 2001
@@ -36,18 +36,19 @@
<para>
<example>
<title>Expressions régulières</title>
- <programlisting>
+ <programlisting role="php">
+<?php
ereg("abc",$string);
-/* Retourne TRUE si "abc"
+/* Retourne <literal>TRUE</literal> si "abc"
est trouvé quelque part dans la chaîne $string. */
ereg("^abc",$string);
-/* Retourne TRUE si "abc"
+/* Retourne <literal>TRUE</literal> si "abc"
est trouvé au début de la chaîne $string. */
ereg("abc$",$string);
-/* Retourne TRUE si "abc"
+/* Retourne <literal>TRUE</literal> si "abc"
est trouvé à la fin de la chaîne $string. */
eregi("(ozilla.[23]|MSIE.3)",$HTTP_USER_AGENT);
-/* Retourne TRUE si le client
+/* Retourne <literal>TRUE</literal> si le client
est Netscape 2, 3 ou MSIE 3. */
ereg("([[:alnum:]]+) ([[:alnum:]]+) ([[:alnum:]]+)",
$string,$regs);
@@ -59,6 +60,7 @@
/* Insère une balise <BR> à la fin de la chaîne $string. */
$string = ereg_replace("\n","",$string);
/* Supprime toutes les nouvelles lignes de $string. */
+?>
</programlisting>
</example>
</para>
@@ -111,8 +113,8 @@
La recherche est sensible à la casse.
</para>
<para>
- <function>ereg</function> retourne TRUE si une occurence a été
- trouvée dans la chaîne, et FALSE dans le cas contraire, ou si
+ <function>ereg</function> retourne <literal>TRUE</literal> si une occurence a
+été
+ trouvée dans la chaîne, et <literal>FALSE</literal> dans le cas
+contraire, ou si
une erreur est survenue.
</para>
<para>
@@ -120,12 +122,14 @@
la forme DD.MM.YYYY :
<example>
<title>Exemple <function>ereg</function></title>
- <programlisting>
+ <programlisting role="php">
+<?php
if ( ereg( "([0-9]{4})-([0-9]{1,2})-([0-9]{1,2})", $date, $regs ) ) {
echo "$regs[3].$regs[2].$regs[1]";
} else {
echo "Format de date invalide : $date";
}
+?>
</programlisting>
</example>
</para>
@@ -175,18 +179,20 @@
ouvrante.
</para>
<para>
- Si aucune occurrence n'est trouvée, la chaîne
+ Si aucune occurrence n'est trouvée, la chaîne
<parameter>string</parameter> sera retournée intacte.
</para>
<para>
Par exemple, le code suivant affiche "Ceci est un test" trois fois :
<example>
<title>Exemple avec <function>ereg_replace</function></title>
- <programlisting>
+ <programlisting role="php">
+<?php
$string = "Ceci est un test";
echo ereg_replace( " est", " etait", $string );
echo ereg_replace( "( )est ", "\\1etait", $string );
echo ereg_replace( "(( )est)", "\\2etait", $string );
+?>
</programlisting>
</example>
</para>
@@ -198,7 +204,7 @@
comme la valeur ordinale d'un caractère, et l'utiliser. Par exemple :
<example>
<title>Exemple avec <function>ereg_replace</function></title>
- <programlisting>
+ <programlisting role="php">
<?php
/* Cet exemple ne fonctionne pas comme voulu. */
$num = 4;
@@ -210,7 +216,8 @@
$string = "Cette chaîne a quatre mots.";
$string = ereg_replace('quatre', $num, $string);
echo $string; /* Affichage : 'Cette chaîne a 4 mots.' */
-?> </programlisting>
+?>
+ </programlisting>
</example>
</para>
<para>
@@ -253,7 +260,7 @@
<refnamediv>
<refname>eregi_replace</refname>
<refpurpose>
- Remplacement par expression régulière insensible à
+ Remplacement par expression régulière insensible à
la casse.
</refpurpose>
</refnamediv>
@@ -282,7 +289,7 @@
<refnamediv>
<refname>split</refname>
<refpurpose>
- Scinde une chaîne en un tableau, grâce à une
+ Scinde une chaîne en un tableau, grâce à une
expression régulière.
</refpurpose>
</refnamediv>
@@ -299,15 +306,17 @@
une sous-chaîne de <parameter>string</parameter>
délimitée par les occurrences trouvées de
l'expression régulière <parameter>pattern</parameter>.
- Si une erreur survient, retourne FALSE.
+ Si une erreur survient, retourne <literal>FALSE</literal>.
</para>
<para>
Pour lire les 5 premiers champs d'une ligne du fichier
<filename>/etc/passwd</filename>:
<example>
<title>Exemple avec <function>split</function></title>
- <programlisting>
+ <programlisting role="php">
+<?php
$passwd_list = split( ":", $passwd_line, 5 );
+?>
</programlisting>
</example>
</para>
@@ -316,10 +325,13 @@
des points ou des tirets :
<example>
<title>Exemple avec <function>split</function></title>
- <programlisting>
-$date = "04/30/1973"; // Les délimiteurs peuvent être des /, des points
ou des tirets
+ <programlisting role="php">
+<?php
+$date = "04/30/1973";
+// Les délimiteurs peuvent être des /, des points ou des tirets
list( $month, $day, $year ) = split( '[/.-]', $date );
echo "Mois: $month; Jour: $day; Annee: $year<br>\n";
+?>
</programlisting>
</example>
</para>
@@ -353,7 +365,7 @@
<refnamediv>
<refname>spliti</refname>
<refpurpose>
- Scinde une chaîne en un tableau, grâce à une
+ Scinde une chaîne en un tableau, grâce à une
expression régulière.
</refpurpose>
</refnamediv>
@@ -375,7 +387,7 @@
</para>
<para>
Voir aussi : <function>split</function>,
- <function>explode</function>, and <function>implode</function>.
+ <function>explode</function>, et <function>implode</function>.
</para>
</refsect1>
</refentry>
@@ -383,7 +395,7 @@
<refnamediv>
<refname>sql_regcase</refname>
<refpurpose>
- Prépare une expression régulière pour effectuer
+ Prépare une expression régulière pour effectuer
une recherche insensible à la casse.
</refpurpose>
</refnamediv>
@@ -405,10 +417,13 @@
caractère original.
<example>
<title>Exemple avec <function>sql_regcase</function></title>
- <programlisting>
+ <programlisting role="php">
+<?php
echo sql_regcase( "Foo bar" );
-</programlisting></example>
- affichera <screen>[Ff][Oo][Oo][ ][Bb][Aa][Rr]</screen>.
+?>
+ </programlisting>
+ </example>
+ affichera <computeroutput>[Ff][Oo][Oo] [Bb][Aa][Rr]</computeroutput>.
</para>
<para>
Cette expression sert à effectuer des recherches
Index: phpdoc/fr/functions/satellite.xml
diff -u phpdoc/fr/functions/satellite.xml:1.1 phpdoc/fr/functions/satellite.xml:1.2
--- phpdoc/fr/functions/satellite.xml:1.1 Mon Oct 16 05:47:15 2000
+++ phpdoc/fr/functions/satellite.xml Tue Jan 23 02:48:27 2001
@@ -1,50 +1,43 @@
-<!--
-
- $Id: satellite.xml,v 1.1 2000/10/16 12:47:15 eschmid Exp $
-
- Author: David Eriksson <[EMAIL PROTECTED]>
-
+<!--
+ $Id: satellite.xml,v 1.2 2001/01/23 10:48:27 dams Exp $
+ Author: David Eriksson <[EMAIL PROTECTED]>
-->
-
<reference id="ref.satellite">
<title>Satellite CORBA client extension</title>
<titleabbrev>Satellite</titleabbrev>
-
<partintro>
<para>
- The Satellite extension is used for accessing CORBA objects. You
- will need to set the idl_directory= entry in php.ini to a path
- where you store all IDL files you use.
+ Le module Satellite sert à accéder aux objets CORBA. Vous devez
+ ajouter l'option idl_directory= entry dans <filename>php.ini</filename>:
+ c'est le chemin jusqu'aux fichiers IDL.
</para>
</partintro>
-
<refentry id="class.orbitobject">
<refnamediv>
<refname>OrbitObject</refname>
- <refpurpose>Access CORBA objects</refpurpose>
+ <refpurpose>Accède aux objets CORBA</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<funcsynopsis>
<funcprototype>
- <funcdef>new <function>OrbitObject</function></funcdef>
+ <funcdef>new <function>orbitobject</function></funcdef>
<paramdef>string <parameter>ior</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
- This class provides access to a CORBA object. The
- <parameter>ior</parameter> parameter should be a string
- containing the IOR (Interoperable Object Reference) that
- identifies the remote object.
+ <function>orbitobject</function> crée un objet qui accèdera aux
+ objets CORBA. Le paramètre <parameter>ior</parameter> doit être une
+ chaîne contenant l'IOR (Interoperable Object Reference
+(référence
+ interopérable d'objet)) qui identifie l'objet distant.
</para>
<para>
<example>
- <title>Sample IDL file</title>
- <programlisting>
-interface MyInterface {
+ <title>Fichier IDL : MonInterface</title>
+ <programlisting role="idl">
+interface MonInterface {
void SetInfo (string info);
string GetInfo();
-
attribute int value;
}
</programlisting>
@@ -52,50 +45,44 @@
</para>
<para>
<example>
- <title>PHP code for accessing MyInterface</title>
+ <title>Code PHP pour accéder à MonInterface</title>
<programlisting role="php">
<?php
$obj = new OrbitObject ($ior);
-
-$obj->SetInfo ("A 2GooD object");
-
+$obj->SetInfo ("Un Super Objet");
echo $obj->GetInfo();
-
$obj->value = 42;
-
echo $obj->value;
-?>
+?>
</programlisting>
</example>
</para>
</refsect1>
</refentry>
-
<refentry id="class.orbitenum">
<refnamediv>
<refname>OrbitEnum</refname>
- <refpurpose>Use CORBA enums</refpurpose>
+ <refpurpose>Utilise les énumérations CORBA</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<funcsynopsis>
<funcprototype>
- <funcdef>new <function>OrbitEnum</function></funcdef>
+ <funcdef>new <function>orbitenum</function></funcdef>
<paramdef>string <parameter>id</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
- This class represents the enumeration identified with the
- <parameter>id</parameter> parameter. The
- <parameter>id</parameter> can be either the name of the
- enumeration (e.g "MyEnum"), or the full repository id
- (e.g. "IDL:MyEnum:1.0").
+ <function>orbitenum</function> représente l'énumeration
+identifiée par
+ <parameter>id</parameter>. <parameter>id</parameter> peut être soit
+ le nom d'une énumération (e.g "MonEnumeration"), ou bien
+l'identifiant
+ du repository complet (e.g. "IDL:MyEnum:1.0").
</para>
<para>
<example>
- <title>Sample IDL file</title>
- <programlisting>
-enum MyEnum {
+ <title>Fichier d'exemple IDL : MonEnumeration</title>
+ <programlisting role="idl">
+enum MonEnumeration {
a,b,c,d,e
};
</programlisting>
@@ -103,142 +90,132 @@
</para>
<para>
<example>
- <title>PHP code for accessing MyEnum</title>
+ <title>Code PHP pour accéder à MonEnumeration</title>
<programlisting role="php">
<?php
-$enum = new OrbitEnum ("MyEnum");
-
-echo $enum->a; /* write 0 */
-echo $enum->c; /* write 2 */
-echo $enum->e; /* write 4 */
-?>
+$enum = new OrbitEnum ("MonEnumeration");
+echo $enum->a; /* écrit 0 */
+echo $enum->c; /* écrit 2 */
+echo $enum->e; /* écrit 4 */
+?>
</programlisting>
</example>
</para>
</refsect1>
</refentry>
-
<refentry id="class.orbitstruct">
<refnamediv>
<refname>OrbitStruct</refname>
- <refpurpose>Use CORBA structs</refpurpose>
+ <refpurpose>Utilise une structure CORBA</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<funcsynopsis>
<funcprototype>
- <funcdef>new <function>OrbitStruct</function></funcdef>
+ <funcdef>new <function>orbitstruct</function></funcdef>
<paramdef>string <parameter>id</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
- This class represents the structure identified with the
- <parameter>id</parameter> parameter. The
- <parameter>id</parameter> can be either the name of the struct
- (e.g "MyStruct"), or the full repository id
- (e.g. "IDL:MyStruct:1.0").
+ <function>orbitstruct</function> représente une structure
+identifiée
+ par le paramètre <parameter>id</parameter>. <parameter>id</parameter>
+ peut être soit le nom d'une structure (e.g "MaStructure"), ou bien
+l'identifiant
+ du repository complet (e.g. "IDL:MaStructure:1.0").
</para>
<para>
<example>
- <title>Sample IDL file</title>
- <programlisting>
-struct MyStruct {
+ <title>Fichier d'exemple IDL : MaStructure</title>
+ <programlisting role="idl">
+struct MaStructure {
short shortvalue;
string stringvalue;
};
-
-interface SomeInterface {
- void SetValues (MyStruct values);
- MyStruct GetValues();
+interface UneInterface {
+ void SetValues (MaStructure values);
+ MaStructure GetValues();
}
</programlisting>
</example>
</para>
<para>
<example>
- <title>PHP code for accessing MyStruct</title>
+ <title>Code PHP pour accéder à MaStructure</title>
<programlisting role="php">
<?php
$obj = new OrbitObject ($ior);
-
-$initial_values = new OrbitStruct ("IDL:MyStruct:1.0");
+$initial_values = new OrbitStruct ("IDL:MaStructure:1.0");
$initial_values->shortvalue = 42;
$initial_values->stringvalue = "HGTTG";
-
$obj->SetValues ($initial_values);
-
$values = $obj->GetValues();
-
echo $values->shortvalue;
echo $values->stringvalue;
-?>
+?>
</programlisting>
</example>
</para>
</refsect1>
</refentry>
-
<refentry id="function.satellite_caught_exception">
<refnamediv>
<refname>satellite_caught_exception</refname>
<refpurpose>
- See if an exception was caught from the previous function
+ Indique si une exception a été émise
</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<funcsynopsis>
<funcprototype>
- <funcdef>bool
+ <funcdef>bool
<function>satellite_caught_exception</function>
</funcdef>
<paramdef></paramdef>
</funcprototype>
</funcsynopsis>
<para>
- This function returns true if an exception has been caught.
+ <function>satellite_caught_exception</function> retourne <literal>TRUE</literal>
+ si une exception a été émise lors du dernier appel à
+une fonction
+ Orbit.
</para>
<para>
<example>
- <title>Sample IDL file</title>
- <programlisting>
-/* ++?????++ Out of Cheese Error. Redo From Start. */
-exception OutOfCheeseError {
+ <title>Fichier IDL exemple : PlusDeFromage</title>
+ <programlisting role="php">
+<?php
+/* ++?????++ Erreur PlusDeFromage. Recommence tout au début. */
+exception PlusDeFromageErreur {
int parameter;
}
-
-interface AnotherInterface {
- void AskWhy() raises (OutOfCheeseError);
+interface UneAutreInterface {
+ void AskWhy() raises (PlusDeFromage);
}
+?>
</programlisting>
</example>
</para>
<para>
<example>
- <title>PHP code for handling CORBA exceptions</title>
+ <title>Code PHP pour gérer les exceptions CORBA</title>
<programlisting role="php">
<?php
$obj = new OrbitObject ($ior);
-
$obj->AskWhy();
-
if (satellite_caught_exception()) {
- if ("IDL:OutOfCheeseError:1.0" == satellite_exception_id()) {
+ if ("IDL:PlusDeFromage:1.0" == satellite_exception_id()) {
$exception = satellite_exception_value();
echo $exception->parameter;
}
}
-?>
+?>
</programlisting>
</example>
</para>
</refsect1>
</refentry>
-
<refentry id="function.satellite_exception_id">
<refnamediv>
<refname>satellite_exception_id</refname>
- <refpurpose>Get the repository id for the latest excetpion.</refpurpose>
+ <refpurpose>Lit l'identifiant de repository de la dernière
+exception</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
@@ -249,39 +226,37 @@
</funcprototype>
</funcsynopsis>
<para>
- Return a repository id string. (E.g. "IDL:MyException:1.0".) For
- example usage see
- <function>satellite_caught_exception</function>.
+ <function>satellite_exception_id</function> retourne une chaîne
+ d'identification d'un repository. (E.g. "IDL:MyException:1.0".) Pour
+ un exemple, voyez <function>satellite_caught_exception</function>.
</para>
</refsect1>
</refentry>
-
<refentry id="function.satellite_exception_value">
<refnamediv>
<refname>satellite_exception_value</refname>
<refpurpose>
- Get the exception struct for the latest exception
+ Lit la structure de la dernière exception
</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<funcsynopsis>
<funcprototype>
- <funcdef>OrbitStruct
+ <funcdef>OrbitStruct
<function>satellite_exception_value</function>
</funcdef>
<paramdef></paramdef>
</funcprototype>
</funcsynopsis>
<para>
- Return an exception struct. For example usage see
+ <function>satellite_exception_value</function> retourne une structure
+ d'exception. Pour un exemple, voyez
<function>satellite_caught_exception</function>.
</para>
</refsect1>
</refentry>
-
</reference>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
@@ -298,4 +273,3 @@
sgml-local-ecat-files:nil
End:
-->
-
Index: phpdoc/fr/functions/sem.xml
diff -u phpdoc/fr/functions/sem.xml:1.2 phpdoc/fr/functions/sem.xml:1.3
--- phpdoc/fr/functions/sem.xml:1.2 Tue Nov 14 01:45:32 2000
+++ phpdoc/fr/functions/sem.xml Tue Jan 23 02:48:27 2001
@@ -4,42 +4,42 @@
<partintro>
<para>
Ce module fourni un système de sémaphore. Ce système
- utilise les sémaphores System V. Les sémaphores peuvent
- être utilisés pour fournir un accès exclusif
- à certaines ressources de la machine, ou pour limiter le
+ utilise les sémaphores System V. Les sémaphores peuvent
+ être utilisés pour fournir un accès exclusif
+ à certaines ressources de la machine, ou pour limiter le
nombre de processus qui utilisent en même temps une ressource.
</para>
<para>
- Ce module fournit aussi un système de mémoire
- partagée, qui utilise la mémoire partagée
- System V. Cette mémoire partagée permet
- d'accéder à des variables globales. Les
- différents démons httpd et mêmes
- d'autres programmes (tels que Perl, C, ...) permettent
- un tel échange de données global. N'oubliez
- pas que la mémoire partagée n'est pas
- protégées contre l'accès simultané.
- Il vous faudra utiliser les sémaphores pour assurer la synchronisation.
+ Ce module fournit aussi un système de mémoire
+ partagée, qui utilise la mémoire partagée
+ System V. Cette mémoire partagée permet
+ d'accéder à des variables globales. Les
+ différents démons httpd et mêmes
+ d'autres programmes (tels que Perl, C, ...) permettent
+ un tel échange de données global. N'oubliez
+ pas que la mémoire partagée n'est pas
+ protégées contre l'accès simultané.
+ Il vous faudra utiliser les sémaphores pour assurer la synchronisation.
<table>
<title>Limites de la mémoire partagée sous Unix OS</title>
<tgroup cols="2">
<tbody>
<row>
- <entry>SHMMAX</entry>
+ <entry>SHMMAX</entry>
<entry>
- Taille maximale de mémoire partagée,
+ Taille maximale de mémoire partagée,
par défaut, 131072 octets.
</entry>
</row>
<row>
<entry>SHMMIN</entry>
<entry>
- Taille minimale de mémoire partagée,
+ Taille minimale de mémoire partagée,
par défaut, 1 octet.
</entry>
</row>
<row>
- <entry>SHMMNI</entry>
+ <entry>SHMMNI</entry>
<entry>
Nombre maximal de segment de mémoire partagé,
par défaut 100.
@@ -48,16 +48,15 @@
<row>
<entry>SHMSEG</entry>
<entry>
- Taille maximale de mémoire partagée par processus,
+ Taille maximale de mémoire partagée par processus,
par défaut 6.
</entry>
</row>
</tbody>
</tgroup>
- </table></para>
-
+ </table>
+ </para>
</partintro>
-
<refentry id="function.sem-get">
<refnamediv>
<refname>sem_get</refname>
@@ -69,38 +68,38 @@
<funcprototype>
<funcdef>int <function>sem_get</function></funcdef>
<paramdef>int <parameter>key</parameter></paramdef>
- <paramdef>int
+ <paramdef>int
<parameter><optional>max_acquire</optional></parameter>
</paramdef>
- <paramdef>int
+ <paramdef>int
<parameter><optional>perm</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
- Retourne un identifiant positif de sémaphore en cas de
- succès, et FALSE en cas d'erreur.
+ Retourne un identifiant positif de sémaphore en cas de
+ succès, et <literal>FALSE</literal> en cas d'erreur.
</para>
<para>
- <function>sem_get</function> retourne un identifiant qui pourra
- être utilisé pour accéder à un
- sémaphore System V. Le sémaphore est créé,
- si nécessaire, en utilisant les bits de permission (par
- défaut, 0666). Le nombre de processus qui peuvent
- réserver simultanément le sémaphore
- est précisé dans max_acquire (par défaut
- à 1). Actuellement, cette valeur n'est affectée
- que si le processus est le seul processus actuellement
+ <function>sem_get</function> retourne un identifiant qui pourra
+ être utilisé pour accéder à un
+ sémaphore System V. Le sémaphore est créé,
+ si nécessaire, en utilisant les bits de permission (par
+ défaut, 0666). Le nombre de processus qui peuvent
+ réserver simultanément le sémaphore
+ est précisé dans max_acquire (par défaut
+ à 1). Actuellement, cette valeur n'est affectée
+ que si le processus est le seul processus actuellement
attaché au sémaphore.
</para>
<para>
- Un deuxième appel à <function>sem_get</function>
- avec la même clé retournera un identifiant
- différent, mais les deux identifiants permettront
+ Un deuxième appel à <function>sem_get</function>
+ avec la même clé retournera un identifiant
+ différent, mais les deux identifiants permettront
d'accéder au même sémaphore.
- </para>
- <para>
- Voir aussi : <function>sem_acquire</function> et
+ </para>
+ <para>
+ Voir aussi : <function>sem_acquire</function> et
<function>sem_release</function>.
</para>
<note>
@@ -110,7 +109,6 @@
</note>
</refsect1>
</refentry>
-
<refentry id="function.sem-acquire">
<refnamediv>
<refname>sem_acquire</refname>
@@ -125,27 +123,26 @@
</funcprototype>
</funcsynopsis>
<para>
- Retourne TRUE en cas de succès, et FALSE sinon.
+ Retourne <literal>TRUE</literal> en cas de succès, et
+<literal>FALSE</literal> sinon.
</para>
<para>
- <function>sem_acquire</function> se bloque (si nécessaire)
- jusqu'à ce que le sémaphore puisse être
- réservé. Un processus qui tente de réserver
- un sémaphore qu'il a déjà reservé
- restera en attente indéfinie, si cette acquisition excède
+ <function>sem_acquire</function> se bloque (si nécessaire)
+ jusqu'à ce que le sémaphore puisse être
+ réservé. Un processus qui tente de réserver
+ un sémaphore qu'il a déjà reservé
+ restera en attente indéfinie, si cette acquisition excède
le nombre max_acquire de réservation simultanée.
</para>
<para>
- A la fin d'un script, tous les sémaphores réservés
- mais non explicitement libérés seront libérés
+ A la fin d'un script, tous les sémaphores réservés
+ mais non explicitement libérés seront libérés
automatiquement, et une alerte sera générée.
</para>
- <para>
+ <para>
Voir aussi : <function>sem_get</function> et <function>sem_release</function>.
</para>
</refsect1>
</refentry>
-
<refentry id="function.sem-release">
<refnamediv>
<refname>sem_release</refname>
@@ -160,19 +157,19 @@
</funcprototype>
</funcsynopsis>
<para>
- Retourne TRUE en cas de succès, FALSE en cas d'erreur.
+ Retourne <literal>TRUE</literal> en cas de succès,
+<literal>FALSE</literal> en cas d'erreur.
</para>
<para>
- <function>sem_release</function> libère le sémaphore
- s'il a été réservé par le
+ <function>sem_release</function> libère le sémaphore
+ s'il a été réservé par le
processus courant. Sinon, génère une erreur.
</para>
<para>
- Après libération du sémaphore,
- <function>sem_acquire</function> peut être appelé
+ Après libération du sémaphore,
+ <function>sem_acquire</function> peut être appelé
pour le réserver à nouveau.
</para>
- <para>
+ <para>
Voir aussi : <function>sem_get</function> et <function>sem_acquire</function>.
</para>
<note>
@@ -182,7 +179,6 @@
</note>
</refsect1>
</refentry>
-
<refentry id="function.shm-attach">
<refnamediv>
<refname>shm_attach</refname>
@@ -195,7 +191,7 @@
<funcsynopsis>
<funcprototype>
<funcdef>int <function>shm_attach</function></funcdef>
- <paramdef>int <parameter>key</parameter></paramdef>
+ <paramdef>int <parameter>key</parameter></paramdef>
<paramdef>int
<parameter><optional>memsize</optional></parameter>
</paramdef>
@@ -205,19 +201,19 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>shm_attach</function> retourne un identifiant qui
- permettra d'accéder au System V de mémoire
- partagée. Au premier appel, la mémoire sera
- créée, avec la taille mem_size (par défaut:
- sysvshm.init_mem dans php3.ini, sinon 10000 octets)
+ <function>shm_attach</function> retourne un identifiant qui
+ permettra d'accéder au System V de mémoire
+ partagée. Au premier appel, la mémoire sera
+ créée, avec la taille mem_size (par défaut:
+ sysvshm.init_mem dans <filename>php3.ini</filename>, sinon 10000 octets)
et avec les permissions perm(par défaut : 666).
</para>
<para>
- Aux appels suivants avec la même clé
- <parameter>key</parameter>, <function>shm_attach</function>
- retournera un nouvel identifiant, mais cet identifiant
- accédera toujours à la même portion de
- mémoire partagée. Dans ce cas, <parameter>memsize</parameter>
+ Aux appels suivants avec la même clé
+ <parameter>key</parameter>, <function>shm_attach</function>
+ retournera un nouvel identifiant, mais cet identifiant
+ accédera toujours à la même portion de
+ mémoire partagée. Dans ce cas, <parameter>memsize</parameter>
et <parameter>perm</parameter>seront ignorés.
</para>
<note>
@@ -227,11 +223,10 @@
</note>
</refsect1>
</refentry>
-
<refentry id="function.shm-detach">
<refnamediv>
<refname>shm_detach</refname>
- <refpurpose>Relâche un segment de mémoire partagée.</refpurpose>
+ <refpurpose>Rel’che un segment de mémoire partagée.</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
@@ -242,19 +237,18 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>shm_detach</function> relâche le segment de
- mémoire partagée identifié par
- <parameter>shm_identifier</parameter> et créé par
- <function>sem_get</function>. N'oubliez pas que cette mémoire
- partagée existe toujours sous Unix, et que les
+ <function>shm_detach</function> rel’che le segment de
+ mémoire partagée identifié par
+ <parameter>shm_identifier</parameter> et créé par
+ <function>sem_get</function>. N'oubliez pas que cette mémoire
+ partagée existe toujours sous Unix, et que les
données sont toujours accessibles.
</para>
</refsect1>
</refentry>
-
<refentry id="function.shm-remove">
<refnamediv>
- <refname>shm_remove</refname>
+ <refname>shm_remove</refname>
<refpurpose>
Supprime un segment de mémoire partagée sous Unix.
</refpurpose>
@@ -268,7 +262,7 @@
</funcprototype>
</funcsynopsis>
<para>
- Supprime un segment de mémoire partagée sous Unix.
+ Supprime un segment de mémoire partagée sous Unix.
Toutes les données seront supprimées.
</para>
<note>
@@ -278,10 +272,9 @@
</note>
</refsect1>
</refentry>
-
<refentry id="function.shm-put-var">
<refnamediv>
- <refname>shm_put_var</refname>
+ <refname>shm_put_var</refname>
<refpurpose>
Insère ou modifie une variable de la mémoire partagée.
</refpurpose>
@@ -297,10 +290,10 @@
</funcprototype>
</funcsynopsis>
<para>
- Insère ou modifie la variable <parameter>variable</parameter> avec
- la clé <parameter>variable_key</parameter>. Tous les types de
+ Insère ou modifie la variable <parameter>variable</parameter> avec
+ la clé <parameter>variable_key</parameter>. Tous les types de
variables (double, int, string, array) sont supportés.
- </para>
+ </para>
<note>
<simpara>
Cette fonction n'est pas disponibles sous Windows.
@@ -308,10 +301,9 @@
</note>
</refsect1>
</refentry>
-
<refentry id="function.shm-get-var">
<refnamediv>
- <refname>shm_get_var</refname>
+ <refname>shm_get_var</refname>
<refpurpose>
Lit une variable dans la mémoire partagée.
</refpurpose>
@@ -326,9 +318,9 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>shm_get_var</function> retourne la variable
- repérée par <parameter>variable_key</parameter>.
- La variable est toujours présente en mémoire
+ <function>shm_get_var</function> retourne la variable
+ repérée par <parameter>variable_key</parameter>.
+ La variable est toujours présente en mémoire
partagée.
</para>
<note>
@@ -338,10 +330,9 @@
</note>
</refsect1>
</refentry>
-
<refentry id="function.shm-remove-var">
<refnamediv>
- <refname>shm_remove_var</refname>
+ <refname>shm_remove_var</refname>
<refpurpose>
Efface une variable de la mémoire partagée.
</refpurpose>
@@ -356,8 +347,8 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>shm_remove_var</function> efface la variable
- <parameter>variable_key</parameter> de la mémoire
+ <function>shm_remove_var</function> efface la variable
+ <parameter>variable_key</parameter> de la mémoire
partagée et libère la mémoire.
</para>
<note>
@@ -367,9 +358,7 @@
</note>
</refsect1>
</refentry>
-
</reference>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Index: phpdoc/fr/functions/sesam.xml
diff -u phpdoc/fr/functions/sesam.xml:1.2 phpdoc/fr/functions/sesam.xml:1.3
--- phpdoc/fr/functions/sesam.xml:1.2 Fri Dec 15 03:29:58 2000
+++ phpdoc/fr/functions/sesam.xml Tue Jan 23 02:48:27 2001
@@ -165,7 +165,7 @@
<para>
Les commandes SQL imposent que les guillemets simples soient doublés
pour être interprété litéralement (contrairement
à d'autres bases
- de données qui utilisent un guillement simple,
précédé d'un antislash),
+ de données qui utilisent un guillemet simple,
+précédé d'un antislash),
il est recommandé d'activer les directives PHP
<link
linkend="ini.magic-quotes-gpc"><literal>php3_magic_quotes_gpc</literal></link>
et
@@ -338,7 +338,7 @@
<simpara>
En SESAM (comme dans le standard SQL), les mots
reservés utilisés comme identifiants doivent être
entourés
- de guillements doubles (ou renommés).
+ de guillemets doubles (ou renommés).
</simpara>
</listitem>
<listitem>
@@ -484,7 +484,7 @@
<title>Affectation d'une colonne de type "champs multiple"</title>
<programlisting role="sesam">
INSERT INTO multi_field_test ( pkey, multi(2..3) )
- VALUES ( 'Second', <'first_val','second_val'>)
+ VALUES ( 'Second', <'first_val','second_val>)
</programlisting>
</example>
Notez que (comme c'est le cas ci-dessus), les sous-champs vides
@@ -521,8 +521,8 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>sesam_connect</function> retourne TRUE si une connexion
- à la base SESAM a été faite, ou FALSE en cas d'erreur.
+ <function>sesam_connect</function> retourne <literal>TRUE</literal> si une
+connexion
+ à la base SESAM a été faite, ou <literal>FALSE</literal> en
+cas d'erreur.
</para>
<para>
<function>sesam_connect</function> établit une connexion au serveur
@@ -576,7 +576,7 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>sesam_disconnect</function> retourne toujours TRUE.
+ <function>sesam_disconnect</function> retourne toujours <literal>TRUE</literal>.
</para>
<para>
<function>sesam_disconnect</function> ferme le lien logique à
@@ -627,9 +627,9 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>sesam_settransaction</function> retourne TRUE si les
+ <function>sesam_settransaction</function> retourne <literal>TRUE</literal> si les
valeurs sont valides et que a modification a été
- réussie. FALSE sinon.
+ réussie. <literal>FALSE</literal> sinon.
</para>
<para>
<function>sesam_settransaction</function> remplace les valeurs par
@@ -743,8 +743,8 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>sesam_commit</function> retourne TRUE en cas de succès
- et FALSE sinon.
+ <function>sesam_commit</function> retourne <literal>TRUE</literal> en cas de
+succès
+ et <literal>FALSE</literal> sinon.
</para>
<para>
<function>sesam_commit</function> valide toutes les modifications
@@ -791,8 +791,8 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>sesam_rollback</function> retourne TRUE en cas de succès
- et FALSE en cas d'erreur.
+ <function>sesam_rollback</function> retourne <literal>TRUE</literal> en cas de
+succès
+ et <literal>FALSE</literal> en cas d'erreur.
</para>
<para>
<function>sesam_rollback</function> annule toutes les modifications
@@ -839,7 +839,7 @@
</funcsynopsis>
<para>
<function>sesam_execimm</function> retourne un identifiant de
- résultat SESAM en cas de succès, et FALSE sinon.
+ résultat SESAM en cas de succès, et <literal>FALSE</literal> sinon.
</para>
<para>
<function>sesam_execimm</function> exécute immédiatement la
requête
@@ -901,7 +901,7 @@
</funcsynopsis>
<para>
<function>sesam_query</function> retourne un identifiant de résultat
- SESAM en cas de succès, ou FALSE en cas d'erreur.
+ SESAM en cas de succès, ou <literal>FALSE</literal> en cas d'erreur.
</para>
<para>
L'identifiant de résultat est utilisé par d'autres fonctions
@@ -953,7 +953,7 @@
echo "<TABLE BORDER>\n";
// Ajoute l'entête de titre comme nom de colonne
if ($cols = sesam_field_array($result)) {
- echo " <TR><TH
COLSPAN=".$cols["count"].">Result:</TH></TR>\n";
+ echo " <TR><TH
+COLSPAN=".$cols["count"].>Result:</TH></TR>\n";
echo " <TR>\n";
for ($col = 0; $col < $cols["count"]; ++$col) {
$colattr = $cols[$col];
@@ -1008,7 +1008,7 @@
Après avoir appelé <function>sesam_query</function> avec une
requête
de selection, <function>sesam_num_fields</function> indique le
nombre de colonnes du résultat identifié par
- <parameter>result_id</parameter>. Retourne FALSE en cas d'erreur.
+ <parameter>result_id</parameter>. Retourne <literal>FALSE</literal> en cas
+d'erreur.
</para>
<para>
Pour les requêtes immédiates, la valeur zéro est
retournée. Les
@@ -1042,7 +1042,7 @@
<para>
<function>sesam_field_name</function> retourne le nom du champs
<parameter>index</parameter> dans le résultat identifié par
- <parameter>result_id</parameter>, ou FALSE en cas d'erreur.
+ <parameter>result_id</parameter>, ou <literal>FALSE</literal> en cas d'erreur.
</para>
<para>
Pour les requêtes immédiates, ou les colonnes dynamiques,
@@ -1258,9 +1258,9 @@
<row>
<entry>boolean $arr["truncated"]</entry>
<entry>
- TRUE si le nombre de ligne était d'au moins
- <parameter>max_rows</parameter>, FALSE sinon. Notez que
- même si cette valeur est à TRUE, le prochain appel à
+ <literal>TRUE</literal> si le nombre de ligne était d'au moins
+ <parameter>max_rows</parameter>, <literal>FALSE</literal> sinon. Notez
+que
+ même si cette valeur est à <literal>TRUE</literal>, le
+prochain appel à
<function>sesam_fetch_result</function> peut retourner
aucune ligne parce qu'il n'y a plus d'entrées.
</entry>
@@ -1582,7 +1582,7 @@
<para>
<function>sesam_fetch_row</function> retourne un tableau qui correspond à
la ligne lue dans le résultat <parameter>result_id</parameter>,
- ou FALSE s'il n'y a plus de ligne.
+ ou <literal>FALSE</literal> s'il n'y a plus de ligne.
</para>
<para>
Le nombre de colonnes du résultat est retourné dans un
élémen du tableau
@@ -1699,7 +1699,7 @@
<para>
Les prochains appels à <function>sesam_fetch_row</function> liront
la prochaine ligne (ou la précédente, ou la n-ième, suivant
le
- type de défilement) dans le résultat, ou FALSE, s'il n'y a plus de
lignes.
+ type de défilement) dans le résultat, ou <literal>FALSE</literal>,
+s'il n'y a plus de lignes.
</para>
<example>
<title>Exemple avec <function>sesam_fetch_row</function></title>
@@ -1757,7 +1757,7 @@
<para>
<function>sesam_fetch_array</function> retourne un tableau qui
correspond à la ligne lue dans le résultat
<parameter>result_id</parameter>,
- ou FALSE si il n'y a pas d'autres lignes.
+ ou <literal>FALSE</literal> si il n'y a pas d'autres lignes.
</para>
<para>
<function>sesam_fetch_array</function> est une version alternative de
@@ -1792,7 +1792,7 @@
de préférence <function>sesam_fetch_row</function> ou bien,
faîtes un
alias de la colonne.
<informalexample>
- <programlisting>
+ <programlisting role="sesam">
SELECT TBL1.COL AS FOO, TBL2.COL AS BAR FROM TBL1, TBL2</programlisting>
</informalexample>
</para>
@@ -1966,7 +1966,7 @@
<para>
<function>sesam_free_result</function> libère les ressources
reservées par la requête <parameter>result_id</parameter>.
- retourne FALSE en cas d'erreur.
+ retourne <literal>FALSE</literal> en cas d'erreur.
</para>
</refsect1>
</refentry>
Index: phpdoc/fr/functions/session.xml
diff -u phpdoc/fr/functions/session.xml:1.5 phpdoc/fr/functions/session.xml:1.6
--- phpdoc/fr/functions/session.xml:1.5 Wed Dec 13 05:53:21 2000
+++ phpdoc/fr/functions/session.xml Tue Jan 23 02:48:27 2001
@@ -1,5 +1,5 @@
<reference id="ref.session">
- <title>Gestion des sessions</title>
+ <title>Sessions</title>
<titleabbrev>Sessions</titleabbrev>
<partintro>
<para>
@@ -136,18 +136,18 @@
session_register("compteur");
$compteur++;
?>
-Salut visiteur, vous avez vu cette page <?php echo $compteur; ?> times.<p>
+Salut visiteur, vous avez vu cette page <?php echo $compteur; ?> times.<P>
<php?
-# le <?=SID?> est nécessaire pour transmettre l'identifiant de session
+# le <?=SID> est nécessaire pour transmettre l'identifiant de session
# au cas oú les utilisateurs auraient inactivé les cookies
?>
-Pour continuer, <A HREF="nextpage.php?<?=SID?>">clique ici</A>
+Pour continuer, <A HREF="nextpage.php?<?=SID"?>clique ici</?>
</programlisting>
</example>
</para>
<para>
- Le <literal><?=SID?></literal> n'est pas nécessaire, si l'option
- <literal>--enable-trans-sid</literal> a été utilisé
+ Le <literal><?=SID-></literal> n'est pas nécessaire, si l'option
+ <literal>--enable-trans-sid</literal> a été utilisé
pour compiler PHP.
</para>
<para>
@@ -158,7 +158,8 @@
</para>
<para>
Le système de gestion des sessions dispose d'un grand nombre d'options,
- qui sont placées dans le fichier php.ini file. En voici un survol rapide :
+ qui sont placées dans le fichier <filename>php.ini</filename>. En voici
+ un survol rapide :
<itemizedlist>
<listitem>
<simpara>
@@ -177,6 +178,13 @@
oú les fichiers sont créés. Par défaut, le
dossier est <literal>/tmp</literal>.
</simpara>
+ <warning>
+ <para>
+ Si le dossier que vous utilisez a les droits de lecture universels,
+ comme <filename>/tmp</filename> (valeur par défaut), les autres utilisateurs
+ du serveur peuvent aussi lire ces fichiers, et s'imiscer dans vos sessions.
+ </para>
+ </warning>
</listitem>
<listitem>
<simpara>
@@ -314,7 +322,7 @@
session passé par une variable GET ou par un cookie)
</simpara>
<simpara>
- Cette fonction retourne toujours TRUE.
+ Cette fonction retourne toujours <literal>TRUE</literal>.
</simpara>
<note>
<para>
@@ -343,7 +351,7 @@
données associées à la session courante.
</simpara>
<simpara>
- Cette fonction retourne TRUE en cas de succès, et FALSE sinon.
+ Cette fonction retourne <literal>TRUE</literal> en cas de succès, et
+<literal>FALSE</literal> sinon.
</simpara>
</refsect1>
</refentry>
@@ -383,7 +391,7 @@
<?php
# Change le nom de la session à WebsiteID
$previous_name = session_name ("WebsiteID");
-echo "L'ancien nom de la session était $previous_name<p>";
+echo "L'ancien nom de la session était $previous_name<P>";
?>
</programlisting>
</example>
@@ -513,7 +521,7 @@
des chaînes ou d'autre tableau (récursif).
</para>
<para>
- Cette fonction retourne TRUE lorsque la variable est correctement
+ Cette fonction retourne <literal>TRUE</literal> lorsque la variable est
+correctement
enregistrée.
<note>
<para>
@@ -543,7 +551,7 @@
nommée <parameter>name</parameter> dans la session courante.
</para>
<para>
- <function>session_unregister</function> retourne TRUE (vrai)
+ <function>session_unregister</function> retourne <literal>TRUE</literal> (vrai)
lorsque la variable a été correctement supprimée
de la session.
<note>
@@ -591,7 +599,7 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>session_is_registered</function> retourne TRUE si il y
+ <function>session_is_registered</function> retourne <literal>TRUE</literal> si
+il y
a une variable du nom de <parameter>name</parameter>
enregistrée dans la session courante.
<note>
@@ -760,8 +768,8 @@
<para>
Vous devez donner à l'option de configuration
<parameter>session.save_handler</parameter> la valeur de
- <parameter>user</parameter> dans votre fichier php.ini file pour que
- <function>session_set_save_handler</function> soint effective.
+ <parameter>user</parameter> dans votre fichier <filename>php.ini</filename>
+pour que
+ <function>session_set_save_handler</function> soit effective.
</para>
</note>
<para>
@@ -781,10 +789,10 @@
global $sess_save_path, $sess_session_name;
$sess_save_path = $save_path;
$sess_session_name = $session_name;
- return(true);
+ return(<literal>TRUE</literal>);
}
function close() {
- return(true);
+ return(<literal>TRUE</literal>);
}
function read ($id) {
global $sess_save_path, $sess_session_name;
@@ -802,7 +810,7 @@
if ($fp = @fopen($sess_file, "w")) {
return(fwrite($fp, $sess_data));
} else {
- return(false);
+ return(<literal>FALSE</literal>);
}
}
function destroy ($id) {
@@ -815,7 +823,7 @@
* d'entretien des sessions ici. *
***************************************************/
function gc ($maxlifetime) {
- return true;
+ return <literal>TRUE</literal>;
}
session_set_save_handler ("open", "close", "read", "write", "destroy", "gc");
session_start();
@@ -867,13 +875,14 @@
# Met le limiteur de cache à 'private'
session_cache_limiter('private');
$cache_limiter = session_cache_limiter();
-echo "Le limiteur de cache vaut actuellement $cache_limiter<p>";
+echo "Le limiteur de cache vaut actuellement $cache_limiter<P>";
?>
</programlisting>
</example>
<note>
<para>
- Cette fonction a été ajoutée dans PHP 4.0.3.
+ <function>session_cache_limiter</function> a été ajoutée
+dans
+ PHP 4.0.3.
</para>
</note>
</refsect1>
Index: phpdoc/fr/functions/strings.xml
diff -u phpdoc/fr/functions/strings.xml:1.18 phpdoc/fr/functions/strings.xml:1.19
--- phpdoc/fr/functions/strings.xml:1.18 Mon Jan 22 03:58:33 2001
+++ phpdoc/fr/functions/strings.xml Tue Jan 23 02:48:27 2001
@@ -1063,7 +1063,7 @@
<refentry id="function.localeconv">
<refnamediv>
<refname>localeconv</refname>
- <refpurpose>Lit le formatage numérique et monétaire</refpurpose>
+ <refpurpose>Lit le formatage numérique et monétaire</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
@@ -1075,13 +1075,13 @@
</funcsynopsis>
<para>
<function>localeconv</function> retourne un tableau associatif contenant
- les informations locales de format monétaire et numérique utilisé par le
+ les informations locales de format monétaire et numérique
+utilisé par le
serveur.
</para>
<para>
- <function>localeconv</function> retourne les informations à partir
- des données locales, comme définies par <function>setlocale</function>.
- Le tableau associatif retourné contient les entrées suivantes :
+ <function>localeconv</function> retourne les informations à partir
+ des données locales, comme définies par
+<function>setlocale</function>.
+ Le tableau associatif retourné contient les entrées suivantes :
<informaltable >
<tgroup cols="2">
<thead>
@@ -1093,35 +1093,35 @@
<tbody>
<row>
<entry>decimal_point</entry>
- <entry>Séparateur décimal</entry>
+ <entry>Séparateur décimal</entry>
</row>
<row>
<entry>thousands_sep</entry>
- <entry>Séparateur de milliers</entry>
+ <entry>Séparateur de milliers</entry>
</row>
<row>
<entry>grouping</entry>
- <entry>Tableau contenant les groupages numériques</entry>
+ <entry>Tableau contenant les groupages numériques</entry>
</row>
<row>
<entry>int_curr_symbol</entry>
- <entry>Symbole monétaire international (i.e. FRF)</entry>
+ <entry>Symbole monétaire international (i.e. FRF)</entry>
</row>
<row>
<entry>currency_symbol</entry>
- <entry>Symbole monétaire local (i.e. F)</entry>
+ <entry>Symbole monétaire local (i.e. F)</entry>
</row>
<row>
<entry>mon_decimal_point</entry>
- <entry>Séparateur décimal monétaire</entry>
+ <entry>Séparateur décimal monétaire</entry>
</row>
<row>
<entry>mon_thousands_sep</entry>
- <entry>Séparateur de milliers monétaires</entry>
+ <entry>Séparateur de milliers monétaires</entry>
</row>
<row>
<entry>mon_grouping</entry>
- <entry>Tableau contenant les groupages numériques monétaires</entry>
+ <entry>Tableau contenant les groupages numériques
+monétaires</entry>
</row>
<row>
<entry>positive_sign</entry>
@@ -1129,34 +1129,34 @@
</row>
<row>
<entry>negative_sign</entry>
- <entry>Signe des valeurs négatives</entry>
+ <entry>Signe des valeurs négatives</entry>
</row>
<row>
<entry>int_frac_digits</entry>
- <entry>Nombre de chiffres décimaux international</entry>
+ <entry>Nombre de chiffres décimaux international</entry>
</row>
<row>
<entry>frac_digits</entry>
- <entry>Nombre de chiffres décimaux locaux</entry>
+ <entry>Nombre de chiffres décimaux locaux</entry>
</row>
<row>
<entry>p_cs_precedes</entry>
- <entry><literal>TRUE</literal> si currency_symbol précède une valeur positive,
- <literal>FALSE</literal> s'il lui succède</entry>
+ <entry><literal>TRUE</literal> si currency_symbol précède une
+valeur positive,
+ <literal>FALSE</literal> s'il lui succède</entry>
</row>
<row>
<entry>p_sep_by_space</entry>
- <entry><literal>TRUE</literal> si un espace sépare currency_symbol d'une
valeur positive,
+ <entry><literal>TRUE</literal> si un espace sépare currency_symbol
+d'une valeur positive,
<literal>FALSE</literal> sinon</entry>
</row>
<row>
<entry>n_cs_precedes</entry>
- <entry><literal>TRUE</literal> si currency_symbol précède une valeur négative,
- <literal>FALSE</literal> s'il lui succède</entry>
+ <entry><literal>TRUE</literal> si currency_symbol précède une
+valeur négative,
+ <literal>FALSE</literal> s'il lui succède</entry>
</row>
<row>
<entry>n_sep_by_space</entry>
- <entry><literal>TRUE</literal> si un espace sépare currency_symbol d'une
valeur négative,
+ <entry><literal>TRUE</literal> si un espace sépare currency_symbol
+d'une valeur négative,
<literal>FALSE</literal> sinon</entry>
</row>
<row valign="top">
@@ -1164,15 +1164,15 @@
<entry>
<simplelist columns="2" type="horiz">
<member>0</member>
- <member>Des parenthèses entourent la quantité est currency_symbol</member>
+ <member>Des parenthèses entourent la quantité est
+currency_symbol</member>
<member>1</member>
- <member>Le signe précède la quantité et currency_symbol</member>
+ <member>Le signe précède la quantité et
+currency_symbol</member>
<member>2</member>
- <member>Le signe suit la quantité et currency_symbol</member>
+ <member>Le signe suit la quantité et currency_symbol</member>
<member>3</member>
- <member>Le signe précède immédiatement currency_symbol</member>
+ <member>Le signe précède immédiatement
+currency_symbol</member>
<member>4</member>
- <member>Le signe suit immédiatement currency_symbol</member>
+ <member>Le signe suit immédiatement currency_symbol</member>
</simplelist>
</entry>
</row>
@@ -1181,15 +1181,15 @@
<entry>
<simplelist columns="2" type="horiz">
<member>0</member>
- <member>Des parenthèses entourent la quantité est currency_symbol</member>
+ <member>Des parenthèses entourent la quantité est
+currency_symbol</member>
<member>1</member>
- <member>Le signe précède la quantité et currency_symbol</member>
+ <member>Le signe précède la quantité et
+currency_symbol</member>
<member>2</member>
- <member>Le signe suit la quantité et currency_symbol</member>
+ <member>Le signe suit la quantité et currency_symbol</member>
<member>3</member>
- <member>Le signe précède immédiatement currency_symbol</member>
+ <member>Le signe précède immédiatement
+currency_symbol</member>
<member>4</member>
- <member>Le signe suit immédiatement currency_symbol</member>
+ <member>Le signe suit immédiatement currency_symbol</member>
</simplelist>
</entry>
</row>
@@ -1198,24 +1198,21 @@
</informaltable>
</para>
<para>
- Le champs de groupage contient un tableau qui définit comment les chiffres
doivent
- être regroupés. Par exemple, ce champs pour le dollar américain contient un
- tableau de deux éléments (3 et 3). Les éléments sont classés de gauche à droite.
- Si un des éléments vaut CHAR_MAX, les groupages ne sont plus effectués.
- Si un éléments vaut 0, la valeur du précédent doit être utilisée.
+ Le champs de groupage contient un tableau qui définit comment les
+chiffres doivent
+ être regroupés. Par exemple, ce champs pour le dollar
+américain contient un
+ tableau de deux éléments (3 et 3). Les éléments sont
+classés de gauche à droite.
+ Si un des éléments vaut CHAR_MAX, les groupages ne sont plus
+effectués.
+ Si un éléments vaut 0, la valeur du précédent doit
+être utilisée.
</para>
<example>
<title>Exemple avec <function>localeconv</function></title>
<programlisting role="php">
setlocale(LC_ALL, "en_US");
-
$locale_info = localeconv();
-
echo "<PRE>\n";
echo "--------------------------------------------\n";
-echo " Informations monétaires pour le serveur local: \n";
+echo " Informations monétaires pour le serveur local: \n";
echo "--------------------------------------------\n\n";
-
echo "int_curr_symbol: {$locale_info["int_curr_symbol"]}\n";
echo "currency_symbol: {$locale_info["currency_symbol"]}\n";
echo "mon_decimal_point: {$locale_info["mon_decimal_point"]}\n";
@@ -1234,11 +1231,11 @@
</programlisting>
</example>
<para>
- La constante CHAR_MAX est aussi définie ci-dessus.
+ La constante CHAR_MAX est aussi définie ci-dessus.
</para>
<note>
<para>
- Ajouté en PHP 4.0.5
+ Ajouté en PHP 4.0.5
</para>
</note>
<para>
@@ -1648,7 +1645,7 @@
</listitem>
<listitem>
<simpara>
- LC_COLLATE pour les comparaisons de chaîne
+ LC_COLLATE pour les comparaisons de chaîne
(voir <function>strcoll</function>)
</simpara>
</listitem>
@@ -2056,7 +2053,7 @@
<refentry id="function.strcoll">
<refnamediv>
<refname>strcoll</refname>
- <refpurpose>Comparaison de chaînes localisée</refpurpose>
+ <refpurpose>Comparaison de chaînes localisée</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
@@ -2068,22 +2065,22 @@
</funcprototype>
</funcsynopsis>
<simpara>
- <function>strcoll</function> retourne < 0 si <parameter>str1</parameter>
- est plus petit que <parameter>str2</parameter>; > 0 si
- <parameter>str1</parameter> est plus grand que <parameter>str2</parameter>,
- et 0 si elles sont égales. <function>strcoll</function> utilise la
- configuration locale pour effectuer les comparaisons. Si la
- configuration locale est : C ou POSIX, <function>strcoll</function>
- est équivalente à <function>strcmp</function>.
+ <function>strcoll</function> retourne < 0 si <parameter>str1</parameter>
+ est plus petit que <parameter>str2</parameter>; > 0 si
+ <parameter>str1</parameter> est plus grand que <parameter>str2</parameter>,
+ et 0 si elles sont égales. <function>strcoll</function> utilise la
+ configuration locale pour effectuer les comparaisons. Si la
+ configuration locale est : C ou POSIX, <function>strcoll</function>
+ est équivalente à <function>strcmp</function>.
</simpara>
<simpara>
- Notez que cette comparaison est sensible à la casse, et que contrairement
- à <function>strcmp</function>, <function>strcoll</function> n'est pas
+ Notez que cette comparaison est sensible à la casse, et que contrairement
+ à <function>strcmp</function>, <function>strcoll</function> n'est pas
binaire.
</simpara>
<note>
<simpara>
- Ajoutée en PHP 4.0.5.
+ Ajoutée en PHP 4.0.5.
</simpara>
</note>
<simpara>
@@ -2951,19 +2948,40 @@
<title>Description</title>
<funcsynopsis>
<funcprototype>
- <funcdef>string <function>str_replace</function></funcdef>
- <paramdef>string <parameter>needle</parameter></paramdef>
- <paramdef>string <parameter>str</parameter></paramdef>
- <paramdef>string <parameter>haystack</parameter></paramdef>
+ <funcdef>mixed <function>str_replace</function></funcdef>
+ <paramdef>mixed <parameter>search</parameter></paramdef>
+ <paramdef>mixed <parameter>replace</parameter></paramdef>
+ <paramdef>mixed <parameter>subject</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
<function>str_replace</function> remplace toutes les occurences de
- <parameter>needle</parameter> dans <parameter>haystack</parameter> par
- la chaîne <parameter>str</parameter>. Si vous n'avez pas besoin de
+ <parameter>search</parameter> dans <parameter>subject</parameter> par
+ la chaîne <parameter>replace</parameter>. Si vous n'avez pas besoin de
règles de remplacement sophistiquées, vous pouvez toujours
utiliser <function>ereg_replace</function>.
</para>
+ <para>
+ En PHP 4.0.5 et plus récent, chaque paramètre de
+ <function>str_replace</function> peut être un tableau.
+ </para>
+ <para>
+ Si <parameter>subject</parameter> est un tableau, alors le remplacement
+ est effectué pour chaque valeur de <parameter>subject</parameter>, et la
+ valeur retourné sera un tableau.
+ </para>
+ <para>
+ Si <parameter>search</parameter> et <parameter>replace</parameter> sont
+ des tableaux, alors <function>str_replace</function> prend une valeur dans
+ chaque tableau, et s'en sert pour chercher et remplacer dans
+ <parameter>subject</parameter>. Si <parameter>replace</parameter> a moins
+ de valeurs que <parameter>search</parameter>, des chaînes vides seront utilisées
+ pour compléter le tableau <parameter>replace</parameter> . Si
+ <parameter>search</parameter> est un tableau et <parameter>replace</parameter>
+ est une chaîne, alors la même chaîne de remplacement sera utilisée pour chaque
+ valeur de <parameter>search</parameter>. Le contraire n'aurait pas beaucoup de
+ sens.
+ </para>
<para>
<example>
<title>Exemple avec <function>str_replace</function></title>
@@ -2975,7 +2993,7 @@
</example>
</para>
<para>
- Cette fonction n'altère pas les données binaires.
+ <function>str_replace</function> n'altère pas les données
+binaires.
</para>
<note>
<para>
@@ -2984,7 +3002,8 @@
</para>
</note>
<para>
- Voir aussi <function>ereg_replace</function> et <function>strtr</function>.
+ Voir aussi <function>ereg_replace</function>, <function>preg_replace</function>
+ et <function>strtr</function>.
</para>
</refsect1>
</refentry>
@@ -3037,7 +3056,7 @@
<informalexample>
<programlisting role="php">
<?php
-$trans = array("bonjour" => "salut", "salut" => "bonjour");
+$trans = array("bonjour" => "salut", "salut" => "bonjour");
echo strtr("bonjour à tous, j'ai dit salut", $trans) . "\n";
?>
</programlisting>
Index: phpdoc/fr/functions/zlib.xml
diff -u phpdoc/fr/functions/zlib.xml:1.4 phpdoc/fr/functions/zlib.xml:1.5
--- phpdoc/fr/functions/zlib.xml:1.4 Mon Jan 22 03:58:33 2001
+++ phpdoc/fr/functions/zlib.xml Tue Jan 23 02:48:27 2001
@@ -68,8 +68,8 @@
<function>gzclose</function> ferme le pointeur <parameter>zp</parameter>.
</para>
<para>
- <function>gzclose</function> retourne <literal>TRUE</literal> ou
<literal>FALSE</literal>, suivant le succès
- ou l'échec.
+ <function>gzclose</function> retourne <literal>TRUE</literal> ou
+ <literal>FALSE</literal>, suivant le succès ou l'échec.
</para>
<para>
Le pointeur de fichier compressé doit être valide, et doit
@@ -159,7 +159,7 @@
<refentry id="function.gzgets">
<refnamediv>
<refname>gzgets</refname>
- <refpurpose>Lit une ligne d'un fichier compressé </refpurpose>
+ <refpurpose>Lit une ligne d'un fichier compressé</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
@@ -208,8 +208,8 @@
<paramdef>string
<parameter><optional>allowable_tags</optional></parameter></paramdef>
</funcsynopsis>
<para>
- Identique à <function>gzgets</function>, mais <function>gzgetss</function>
- essaie de supprimer toutes les balises HTML et PHP du texte lu.
+ <function>gzgetss</function> est identique à <function>gzgets</function>,
+ mais elle essaie de supprimer toutes les balises HTML et PHP du texte lu.
</para>
<para>
Vous pouvez utiliser le troisième argument optionnel pour indiquer
@@ -217,7 +217,7 @@
<note>
<para>
<parameter>allowable_tags</parameter> a été ajouté
- dans PHP 3.0.13, PHP 4.0B3.
+ en PHP 3.0.13, PHP 4.0B3.
</para>
</note>
</para>
@@ -241,20 +241,20 @@
<paramdef>int
<parameter><optional>use_include_path</optional></parameter></paramdef>
</funcsynopsis>
<para>
- Ouvre un fichier compressé avec gzip (.gz) pour le lire ou
- l'écrire. Le paramètre de mode est le même que dans
- <function>fopen</function> ("rb" ou "wb") mais il peut aussi inclure
- un niveau de compression ("wb9") ou une stratégie: 'f' pour
- les données filtrées, comme dans "wb6f", 'h' pour
- Huffman seul , comme dans "wb1h". (Voir la description de deflateInit2
- dans zlib.h pour plus de détails a propos des paramètres
- de stratégie).
+ <function>gzopen</function> ouvre un fichier compressé avec gzip (.gz)
+ pour le lire ou l'écrire. Le paramètre de mode est le même
+ que dans <function>fopen</function> ("rb" ou "wb") mais il peut aussi inclure
+ un niveau de compression ("wb9") ou une stratégie: 'f' pour
+ les données filtrées, comme dans "wb6f", 'h' pour
+ Huffman seul , comme dans "wb1h". (Voir la description de deflateInit2
+ dans zlib.h pour plus de détails a propos des paramètres
+ de stratégie).
</para>
<para>
- <function>gzopen</function> peut être utilisé pour
- ouvrir des fichiers qui ne sont pas au format gzip; dans ce cas,
- <function>gzread</function> lira directement le fichier, sans
- appliquer de décompression.
+ <function>gzopen</function> peut être utilisé pour
+ ouvrir des fichiers qui ne sont pas au format gzip; dans ce cas,
+ <function>gzread</function> lira directement le fichier, sans
+ appliquer de décompression.
</para>
<para>
<function>gzopen</function> retourne un pointeur de fichier sur le
@@ -372,7 +372,8 @@
<simpara>
Voir aussi <function>gzwrite</function>, <function>gzopen</function>,
<function>gzgets</function>, <function>gzgetss</function>,
- <function>gzfile</function>, et <function>gzpassthru</function>.</simpara>
+ <function>gzfile</function>, et <function>gzpassthru</function>.
+ </simpara>
</refsect1>
</refentry>
<refentry id="function.gzrewind">
@@ -418,23 +419,25 @@
<paramdef>int <parameter>offset</parameter></paramdef>
</funcsynopsis>
<para>
- Positionne le pointeur interne du fichier compressé zp à
- la position donnée en offset. Equivalent à l'appel (en C) de
- <literal>gzseek( zp, offset, SEEK_SET )</literal>.
+ <function>gzseek</function> positionne le pointeur interne du fichier
+ compressé <parameter>zp</parameter> à la position donnée
+ en <parameter>offset</parameter>. Equivalent à l'appel (en C) de
+ <literal>gzseek(zp, offset, SEEK_SET)</literal>.
</para>
<para>
- Si le fichier est ouvert en lecture seule, cette fonction
- émulée peut être extrêmement lente. Si
- le fichier est ouvert en lecture, seul le déplacement avant
- (forward seek) sont acceptés. gzseek compresse alors une
- séquence de zéro jusqu'à la nouvelle position.
+ Si le fichier est ouvert en lecture seule, cette fonction
+ émulée peut être extrêmement lente. Si
+ le fichier est ouvert en lecture, seul le déplacement avant
+ (forward seek) sont acceptés. gzseek compresse alors une
+ séquence de zéro jusqu'à la nouvelle position.
</para>
<para>
- Retourne 0 en cas de succès, sinon retourne -1. Notez positionner
- le pointeur au delà de la fin du fichier est une erreur.
+ <function>gzseek</function> retourne 0 en cas de succès, sinon
+ retourne -1. Notez que positionner le pointeur au delà de la
+ fin du fichier est une erreur.
</para>
<para>
- Voir aussi <function>gztell</function> et <function>gzrewind</function>.
+ Voir aussi <function>gztell</function> et <function>gzrewind</function>.
</para>
</refsect1>
</refentry>
@@ -451,8 +454,8 @@
</funcsynopsis>
<para>
<function>gztell</function> retourne la position du pointeur interne
- du fichier référencé par zp, i.e., son offset en
- octets depuis le début du fichier.
+ du fichier référencé par <parameter>zp</parameter>,
+ i.e., son offset en octets depuis le début du fichier.
</para>
<para>
Si une erreur survient, retourne <literal>FALSE</literal>.
@@ -491,11 +494,11 @@
la fin de la chaîne a été atteinte.
</simpara>
<simpara>
- Notez que si l'argument <parameter>length</parameter> est donnée,
- alors l'option
- <link linkend="ini.magic-quotes-runtime">magic_quotes_runtime</link>
- sera ignorée et les slashes ne seront pas supprimés de
- la chaîne <parameter>string</parameter>.
+ Notez que si l'argument <parameter>length</parameter> est donnée,
+ alors l'option
+ <link linkend="ini.magic-quotes-runtime">magic_quotes_runtime</link>
+ sera ignorée et les slashes ne seront pas supprimés de
+ la chaîne <parameter>string</parameter>.
</simpara>
<simpara>
Voir aussi <function>gzread</function>, <function>gzopen</function>,
@@ -506,7 +509,7 @@
<refentry id="function.readgzfile">
<refnamediv>
<refname>readgzfile</refname>
- <refpurpose>Affiche un fichier compressé </refpurpose>
+ <refpurpose>Affiche un fichier compressé</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
@@ -516,8 +519,8 @@
<paramdef>int
<parameter><optional>use_include_path</optional></parameter></paramdef>
</funcsynopsis>
<para>
- Lit un fichier, le décompresse et l'écrit dans la sortie
- standard.
+ <function>readgzfile</function> lit un fichier, le décompresse et
+ l'écrit dans la sortie standard.
</para>
<para>
<function>readgzfile</function> peut être utilisé pour
@@ -525,10 +528,10 @@
décompression est omise, et le fichier est directement affiché.
</para>
<para>
- Retourne le nombre d'octets (non compressé) lus depuis le fichier.
- Si une erreur survient, retourne <literal>FALSE</literal>, et à moins
que la fonction
- n'ai été appelée avec @readgzfile, l'erreur est
- affichée.
+ <function>readgzfile</function> retourne le nombre d'octets (non
+compressé)
+ lus depuis le fichier. Si une erreur survient, retourne
+<literal>FALSE</literal>,
+ et à moins que la fonction n'ai été appelée avec
+ @readgzfile, l'erreur est affichée.
</para>
<para>
Le fichier <parameter>filename</parameter> sera ouvert et son contenu
@@ -545,7 +548,7 @@
</para>
</refsect1>
</refentry>
-<refentry id="function.gzcompress">
+ <refentry id="function.gzcompress">
<refnamediv>
<refname>gzcompress</refname>
<refpurpose>Compresse une chaˆne avec Gz</refpurpose>
@@ -562,10 +565,11 @@
</funcprototype>
</funcsynopsis>
<para>
- Cette fonction retourne la version compressé GZ de la chaîne
- <parameter>data</parameter>, ou <literal>FALSE</literal> en cas d'erreur. Le
paramètre
- <parameter>level</parameter> peut prendre des valeurs depuis 0 (pas de
- compression) jusqu'à 9 (compression maximum).
+ <function>gzcompress</function> retourne la version compressé GZ de
+ la chaîne <parameter>data</parameter>, ou <literal>FALSE</literal>
+ en cas d'erreur. Le paramètre <parameter>level</parameter> peut
+ prendre des valeurs depuis 0 (pas de compression) jusqu'à 9
+ (compression maximum).
</para>
<para>
Voir aussi <function>gzuncompress</function>.
@@ -592,12 +596,19 @@
<function>gzuncompress</function> prend la chaîne
<parameter>data</parameter> en entrée (compressée par
<function>gzcompress</function>) et retourne la chaîne originale,
- ou bien <literal>FALSE</literal> en cas d'erreur. Cette fonction retournera une
erreur si
- la taille de la chaîne décompressée est plus de
- 256 fois la longueur de la chaîne compressée
+ ou bien <literal>FALSE</literal> en cas d'erreur.
+<function>gzuncompress</function>
+ retournera une erreur si la taille de la chaîne décompressée
+ est plus de 256 fois la longueur de la chaîne compressée
<parameter>data</parameter> ou plus que le paramètre optionnel
<parameter>length</parameter>.
</para>
+ <note>
+ <para>
+ Ceci <emphasis>n'est pas équivalent</emphasis> à une comrpession gzip,
+ qui inclus en plus des données d'entête. Voir <function>gzencode</function>
+ pour la compression gzip.
+ </para>
+ </note>
<para>
Voir aussi <function>gzcompress</function>.
</para>
Index: phpdoc/fr/functions/readline.xml
diff -u phpdoc/fr/functions/readline.xml:1.3 phpdoc/fr/functions/readline.xml:1.4
--- phpdoc/fr/functions/readline.xml:1.3 Tue Dec 12 02:50:00 2000
+++ phpdoc/fr/functions/readline.xml Tue Jan 23 02:48:27 2001
@@ -43,15 +43,17 @@
<example>
<title>Exemple avec <function>readline</function></title>
<programlisting role="php">
+<?php
//Lit 3 commandes de l'utilisateur
-for ($i=0; $i < 3; $i++) {
- $line = readline ("Commande: ");
- readline_add_history ($line);
+for ($i=0; $i < 3; $i++) {
+ $line = readline("Commande: ");
+ readline_add_history($line);
}
//liste l'historique
-print_r (readline_list_history());
-//list les variables
-print_r (readline_info());
+print_r(readline_list_history());
+//liste les variables
+print_r(readline_info());
+?>
</programlisting>
</example>
</refsect1>
