dams Mon Jan 22 03:58:34 2001 EDT
Modified files:
/phpdoc/fr/functions snmp.xml sockets.xml strings.xml swf.xml
sybase.xml uodbc.xml url.xml var.xml
vmailmgr.xml wddx.xml xml.xml xslt.xml
zlib.xml shmop.xml
Log:
Next update for function's files (3/5). Going on....
Index: phpdoc/fr/functions/snmp.xml
diff -u phpdoc/fr/functions/snmp.xml:1.3 phpdoc/fr/functions/snmp.xml:1.4
--- phpdoc/fr/functions/snmp.xml:1.3 Tue Dec 12 02:50:13 2000
+++ phpdoc/fr/functions/snmp.xml Mon Jan 22 03:58:33 2001
@@ -3,15 +3,15 @@
<titleabbrev>SNMP</titleabbrev>
<partintro>
<simpara>
- Afin de pouvoir utiliser les fonctions SNMP sous Unix, vous aurez
+ Afin de pouvoir utiliser les fonctions <acronym>SNMP</acronym> sous Unix, vous
+aurez
besoin d'installer le package <ulink url="&url.ucd-snmp;">UCD SNMP</ulink>.
Sous Windows ces fonctions ne sont disponibles que sous NT, et
pas sous Win95/98.
</simpara>
<simpara>
- Important : Afin d'utiliser le package UCD SNMP, vous devez
+ Important : Afin d'utiliser le package UCD <acronym>SNMP</acronym>, vous devez
mettre la variable NO_ZEROLENGTH_COMMUNITY à 1 avant de
- compiler. Après avoir configuré UCD SNMP, éditez
+ compiler. Après avoir configuré UCD <acronym>SNMP</acronym>,
+éditez
le fichier config.h et recherchez la valeur NO_ZEROLENGTH_COMMUNITY.
Décommentez la ligne avec le #define. Cela doit ressembler
à ceci :
@@ -23,9 +23,9 @@
</para>
<simpara>
Si vous avez des erreurs "segmentation faults", lors de l'utilisation
- des commandes SNMP, c'est que vous n'avez pas suivi les
+ des commandes <acronym>SNMP</acronym>, c'est que vous n'avez pas suivi les
recommendations précédentes. Si vous ne voulez
- pas recompiler UCD SNMP, vous pouvez aussi recompiler PHP
+ pas recompiler UCD <acronym>SNMP</acronym>, vous pouvez aussi recompiler PHP
avec l'option --enable-ucd-snmp-hack qui évitera
cette erreur.
</simpara>
@@ -33,7 +33,7 @@
<refentry id="function.snmpget">
<refnamediv>
<refname>snmpget</refname>
- <refpurpose>Reçoit un objet SNMP.</refpurpose>
+ <refpurpose>Reçoit un objet <acronym>SNMP</acronym>.</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
@@ -48,13 +48,13 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>snmpget</function> retourne un objet SNMP en cas de
- succès, et FALSE en cas d'erreur.
+ <function>snmpget</function> retourne un objet <acronym>SNMP</acronym> en cas de
+ succès, et <literal>FALSE</literal> en cas d'erreur.
</para>
<para>
<function>snmpget</function> sert à lire une valeur
- d'un objet SNMP représenté par
- <parameter>object_id</parameter>. L'agent SNMP est défini par
+ d'un objet <acronym>SNMP</acronym> représenté par
+ <parameter>object_id</parameter>. L'agent <acronym>SNMP</acronym> est
+défini par
<parameter>hostname</parameter> et la communauté de lecture
est spécifiée par le paramètre
<parameter>community</parameter>.
@@ -88,14 +88,14 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>snmpset</function> modifie la valeur de l'objet SNMP
- spécifié, en retournant TRUE en cas de succès
- et FALSE en cas d'erreur.
+ <function>snmpset</function> modifie la valeur de l'objet
+<acronym>SNMP</acronym>
+ spécifié, en retournant <literal>TRUE</literal> en cas de
+succès
+ et <literal>FALSE</literal> en cas d'erreur.
</para>
<para>
<function>snmpget</function> sert à affecter une valeur
- donnée à un objet SNMP, référencé
- par <parameter>object_id</parameter>. L'agent SNMP est défini
+ donnée à un objet <acronym>SNMP</acronym>,
+référencé
+ par <parameter>object_id</parameter>. L'agent <acronym>SNMP</acronym> est
+défini
par <parameter>hostname</parameter> et la communauté de lecture
est spécifiée par le paramètre
<parameter>community</parameter>.
@@ -105,7 +105,7 @@
<refentry id="function.snmpwalk">
<refnamediv>
<refname>snmpwalk</refname>
- <refpurpose>Reçoit tous les objets SNMP d'un agent.</refpurpose>
+ <refpurpose>Reçoit tous les objets <acronym>SNMP</acronym> d'un
+agent.</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
@@ -122,34 +122,38 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>snmpwalk</function> retourne un tableau d'objets SNMP,
+ <function>snmpwalk</function> retourne un tableau d'objets
+<acronym>SNMP</acronym>,
en commencant à partir de <parameter>object_id</parameter>
- comme racine, ou FALSE en cas d'erreur.
+ comme racine, ou <literal>FALSE</literal> en cas d'erreur.
</para>
<para>
<function>snmpwalk</function> sert à lire toutes les valeurs d'un
- agent SNMP, défini par <parameter>hostname</parameter>.
+ agent <acronym>SNMP</acronym>, défini par
+<parameter>hostname</parameter>.
<parameter>community</parameter> définit la communauté
de lecture de l'agent. Un objet (<parameter>object_id</parameter> = null)
- sert de racine à l'arbre d'objet SNMP et tous les objets sous cette
- racine sont retournés dans un tableau. Si
+ sert de racine à l'arbre d'objet <acronym>SNMP</acronym> et
+ tous les objets sous cette racine sont retournés dans un tableau. Si
<parameter>object_id</parameter> est spécifié, tous
- les objets SNMP sous cet objet sont retournés.
+ les objets <acronym>SNMP</acronym> sous cet objet sont retournés.
<informalexample>
<programlisting role="php">
+<?php
$a = snmpwalk("127.0.0.1", "public", "");
+?>
</programlisting>
</informalexample>
</para>
<para>
- La fonction ci-dessus va retourner tous les objets SNMP d'un agent
- SNMP qui fonctionnerait sur l'hôte local (localhost). Il suffit
+ La fonction ci-dessus va retourner tous les objets <acronym>SNMP</acronym> d'un
+agent
+ <acronym>SNMP</acronym> qui fonctionnerait sur l'hôte local (localhost).
+Il suffit
alors de faire une boucle pour travailler avec chacun des objets.
<informalexample>
<programlisting role="php">
+<?php
for ($i=0; $i<count($a); $i++) {
echo $a[$i];
}
+?>
</programlisting>
</informalexample>
</para>
@@ -180,21 +184,21 @@
<function>snmpwalkoid</function> retourne un tableau associatif,
avec les identifiants d'objet et les objets associés, pour
tous les objets situés sous la racine
- <parameter>object_id</parameter>, ou FALSE en cas d'erreur.
+ <parameter>object_id</parameter>, ou <literal>FALSE</literal> en cas d'erreur.
</para>
<para>
<function>snmpwalkoid</function> sert à lire tous les
identifiants d'objet, et leur valeurs respectives, depuis un
- serveur SNMP. <parameter>community</parameter> indique la
+ serveur <acronym>SNMP</acronym>. <parameter>community</parameter> indique la
communauté de lecture pour cet agent. Un
<parameter>object_id</parameter> null signifie qu'il faut utiliser
- la racine de l'arbre SNMP et tous les objets sous cet arbre
+ la racine de l'arbre <acronym>SNMP</acronym> et tous les objets sous cet arbre
seront retournés. Si <parameter>object_id</parameter>
- est spécifié, tous les objets SNMP situés sous
+ est spécifié, tous les objets <acronym>SNMP</acronym>
+situés sous
cet objet seront retournés.
</para>
<para>
- La fonction ci-dessous va lire tous les objets de l'agent SNMP
+ La fonction ci-dessous va lire tous les objets de l'agent
+<acronym>SNMP</acronym>
qui fonctionne sur l'hôte local. Il est alors possible de
les passer en revue avec une boucle : l'existence de
<function>snmpwalkoid</function> et <function>snmpwalk</function>
@@ -202,12 +206,14 @@
fournies pour des raisons de compatbilité ascendante.
<informalexample>
<programlisting role="php">
+<?php
$a = snmpwalkoid("127.0.0.1", "public", "");
+?>
</programlisting>
</informalexample>
</para>
<para>
- La fonction ci-dessous va lire tous les objets de l'agent SNMP
+ La fonction ci-dessous va lire tous les objets de l'agent
+<acronym>SNMP</acronym>
qui fonctionne sur l'hôte local. Il est alors possible de
les passer en revue avec une boucle :
<informalexample>
@@ -240,18 +246,20 @@
Par défaut, quick_print est inactivée.
<informalexample>
<programlisting role="php">
+<?php
$quickprint = snmp_get_quick_print();
+?>
</programlisting>
</informalexample>
</para>
<para>
- L'exemple ci-dessus devrait retourner FALSE, si
- quick_print est inactivée et, TRUE si quick_print est activée.
+ L'exemple ci-dessus devrait retourner <literal>FALSE</literal>, si
+ quick_print est inactivée et, <literal>TRUE</literal> si quick_print est
+activée.
</para>
<para>
<function>snmp_get_quick_print</function> est seulement disponible avec la
- librairie UCD SNMP. Cette fonction n'est pas disponible avec la librairie
- Windows SNMP.
+ librairie UCD <acronym>SNMP</acronym>. Cette fonction n'est pas disponible avec
+la librairie
+ Windows <acronym>SNMP</acronym>.
</para>
<para>
Voir : <function>snmp_set_quick_print</function> pour une description
@@ -275,8 +283,8 @@
</funcsynopsis>
<para>
<function>snmp_set_quick_print</function> fixe la valeur de
- l'option quick_print de la librairie UCD SNMP. Lorsqu'elle a
- la valeur de (1), la librairie SNMP retournera des valeurs
+ l'option quick_print de la librairie UCD <acronym>SNMP</acronym>. Lorsqu'elle a
+ la valeur de (1), la librairie <acronym>SNMP</acronym> retournera des valeurs
'rapides'. Cela signifie que seule, la valeur sera
retournée. Lorsqu'elle a la valeur de (0), la librairie
va afficher d'autres informations (telles que l'adresse IP
@@ -305,7 +313,7 @@
activée, seul '0:00:00.00' sera affiché.
</para>
<para>
- Par défaut, UCD SNMP retourne des valeurs
+ Par défaut, UCD <acronym>SNMP</acronym> retourne des valeurs
détaillées, et quick_print sert à ne
retourner que la valeur.
</para>
@@ -316,8 +324,9 @@
</para>
<para>
<function>snmp_set_quick_print</function> ne fonctionne
- qu'avec la librairie UCD SNMP. Cette fonction n'est pas
- disponible avec la librairie Windows SNMP.
+ qu'avec la librairie UCD <acronym>SNMP</acronym>.
+ <function>snmp_set_quick_print</function> n'est pas
+ disponible avec la librairie Windows <acronym>SNMP</acronym>.
</para>
</refsect1>
</refentry>
Index: phpdoc/fr/functions/sockets.xml
diff -u phpdoc/fr/functions/sockets.xml:1.3 phpdoc/fr/functions/sockets.xml:1.4
--- phpdoc/fr/functions/sockets.xml:1.3 Wed Dec 6 05:01:02 2000
+++ phpdoc/fr/functions/sockets.xml Mon Jan 22 03:58:33 2001
@@ -1,5 +1,5 @@
<reference id="ref.sockets">
- <title>Socket</title>
+ <title>Sockets</title>
<titleabbrev>Sockets</titleabbrev>
<partintro>
<simpara>
@@ -7,61 +7,51 @@
fonctions de communication par socket. Cela permet de mettre en place
un serveur aussi bien qu'un client.
</simpara>
-
<para>
- Pour une interface client plus générique, reportez vous à
+ Pour une interface client plus générique, reportez vous à
<function>fsockopen</function> et <function>pfsockopen</function>.
</para>
-
<para>
Lorsque vous utiliserez les fonctions de sockets qui sont décrites ici,
gardez bien à l'esprit que même si elles ont souvent des noms
identiques
aux fonctions C, elles ont souvent des prototypes différents. Lisez
attentivement
la documentation pour éviter les confusions.
</para>
-
<para>
Cela dit, ceux qui n'ont pas l'habitude de la programmation avec les sockets
pourront trouver beaucoup de documentation pertinente dans les pages de
manuel Unix, et de nombreux tutorial de programmation C sur le web, dont la
plus part peuvent être repris après de légère
modifications, en PHP.
</para>
-
<para>
<example>
<title>Exemple de programmation Socket : serveur TCP/IP</title>
<para>
Cet exemple est un serveur perroquete : tout ce que vous lui envoyez
- vous est retourné. Changez les variables
+ vous est retourné. Changez les variables
<varname>address</varname> et <varname>port</varname> pour les adapter à
votre configuration, et lancez le script. Vous pouvez vous connecter
au serveur avec une commande telle que <command>telnet 192.168.1.53
10000</command>
- (avec l'adresse et le port qui sont ceux de votre configuration).
+ (avec l'adresse et le port qui sont ceux de votre configuration).
Pour vous déconnecter, tapez 'quit'.
</para>
- <programlisting>
+ <programlisting role="php">
<?php
error_reporting(E_ALL);
-
/* On autorise le script à attendre les connexions indéfiniment. */
set_time_limit(0);
-
/* Modifiez ces valeurs pour qu'elles soient celles de votre configuration */
$address = '192.168.1.53';
$port = 10000;
-
if (($sock = socket(AF_INET, SOCK_STREAM, 0)) < 0) {
echo "socket() a échoué : raison : " . strerror($sock) . "\n";
}
-
if (($ret = bind($sock, $address, $port)) < 0) {
echo "bind() a échoué : raison: " . strerror($ret) . "\n";
}
-
if (($ret = listen($sock, 5)) < 0) {
echo "listen() a échoué : raison: " . strerror($ret) . "\n";
}
-
do {
if (($msgsock = accept_connect($sock)) < 0) {
echo "accept_connect() a échoué : raison : " .
strerror($msgsock) . "\n";
@@ -85,16 +75,14 @@
$talkback = "PHP: Vous avez dit '$buf'.\n";
write($msgsock, $talkback, strlen($talkback));
echo "$buf\n";
- } while (true);
+ } while (<literal>TRUE</literal>);
close($msgsock);
-} while (true);
-
+} while (<literal>TRUE</literal>);
close($sock);
-?>
+?>
</programlisting>
</example>
</para>
-
<para>
<example>
<title>Exemple avec les sockets : Client TCP/IP</title>
@@ -102,18 +90,14 @@
Cet exemple est un client HTTP basique. Il se connecte à une page
envoi les entêtes (requête HEAD), affiche le retour, et quitte.
</para>
- <programlisting>
+ <programlisting role="php">
<?php
error_reporting(E_ALL);
-
echo "<h2>TCP/IP Connection</h2>\n";
-
/* Demande le port du service WWW. */
$service_port = getservbyname('www', 'tcp');
-
/* Demande l'IP du serveur de destination. */
$address = gethostbyname('www.php.net');
-
/* Crée la connexion TCP/IP. */
$socket = socket(AF_INET, SOCK_STREAM, 0);
if ($socket < 0) {
@@ -121,7 +105,6 @@
} else {
"socket() réussi: " . strerror($socket) . "\n";
}
-
echo "Connexion à '$address' on port '$service_port'...";
$result = connect($socket, $address, $service_port);
if ($result < 0) {
@@ -129,29 +112,23 @@
} else {
echo "OK.\n";
}
-
$in = "HEAD / HTTP/1.0\r\n\r\n";
$out = '';
-
echo "Envoi des entêtes HTTP HEAD...";
write($socket, $in, strlen($in));
echo "OK.\n";
-
echo "Lecture de la réponse :\n\n";
while (read($socket, $out, 2048)) {
echo $out;
}
-
echo "Fermeture de la socket...";
close($socket);
echo "OK.\n\n";
-?>
+?>
</programlisting>
</example>
</para>
-
</partintro>
-
<refentry id="function.accept-connect">
<refnamediv>
<refname>accept_connect</refname>
@@ -165,44 +142,38 @@
<paramdef>int <parameter>socket</parameter></paramdef>
</funcprototype>
</funcsynopsis>
-
<para>
Une fois que la socket <parameter>socket</parameter> a été
créé, avec la
fonction <function>socket</function>, liée à un nom avec
<function>bind</function>,
- et mise en attente de connexion avec <function>listen</function>,
+ et mise en attente de connexion avec <function>listen</function>,
<function>accept_connect</function> accepte les connexions sur la socket
<parameter>socket</parameter>. Une fois que la connexion est faite,
un nouveau pointeur de socket est retourné, pour utilisation
ultérieure.
Si il n'y a pas de connexion en attente, <function>accept_connect</function>
se bloquera jusqu'à une connexion soit disponible. Si
<parameter>socket</parameter>
- a été configurée comme non-bloquante, avec
+ a été configurée comme non-bloquante, avec
<function>socket_set_blocking</function>, une erreur sera retournée.
</para>
-
<para>
Le pointeur de socket retourné par <function>accept_connect</function>
- ne peut plus accepter de nouvelles connexion. La socket originale,
+ ne peut plus accepter de nouvelles connexion. La socket originale,
<parameter>socket</parameter>, reste ouverte, et peut être
réutilisée.
</para>
-
<para>
Retourne une nouveau pointeur de socket en cas de succès, ou une erreur
négative en cas d'erreur. Ce code peut être passé à
la fonction
<function>strerror</function> pour obtenir un message d'erreur lisible.
</para>
-
<para>
- Voir aussi
+ Voir aussi
<function>bind</function>,
<function>connect</function>,
<function>listen</function>,
<function>socket</function>, et
<function>strerror</function>.
</para>
-
</refsect1>
</refentry>
-
<refentry id="function.bind">
<refnamediv>
<refname>bind</refname>
@@ -215,48 +186,41 @@
<funcdef>int <function>bind</function></funcdef>
<paramdef>int <parameter>socket</parameter></paramdef>
<paramdef>string <parameter>address</parameter></paramdef>
- <paramdef>int
+ <paramdef>int
<parameter><optional>protocol</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
-
<para>
<function>bind</function> lie le nom <parameter>address</parameter>,
à la socket <parameter>socket</parameter>, qui doit être une socket
valide, créée avec <function>socket</function>.
</para>
-
<para>
- <parameter>address</parameter> peut être une adresse IP numérique
+ <parameter>address</parameter> peut être une adresse IP numérique
(e.g. <literal>127.0.0.1</literal>), is la socket est de la famille
<constant>AF_INET</constant>; ou bien un chemin d'un domaine UNIX, si la
socket est de la famille des <constant>AF_UNIX</constant>.
</para>
-
<para>
<parameter>port</parameter> sert uniquement dans le cas des sockets de type
<constant>AF_INET</constant> et désigne le port de connexion sur
l'hôte distant.
</para>
-
<para>
- Retourne zéro en cas de succès, et une erreur négative en
cas d'échec.
+ Retourne zéro en cas de succès, et une erreur négative en
+cas d'échec.
Ce code peut être passé à la fonction
<function>strerror</function> pour obtenir un message d'erreur lisible.
</para>
-
<para>
- Voir aussi
+ Voir aussi
<function>accept_connect</function>,
<function>connect</function>,
<function>listen</function>,
<function>socket</function>, et
<function>strerror</function>.
</para>
-
</refsect1>
</refentry>
-
<refentry id="function.close">
<refnamediv>
<refname>close</refname>
@@ -270,12 +234,10 @@
<paramdef>int <parameter>socket</parameter></paramdef>
</funcprototype>
</funcsynopsis>
-
<para>
- <function>close</function> ferme le fichier (ou la socket)
+ <function>close</function> ferme le fichier (ou la socket)
<parameter>socket</parameter>.
</para>
-
<para>
Notez que <function>close</function> ne doit pas être utilisée avec
des pointeurs de fichiers créé par <function>fopen</function>,
@@ -283,20 +245,16 @@
<function>pfsockopen</function>; elle ne sert que pour les sockets
créées avec <function>socket</function> ou
<function>accept_connect</function>.
</para>
-
<para>
- Retourne True en cas de succès, ou false en cas d'erreur(i.e.,
+ Retourne <literal>TRUE</literal> en cas de succès, ou
+<literal>FALSE</literal> en cas d'erreur(i.e.,
<parameter>socket</parameter> est invalide).
</para>
-
<para>
Voir aussi <function>bind</function>, <function>listen</function>,
<function>socket</function>, et <function>strerror</function>.
</para>
-
</refsect1>
</refentry>
-
<refentry id="function.connect">
<refnamediv>
<refname>connect</refname>
@@ -309,46 +267,39 @@
<funcdef>int <function>connect</function></funcdef>
<paramdef>int <parameter>socket</parameter></paramdef>
<paramdef>string <parameter>address</parameter></paramdef>
- <paramdef>int
+ <paramdef>int
<parameter><optional>port</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
-
<para>
- Initie une connexion avec la socket <parameter>socket</parameter>,
+ Initie une connexion avec la socket <parameter>socket</parameter>,
qui doit être une socket valide, créée avec
<function>socket</function>.
</para>
-
<para>
- <parameter>address</parameter> peut être une adresse IP numérique
+ <parameter>address</parameter> peut être une adresse IP numérique
(e.g. <literal>127.0.0.1</literal>), is la socket est de la famille
<constant>AF_INET</constant>; ou bien un chemin d'un domaine UNIX, si la
socket est de la famille des <constant>AF_UNIX</constant>.
</para>
-
<para>
<parameter>port</parameter> sert uniquement dans le cas des sockets de type
<constant>AF_INET</constant> et désigne le port de connexion sur
l'hôte distant.
</para>
-
<para>
- Retourne zéro en cas de succès, et une erreur négative en
cas d'échec.
+ Retourne zéro en cas de succès, et une erreur négative en
+cas d'échec.
Ce code peut être passé à la fonction
<function>strerror</function> pour obtenir un message d'erreur lisible.
</para>
-
<para>
- Voir aussi
+ Voir aussi
<function>bind</function>,
<function>listen</function>,
<function>socket</function>, et
<function>strerror</function>.
</para>
-
</refsect1>
</refentry>
-
<refentry id="function.listen">
<refnamediv>
<refname>listen</refname>
@@ -363,37 +314,31 @@
<paramdef>int <parameter>backlog</parameter></paramdef>
</funcprototype>
</funcsynopsis>
-
<para>
- Une fois que la socket <parameter>socket</parameter> a été
créée avec
+ Une fois que la socket <parameter>socket</parameter> a été
+créée avec
<function>socket</function> et liée avec <function>bind</function>, elle
peut être
mise en attente de connexion entrante. Un maximum de
<parameter>backlog</parameter>
connexion entrantes seront mises en attente de traitement.
</para>
-
<para>
- <function>listen</function> ne fonctionne qu'avec des sockets de type
+ <function>listen</function> ne fonctionne qu'avec des sockets de type
<literal>SOCK_STREAM</literal> et <literal>SOCK_SEQPACKET</literal>.
</para>
-
<para>
- Retourne zéro en cas de succès, et une erreur négative en
cas d'échec.
+ Retourne zéro en cas de succès, et une erreur négative en
+cas d'échec.
Ce code peut être passé à la fonction
<function>strerror</function> pour obtenir un message d'erreur lisible.
</para>
-
<para>
- Voir aussi
+ Voir aussi
<function>accept_connect</function>,
<function>bind</function>,
<function>connect</function>,
<function>socket</function>, et
<function>strerror</function>.
</para>
-
</refsect1>
</refentry>
-
<refentry id="function.read">
<refnamediv>
<refname>read</refname>
@@ -410,27 +355,26 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>read</function> lit sur la socket
- <parameter>socket_des</parameter> créée avec
+ <function>read</function> lit sur la socket
+ <parameter>socket_des</parameter> créée avec
<function>accept_connect</function>, et place le résultat dans
- le buffer <parameter>&buffer</parameter>,
+ le buffer <parameter>&buffer</parameter>,
<parameter>length</parameter> octets. Vous pouvez aussi
- utiliser \n, \t ou \0 pour terminer la lecture.
+ utiliser \n, \t ou \0 pour terminer la lecture.
Le nombre d'octets lus est retourné.
</para>
<para>
- Voir aussi
+ Voir aussi
<function>accept_connect</function>,
<function>bind</function>,
<function>connect</function>,
<function>listen</function>,
<function>strerror</function>,
<function>socket_get_status</function> et
- <function>write</function>.
+ <function>write</function>.
</para>
</refsect1>
</refentry>
-
<refentry id="function.socket">
<refnamediv>
<refname>socket</refname>
@@ -446,53 +390,44 @@
<paramdef>int <parameter>protocol</parameter></paramdef>
</funcprototype>
</funcsynopsis>
-
<para>
Crée un point de communication, dit socket, et retourne un pointeur de
- socket.
+ socket.
</para>
-
<para>
<parameter>domain</parameter> représente le domaine. Actuellement, ce peut
être <constant>AF_INET</constant> et <constant>AF_UNIX</constant>.
</para>
-
<para>
- <parameter>type</parameter> selectionne le type de socket.
+ <parameter>type</parameter> selectionne le type de socket.
Il peut prendre les valeurs suivantes : <constant>SOCK_STREAM</constant>,
<constant>SOCK_DGRAM</constant>, <constant>SOCK_SEQPACKET</constant>,
<constant>SOCK_RAW</constant>, <constant>SOCK_RDM</constant>, ou
<constant>SOCK_PACKET</constant>.
</para>
-
<para>
<parameter>protocol</parameter> choisit le protocole.
</para>
-
<para>
- Retourne un pointeur de socket valide en cas de succès, et une erreur
négative
+ Retourne un pointeur de socket valide en cas de succès, et une erreur
+négative
en cas d'échec. Ce code peut être passé à la fonction
<function>strerror</function> pour obtenir un message d'erreur lisible.
</para>
-
<para>
For more information on the usage of <function>socket</function>,
as well as on the meanings of the various parameters, see the
Unix man page <filename>socket (2)</filename>.
</para>
-
<para>
- Voir aussi
+ 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.strerror">
<refnamediv>
<refname>strerror</refname>
@@ -506,7 +441,6 @@
<paramdef>int <parameter>errno</parameter></paramdef>
</funcprototype>
</funcsynopsis>
-
<para>
<function>strerror</function> prend comme paramètre
<parameter>errno</parameter>
la valeur négative de retour d'une fonction de socket, et retourne
l'explication
@@ -515,45 +449,35 @@
rechercher la signification dans les fichiers systèmes, il suffit de la
passer à <function>strerror</function>, pour savoir ce qui s'est
passé.
</para>
-
<para>
<example>
<title>Exemple avec <function>strerror</function></title>
- <programlisting>
+ <programlisting role="php">
<?php
if (($socket = socket(AF_INET, SOCK_STREAM, 0)) < 0) {
echo "socket() a échoué : raison: " . strerror($socket) . "\n";
-}
-
+}
if (($ret = bind($socket, '127.0.0.1', 80)) < 0) {
echo "bind() a échoué : raison: " . strerror($ret) . "\n";
}
-?>
+?>
</programlisting>
-
<para>
- Le résultat de l'exemple ci dessus (en supposant que le script n'est
pas exécuté
- avec les droits du root) :
+ Le résultat de l'exemple ci dessus (en supposant que le script
+ n'est pas exécuté avec les droits du root) :
<screen>
bind() a échoué : raison : Permission denied
</screen>
</para>
-
</example>
</para>
-
<para>
- Voir aussi
- <function>accept_connect</function>,
- <function>bind</function>,
- <function>connect</function>,
- <function>listen</function>, et
+ Voir aussi <function>accept_connect</function>, <function>bind</function>,
+ <function>connect</function>, <function>listen</function> et
<function>socket</function>.
</para>
-
</refsect1>
</refentry>
-
<refentry id="function.write">
<refnamediv>
<refname>write</refname>
@@ -570,25 +494,19 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>write</function> écrit sur la socket
+ <function>write</function> écrit sur la socket
<parameter>socket_des</parameter>, <parameter>length</parameter>
octets issus du buffer <parameter>&buffer</parameter>.
</para>
<para>
- Voir aussi
- <function>accept_connect</function>,
- <function>bind</function>,
- <function>connect</function>,
- <function>listen</function>,
- <function>read</function>,
- <function>strerror</function>, et
+ Voir aussi <function>accept_connect</function>, <function>bind</function>,
+ <function>connect</function>, <function>listen</function>,
+ <function>read</function>, <function>strerror</function> et
<function>socket_get_status</function>.
</para>
</refsect1>
</refentry>
-
</reference>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
@@ -605,4 +523,3 @@
sgml-local-ecat-files:nil
End:
-->
-
Index: phpdoc/fr/functions/strings.xml
diff -u phpdoc/fr/functions/strings.xml:1.17 phpdoc/fr/functions/strings.xml:1.18
--- phpdoc/fr/functions/strings.xml:1.17 Tue Dec 26 03:33:28 2000
+++ phpdoc/fr/functions/strings.xml Mon Jan 22 03:58:33 2001
@@ -1,5 +1,5 @@
<reference id="ref.strings">
- <title>Fonctions de chaîne de caractères</title>
+ <title>Chaîne de caractères</title>
<titleabbrev>Chaînes</titleabbrev>
<partintro>
<simpara>
@@ -38,7 +38,7 @@
<literal>\n</literal>, <literal>\r</literal> etc. sont échappés.
En langage C, les caractères avec un code ASCII inférieur
à 32 ou supérieur à 126 sont convertis en
- représentation octale. Faites bien attention lorsque vous
+ représentation octale. Faîtes bien attention lorsque vous
échappez des caractères alpha-numériques.
Vous pouvez spécifier un intervalle dans <parameter>charlist</parameter>
comme "\0..\37", qui échappera les caractères compris
@@ -46,19 +46,20 @@
<example>
<title>Exemple avec <function>addcslashes</function></title>
<programlisting role="php">
-$escaped = addcslashes ($no_echappe, "\0..\37!@\177..\377");
+<?php
+$escaped = addcslashes($no_echappe, "\0..\37!@\177..\377");
+?>
</programlisting>
</example>
<note>
<simpara>
- Ajouté dans PHP4b3-dev.</simpara>
+ <function>addcslashes</function> a été ajouté dans PHP
+4.0b3-dev.
+ </simpara>
</note>
</para>
<para>
- Voir aussi <function>stripcslashes</function>,
- <function>stripslashes</function>,
- <function>htmlspecialchars</function>,
- <function>htmlspecialchars</function>, et
+ Voir aussi <function>stripcslashes</function>, <function>stripslashes</function>,
+ <function>htmlspecialchars</function>, <function>htmlspecialchars</function> et
<function>quotemeta</function>.
</para>
</refsect1>
@@ -94,7 +95,7 @@
<refnamediv>
<refname>bin2hex</refname>
<refpurpose>
- Converti une valeur binaire en hexadécimal
+ Convertit une valeur binaire en hexadécimal
</refpurpose>
</refnamediv>
<refsect1>
@@ -132,7 +133,9 @@
<example>
<title>Exemple avec <function>chop</function></title>
<programlisting role="php">
-$trimmed = chop ($line);
+<?php
+$trimmed = chop($line);
+?>
</programlisting>
</example>
</para>
@@ -163,16 +166,19 @@
</funcprototype>
</funcsynopsis>
<para>
- Retourne le caractère de code ASCII <parameter>ascii</parameter>.
+ <function>chr</function> retourne le caractère de code ASCII
+ <parameter>ascii</parameter>.
<example>
<title>Exemple avec <function>chr</function></title>
<programlisting role="php">
-$str .= chr (27); /* ajoute un échappement à la fin de la chaîne
$str */
+<?php
+$str .= chr(27); /* ajoute un échappement à la fin de la chaîne
+$str */
/* Généralement, ceci est plus efficace */
-$str = sprintf ("Cette chaîne se termine par un escape: %c", 27);
+$str = sprintf("Cette chaîne se termine par un escape: %c", 27);
+?>
</programlisting>
</example>
- Cette fonction est le contraire de <function>ord</function>.
+ <function>chr</function> est le contraire de <function>ord</function>.
Voir aussi <function>sprintf</function> avec le format de chaîne
<literal>%c</literal>.
</para>
@@ -198,8 +204,8 @@
</funcprototype>
</funcsynopsis>
<para>
- Permet de scinder une chaîne en plus petit morceaux, comme dans
- le cas de la conversion en
+ <function>chunk_split</function> permet de scinder une chaîne en
+ plus petit morceaux, comme dans le cas de la conversion en
<link linkend="function.base64-encode">base64_encode</link> pour se
conformer à la RFC 2045. Cette fonction insère une fin
de chaîne <parameter>end</parameter> (par défaut "\r\n"),
@@ -209,14 +215,17 @@
<example>
<title>Exemple avec <function>chunk_split</function></title>
<programlisting role="php">
+<?php
# formate $data avec la sémantique RFC 2045
-$new_string = chunk_split (base64_encode($data));
+$new_string = chunk_split(base64_encode($data));
+?>
</programlisting>
</example>
- Cette fonction est nettement plus rapide que <function>ereg_replace</function>.
+ <function>chunk_split</function> est nettement plus rapide que
+ <function>ereg_replace</function>.
<note>
<para>
- Cette fonction a été ajoutée en 3.0.6.
+ <function>chunk_split</function> a été ajoutée en 3.0.6.
</para>
</note>
</para>
@@ -226,7 +235,7 @@
<refnamediv>
<refname>convert_cyr_string</refname>
<refpurpose>
- Converti la chaîne d'un alphabet cyrillique vers un autre.
+ Convertit la chaîne d'un alphabet cyrillique vers un autre.
</refpurpose>
</refnamediv>
<refsect1>
@@ -240,11 +249,11 @@
</funcprototype>
</funcsynopsis>
<para>
- Cette fonction convertit la chaîne donnée depuis un
- alphabet cyrillique vers un autre. Les arguments <parameter>from</parameter>
- et <parameter>to</parameter> sont des caractères qui
- représentent la source et la destination.
- Les valeurs acceptées :
+ <function>convert_cyr_string</function> convertit la chaîne
+ donnée depuis un alphabet cyrillique vers un autre. Les
+ arguments <parameter>from</parameter> et <parameter>to</parameter>
+ sont des caractères qui représentent la source et
+ la destination. Les valeurs acceptées :
<itemizedlist>
<listitem>
<simpara>
@@ -476,11 +485,13 @@
<example>
<title>Exemple avec <function>echo</function></title>
<programlisting role="php">
+<?php
echo "Bonjour Monde";
echo "Cet echo se
répartis sur plusieurs lignes. Les nouvelles lignes
seront aussi affichées";
echo "et echo se\nrépartis sur plusieurs lignes. Les nouvelles lignes\nseront
aussi affichées.";
+?>
</programlisting>
</example>
</para>
@@ -523,16 +534,18 @@
<example>
<title>Exemple avec <function>explode</function></title>
<programlisting role="php">
+<?php
$pizza = "piece1 piece2 piece3 piece4 piece5 piece6";
-$pieces = explode (" ", $pizza);
+$pieces = explode(" ", $pizza);
+?>
</programlisting>
</example>
</para>
<note>
<para>
- Le paramètre <parameter>limit</parameter> a été
+ Le paramètre <parameter>limit</parameter> a été
ajouté en PHP 4.0.1.
- </para>
+ </para>
</note>
<note>
<para>
@@ -575,9 +588,11 @@
<example>
<title>Exemple de table de traduction</title>
<programlisting role="php">
-$trans = get_html_translation_table (HTML_ENTITIES);
+<?php
+$trans = get_html_translation_table(HTML_ENTITIES);
$str = "Hallo & <Frau> & Krämer";
-$encoded = strtr ($str, $trans);
+$encoded = strtr($str, $trans);
+?>
</programlisting>
</example>
La variable <literal>$encoded</literal> va contenir désormais : "Hallo
@@ -590,8 +605,10 @@
direction de traduction :
<informalexample>
<programlisting role="php">
-$trans = array_flip ($trans);
-$original = strtr ($str, $trans);
+<?php
+$trans = array_flip($trans);
+$original = strtr($str, $trans);
+?>
</programlisting>
</informalexample>
Le contenu de <literal>$original</literal> sera : "Hallo & <Frau> &
Krämer".
@@ -631,23 +648,25 @@
Ouvre le fichier <parameter>filename</parameter> et l'analyse ligne par ligne,
en recherchant les balises <meta>.
<example>
- <title>Meta Tags Example</title>
+ <title>Exemple avec les balises méta</title>
<programlisting role="html">
+<?php
<meta name="author" content="name">
<meta name="tags" content="php3 documentation">
</head> <!-- parsing stops here -->
+?>
</programlisting>
</example>
- (Faites bien attention aux fins de lignes. PHP utilise une fonction
+ (Faîtes bien attention aux fins de lignes. PHP utilise une fonction
native pour analyser le fichier d'entrée, ce qui fait que les
- fichiers faits sous Mac ne fonctionneront pas sous Unix).
+ fichiers créés sous MacOS ne fonctionneront pas sous Unix).
</para>
<para>
Le nom d'une propriété devient sa clé, et la
valeur devient la valeur dans le tableau associatif retourné,
ce qui rend aisé la manipulation des informations. Les
caractères spéciaux dans la nom de la propriété
- sont remplacés par des '_', le reste est converti en minuscule.
+ sont remplacés par des '_', le reste est converti en minuscules.
</para>
<para>
Mettre <parameter>use_include_path</parameter> à 1 forcera PHP
@@ -659,7 +678,7 @@
<refnamediv>
<refname>hebrev</refname>
<refpurpose>
- Converti un texte Hebreux logique en texte visual
+ Convertit un texte Hébreux logique en texte visual
</refpurpose>
</refnamediv>
<refsect1>
@@ -688,7 +707,7 @@
<refnamediv>
<refname>hebrevc</refname>
<refpurpose>
- Converti un texte hébreux logique en texte visuel
+ Convertit un texte hébreux logique en texte visuel
avec les nouvelles lignes de conversion.
</refpurpose>
</refnamediv>
@@ -706,7 +725,7 @@
<para>
<function>hebrevc</function> est similaire à
<function>hebrev</function>, au détail près
- qu'elle converti les nouvelles lignes (\n) en "<br>\n".
+ qu'elle convertit les nouvelles lignes (\n) en "<br>\n".
Le paramètre optionnel <parameter>max_chars_per_line</parameter>
indique le nombre maximum de caractères par ligne
qui seront générés. La fonction essaie
@@ -721,7 +740,7 @@
<refnamediv>
<refname>htmlentities</refname>
<refpurpose>
- Converti tous les caractères spéciaux en équivalent HTML.
+ Convertit tous les caractères spéciaux en équivalent HTML.
</refpurpose>
</refnamediv>
<refsect1>
@@ -748,7 +767,7 @@
<para>
Actuellement, le jeu de caractères ISO-8859-1 character
est utilisé. Notez que l'argument optionnel
- a été ajouté PHP 3.0.17 and PHP 4.0.3.
+ a été ajouté PHP 3.0.17 et PHP 4.0.3.
</para>
<para>
Voir aussi <function>htmlspecialchars</function> et <function>nl2br</function>.
@@ -759,7 +778,7 @@
<refnamediv>
<refname>htmlspecialchars</refname>
<refpurpose>
- Converti tous les caractères spéciaux en équivalent HTML.
+ Convertit tous les caractères spéciaux en équivalent HTML.
</refpurpose>
</refnamediv>
<refsect1>
@@ -802,7 +821,7 @@
</listitem>
<listitem>
<simpara>
- '"' guillement double) devient '&quot;' si ENT_NOQUOTES n'est pas
actif.
+ '"' (guillemet double) devient '&quot;' si ENT_NOQUOTES n'est pas
+actif.
</simpara>
</listitem>
<listitem>
@@ -830,7 +849,9 @@
<example>
<title>Exemple avec <function>htmlspecialchars</function></title>
<programlisting role="php">
-$new = htmlspecialchars("<a href='test'>Test</a>", ENT_QUOTES);
+<?php
+$new = htmlspecialchars("<a href='test'>Test</A>", ENT_QUOTES);
+?>
</programlisting>
</example>
<para>
@@ -838,7 +859,7 @@
ceux listés ci-dessus. Pour une traduction complète
de toutes les balises, reportez vous à
<function>htmlentities</function>. Notez que l'argument optionnel
- a été ajouté PHP 3.0.17 and PHP 4.0.3.
+ a été ajouté PHP 3.0.17 et PHP 4.0.3.
</para>
<para>
Voir aussi <function>htmlentities</function> et <function>nl2br</function>.
@@ -870,7 +891,9 @@
<example>
<title>Exemple avec <function>implode</function></title>
<programlisting role="php">
-$colon_separated = implode (":", $array);
+<?php
+$colon_separated = implode(":", $array);
+?>
</programlisting>
</example>
</para>
@@ -1037,6 +1060,192 @@
</para>
</refsect1>
</refentry>
+ <refentry id="function.localeconv">
+ <refnamediv>
+ <refname>localeconv</refname>
+ <refpurpose>Lit le formatage numérique et monétaire</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>localeconv</function></funcdef>
+ <void/>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>localeconv</function> retourne un tableau associatif contenant
+ 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 :
+ <informaltable >
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>Index</entry>
+ <entry>Description</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>decimal_point</entry>
+ <entry>Séparateur décimal</entry>
+ </row>
+ <row>
+ <entry>thousands_sep</entry>
+ <entry>Séparateur de milliers</entry>
+ </row>
+ <row>
+ <entry>grouping</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>
+ </row>
+ <row>
+ <entry>currency_symbol</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>
+ </row>
+ <row>
+ <entry>mon_thousands_sep</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>
+ </row>
+ <row>
+ <entry>positive_sign</entry>
+ <entry>Signe des valeurs positives</entry>
+ </row>
+ <row>
+ <entry>negative_sign</entry>
+ <entry>Signe des valeurs négatives</entry>
+ </row>
+ <row>
+ <entry>int_frac_digits</entry>
+ <entry>Nombre de chiffres décimaux international</entry>
+ </row>
+ <row>
+ <entry>frac_digits</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>
+ </row>
+ <row>
+ <entry>p_sep_by_space</entry>
+ <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>
+ </row>
+ <row>
+ <entry>n_sep_by_space</entry>
+ <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">
+ <entry>p_sign_posn</entry>
+ <entry>
+ <simplelist columns="2" type="horiz">
+ <member>0</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>2</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>4</member>
+ <member>Le signe suit immédiatement currency_symbol</member>
+ </simplelist>
+ </entry>
+ </row>
+ <row valign="top">
+ <entry>n_sign_posn</entry>
+ <entry>
+ <simplelist columns="2" type="horiz">
+ <member>0</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>2</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>4</member>
+ <member>Le signe suit immédiatement currency_symbol</member>
+ </simplelist>
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </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.
+ </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 "--------------------------------------------\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";
+echo "mon_thousands_sep: {$locale_info["mon_thousands_sep"]}\n";
+echo "positive_sign: {$locale_info["positive_sign"]}\n";
+echo "negative_sign: {$locale_info["negative_sign"]}\n";
+echo "int_frac_digits: {$locale_info["int_frac_digits"]}\n";
+echo "frac_digits: {$locale_info["frac_digits"]}\n";
+echo "p_cs_precedes: {$locale_info["p_cs_precedes"]}\n";
+echo "p_sep_by_space: {$locale_info["p_sep_by_space"]}\n";
+echo "n_cs_precedes: {$locale_info["n_cs_precedes"]}\n";
+echo "n_sep_by_space: {$locale_info["n_sep_by_space"]}\n";
+echo "p_sign_posn: {$locale_info["p_sign_posn"]}\n";
+echo "n_sign_posn: {$locale_info["n_sign_posn"]}\n";
+echo "</PRE>\n";
+ </programlisting>
+ </example>
+ <para>
+ La constante CHAR_MAX est aussi définie ci-dessus.
+ </para>
+ <note>
+ <para>
+ Ajouté en PHP 4.0.5
+ </para>
+ </note>
+ <para>
+ Voir aussi : <function>setlocale</function>.
+ </para>
+ </refsect1>
+ </refentry>
<refentry id="function.ltrim">
<refnamediv>
<refname>ltrim</refname>
@@ -1122,7 +1331,7 @@
<refentry id="function.nl2br">
<refnamediv>
<refname>nl2br</refname>
- <refpurpose>Converti les nouvelles lignes en HTML (<BR≶).</refpurpose>
+ <refpurpose>Convertit les nouvelles lignes en HTML (<BR≶).</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
@@ -1163,9 +1372,11 @@
<example>
<title>Exemple avec <function>ord</function></title>
<programlisting role="php">
-if (ord ($str) == 10) {
+<?php
+if (ord($str) == 10) {
echo "Le premier caractère de \$str est un retour chariot.\n";
}
+?>
</programlisting>
</example>
</para>
@@ -1199,11 +1410,13 @@
<example>
<title>Utilisation de <function>parse_str</function></title>
<programlisting role="php">
+<?php
$str = "first=valeur&second[]=ceci+marche&second[]=encore";
parse_str($str);
echo $first; /* affiche "valeur" */
echo $second[0]; /* affiche "ceci marche" */
echo $second[1]; /* affiche "encore" */
+?>
</programlisting>
</example>
</para>
@@ -1304,14 +1517,11 @@
<function>quotemeta</function> retourne une version de la
chaîne <parameter>str</parameter>, avec un antislash
(<literal>\</literal>) devant tous les caractères de la liste
- ci-dessous :
-<screen>. \\ + * ? [ ^ ] ( $ )</screen>
+ ci-dessous : <screen>. \\ + * ? [ ^ ] ( $ )</screen>.
</para>
<simpara>
- Voir aussi <function>addslashes</function>,
- <function>htmlentities</function>,
- <function>htmlspecialchars</function>,
- <function>nl2br</function>, et
+ Voir aussi <function>addslashes</function>, <function>htmlentities</function>,
+ <function>htmlspecialchars</function>, <function>nl2br</function> et
<function>stripslashes</function>.
</simpara>
</refsect1>
@@ -1336,12 +1546,14 @@
<example>
<title>Exemple avec <function>rtrim</function> example</title>
<programlisting role="php">
-$trimmed = rtrim ($line);
+<?php
+$trimmed = rtrim($line);
+?>
</programlisting>
</example>
</para>
<para>
- Voir aussi <function>trim</function>, <function>ltrim</function>, and
+ Voir aussi <function>trim</function>, <function>ltrim</function>, et
<function>rtrim</function>.
</para>
</refsect1>
@@ -1374,21 +1586,24 @@
<example>
<title>Exemple avec <function>sscanf</function></title>
<programlisting role="php">
+<?php
// lecture d'un numéro de série
$serial = sscanf("SN/2350001","SN/%d");
// et la date de fabrication
$mandate = "January 01 2000";
list($month, $day, $year) = sscanf($mandate,"%s %d %d");
echo "Le produit $serial a été fabriqué le:
$year-".substr($month,0,3)."-$day\n";
+?>
</programlisting>
</example>
Si les paramètres optionnels sont passés,
<function>sscanf</function> retournera le nombre de valeurs
assignés. Les options doivent être passés
par référence.
- <example>
- <title>Utilisation des options avec <function>sscanf</function></title>
- <programlisting role="php">
+ <example>
+ <title>Utilisation des options avec <function>sscanf</function></title>
+ <programlisting role="php">
+<?php
// Lecture des informations d'auteur, et génération
// d'une entrée DocBook
$auth = "24\tVictor Hugo";
@@ -1397,6 +1612,7 @@
<Prénom>$first</firstname>
<Nom>$last</surname>
</auteur>\n";
+?>
</programlisting>
</example>
</para>
@@ -1432,8 +1648,8 @@
</listitem>
<listitem>
<simpara>
- LC_COLLATE pour les comparaison de chaîne (en cours
- d'implémentation)
+ LC_COLLATE pour les comparaisons de chaîne
+ (voir <function>strcoll</function>)
</simpara>
</listitem>
<listitem>
@@ -1473,7 +1689,7 @@
</para>
<para>
<function>setlocale</function> retourne la valeur courante, ou
- FALSE si la fonctionnalité n'est pas encore
+ <literal>FALSE</literal> si la fonctionnalité n'est pas encore
implémentée pour la plateforme. Une catégorie
invalide provoque une alerte.
</para>
@@ -1549,11 +1765,13 @@
<example>
<title>Exemple avec Soundex</title>
<programlisting role="php">
-soundex ("Euler") == soundex ("Ellery") == 'E460';
-soundex ("Gauss") == soundex ("Ghosh") == 'G200';
-soundex ("Knuth") == soundex ("Kant") == 'H416';
-soundex ("Lloyd") == soundex ("Ladd") == 'L300';
-soundex ("Lukasiewicz") == soundex ("Lissajous") == 'L222';
+<?php
+soundex("Euler") == soundex("Ellery") == 'E460';
+soundex("Gauss") == soundex("Ghosh") == 'G200';
+soundex("Knuth") == soundex("Kant") == 'H416';
+soundex("Lloyd") == soundex("Ladd") == 'L300';
+soundex("Lukasiewicz") == soundex("Lissajous") == 'L222';
+?>
</programlisting>
</example>
</para>
@@ -1621,7 +1839,7 @@
Argument optionnel, <emphasis>precision specifier</emphasis> indique le
nombre
de chiffres utilisé pour afficher un nombre à virgule flottante.
Cette option n'a d'effet que sur les nombres à virgule, double.
- (Une autre fonciton pratique pour formater les nombres est :
+ (Une autre fonction pratique pour formater les nombres est :
<function>number_format</function>.)
</simpara>
</listitem>
@@ -1660,11 +1878,11 @@
</member>
<member>
<literal>x</literal> - l'argument est traité comme un entier, et
représenté
- comme un nombre hexadécimal (en minuscule).
+ comme un nombre hexadécimal (en minuscules).
</member>
<member>
<literal>X</literal> - l'argument est traité comme un entier, et
représenté
- comme un nombre hexadécimal (en majuscule).
+ comme un nombre hexadécimal (en majuscules).
</member>
</simplelist>
</para>
@@ -1678,21 +1896,26 @@
<para>
<example>
<title>
- Exemple avec <function>sprintf</function>: complété avec des
zéros
+ Exemple avec <function>sprintf</function>: complété
+ avec des zéros
</title>
<programlisting role="php">
-$isodate = sprintf ("%04d-%02d-%02d", $year, $month, $day);
+<?php
+$isodate = sprintf("%04d-%02d-%02d", $year, $month, $day);
+?>
</programlisting>
</example>
<example>
<title>Exemple avec <function>sprintf</function>: format
monétaire</title>
<programlisting role="php">
+<?php
$money1 = 68.75;
$money2 = 54.35;
$money = $money1 + $money2;
// echo $money affichera "123.1";
-$formatted = sprintf ("%01.2f", $money);
+$formatted = sprintf("%01.2f", $money);
// echo $formatted affichera "123.10"
+?>
</programlisting>
</example>
</para>
@@ -1725,8 +1948,8 @@
la comparaison.
</para>
<simpara>
- Retourne < 0 si <parameter>str1</parameter> est plus petit que
- <parameter>str2</parameter>; > 0 si <parameter>str1</parameter>
+ <function>strncasecmp</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.
</simpara>
@@ -1754,17 +1977,19 @@
</funcprototype>
</funcsynopsis>
<para>
- Retourne < 0 si <parameter>str1</parameter> est plus petit que
- <parameter>str2</parameter>; > 0 si <parameter>str1</parameter>
+ 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 ils sont égaux.
<example>
<title>Exemple avec <function>strcasecmp</function></title>
<programlisting role="php">
+<?php
$var1 = "Bonjour";
$var2 = "bonjour";
if ( !strcasecmp($var1,$var2) ) {
echo '$var1 est égal à $var2, à la casse près.';
}
+?>
</programlisting>
</example>
</para>
@@ -1812,8 +2037,8 @@
</funcprototype>
</funcsynopsis>
<simpara>
- <function>strcmp</function> retourne < 0 si <parameter>str1</parameter>
- est plus petit que <parameter>str2</parameter>; > 0 si
+ <function>strcmp</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 ils sont égaux.
</simpara>
@@ -1828,6 +2053,48 @@
</simpara>
</refsect1>
</refentry>
+ <refentry id="function.strcoll">
+ <refnamediv>
+ <refname>strcoll</refname>
+ <refpurpose>Comparaison de chaînes localisée</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>strcoll</function></funcdef>
+ <paramdef>string <parameter>str1</parameter></paramdef>
+ <paramdef>string <parameter>str2</parameter></paramdef>
+ </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>.
+ </simpara>
+ <simpara>
+ 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.
+ </simpara>
+ </note>
+ <simpara>
+ Voir aussi <function>ereg</function>, <function>strcmp</function>,
+ <function>strcasecmp</function>, <function>substr</function>,
+ <function>stristr</function>, <function>strncasecmp</function>,
+ <function>strncmp</function>, <function>strstr</function>,
+ et <function>setlocale</function>.
+ </simpara>
+ </refsect1>
+ </refentry>
<refentry id="function.strcspn">
<refnamediv>
<refname>strcspn</refname>
@@ -1886,7 +2153,7 @@
<note>
<para>
<parameter>allowable_tags</parameter> a été
- ajouté en PHP 3.0.13, et PHP4B3.
+ ajouté en PHP 3.0.13, et PHP 4.0B3.
</para>
</note>
</para>
@@ -1914,7 +2181,7 @@
octales et hexadécimales utilisées en C.
<note>
<simpara>
- Ajouté dans PHP4b3-dev.
+ <function>stripcslashes</function> a été ajouté dans PHP
+4.0b3-dev.
</simpara>
</note>
</para>
@@ -1971,7 +2238,7 @@
sont examinés sans tenir compte de la casse.
</para>
<para>
- Si <parameter>needle</parameter> n'est pas trouvé, retourne FALSE.
+ Si <parameter>needle</parameter> n'est pas trouvé, retourne
+<literal>FALSE</literal>.
</para>
<para>
Si <parameter>needle</parameter> n'est pas une chaîne, elle est convertie
en entier,
@@ -2027,19 +2294,21 @@
(comme lorsqu'on utilise <function>strcmp</function>) est
illustré ci dessous :
<informalexample>
- <programlisting>
-$arr1 = $arr2 = array ("img12.png","img10.png","img2.png","img1.png");
+ <programlisting role="php">
+<?php
+$arr1 = $arr2 = array("img12.png","img10.png","img2.png","img1.png");
echo "Comparaison standard de chaînes\n";
usort($arr1,"strcmp");
print_r($arr1);
echo "\nComparaison de chaînes par ordre naturel\n";
usort($arr2,"strnatcmp");
print_r($arr2);
+?>
</programlisting>
</informalexample>
L'exemple précédent affiche ceci :
<informalexample>
- <programlisting>
+ <computeroutput>
Comparaison standard de chaînes
Array
(
@@ -2056,7 +2325,7 @@
[2] => img10.png
[3] => img12.png
)
- </programlisting>
+ </computeroutput>
</informalexample>
Pour plus d'informations, reportez vous à Martin Pool <ulink
url="&url.strnatcmp;">Natural Order String Comparison</ulink>.
@@ -2203,10 +2472,12 @@
<example>
<title>Exemple avec <function>str_pad</function></title>
<programlisting role="php">
+<?php
$input = "Paris";
print str_pad($input, 10); // produces "Paris "
print str_pad($input, 10, "-=", STR_PAD_LEFT); // produces "-=-=-Paris"
print str_pad($input, 10, "_", STR_PAD_BOTH); // produces "__Paris___"
+?>
</programlisting>
</example>
</para>
@@ -2239,7 +2510,8 @@
être une chaîne.
</para>
<para>
- Si <parameter>needle</parameter> n'est pas trouvée, retourne FALSE.
+ Si <parameter>needle</parameter> n'est pas trouvée, retourne
+ <literal>FALSE</literal>.
<note>
<para>
Il est facile de confondre la valeur de retour "caractère trouvé
@@ -2247,17 +2519,19 @@
la différence :
<informalexample>
<programlisting role="php">
+<?php
// PHP 4.0b3 et plus récent :
-$pos = strpos ("b", $mystring);
-if ($pos === FALSE) { // note: trois égal signes
+$pos = strpos("b", $mystring);
+if ($pos === FALSE) { // note: trois signes égal
// non trouvé
}
// versions plus anciennes que 4.0b3:
-$pos = strpos ("b", $mystring);
-if (is_string ($pos) && !$pos) {
+$pos = strpos("b", $mystring);
+if (is_string($pos) && !$pos) {
// non trouvé
}
- </programlisting>
+?>
+ </programlisting>
</informalexample>
</para>
</note>
@@ -2303,7 +2577,7 @@
la chaîne <parameter>haystack</parameter>.
</para>
<para>
- Retourne FALSE si <parameter>needle</parameter> n'est pas trouvé.
+ Retourne <literal>FALSE</literal> si <parameter>needle</parameter> n'est pas
+trouvé.
</para>
<para>
Si <parameter>needle</parameter> contient plus d'un caractère,
@@ -2315,11 +2589,13 @@
<example>
<title>Exemple avec <function>strrchr</function></title>
<programlisting role="php">
+<?php
// lis le dernier repertoire de $PATH
-$dir = substr (strrchr ($PATH, ":"), 1);
+$dir = substr(strrchr($PATH, ":"), 1);
// lis tout après la dernière ligne
$text = "Line 1\nLine 2\nLine 3";
-$last = substr (strrchr ($text, 10), 1 );
+$last = substr(strrchr($text, 10), 1 );
+?>
</programlisting>
</example>
</para>
@@ -2351,7 +2627,9 @@
<example>
<title>Exemple avec <function>str_repeat</function></title>
<programlisting role="php">
-echo str_repeat ("-=", 10);
+<?php
+echo str_repeat("-=", 10);
+?>
</programlisting>
</example>
<para>
@@ -2409,7 +2687,7 @@
ne peut accepter qu'un seul caractère.
</para>
<para>
- Si <parameter>needle</parameter> n'est pas trouvé, retourne FALSE.
+ Si <parameter>needle</parameter> n'est pas trouvé, retourne
+<literal>FALSE</literal>.
</para>
<note>
<para>
@@ -2418,17 +2696,19 @@
la différence :
<informalexample>
<programlisting role="php">
+<?php
// PHP 4.0b3 et plus récent :
-$pos = strpos ("b", $mystring);
-if ($pos === false) { // note: trois égal signes
+$pos = strpos("b", $mystring);
+if ($pos === <literal>FALSE</literal>) { // note: trois égal signes
// non trouvé
}
// versions plus anciennes que 4.0b3:
-$pos = strpos ("b", $mystring);
-if (is_string ($pos) && !$pos) {
+$pos = strpos("b", $mystring);
+if (is_string($pos) && !$pos) {
// non trouvé
}
- </programlisting>
+?>
+ </programlisting>
</informalexample>
</para>
</note>
@@ -2468,7 +2748,9 @@
<para>
<informalexample>
<programlisting role="php">
-strspn ("42 est une réponse, quelle est la question ...", "1234567890");
+<?php
+strspn("42 est une réponse, quelle est la question ...", "1234567890");
+?>
</programlisting>
<para>
affichera "2".
@@ -2500,7 +2782,7 @@
occurrence de <parameter>needle</parameter>, jusqu'à la fin.
</para>
<para>
- Si <parameter>needle</parameter> n'est pas trouvé, retourne FALSE.
+ Si <parameter>needle</parameter> n'est pas trouvé, retourne
+<literal>FALSE</literal>.
</para>
<para>
<note>
@@ -2517,9 +2799,11 @@
<example>
<title>Exemple avec <function>strstr</function></title>
<programlisting role="php">
+<?php
$email = '[EMAIL PROTECTED]';
-$domain = strstr ($email, '@');
+$domain = strstr($email, '@');
print $domain; // affiche designmultimedia.com
+?>
</programlisting>
</example>
</para>
@@ -2551,12 +2835,14 @@
<example>
<title>Exemple avec <function>strtok</function></title>
<programlisting role="php">
+<?php
$string = "ceci est une chaîne exemple";
-$tok = strtok ($string," ");
+$tok = strtok($string," ");
while ($tok) {
echo "Mot=$tok<br>";
- $tok = strtok (" ");
+ $tok = strtok(" ");
}
+?>
</programlisting>
</example>
</para>
@@ -2571,7 +2857,7 @@
</para>
<para>
Soyez prudents avec les délimiteurs qui sont égaux à "0".
- Cette valeur sera confondue avec FALSE.
+ Cette valeur sera confondue avec <literal>FALSE</literal>.
</para>
<para>
Voir aussi <function>split</function> et <function>explode</function>.
@@ -2604,9 +2890,11 @@
<example>
<title>Exemple avec <function>strtolower</function></title>
<programlisting role="php">
+<?php
$str = "Marie A Un Petit Agneau, Et Elle L'Adore";
$str = strtolower($str);
print $str; # Affiche : marie a un petit agneau, et elle l'adore
+?>
</programlisting>
</example>
<para>
@@ -2640,9 +2928,11 @@
<example>
<title>Exemple avec <function>strtoupper</function></title>
<programlisting role="php">
+<?php
$str = "Marie A Un Petit Agneau, Et Elle L'Adore";
-$str = strtoupper ($str);
+$str = strtoupper($str);
print $str; # Affiche : MARIE A UN PETIT AGNEAU, ET ELLE L'ADORE
+?>
</programlisting>
</example>
<para>
@@ -2678,7 +2968,9 @@
<example>
<title>Exemple avec <function>str_replace</function></title>
<programlisting role="php">
-$bodytag = str_replace ("%body%", "black", "<body text=%body%>");
+<?php
+$bodytag = str_replace("%body%", "black", "<body text=%body%>");
+?>
</programlisting>
</example>
</para>
@@ -2725,7 +3017,9 @@
<example>
<title>Exemple avec <function>strtr</function></title>
<programlisting role="php">
+<?php
$addr = strtr($addr, "AAÖ", "aao");
+?>
</programlisting>
</example>
</para>
@@ -2742,8 +3036,10 @@
Exemples:
<informalexample>
<programlisting role="php">
-$trans = array ("bonjour" => "salut", "salut" => "bonjour");
+<?php
+$trans = array("bonjour" => "salut", "salut" => "bonjour");
echo strtr("bonjour à tous, j'ai dit salut", $trans) . "\n";
+?>
</programlisting>
</informalexample>
Cete exemple affichera : "salut à tous, j'ai dit bonjour",
@@ -2792,8 +3088,10 @@
Exemples:
<informalexample>
<programlisting role="php">
-$rest = substr ("abcdef", 1); // retourne "bcdef"
-$rest = substr ("abcdef", 1, 3); // retourne "bcd"
+<?php
+$rest = substr("abcdef", 1); // retourne "bcdef"
+$rest = substr("abcdef", 1, 3); // retourne "bcd"
+?>
</programlisting>
</informalexample>
</para>
@@ -2807,9 +3105,11 @@
Exemples:
<informalexample>
<programlisting role="php">
-$rest = substr ("abcdef", -1); // retourne "f"
-$rest = substr ("abcdef", -2); // retourne "ef"
-$rest = substr ("abcdef", -3, 1); // retourne "d"
+<?php
+$rest = substr("abcdef", -1); // retourne "f"
+$rest = substr("abcdef", -2); // retourne "ef"
+$rest = substr("abcdef", -3, 1); // retourne "d"
+?>
</programlisting>
</informalexample>
</para>
@@ -2823,7 +3123,9 @@
Exemples:
<informalexample>
<programlisting role="php">
-$rest = substr ("abcdef", 1, -1); // retourne "bcde"
+<?php
+$rest = substr("abcdef", 1, -1); // retourne "bcde"
+?>
</programlisting>
</informalexample>
</para>
@@ -2853,8 +3155,10 @@
<para>
<example>
<title>Exemple <function>substr_count</function></title>
- <programlisting>
+ <programlisting role="php">
+<?php
print substr_count("Ceci est un test", "es"); // affiche 2
+?>
</programlisting>
</example>
</para>
@@ -2912,15 +3216,15 @@
$var = 'ABCDEFGH:/MNRPQR/';
echo "Original: $var<hr>\n";
/* Ces deux exemples remplacent tout $var avec 'bob'. */
-echo substr_replace ($var, 'bob', 0) . "<br>\n";
-echo substr_replace ($var, 'bob', 0, strlen ($var)) . "<br>\n";
+echo substr_replace($var, 'bob', 0) . "<br>\n";
+echo substr_replace($var, 'bob', 0, strlen($var)) . "<br>\n";
/* Insère 'bob' à gauche, du début de $var. */
-echo substr_replace ($var, 'bob', 0, 0) . "<br>\n";
+echo substr_replace($var, 'bob', 0, 0) . "<br>\n";
/* Ces deux exemples remplacent 'MNRPQR' dans $var avec 'bob'. */
-echo substr_replace ($var, 'bob', 10, -1) . "<br>\n";
-echo substr_replace ($var, 'bob', -7, -1) . "<br>\n";
+echo substr_replace($var, 'bob', 10, -1) . "<br>\n";
+echo substr_replace($var, 'bob', -7, -1) . "<br>\n";
/* Efface 'MNRPQR' dans $var. */
-echo substr_replace ($var, '', 10, -1) . "<br>\n";
+echo substr_replace($var, '', 10, -1) . "<br>\n";
?>
</programlisting>
</example>
@@ -2987,8 +3291,10 @@
<example>
<title>Exemple avec <function>ucfirst</function></title>
<programlisting role="php">
+<?php
$text = 'marie a un petit agneau, et l'adore.';
$text = ucfirst($text); // $text vaut : Marie a un petit agneau, et l'adore
+?>
</programlisting>
</example>
</para>
@@ -3019,8 +3325,10 @@
<example>
<title>Exemple avec <function>ucwords</function></title>
<programlisting role="php">
+<?php
$text = "marie a un petit agneau, et l'adore.";
$text = ucwords($text); // $text vaut : Marie A Un Petit Agneau, Et l'Adore.
+?>
</programlisting>
</example>
</para>
@@ -3088,9 +3396,11 @@
<example>
<title>Exemple <function>wordwrap</function></title>
<programlisting role="php">
+<?php
$text = "Maître corbeau jura, mais un peu tard, qu'on ne l'y prendrait plus.";
$newtext = wordwrap( $text, 20 );
echo "$newtext\n";
+?>
</programlisting>
</example>
</para>
@@ -3099,32 +3409,23 @@
</para>
<para>
<informalexample>
- <programlisting>
+ <computeroutput>
Maître corbeau
jura, mais un peu t
ard, qu'on ne l'y pr
endrait plus
- </programlisting>
- </informalexample>
- </para>
- <para>
- Cet exemple va afficher :
- </para>
- <para>
- <informalexample>
- <programlisting>
-The quick brown fox
-jumped over the lazy dog.
- </programlisting>
+ </computeroutput>
</informalexample>
</para>
<para>
<example>
<title>Exemple avec <function>wordwrap</function></title>
<programlisting role="php">
+<?php
$text = "Un tres tres long mooooooooooooooooooooooooot.";
$newtext = wordwrap( $text, 8, "\n", 1);
echo "$newtext\n";
+?>
</programlisting>
</example>
</para>
@@ -3133,14 +3434,14 @@
</para>
<para>
<informalexample>
- <programlisting>
+ <computeroutput>
Un tres
tres
long
mooooooo
oooooooo
oooooooo
- </programlisting>
+ </computeroutput>
</informalexample>
</para>
<para>
Index: phpdoc/fr/functions/swf.xml
diff -u phpdoc/fr/functions/swf.xml:1.3 phpdoc/fr/functions/swf.xml:1.4
--- phpdoc/fr/functions/swf.xml:1.3 Fri Nov 24 03:07:33 2000
+++ phpdoc/fr/functions/swf.xml Mon Jan 22 03:58:33 2001
@@ -1,5 +1,5 @@
<reference id="ref.swf">
- <title>Fonctions Shockwave Flash</title>
+ <title>Shockwave Flash</title>
<titleabbrev>SWF</titleabbrev>
<partintro>
<simpara>
@@ -69,7 +69,7 @@
</para>
<note>
<para>
- Le support de Flash a été ajouté dans PHP4 RC2.
+ Le support de Flash a été ajouté dans PHP 4.0RC2.
</para>
<para>
La librairie libswf n'est pas disponible pour Windows : son développement
@@ -207,7 +207,7 @@
@mysql_free_result ($sth);
@mysql_close ($dbh);
}
->
+?>
</programlisting>
</example>
</para>
Index: phpdoc/fr/functions/sybase.xml
diff -u phpdoc/fr/functions/sybase.xml:1.5 phpdoc/fr/functions/sybase.xml:1.6
--- phpdoc/fr/functions/sybase.xml:1.5 Tue Dec 12 03:16:02 2000
+++ phpdoc/fr/functions/sybase.xml Mon Jan 22 03:58:33 2001
@@ -5,7 +5,7 @@
<refnamediv>
<refname>sybase_affected_rows</refname>
<refpurpose>
- Retourne le nombre de lignes affectées par la dernière
+ Retourne le nombre de lignes affectées par la dernière
requête.
</refpurpose>
</refnamediv>
@@ -14,33 +14,34 @@
<funcsynopsis>
<funcprototype>
<funcdef>int <function>sybase_affected_rows</function></funcdef>
- <paramdef>int
+ <paramdef>int
<parameter><optional>link_identifier</optional></parameter>
</paramdef>
</funcprototype>
- </funcsynopsis>
+ </funcsynopsis>
<para>
- <function>sybase_affected_rows</function> retourne le nombre de lignes
+ <function>sybase_affected_rows</function> retourne le nombre de lignes
affectées par la dernière requête.
</para>
<para>
- <function>sybase_affected_rows</function> retourne le nombre de lignes
- affectées par la dernière requête INSERT, UPDATE ou
- DELETE sur le serveur associé à l'identifiant de connexion
- <parameter><optional>link_identifier</optional></parameter>. Si le lien
+ <function>sybase_affected_rows</function> retourne le nombre de lignes
+ affectées par la dernière requête INSERT, UPDATE ou
+ DELETE sur le serveur associé à l'identifiant de connexion
+ <parameter><optional>link_identifier</optional></parameter>. Si le lien
n'est pas précisé, le dernier lien ouvert est utilisé.
</para>
<para>
- Cette commande ne sert à rien sur les requête SELECT : uniquement
- sur des requêtes qui modifient les lignes. Pour connaître le
- nombre de lignes retournées par un SELECT, utilisez
+ Cette commande ne sert à rien sur les requête SELECT : uniquement
+ sur des requêtes qui modifient les lignes. Pour connaître le
+ nombre de lignes retournées par un SELECT, utilisez
<function>sybase_num_rows</function>.
<note>
<para>
- <function>sybase_affected_rows</function> est disponible avec l'interface
+ <function>sybase_affected_rows</function> est disponible avec l'interface
CT vers Sybase, mais pas avec la librairie DB.
</para>
- </note></para>
+ </note>
+ </para>
</refsect1>
</refentry>
<refentry id="function.sybase-close">
@@ -57,16 +58,16 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>sybase_close</function> retourne TRUE en cas de succès,
- et FALSE en cas d'erreur.
+ <function>sybase_close</function> retourne <literal>TRUE</literal> en cas de
+succès,
+ et <literal>FALSE</literal> en cas d'erreur.
</para>
<para>
<function>sybase_close</function> termine la connexion avec le serveur Sybase
- associé à l'identifiant de connexion
+ associé à l'identifiant de connexion
<parameter>link_identifier</parameter>.
</para>
<para>
- Notez qu'il n'est pas utile de fermer les connexions non persistantes,
+ Notez qu'il n'est pas utile de fermer les connexions non persistantes,
car elles seront terminées à la fin du script.
</para>
<para>
@@ -95,23 +96,23 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>sybase_connect</function> retourne un identifiant positif de
- lien Sybase en cas de succès, et FALSE en cas d'erreur.
+ <function>sybase_connect</function> retourne un identifiant positif de
+ lien Sybase en cas de succès, et <literal>FALSE</literal> en cas
+d'erreur.
</para>
<para>
<function>sybase_connect</function> établit une connexion à
- un serveur Sybase. Le nom de serveur <parameter>servername</parameter>
+ un serveur Sybase. Le nom de serveur <parameter>servername</parameter>
doit être valide, défini dans le fichier d'interface.
</para>
<para>
- Si un deuxième appel à <function>sybase_connect</function>
- est fait avec les mêmes arguments, une nouvelle connexion ne sera
- pas établie, mais ce sera l'identifiant de la connexion
+ Si un deuxième appel à <function>sybase_connect</function>
+ est fait avec les mêmes arguments, une nouvelle connexion ne sera
+ pas établie, mais ce sera l'identifiant de la connexion
déjà ouverte qui sera retourné.
</para>
<para>
- La connexion sera fermée dès la fin du script, à
- moins qu'elle ne soit pas explicitement fermée avec
+ La connexion sera fermée dès la fin du script, à
+ moins qu'elle ne soit pas explicitement fermée avec
<function>sybase_close</function>.
</para>
<para>
@@ -135,7 +136,7 @@
</funcprototype>
</funcsynopsis>
<para>
- Retourne TRUE en cas de succès, et FALSE en cas d'échec.
+ Retourne <literal>TRUE</literal> en cas de succès, et
+<literal>FALSE</literal> en cas d'échec.
</para>
<para>
<function>sybase_data_seek</function> déplace le pointeur interne de
ligne
@@ -162,7 +163,7 @@
</funcprototype>
</funcsynopsis>
<para>
- Retourne un tableau qui contient la ligne demandée, ou FALSE s'il ne
reste
+ Retourne un tableau qui contient la ligne demandée, ou
+<literal>FALSE</literal> s'il ne reste
plus de ligne.
</para>
<para>
@@ -200,9 +201,9 @@
Retourne un objet contenant les informations du champs.
</para>
<para>
- <function>sybase_fetch_field</function> sert à obtenir des
- informations à propos des champs dans le résultat
- <parameter>result</parameter>. Si l'offset du champs n'est pas
+ <function>sybase_fetch_field</function> sert à obtenir des
+ informations à propos des champs dans le résultat
+ <parameter>result</parameter>. Si l'offset du champs n'est pas
précisé, le champs suivant est traité.
</para>
<para>
@@ -210,8 +211,8 @@
</para>
<itemizedlist>
<listitem><simpara>
- name - column name. nom de la colonne. Si la colonne est un
- résultat de fonction, le nom de cette fonction devient
+ name - column name. nom de la colonne. Si la colonne est un
+ résultat de fonction, le nom de cette fonction devient
computed#N, oú #N est un numéro de série.
</simpara>
</listitem>
@@ -255,15 +256,15 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>sybase_fetch_object</function> retourne un objet qui
+ <function>sybase_fetch_object</function> retourne un objet qui
contient la ligne demandée, en cas de succès, et
- FALSE en cas d'erreur.
+ <literal>FALSE</literal> en cas d'erreur.
</para>
<para>
<function>sybase_fetch_object</function> est similaire à
<function>sybase_fetch_array</function>, avec une différence :
- c'est un objet qui est retourné à la place d'un tableau.
- Indirectement, cela signifie que vous ne pourrez accéder aux
+ c'est un objet qui est retourné à la place d'un tableau.
+ Indirectement, cela signifie que vous ne pourrez accéder aux
valeurs que par les propriétés, et non plus avec des offsets
(les nombres sont interdits comme nom de propriété).
</para>
@@ -272,7 +273,7 @@
<function>sybase_fetch_array</function>, et presque aussi rapide que
<function>sybase_fetch_row</function> (la différence est insignifiante).
</para>
- <para>
+ <para>
Voir aussi: <function>sybase_fetch-array</function> et
<function>sybase_fetch-row</function>.
</para>
@@ -294,24 +295,24 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>sybase_fetch_row</function> retourne un tableau qui contient la
- ligne demandée, en cas de succès, et FALSE en cas d'erreur.
+ <function>sybase_fetch_row</function> retourne un tableau qui contient la
+ ligne demandée, en cas de succès, et <literal>FALSE</literal> en
+cas d'erreur.
</para>
<para>
- <function>sybase_fetch_row</function> lit une ligne dans le résultat
- associé à l'identifiant de résultat
- <parameter>result</parameter>. La ligne retournée est sous la
+ <function>sybase_fetch_row</function> lit une ligne dans le résultat
+ associé à l'identifiant de résultat
+ <parameter>result</parameter>. La ligne retournée est sous la
forme d'un tableau. Chaque champs est enregistré dans un index du
tableau, les index commencant à 0.
</para>
<para>
- Les prochains appels à <function>sybase_fetch_row</function>
- retourneront la ligne suivante du résultat, ou FALSE, si il
+ Les prochains appels à <function>sybase_fetch_row</function>
+ retourneront la ligne suivante du résultat, ou
+<literal>FALSE</literal>, si il
ne reste plus de lignes.
</para>
<para>
- Voir aussi: <function>sybase_fetch_array</function>,
- <function>sybase_fetch_object</function>, <function>sybase_data_seek</function>
+ Voir aussi: <function>sybase_fetch_array</function>,
+ <function>sybase_fetch_object</function>, <function>sybase_data_seek</function>
et <function>sybase_result</function>.
</para>
</refsect1>
@@ -331,8 +332,8 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>sybase_field_seek</function> modifie l'index d'un champs.
- Le prochain appel à la fonction
+ <function>sybase_field_seek</function> modifie l'index d'un champs.
+ Le prochain appel à la fonction
<function>sybase_fetch_field</function> sans préciser l'index du champs
retournera ce champs.
</para>
@@ -568,7 +569,7 @@
</funcsynopsis>
<para>
Retourne un identifiant de connexion positive en cas de succès, et
- FALSE en cas d'erreur.
+ <literal>FALSE</literal> en cas d'erreur.
</para>
<para>
<function>sybase_connect</function> se comporte comme
@@ -606,7 +607,7 @@
</funcprototype>
</funcsynopsis>
<para>
- Retourne un identifiant de résultat positif en cas de succès, et
FALSE sinon.
+ Retourne un identifiant de résultat positif en cas de succès, et
+<literal>FALSE</literal> sinon.
</para>
<para>
<function>sybase_query</function> envoie une requête à la base de
données
@@ -673,7 +674,7 @@
</funcprototype>
</funcsynopsis>
<para>
- Retourne TRUE en cas de succès, et FALSE en cas d'erreur.
+ Retourne <literal>TRUE</literal> en cas de succès, et
+<literal>FALSE</literal> en cas d'erreur.
</para>
<para>
<function>sybase_select_db</function> change la base de données
courante et
Index: phpdoc/fr/functions/uodbc.xml
diff -u phpdoc/fr/functions/uodbc.xml:1.3 phpdoc/fr/functions/uodbc.xml:1.4
--- phpdoc/fr/functions/uodbc.xml:1.3 Tue Dec 26 02:24:40 2000
+++ phpdoc/fr/functions/uodbc.xml Mon Jan 22 03:58:33 2001
@@ -1,16 +1,17 @@
<reference id="ref.odbc">
- <title>ODBC</title>
+ <title>ODBC unifié</title>
<titleabbrev>ODBC</titleabbrev>
<partintro>
<simpara>
En plus du support de l'ODBC normal, l'ODBC unifié de PHP vous donne
- accès à diverses bases de données qui ont emprunté la
sémantique
- des API ODBC pour implémenter leur propres API. Au lieu de
- maintenir de multiples pilotes qui sont similaires, ces
- pilotes ont été rassemblés dans un jeu de fonctions ODBC
uniques.
+ accès à diverses bases de données qui ont emprunté
+ la sémantique des API ODBC pour implémenter leur propres API.
+ Au lieu de maintenir de multiples pilotes qui sont similaires, ces pilotes
+ ont été rassemblés dans un jeu de fonctions ODBC uniques.
</simpara>
<simpara>
- Les bases de données suivantes sont supportées par l'ODBC
unifié :
+ Les bases de données suivantes sont supportées par l'ODBC
+ unifié :
<ulink url="&url.adabas;">Adabas D</ulink>,
<ulink url="&url.ibmdb2;">IBM DB2</ulink>,
<ulink url="&url.iodbc;">iODBC</ulink>,
@@ -18,14 +19,14 @@
<ulink url="&url.sybase;">Sybase SQL Anywhere</ulink>.
</simpara>
<simpara>
- Reportez vous à <link
- linkend="database-support-options">Installation sous Unix</link>
+ Reportez vous à
+ <link linkend="database-support-options">Installation sous Unix</link>
pour plus de détails sur les configurations de ces serveurs.
</simpara>
<note>
<simpara>
- Il n'y a pas d'ODBC utilisé lors des connexions aux bases de
données
- ci-dessus. Les fonctions que vous utiliserez portent des noms
+ Il n'y a pas d'ODBC utilisé lors des connexions aux bases de
+ données ci-dessus. Les fonctions que vous utiliserez portent des noms
évocateurs, et utilisent les mêmes syntaxes que leurs cousines
d'ODBC.
</simpara>
@@ -46,15 +47,15 @@
</funcprototype>
</funcsynopsis>
<para>
- Sans paramètre <parameter>OnOff</parameter>,
+ Sans le paramètre <parameter>OnOff</parameter>,
<function>odbc_autocommit</function> retourne le statut d'auto-validation
- de la connexion <parameter>connection_id</parameter>. TRUE si le mode
- est activé, FALSE si il ne l'est pas, ou si une erreur survient.
+ de la connexion <parameter>connection_id</parameter>. <literal>TRUE</literal>
+si le mode
+ est activé, <literal>FALSE</literal> si il ne l'est pas, ou si une
+erreur survient.
</para>
<para>
- Si <parameter>OnOff</parameter> vaut TRUE, l'auto-validation est
- activée. Si il est FALSE, l'auto-validation est désactivée.
- Retourne TRUE en cas de succès, FALSE en cas d'échec.
+ Si <parameter>OnOff</parameter> vaut <literal>TRUE</literal>, l'auto-validation
+est
+ activée. Si il est <literal>FALSE</literal>, l'auto-validation est
+désactivée.
+ Retourne <literal>TRUE</literal> en cas de succès,
+<literal>FALSE</literal> en cas d'échec.
</para>
<para>
Par défaut, l'auto-validation est activée. Désactiver
@@ -97,7 +98,7 @@
</listitem>
<listitem>
<simpara>
- ODBC_BINMODE_CONVERT: Converti en char et retourne la valeur.
+ ODBC_BINMODE_CONVERT: Convertit en char et retourne la valeur.
</simpara>
</listitem>
</itemizedlist>
@@ -242,7 +243,7 @@
</funcprototype>
</funcsynopsis>
<para>
- Retourne TRUE en case de succès, FALSE en cas d'erreur. Toutes
+ Retourne <literal>TRUE</literal> en case de succès,
+<literal>FALSE</literal> en cas d'erreur. Toutes
les connexions en cours sur <parameter>connection_id</parameter> sont
validées.
</para>
@@ -266,7 +267,7 @@
</funcsynopsis>
<para>
<function>odbc_connect</function> retourne un identifiant de connexion ODBC
- ou 0 (FALSE) en cas d'erreur.
+ ou 0 (<literal>FALSE</literal>) en cas d'erreur.
</para>
<simpara>
L'identifiant de connexion retournée par cette fonction est
@@ -360,6 +361,56 @@
</para>
</refsect1>
</refentry>
+ <refentry id="function.odbc-error">
+ <refnamediv>
+ <refname>odbc_error</refname>
+ <refpurpose>Lit le dernier code d'erreur</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>odbc_error</function></funcdef>
+ <paramdef>int
+<parameter><optional>connection_id</optional></parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <simpara>
+ <function>odbc_error</function> retourne un état ODVBC sur 6 chiffres,
+ ou une chaîne vide s'il n'y avait plus d'erreurs. Si
+<parameter>connection_id</parameter>
+ est spécifié, le dernier état ODBC de cette connexion est
+retourné. Si
+ <parameter>connection_id</parameter> est omis, c'est le dernier état de
+n'importe
+ quelle connexion qui est retourné.
+ </simpara>
+ <simpara>
+ Voir aussi : <function>odbc_errormsg</function> et
+<function>odbc_exec</function>.
+ </simpara>
+ </refsect1>
+ </refentry>
+ <refentry id="function.odbc-errormsg">
+ <refnamediv>
+ <refname>odbc_errormsg</refname>
+ <refpurpose>Lit le dernier message d'erreur</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>odbc_errormsg</function></funcdef>
+ <paramdef>int
+<parameter><optional>connection_id</optional></parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <simpara>
+ <function>odbc_errormsg</function> retourne une chaîne contenant le dernier
+ message d'erreur ODBC, ou une chaîne vide s'il n'y avait pas d'erreur. Si
+ <parameter>connection_id</parameter> est spécifié, le dernier
+état ODBC de
+ cette connexion est retourné. Si <parameter>connection_id</parameter> est
+omis,
+ c'est le dernier état de n'importe quelle connexion qui est
+retourné.
+ </simpara>
+ <simpara>
+ Voir aussi : <function>odbc_error</function> et <function>odbc_exec</function>.
+ </simpara>
+ </refsect1>
+ </refentry>
<refentry id="function.odbc-exec">
<refnamediv>
<refname>odbc_exec</refname>
@@ -377,7 +428,7 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>odbc_exec</function> retourne FALSE en cas d'erreur, ou bien
+ <function>odbc_exec</function> retourne <literal>FALSE</literal> en cas
+d'erreur, ou bien
retourne un identifiant de résultat ODBC en cas
d'exécution réussie.
</para>
@@ -413,8 +464,7 @@
<para>
<function>odbc_execute</function> exécute une requête SQL
préparée par <function>odbc_prepare</function>.
- Retourne TRUE en cas d'exécution réussie, et FALSE
- sinon. Le tableau de paramètres
+ Retourne <literal>TRUE</literal> en cas d'exécution réussie, et
+<literal>FALSE</literal> sinon. Le tableau de paramètres
<parameter>parameters_array</parameter> ne sert que si vous avez besoin de
paramètres votre requête.
</para>
@@ -439,12 +489,12 @@
</funcsynopsis>
<para>
<function>odbc_fetch_into</function> retourne le nombre de colonnes
- dans le résultat, ou FALSE en cas d'erreur.
+ dans le résultat, ou <literal>FALSE</literal> en cas d'erreur.
<parameter>result_array</parameter> doit avoir été
passé par référence, mais il peut être
de n'importe quel type, étant donné qu'il sera converti en tableau.
- Le tableau contiendra les valeurs des colonnes, ces dernières
étant numérotées à
- partir de 0.
+ Le tableau contiendra les valeurs des colonnes, ces dernières
+ étant numérotées à partir de 0.
</para>
</refsect1>
</refentry>
@@ -463,9 +513,9 @@
</funcprototype>
</funcsynopsis>
<para>
- Si <function>odbc_fetch_row</function> a réussi, TRUE est
+ Si <function>odbc_fetch_row</function> a réussi, <literal>TRUE</literal>
+est
retourné. Si il n'y avait plus de ligne, ou en cas d'erreur,
- FALSE est retourné.
+ <literal>FALSE</literal> est retourné.
</para>
<para>
<function>odbc_fetch_row</function> lit une ligne dans le
@@ -510,7 +560,7 @@
<function>odbc_field_name</function> lit le nom de la colonne dont
l'index est <parameter>field_number</parameter>. La
numérotation des champs commence à 1.
- FALSE est retourné en cas d'erreur.
+ <literal>FALSE</literal> est retourné en cas d'erreur.
</para>
</refsect1>
</refentry>
@@ -642,7 +692,7 @@
</funcprototype>
</funcsynopsis>
<para>
- Retourne toujours TRUE.</para>
+ Retourne toujours <literal>TRUE</literal>.</para>
<para>
<function>odbc_free_result</function> n'est nécessaire que
si vous craignez d'utiliser trop de mémoire lors de
@@ -737,7 +787,7 @@
</funcprototype>
</funcsynopsis>
<para>
- Retourne un identifiant de connexion ODBC ou 0 (FALSE) en cas d'erreur.
+ Retourne un identifiant de connexion ODBC ou 0 (<literal>FALSE</literal>) en
+cas d'erreur.
Cette fonction se comporte de manière similaire à
<function>odbc_connect</function>, mais la connexion ouverte
n'est pas vraiment terminée lorsque le script est
@@ -840,9 +890,11 @@
résultat, ou bien une chaîne de caractère, qui
représente le nom du champs. Par exemple:
<informalexample>
- <programlisting>
- $item_3 = odbc_result($Query_ID, 3 );
- $item_val = odbc_result($Query_ID, "val");
+ <programlisting role="php">
+<?php
+$item_3 = odbc_result($Query_ID, 3 );
+$item_val = odbc_result($Query_ID, "val");
+?>
</programlisting>
</informalexample>
</para>
@@ -892,7 +944,7 @@
</funcsynopsis>
<para>
<function>odbc_result_all</function> retourne le nombre de lignes
- dans le résultat, ou FALSE en cas d'erreur.
+ dans le résultat, ou <literal>FALSE</literal> en cas d'erreur.
</para>
<para>
<function>odbc_result_all</function> affiche toutes les lignes
@@ -917,8 +969,8 @@
</funcsynopsis>
<para>
<function>odbc_rollback</function> annule toutes les transactions sur
- la connexion <parameter>connection_id</parameter>. Retourne TRUE en
- cas de succès, et FALSE en cas d'echec.
+ la connexion <parameter>connection_id</parameter>. Retourne
+<literal>TRUE</literal> en
+ cas de succès, et <literal>FALSE</literal> en cas d'échec.
</para>
</refsect1>
</refentry>
@@ -984,16 +1036,18 @@
<example>
<title>Exemple de modification d'option ODBC</title>
<programlisting role="php">
+<?php
// 1. L'option 102 de SQLSetConnectOption() est SQL_AUTOCOMMIT.
// 1 de SQL_AUTOCOMMIT est SQL_AUTOCOMMIT_ON.
// Cet exemple a le meme effet que
-// odbc_autocommit($conn, TRUE);
-odbc_setoption ($conn, 1, 102, 1);
+// odbc_autocommit($conn, <literal>TRUE</literal>);
+odbc_setoption($conn, 1, 102, 1);
// 2. Option 0 de SQLSetStmtOption() est SQL_QUERY_TIMEOUT.
-// Cet exemple fixe le délai d'expiration à 30 secondes.
-$result = odbc_prepare ($conn, $sql);
-odbc_setoption ($result, 2, 0, 30);
-odbc_execute ($result);
+// Cet exemple fixe le délai d'éxpiration à 30 secondes.
+$result = odbc_prepare($conn, $sql);
+odbc_setoption($result, 2, 0, 30);
+odbc_execute($result);
+?>
</programlisting>
</example>
</para>
@@ -1082,7 +1136,7 @@
Si <parameter>table_type</parameter> n'est pas une chaîne vide,
il doit contenir une liste de valeurs, séparées par des virgules,
qui representent les types recherchés. Chaque valeur peut être
- insérée entre guillements simples ('), ou sans guillements. Par
+ insérée entre guillemets simples ('), ou sans guillemets. Par
exemple "'TABLE','VIEW'" ou "TABLE, VIEW". Si la source de données
ne supporte par un type de table donné, <function>odbc_tables</function>
ne retournera aucun résultat pour ce type.
@@ -1114,7 +1168,7 @@
<para>
<function>odbc_tableprivileges</function> liste les tables de la source
et leurs droits associés. Retourne un identifiant de résultat
- ODBC, ou bien FALSE en cas d'erreur.
+ ODBC, ou bien <literal>FALSE</literal> en cas d'erreur.
</para>
<para>
Le résultat possède les colonnes suivantes :
@@ -1161,7 +1215,7 @@
<para>
<function>odbc_columns</function> liste toutes les colonnes
de la source dedonnées. Retourne un identifiant de résultat
- ODBC, ou bien FALSE en cas d'erreur.
+ ODBC, ou bien <literal>FALSE</literal> en cas d'erreur.
</para>
<para>
Le résultat possède les colonnes suivantes :
@@ -1218,7 +1272,7 @@
<para>
<function>odbc_columnprivileges</function> liste les colonnes
et leurs droits associés pour la table <parameter>table_name</parameter>.
- Retourne un identifiant de résultat ODBC, ou bien FALSE en cas d'erreur.
+ Retourne un identifiant de résultat ODBC, ou bien
+<literal>FALSE</literal> en cas d'erreur.
</para>
<para>
Le résultat possède les colonnes suivantes :
@@ -1262,7 +1316,7 @@
<para>
<function>odbc_gettypeinfo</function> liste les types de données
qui sont supportées par une source. Retourne un identifiant de
- résultat, ou FALSE en cas d'erreur. L'argument optionel
+ résultat, ou <literal>FALSE</literal> en cas d'erreur. L'argument optionel
<parameter>data_type</parameter> peut être utilisé pour
restreindre les informations à un seul type de données.
</para>
@@ -1311,7 +1365,7 @@
<para>
<function>odbc_primarykeys</function> liste les colonnes
utilisées dans une clé primaire de la table
<parameter>table</parameter>.
- Retourne un identifiant de résultat, ou FALSE en cas d'erreur.
+ Retourne un identifiant de résultat, ou <literal>FALSE</literal> en cas
+d'erreur.
</para>
<para>
Le résultat possède les colonnes suivantes :
@@ -1350,7 +1404,7 @@
<para>
<function>odbc_foreignkeys</function> liste les clés
étrangèes
utilisées dans la table <parameter>pk_table</parameter>.
- Retourne un identifiant de résultat, ou FALSE en cas d'erreur.
+ Retourne un identifiant de résultat, ou <literal>FALSE</literal> en cas
+d'erreur.
</para>
<para>
Le résultat possède les colonnes suivantes :
@@ -1413,7 +1467,7 @@
<para>
<function>odbc_procedures</function> liste toutes les procédures
stockées dans la source de données. Retourne un identifiant de
- résultat, ou FALSE en cas d'erreur.
+ résultat, ou <literal>FALSE</literal> en cas d'erreur.
</para>
<para>
Le résultat possède les colonnes suivantes :
@@ -1458,7 +1512,7 @@
<function>odbc_procedurecolumns</function> list les paramètres
d'entrée et de sortie, ainsi que les colonnes utilisées dans les
procédures
désignées par les paramètres. Retourne un identifiant de
résultat, ou
- FALSE en cas d'erreur.
+ <literal>FALSE</literal> en cas d'erreur.
</para>
<para>
Le résultat possède les colonnes suivantes :
@@ -1524,7 +1578,7 @@
on puisse spécifier n'importe quelle ligne de manière unique.
</simpara>
<simpara>
- Retourne un identifiant de résultat, ou FALSE en cas d'erreur.
+ Retourne un identifiant de résultat, ou <literal>FALSE</literal> en cas
+d'erreur.
</simpara>
<para>
Le résultat possède les colonnes suivantes :
@@ -1565,7 +1619,7 @@
<para>
<function>odbc_statistics</function> effectue quelques statistiques
sur une tables et ses index. Retourne un identifiant de
- résultat, ou FALSE en cas d'erreur.
+ résultat, ou <literal>FALSE</literal> en cas d'erreur.
</para>
<para>
Le résultat possède les colonnes suivantes :
Index: phpdoc/fr/functions/url.xml
diff -u phpdoc/fr/functions/url.xml:1.4 phpdoc/fr/functions/url.xml:1.5
--- phpdoc/fr/functions/url.xml:1.4 Fri Dec 8 02:06:04 2000
+++ phpdoc/fr/functions/url.xml Mon Jan 22 03:58:33 2001
@@ -1,5 +1,5 @@
<reference id="ref.url">
- <title>Fonctions URL</title>
+ <title>URL</title>
<titleabbrev>Fonctions URL</titleabbrev>
<refentry id="function.base64-decode">
<refnamediv>
@@ -127,7 +127,7 @@
du transfert (contrairement à certains systèmes email).
Par exemple, si vous voulez mettre un mot de passe dans une URL de ftp :
<example>
- <title>Exemple avec <function>rawurlencode</function> example 1</title>
+ <title>Exemple avec <function>rawurlencode</function></title>
<programlisting role="php">
echo '<A HREF="ftp://user:', rawurlencode ('foo @+%/'),
'@ftp.my.com/x.txt">';
@@ -135,7 +135,7 @@
</example>
Ou, si vous transmettez un chemin dans une URL
<example>
- <title>Exemple avec <function>rawurlencode</function> example 2</title>
+ <title>Exemple avec <function>rawurlencode</function></title>
<programlisting role="php">
echo '<A HREF="http://x.com/department_list_script/',
rawurlencode ('sales et marketing/Miami'), '">';
@@ -169,6 +169,7 @@
<example>
<title>Exemple avec <function>urldecode</function></title>
<programlisting role="php">
+<?php
$a = split ('&', $querystring);
$i = 0;
while ($i < count ($a)) {
@@ -177,13 +178,13 @@
' is ', htmlspecialchars (urldecode ($b [1])), "<BR>";
$i++;
}
+?>
</programlisting>
</example>
</para>
<para>
- Voir aussi <function>urlencode</function>,
- <function>rawurlencode</function>,
- <function>rawurldecode</function>.
+ Voir aussi <function>urlencode</function>, <function>rawurlencode</function>
+ et <function>rawurldecode</function>.
</para>
</refsect1>
</refentry>
@@ -213,9 +214,9 @@
Ce codage est différent de celui spécifié
dans la RFC1738 (voir <function>rawurlencode</function>) : pour
des raisons historiques, les espaces sont remplacés par
- des signes plus (+). <function>urlencode</function> est pratique pour
transmettre
- des informations via une URL. C'est aussi un moyen de passer des
- informations d'une page à l'autre.
+ des signes plus (+). <function>urlencode</function> est pratique pour
+ transmettre des informations via une URL. C'est aussi un moyen de passer
+ des informations d'une page à l'autre.
<example>
<title>Exemple avec <function>urlencode</function></title>
<programlisting role="php">
@@ -227,31 +228,36 @@
Voir aussi <function>urldecode</function>.
</para>
<para>
- Note: Faites bien attention aux variables qui ressemblent à des
entitées
- HTML, comme par exemple &amp, &copy et &pound, qui sont
- analysées par le client web et remplacée par leur valeur, au lieu
- de passer le nom de variable désiré. C'est un vrai
problème qui a
- été montré par le W3C depuis longtemps. La
référence est ici :
+ Note: Faîtes bien attention aux variables qui ressemblent à
+ des entitées HTML, comme par exemple &amp, &copy et &pound,
+ qui sont analysées par le client web et remplacée par leur
+ valeur, au lieu de passer le nom de variable désiré. C'est
+ un vrai problème qui a été montré par le W3C
+ depuis longtemps. La référence est ici :
<ulink url="&url.argsep;">&url.argsep;</ulink>.
PHP supporte le remplacement de séparateur d'arguments par un
- point-virgule, comme recommandé par le W3C, grâce à la
directive
- arg_separator .ini. Malheureusement, la plus part des clients web
+ point-virgule, comme recommandé par le W3C, grâce à
+ la directive arg_separator .ini. Malheureusement, la plus part des clients web
n'envoie pas leur données de formulaire avec des point-virgule. Une
solution plus portable est d'utiliser &amp; à la place de &
comme
- séparateur. Vous n'avez alors pas à changer la directive
arg_separator. Laissez
- la à &, mais encodez vos URL avec
<function>htmlentities</function>(urlencode($data)).
+ séparateur. Vous n'avez alors pas à changer la directive
+ arg_separator. Laissez la à &, mais encodez vos URL avec
+ <function>htmlentities</function>(urlencode($data)).
<example>
- <title>Exemple avec <function>urlencode</function> et
<function>htmlentities</function></title>
+ <title>
+ Exemple avec <function>urlencode</function> et
+ <function>htmlentities</function>
+ </title>
<programlisting role="php">
+<?php
echo '<A HREF="moncgi?foo=', htmlentities (urlencode ($userinput) ), '">';
+?>
</programlisting>
</example>
</para>
<para>
- Voir aussi <function>urldecode</function>,
- <function>htmlentities</function>,
- <function>rawurldecode</function>,
- <function>rawurlencode</function>.
+ Voir aussi <function>urldecode</function>, <function>htmlentities</function>,
+ <function>rawurldecode</function> et <function>rawurlencode</function>.
</para>
</refsect1>
</refentry>
Index: phpdoc/fr/functions/var.xml
diff -u phpdoc/fr/functions/var.xml:1.8 phpdoc/fr/functions/var.xml:1.9
--- phpdoc/fr/functions/var.xml:1.8 Tue Dec 26 03:26:33 2000
+++ phpdoc/fr/functions/var.xml Mon Jan 22 03:58:33 2001
@@ -1,5 +1,5 @@
<reference id="ref.var">
- <title>Fonctions sur les variables</title>
+ <title>Variables</title>
<titleabbrev>Fonctions sur les variables</titleabbrev>
<refentry id="function.doubleval">
<refnamediv>
@@ -51,17 +51,17 @@
<paramdef>mixed <parameter>var</parameter></paramdef>
</funcsynopsis>
<para>
- <function>empty</function> retourne la valeur FALSE si la variable
+ <function>empty</function> retourne la valeur <literal>FALSE</literal> si la
+variable
<parameter>var</parameter> est affectée ou bien a une valeur
- différente de 0; la valeur TRUE dans les autres cas.
+ différente de 0; la valeur <literal>TRUE</literal> dans les autres cas.
<informalexample>
<programlisting role="php">
<?php
$var = 0;
-if (empty($var)) { // retourne TRUE
+if (empty($var)) { // retourne <literal>TRUE</literal>
print 'soit $var vaut 0, soit il n'est pas défini';
}
-if (!isset($var)) { // retourne FALSE
+if (!isset($var)) { // retourne <literal>FALSE</literal>
print '$var n'est pas définie';
}
?>
@@ -180,8 +180,8 @@
</funcprototype>
</funcsynopsis>
<para>
- Renvoie la valeur TRUE si la variable <parameter>var</parameter> est un tableau,
- FALSE sinon.
+ Renvoie la valeur <literal>TRUE</literal> si la variable
+<parameter>var</parameter> est un tableau,
+ <literal>FALSE</literal> sinon.
</para>
<para>
Voir aussi <function>is_double</function>,
@@ -215,7 +215,7 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>is_bool</function> retourne TRUE si <parameter>var</parameter>
+ <function>is_bool</function> retourne <literal>TRUE</literal> si
+<parameter>var</parameter>
est un booléen.
</para>
<para>
@@ -245,8 +245,8 @@
</funcprototype>
</funcsynopsis>
<para>
- Renvoie TRUE si la variable <parameter>var</parameter> est du type "double",
- FALSE sinon.
+ Renvoie <literal>TRUE</literal> si la variable <parameter>var</parameter> est
+du type "double",
+ <literal>FALSE</literal> sinon.
</para>
<para>
Voir aussi <function>is_array</function>,
@@ -363,8 +363,8 @@
</funcprototype>
</funcsynopsis>
<para>
- Renvoie TRUE si la variable <parameter>var</parameter> est du type
- integer (long), FALSE sinon.
+ Renvoie <literal>TRUE</literal> si la variable <parameter>var</parameter> est
+du type
+ integer (long), <literal>FALSE</literal> sinon.
</para>
<para>
Voir aussi <function>is_bool</function>,
@@ -395,9 +395,9 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>is_numeric</function> retourne TRUE si
+ <function>is_numeric</function> retourne <literal>TRUE</literal> si
<parameter>var</parameter> est un nombre, ou une chaîne
- numérique, ou FALSE sinon.
+ numérique, ou <literal>FALSE</literal> sinon.
</para>
<para>
Voir aussi <function>is_bool</function>,
@@ -426,8 +426,8 @@
</funcprototype>
</funcsynopsis>
<para>
- Renvoie TRUE si la variable <parameter>var</parameter> est un objet,
- FALSE sinon.
+ Renvoie <literal>TRUE</literal> si la variable <parameter>var</parameter> est un
+objet,
+ <literal>FALSE</literal> sinon.
</para>
<para>
Voir aussi <function>is_bool</function>,
@@ -491,8 +491,8 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>is_resource</function> retourne TRUE si la variable
- <parameter>var</parameter> est une ressource PHP, sinon FALSE.
+ <function>is_resource</function> retourne <literal>TRUE</literal> si la variable
+ <parameter>var</parameter> est une ressource PHP, sinon <literal>FALSE</literal>.
</para>
<para>
Les ressources peuvent être des pointeurs de fichiers, des identifiants
@@ -516,8 +516,8 @@
</funcprototype>
</funcsynopsis>
<para>
- Renvoie TRUE si la variable <parameter>var</parameter> est du type "string",
- FALSE sinon.
+ Renvoie <literal>TRUE</literal> si la variable <parameter>var</parameter> est
+du type "string",
+ <literal>FALSE</literal> sinon.
</para>
<para>
Voir aussi <function>is_long</function>,
@@ -544,21 +544,20 @@
</funcprototype>
</funcsynopsis>
<simpara>
- Renvoie TRUE si la variable <parameter>var</parameter> est définie,
- FALSE sinon.
+ Renvoie <literal>TRUE</literal> si la variable <parameter>var</parameter> est
+définie,
+ <literal>FALSE</literal> sinon.
</simpara>
<para>
Si une variable a été désaffectée avec la fonction
<function>unset</function>, la fonction <function>isset</function> renverra
- FALSE.
+ <literal>FALSE</literal>.
<informalexample>
<programlisting role="php">
<?php
$a = "test";
-echo isset ($a); // TRUE
+echo isset ($a); // <literal>TRUE</literal>
unset($a);
-echo isset ($a); // FALSE
-?>
+echo isset ($a); // <literal>FALSE</literal> ?>
</programlisting>
</informalexample>
</para>
@@ -694,7 +693,7 @@
</itemizedlist>
</para>
<para>
- Renvoie TRUE en cas de succès, FALSE sinon.
+ Renvoie <literal>TRUE</literal> en cas de succès,
+<literal>FALSE</literal> sinon.
</para>
<para>
Voir aussi <function>gettype</function>.
@@ -747,8 +746,8 @@
</funcsynopsis>
<simpara>
<function>unserialize</function> prend une variable linéarisée
- (voir <function>serialize</function>) et la converti en variable PHP.
- Ma valeur convertie est retournée par la fonction, et peut être de
+ (voir <function>serialize</function>) et la convertit en variable PHP.
+ La valeur convertie est retournée par la fonction, et peut être de
type <type>integer</type>, <type>double</type>,
<type>string</type>, <type>array</type> ou <type>object</type>.
Les objets linéarisés perdent leurs méthodes.
@@ -798,7 +797,7 @@
</funcsynopsis>
<para>
<function>unset</function> détruit les variables
<parameter>var</parameter>,
- et retourne TRUE.
+ et retourne <literal>TRUE</literal>.
</para>
<para>
<example>
@@ -840,9 +839,9 @@
</informalexample>
L'exemple ci dessus affichera :
<informalexample>
- <programlisting>
+ <computeroutput>
bar
- </programlisting>
+ </computeroutput>
</informalexample>
</para>
<para>
@@ -853,7 +852,7 @@
<informalexample>
<programlisting role="php">
<?php
-function foo(&$bar) {
+function foo(&$bar) {
unset($bar);
$bar = "bla";
}
@@ -866,10 +865,10 @@
</informalexample>
L'exemple ci dessus va afficher :
<informalexample>
- <programlisting>
+ <computeroutput>
truc
truc
- </programlisting>
+ </computeroutput>
</informalexample>
</para>
<para>
@@ -893,11 +892,11 @@
</informalexample>
L'affichage du script ci-dessus donnera :
<informalexample>
- <programlisting>
+ <computeroutput>
1
2
3
- </programlisting>
+ </computeroutput>
</informalexample>
</para>
<para>
Index: phpdoc/fr/functions/vmailmgr.xml
diff -u phpdoc/fr/functions/vmailmgr.xml:1.3 phpdoc/fr/functions/vmailmgr.xml:1.4
--- phpdoc/fr/functions/vmailmgr.xml:1.3 Fri Nov 17 04:24:59 2000
+++ phpdoc/fr/functions/vmailmgr.xml Mon Jan 22 03:58:33 2001
@@ -1,5 +1,5 @@
<reference id="ref.vmailmgr">
- <title>Fonctions Vmailmgr</title>
+ <title>Vmailmgr</title>
<titleabbrev>Vmailmgr</titleabbrev>
<partintro>
<simpara>
@@ -24,7 +24,8 @@
<member>1 mauvais</member>
<member>2 erreur</member>
<member>3 erreur de connexion</member>
- </simplelist></para>
+ </simplelist>
+ </para>
<para>
<emphasis>Problème connu</emphasis> : <function>vm_deluser</function>
n'efface pas
un utilisateur d'un dossier comme il devrait le faire.
@@ -32,14 +33,15 @@
</para>
<para>
<informalexample>
- <programlisting>
+ <programlisting role="php">
<?php
dl("php3_vmailmgr.so"); //charge la librairie
$vdomain="vdomain.com";
$basepwd="password";
-?>
+?>
</programlisting>
- </informalexample></para>
+ </informalexample>
+ </para>
</partintro>
<refentry id="function.vm-adduser">
<refnamediv>
@@ -58,8 +60,9 @@
</funcprototype>
</funcsynopsis>
<simpara>
- Ajoute une nouvel utilisateur virtuel <parameter>newusername</parameter>,
- avec le mot de passe <parameter>newuserpassword</parameter>.
+ <function>vm_adduser</function>joute une nouvel utilisateur virtuel
+ <parameter>newusername</parameter>, avec le mot de passe
+ <parameter>newuserpassword</parameter>.
</simpara>
</refsect1>
</refentry>
Index: phpdoc/fr/functions/wddx.xml
diff -u phpdoc/fr/functions/wddx.xml:1.3 phpdoc/fr/functions/wddx.xml:1.4
--- phpdoc/fr/functions/wddx.xml:1.3 Wed Dec 27 00:53:25 2000
+++ phpdoc/fr/functions/wddx.xml Mon Jan 22 03:58:33 2001
@@ -3,15 +3,21 @@
<titleabbrev>WDDX</titleabbrev>
<partintro>
<para>
- Ces fonctions opèrent avec l'aide de <ulink url="&url.wddx;">WDDX</ulink>.
+ Ces fonctions doivent fonctionner avec l'aide de <ulink
+url="&url.wddx;">WDDX</ulink>.
</para>
<para>
- Notez bien que toutes les fonctions qui enregistrent des données,
- utilisent le premier élément d'un tableau pour savoir si
- ce tableau doit être enregistré sous la forme d'un tableau,
- ou d'une structure. Si le premier élément a une clé de
- type chaîne, le tableau sera enregistré sous la forme d'une
- structure, et sinon, sous la forme d'un tableau.
+ Pour utiliser WDDX, you devez installer la librairie EXPAT (qui est fournie
+ avec la distribution d'Apache 1.3.7 ou plus récent), et recompiler PHP
+ avec <option role="configure">--with-xml</option> et
+ <option role="configure">--enable-wddx</option>.
+ </para>
+ <para>
+ Notez bien que toutes les fonctions qui enregistrent des données,
+ utilisent le premier élément d'un tableau pour savoir si
+ ce tableau doit être enregistré sous la forme d'un tableau,
+ ou d'une structure. Si le premier élément a une clé de
+ type chaîne, le tableau sera enregistré sous la forme d'une
+ structure, et sinon, sous la forme d'un tableau.
<example>
<title>Enregistrer une valeur simple</title>
<programlisting role="php">
@@ -25,7 +31,7 @@
Cet exemple va produire le résultat suivant :
<informalexample>
<programlisting role="php">
-<wddxPacket version='0.9'><header comment='Paquet PHP'/><data>
+<wddxPacket version='0.9'><header comment='Paquet PHP' ><data>
<string>Exemple de paquet de PHP à
WDDX</string></data></wddxPacket>
</programlisting>
</informalexample>
@@ -43,17 +49,19 @@
print $packet;
?>
</programlisting>
- </example></para>
+ </example>
+ </para>
<para>
Cet exemple donnera :
<informalexample>
<programlisting role="php">
-<wddxPacket version='0.9'><header
comment='PHP'/><data><struct>
+<wddxPacket version='0.9'><header comment='PHP'
+><data><struct>
<var name='pi'><number>3.1415926</number></var><var
name='cities'>
<array
length='3'><string>Paris</string><string>Marseilles</string>
<string>Lyon</string></array></var></struct></data></wddxPacket>
</programlisting>
- </informalexample></para>
+ </informalexample>
+ </para>
</partintro>
<refentry id="function.wddx-serialize-value">
<refnamediv>
@@ -110,7 +118,7 @@
<para>
<example>
<title><function>wddx_serialize_vars</function></title>
- <programlisting>
+ <programlisting role="php">
<?php
$a = 1;
$b = 5.5;
@@ -120,15 +128,17 @@
print wddx_serialize_vars("a", "b", $clvars);
?>
</programlisting>
- </example></para>
+ </example>
+ </para>
<para>
L'exemple ci-dessus donnera :
- <programlisting>
-<wddxPacket version='0.9'><header/><data><struct><var
name='a'><number>1</number></var>
+ <computeroutput>
+<wddxPacket version='0.9'><header ><data><struct><var
+name='a'><number>1</number></var>
<var name='b'><number>5.5</number></var><var
name='c'><array length='3'>
<string>bleu</string><string>orange</string><string>violet</string></array></var>
<var
name='d'><string>colors</string></var></struct></data></wddxPacket>
- </programlisting></para>
+ </computeroutput>
+ </para>
</refsect1>
</refentry>
<refentry id="function.wddx-packet-start">
Index: phpdoc/fr/functions/xml.xml
diff -u phpdoc/fr/functions/xml.xml:1.2 phpdoc/fr/functions/xml.xml:1.3
--- phpdoc/fr/functions/xml.xml:1.2 Thu Nov 23 06:26:50 2000
+++ phpdoc/fr/functions/xml.xml Mon Jan 22 03:58:33 2001
@@ -7,22 +7,22 @@
<sect2 id="xml.intro">
<title>A propos de XML</title>
<para>
- Le langage XML (eXtensible Markup Language (Langage à Balises
- Etendu)) est un format structuré de données pour les
- échanges sur le web. C'est un standard défini par le
- consortium World Wide Web (W3C). Plus d'informations à propos
- du XML et des technologies afférentes sont accessibles (en anglais)
- <ulink url="&url.xml;">&url.xml;</ulink>.
+ Le langage XML (eXtensible Markup Language (Langage à Balises
+ Etendu)) est un format structuré de données pour les
+ échanges sur le web. C'est un standard défini par le
+ consortium World Wide Web (W3C). Plus d'informations à propos
+ du XML et des technologies afférentes sont accessibles (en anglais)
+ <ulink url="&url.xml;">&url.xml;</ulink>.
</para>
</sect2>
<sect2 id="xml.install">
<title>Installation</title>
<para>
- Cette extension de PHP utilise <productname>expat</productname>,
- disponible à <ulink url="&url.expat;">&url.expat;</ulink>.
- Le fichier Makefile livré avec <productname>expat</productname>
- ne construit pas par défaut de librairie : il faut utiliser
- la ligne suivante :
+ Cette extension de PHP utilise <productname>expat</productname>,
+ disponible à <ulink url="&url.expat;">&url.expat;</ulink>.
+ Le fichier Makefile livré avec <productname>expat</productname>
+ ne construit pas par défaut de librairie : il faut utiliser
+ la ligne suivante :
<programlisting role="makefile">
libexpat.a: $(OBJS)
ar -rc $@ $(OBJS)
@@ -110,7 +110,7 @@
<entry>
Les programmeurs PHP sont habitués aux instructions
exécutables (processing instructions ou PIs).
- <?php ?> est une instruction exécutable oú
+ <literal><?php ?></literal> est une instruction exécutable
+oú
php est appelé programme cible. Ces instructions sont
gérées de manière spécifiques,
(sauf le programme cible, qui est réservé à XML).
@@ -270,6 +270,7 @@
<example>
<title>Afficher une structure XML</title>
<programlisting role="php">
+<?php
$file = "data.xml";
$depth = array();
function startElement($parser, $name, $attrs) {
@@ -297,6 +298,7 @@
}
}
xml_parser_free($xml_parser);
+?>
</programlisting>
</example>
</para>
@@ -312,6 +314,7 @@
Bien entendu, cet exemple sera appliqué à un type
précis de fichiers XML.
<programlisting role="php">
+<?php
$file = "data.xml";
$map_array = array(
"BOLD" => "B",
@@ -335,7 +338,7 @@
}
$xml_parser = xml_parser_create();
// use case-folding so we are sure to find the tag in $map_array
-xml_parser_set_option($xml_parser, XML_OPTION_CASE_FOLDING, true);
+xml_parser_set_option($xml_parser, XML_OPTION_CASE_FOLDING, <literal>TRUE</literal>);
xml_set_element_handler($xml_parser, "startElement", "endElement");
xml_set_character_data_handler($xml_parser, "characterData");
if (!($fp = fopen($file, "r"))) {
@@ -349,6 +352,7 @@
}
}
xml_parser_free($xml_parser);
+?>
</programlisting>
</para>
</example>
@@ -373,14 +377,15 @@
<example>
<title>Entitée externe</title>
<programlisting role="php">
+<?php
$file = "xmltest.xml";
function trustedFile($file) {
// only trust local files owned by ourselves
if (!eregi("^([a-z]+)://", $file)
&& fileowner($file) == getmyuid()) {
- return true;
+ return <literal>TRUE</literal>;
}
- return false;
+ return <literal>FALSE</literal>;
}
function startElement($parser, $name, $attribs) {
print "&lt;<font color=\"#0000cc\">$name</font>";
@@ -396,7 +401,7 @@
print "&lt;/<font color=\"#0000cc\">$name</font>&gt;";
}
function characterData($parser, $data) {
- print "<b>$data</b>";
+ print "<B>$data</B>";
}
function PIHandler($parser, $target, $data) {
switch (strtolower($target)) {
@@ -408,7 +413,7 @@
if (trustedFile($parser_file[$parser])) {
eval($data);
} else {
- printf("Untrusted PHP code: <i>%s</i>",
+ printf("Code PHP peu sûr : <B>%s</B>",
htmlspecialchars($data));
}
break;
@@ -429,7 +434,7 @@
if (!list($parser, $fp) = new_xml_parser($systemId)) {
printf("Could not open entity %s at %s\n", $openEntityNames,
$systemId);
- return false;
+ return <literal>FALSE</literal>;
}
while ($data = fread($fp, 4096)) {
if (!xml_parse($parser, $data, feof($fp))) {
@@ -437,13 +442,13 @@
xml_error_string(xml_get_error_code($parser)),
xml_get_current_line_number($parser), $openEntityNames);
xml_parser_free($parser);
- return false;
+ return <literal>FALSE</literal>;
}
}
xml_parser_free($parser);
- return true;
+ return <literal>TRUE</literal>;
}
- return false;
+ return <literal>FALSE</literal>;
}
function new_xml_parser($file) {
global $parser_file;
@@ -455,7 +460,7 @@
xml_set_default_handler($xml_parser, "defaultHandler");
xml_set_external_entity_ref_handler($xml_parser, "externalEntityRefHandler");
if (!($fp = @fopen($file, "r"))) {
- return false;
+ return <literal>FALSE</literal>;
}
if (!is_array($parser_file)) {
settype($parser_file, "array");
@@ -489,7 +494,7 @@
<!DOCTYPE chapter SYSTEM "/just/a/test.dtd" [
<!ENTITY plainEntity "FOO entity">
<!ENTITY systemEntity SYSTEM "xmltest2.xml">
-]>
+?>
<chapter>
<TITLE>Title &plainEntity;</TITLE>
<para>
@@ -507,8 +512,8 @@
<sect1 id="about">
<title>About this Document</title>
<para>
- <!-- this is a comment -->
- <?php print 'Hi! This is PHP version '.phpversion(); ?>
+ <!-- this is a comment -">
+ <?php print 'Hi! This is PHP version '.phpversion(); ">
</para>
</sect1>
</chapter>
@@ -520,12 +525,12 @@
<example>
<title>xmltest2.xml</title>
<programlisting role="xml">
-<?xml version="1.0"?>
+<?xml version="1.0" ?>
<!DOCTYPE foo [
<!ENTITY testEnt "test entity">
-]>
+?>
<foo>
- <element attrib="value"/>
+ <element attrib="value"?>
&testEnt;
<?php print "This is some more PHP code being executed."; ?>
</foo>
@@ -570,7 +575,7 @@
Cette fonction crée un analyseur XML et retourne une
référence sur cet analyseur pour qu'il puisse
être utilisé ultérieurement par d'autres
- fonctions XML. Retourne FALSE en cas d'erreur.
+ fonctions XML. Retourne <literal>FALSE</literal> en cas d'erreur.
</para>
</refsect1>
</refentry>
@@ -618,9 +623,9 @@
function tag_close($parser,$tag) {
var_dump($parser,$tag);
}
-} // end of class xml
+} // Fin de la classe xml
$xml_parser = new xml();
-$xml_parser->parse("<A ID=\"hallo\">PHP</A>");
+$xml_parser->parse("<A ID=\"bonjour\">PHP</?>");
?>
</programlisting>
</refsect1>
@@ -745,11 +750,11 @@
</variablelist>
</para>
<para>
- Si un gestionnaire recoit une chaîne vide, ou FALSE, c'est qu'il est en
+ Si un gestionnaire recoit une chaîne vide, ou <literal>FALSE</literal>,
+c'est qu'il est en
train d'être désactivé.
</para>
<para>
- Retourne TRUE si le gestionnaire est actif, et FALSE sinon, ou si
+ Retourne <literal>TRUE</literal> si le gestionnaire est actif, et
+<literal>FALSE</literal> sinon, ou si
<parameter>parser</parameter> n'est pas un analyseur.
</para>
<para>
@@ -796,8 +801,8 @@
<term><parameter>parser</parameter></term>
<listitem>
<simpara>
- Le premier paramètre, <replaceable>parser</replaceable>, est
- une référence sur l'analyseur XML qui appelle cette fonction.
+ Le premier paramètre, <replaceable>parser</replaceable>, est
+ une référence sur l'analyseur XML qui appelle cette fonction.
</simpara>
</listitem>
</varlistentry>
@@ -805,18 +810,19 @@
<term><parameter>data</parameter></term>
<listitem>
<simpara>
- Le second paramètre, <parameter>data</parameter>, contient
- les caractères sous la forme d'une chaîne.
+ Le second paramètre, <parameter>data</parameter>, contient
+ les caractères sous la forme d'une chaîne.
</simpara>
</listitem>
</varlistentry>
- </variablelist></para>
+ </variablelist>
+ </para>
<para>
- Si un gestionnaire reçoit une chaîne vide ou FALSE, c'est
+ Si un gestionnaire reçoit une chaîne vide ou
+<literal>FALSE</literal>, c'est
qu'il est en train d'être désactivé.
</para>
<para>
- Retourne TRUE si le gestionnaire est actif, et FALSE sinon, ou si
+ Retourne <literal>TRUE</literal> si le gestionnaire est actif, et
+<literal>FALSE</literal> sinon, ou si
<parameter>parser</parameter> n'est pas un analyseur.
</para>
<para>
@@ -852,11 +858,12 @@
<parameter>parser</parameter>.
</para>
<para>
- Une instruction exécutable a la forme suivante ::
+ Une instruction exécutable a la forme suivante :
<informalexample>
- <programlisting><?
+ <programlisting>
+<?
<replaceable>target</replaceable>
- <replaceable>data</replaceable>?>
+ <replaceable>data</replaceable>
</programlisting>
</informalexample>
Vous pouvez mettre du code PHP entre ces balises, mais soyez conscient d'une
@@ -905,13 +912,14 @@
le code sous la forme d'une chaîne.
</simpara></listitem>
</varlistentry>
- </variablelist></para>
+ </variablelist>
+ </para>
<para>
- Si un gestionnaire reçoit une chaîne vide, ou FALSE,
+ Si un gestionnaire reçoit une chaîne vide, ou
+<literal>FALSE</literal>,
c'est qu'il est en train d'être désactivé.
</para>
<para>
- Retourne TRUE si le gestionnaire est actif, et FALSE sinon, ou si
+ Retourne <literal>TRUE</literal> si le gestionnaire est actif, et
+<literal>FALSE</literal> sinon, ou si
<parameter>parser</parameter> n'est pas un analyseur.
</para>
<para>
@@ -960,8 +968,8 @@
</term>
<listitem>
<simpara>
- Le premier paramètre, <replaceable>parser</replaceable>, est une
- référence sur l'analyseur XML qui appelle cette fonction.
+ Le premier paramètre, <replaceable>parser</replaceable>, est une
+ référence sur l'analyseur XML qui appelle cette fonction.
</simpara>
</listitem>
</varlistentry>
@@ -971,21 +979,21 @@
</term>
<listitem>
<simpara>
- Le second paramètre, <parameter>data</parameter>, contient les
- caractères sous la forme d'une chaîne. Cela peut être
- une déclaration XML, un type de document, une entité ou
- d'autre données pour qui aucun gestionnaire n'est prévu.
+ Le second paramètre, <parameter>data</parameter>, contient les
+ caractères sous la forme d'une chaîne. Cela peut être
+ une déclaration XML, un type de document, une entité ou
+ d'autre données pour qui aucun gestionnaire n'est prévu.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
<para>
- Si un gestionnaire reçoit une chaîne vide ou FALSE, c'est
+ Si un gestionnaire reçoit une chaîne vide ou
+<literal>FALSE</literal>, c'est
qu'il est en train d'être désactivé.
</para>
<para>
- Retourne TRUE si le gestionnaire est actif, et FALSE sinon, ou si
+ Retourne <literal>TRUE</literal> si le gestionnaire est actif, et
+<literal>FALSE</literal> sinon, ou si
<parameter>parser</parameter> n'est pas un analyseur.
</para>
<para>
@@ -1026,7 +1034,7 @@
de NDATA, comme suit :
<programlisting role="xml">
<!ENTITY <parameter>name</parameter> {<parameter>publicId</parameter> |
<parameter>systemId</parameter>}
- NDATA <parameter>notationName</parameter>>
+ NDATA <parameter>notationName</parameter>
</programlisting>
</para>
<para>
@@ -1052,8 +1060,8 @@
<term><parameter>parser</parameter></term>
<listitem>
<simpara>
- Le premier paramètre, <replaceable>parser</replaceable>, est une
- référence sur l'analyseur XML qui appelle cette fonction.
+ Le premier paramètre, <replaceable>parser</replaceable>, est une
+ référence sur l'analyseur XML qui appelle cette fonction.
</simpara>
</listitem>
</varlistentry>
@@ -1095,18 +1103,19 @@
<term><parameter>notationName</parameter></term>
<listitem>
<simpara>
- Nom de la notation de cette entité. (Voir
- <function>xml_set_notation_decl_handler</function>).
+ Nom de la notation de cette entité. (Voir
+ <function>xml_set_notation_decl_handler</function>).
</simpara>
</listitem>
</varlistentry>
- </variablelist></para>
+ </variablelist>
+ </para>
<para>
- Si un gestionnaire reçoit une chaîne vide ou FALSE,
+ Si un gestionnaire reçoit une chaîne vide ou
+<literal>FALSE</literal>,
c'est qu'il est en train d'être désactivé.
</para>
<para>
- Retourne TRUE si le gestionnaire est actif, et FALSE sinon, ou si
+ Retourne <literal>TRUE</literal> si le gestionnaire est actif, et
+<literal>FALSE</literal> sinon, ou si
<parameter>parser</parameter> n'est pas un analyseur.
</para>
<para>
@@ -1140,12 +1149,14 @@
<parameter>parser</parameter>.
</para>
<para>
- Une notation est une partie du DTD du document, qui a le format suivant :
- <programlisting role="xml"><!NOTATION <parameter>name</parameter>
{<parameter>systemId</parameter> |
- <parameter>publicId</parameter>}></programlisting>
- Reportez vous à la section
- <ulink url="&url.rec-xml;#sec-external-ent">des spécifications XML
1.0</ulink>
- pour connaître les notations des entités externes.
+ Une notation est une partie du DTD du document, qui a le format suivant :
+ <programlisting role="xml">
+<!NOTATION <parameter>name</parameter>
+{ <parameter>systemId</parameter> | <parameter>publicId</parameter>?>
+ </programlisting>
+ Reportez vous à la section
+ <ulink url="&url.rec-xml;#sec-external-ent">des spécifications XML
+1.0</ulink>
+ pour connaître les notations des entités externes.
</para>
<para>
La fonction <parameter>handler</parameter> doit accepter cinq
@@ -1167,8 +1178,8 @@
</term>
<listitem>
<simpara>
- Le premier paramètre, <replaceable>parser</replaceable>, est une
- référence sur l'analyseur XML qui appelle cette fonction.
+ Le premier paramètre, <replaceable>parser</replaceable>, est une
+ référence sur l'analyseur XML qui appelle cette fonction.
</simpara>
</listitem>
</varlistentry>
@@ -1176,8 +1187,8 @@
<term><parameter>notationName</parameter></term>
<listitem>
<simpara>
- Le nom de la notation,<parameter>name</parameter>, comme
- précisé dans le format de notation ci dessus.
+ Le nom de la notation,<parameter>name</parameter>, comme
+ précisé dans le format de notation ci dessus.
</simpara>
</listitem>
</varlistentry>
@@ -1187,9 +1198,9 @@
</term>
<listitem>
<simpara>
- La meilleure base de résolution de l'identifiant système
- de cette entité externe. Actuellement, ce paramètre
- est toujours une chaîne vide.
+ La meilleure base de résolution de l'identifiant système
+ de cette entité externe. Actuellement, ce paramètre
+ est toujours une chaîne vide.
</simpara>
</listitem>
</varlistentry>
@@ -1197,7 +1208,7 @@
<term><parameter>systemId</parameter></term>
<listitem>
<simpara>
- Identifiant système pour cette entitée externe.
+ Identifiant système pour cette entitée externe.
</simpara>
</listitem>
</varlistentry>
@@ -1207,18 +1218,18 @@
</term>
<listitem>
<simpara>
- Identifiant public pour cet entité externe.
+ Identifiant public pour cet entité externe.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
<para>
- Si un gestionnaire reçoit une chaîne vide ou FALSE,
+ Si un gestionnaire reçoit une chaîne vide ou
+<literal>FALSE</literal>,
c'est qu'il est en train d'être désactivé.
</para>
<para>
- Retourne TRUE si le gestionnaire est actif, et FALSE sinon ou si
+ Retourne <literal>TRUE</literal> si le gestionnaire est actif, et
+<literal>FALSE</literal> sinon ou si
<parameter>parser</parameter> n'est pas un analyseur.
</para>
<para>
@@ -1255,7 +1266,7 @@
<para>
La fonction <parameter>handler</parameter> doit accepter 5
paramètres, et retourner un entier. Si la valeur retourné par
- le gestionnaire est FALSE (comme par exemple si aucune valeur n'est
+ le gestionnaire est <literal>FALSE</literal> (comme par exemple si aucune
+valeur n'est
retournée), l'analyseur XML s'arrêtera, et la fonction
<function>xml_get_error_code</function> retournera
<systemitem class="constant">XML_ERROR_EXTERNAL_ENTITY_HANDLING</systemitem>.
@@ -1276,8 +1287,8 @@
<term><parameter>parser</parameter></term>
<listitem>
<simpara>
- Le premier paramètre,<replaceable>parser</replaceable>, est une
- référence sur l'analyseur XML qui appelle cette fonction.
+ Le premier paramètre,<replaceable>parser</replaceable>, est une
+ référence sur l'analyseur XML qui appelle cette fonction.
</simpara>
</listitem>
</varlistentry>
@@ -1285,10 +1296,10 @@
<term><parameter>openEntityNames</parameter></term>
<listitem>
<simpara>
- Le deuxième paramètre, <parameter>openEntityNames</parameter>,
- est i.e. liste de noms d'entité, séparés par des
- espaces. Ces entités sont accessibles à l'analyse par cet
- entité (y compris le nom de l'entité reférencé).
+ Le deuxième paramètre, <parameter>openEntityNames</parameter>,
+ est i.e. liste de noms d'entité, séparés par des
+ espaces. Ces entités sont accessibles à l'analyse par cet
+ entité (y compris le nom de l'entité reférencé).
</simpara>
</listitem>
</varlistentry>
@@ -1296,9 +1307,9 @@
<term><parameter>base</parameter></term>
<listitem>
<simpara>
- La meilleure base de résolution de l'identifiant système
- de cet entité externe. Actuellement, ce paramètre est
- toujours une chaîne vide.
+ La meilleure base de résolution de l'identifiant système
+ de cet entité externe. Actuellement, ce paramètre est
+ toujours une chaîne vide.
</simpara>
</listitem>
</varlistentry>
@@ -1306,7 +1317,7 @@
<term><parameter>systemId</parameter></term>
<listitem>
<simpara>
- Identifiant système pour cet entité externe.
+ Identifiant système pour cet entité externe.
</simpara>
</listitem>
</varlistentry>
@@ -1314,23 +1325,23 @@
<term><parameter>publicId</parameter></term>
<listitem>
<simpara>
- Le cinquième paramètre, <parameter>publicId</parameter>,
- est l'identifiant public, comme spécifié dans la
- déclaration d'entité, ou un chaîne vide, si
- aucune déclaration n'a été spécifiée.
- L'espace dans l'identifiant public sera normalisé comme
- spécifié dans les spécifications XML.
+ Le cinquième paramètre, <parameter>publicId</parameter>,
+ est l'identifiant public, comme spécifié dans la
+ déclaration d'entité, ou un chaîne vide, si
+ aucune déclaration n'a été spécifiée.
+ L'espace dans l'identifiant public sera normalisé comme
+ spécifié dans les spécifications XML.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
<para>
- Si un gestionnaire reçoit une chaîne vide, ou FALSE, c'est qu'il
est en train
+ Si un gestionnaire reçoit une chaîne vide, ou
+<literal>FALSE</literal>, c'est qu'il est en train
d'être désactivé.
</para>
<para>
- Retourne TRUE si le gestionnaire est actif, et FALSE sinon ou si
+ Retourne <literal>TRUE</literal> si le gestionnaire est actif, et
+<literal>FALSE</literal> sinon ou si
<parameter>parser</parameter> n'est pas un analyseur.
</para>
<para>
@@ -1371,11 +1382,11 @@
<term><parameter>data</parameter></term>
<listitem>
<simpara>
- Une partie des données à analyser. Un document peut
- être analysé morceau par morceau, en appelant
- <function>xml_parse</function> plusieurs fois, tant que le
- paramètre <parameter>isFinal</parameter> est mis à
- TRUE pour le dernier morceau.
+ Une partie des données à analyser. Un document peut
+ être analysé morceau par morceau, en appelant
+ <function>xml_parse</function> plusieurs fois, tant que le
+ paramètre <parameter>isFinal</parameter> est mis à
+ <literal>TRUE</literal> pour le dernier morceau.
</simpara>
</listitem>
</varlistentry>
@@ -1383,8 +1394,8 @@
<term><parameter>isFinal</parameter> (optional)</term>
<listitem>
<simpara>
- Si il vaut TRUE, <parameter>data</parameter> est la dernière partie
- à analyser.
+ Si il vaut <literal>TRUE</literal>, <parameter>data</parameter> est la
+dernière partie
+ à analyser.
</simpara>
</listitem>
</varlistentry>
@@ -1393,11 +1404,11 @@
<para>
Lorsqu'un document XML est analysé, les gestionnaires
d'événements sont appelés aussi souvent que
- nécessaire, et retournent TRUE ou FALSE.
+ nécessaire, et retournent <literal>TRUE</literal> ou
+<literal>FALSE</literal>.
</para>
<para>
- TRUE est retourné lorsque l'analyse a été concluante,
- et FALSE en cas d'échec, ou si <parameter>parser</parameter> n'est pas
+ <literal>TRUE</literal> est retourné lorsque l'analyse a
+été concluante,
+ et <literal>FALSE</literal> en cas d'échec, ou si
+<parameter>parser</parameter> n'est pas
un analyseur valide. Lors d'un échec d'analyse, la cause de l'erreur
peut être obtenue grâce aux fonctions
<function>xml_get_error_code</function>, <function>xml_error_string</function>,
@@ -1426,7 +1437,7 @@
<term><parameter>parser</parameter></term>
<listitem>
<simpara>
- Cette fonction retourne FALSE si <parameter>parser</parameter> n'est pas
+ Cette fonction retourne <literal>FALSE</literal> si
+<parameter>parser</parameter> n'est pas
valide, ou sinon, retourne le numéro de colonne courante de la
ligne courante de l'analyseur, qui correspond à la position
d'analyse courante de l'analyseur XML.
@@ -1436,7 +1447,7 @@
</variablelist>
</para>
<para>
- Cette fonction retourne FALSE si <parameter>parser</parameter> n'est pas
valide,
+ Cette fonction retourne <literal>FALSE</literal> si
+<parameter>parser</parameter> n'est pas valide,
ou sinon, retourne le numéro de colonne courante de la ligne courante de
l'analyseur, qui correspond à la position d'analyse courante de
l'analyseur XML.
@@ -1470,7 +1481,7 @@
</para>
<para>
Retourne la chaîne avec un message textuel, décrivant l'erreur
- <parameter>code</parameter>, ou FALSE si aucune description n'a
+ <parameter>code</parameter>, ou <literal>FALSE</literal> si aucune description
+n'a
été trouvée.
</para>
</refsect1>
@@ -1505,7 +1516,7 @@
</variablelist>
</para>
<para>
- Cette fonction retourne FALSE si <parameter>parser</parameter> n'est
+ Cette fonction retourne <literal>FALSE</literal> si
+<parameter>parser</parameter> n'est
pas valide, ou sinon, retourne le numéro de la ligne en cours
d'analyse.
</para>
@@ -1541,7 +1552,7 @@
</variablelist>
</para>
<para>
- Cette fonction retourne FALSE si <parameter>parser</parameter> n'est
+ Cette fonction retourne <literal>FALSE</literal> si
+<parameter>parser</parameter> n'est
pas valide, ou sinon, retourne le numéro de colonne courante
de la ligne courante de l'analyseur, qui correspond à la
position d'analyse courante de l'analyseur XML.
@@ -1576,7 +1587,7 @@
</variablelist>
</para>
<para>
- Cette fonction retourne FALSE si <parameter>parser</parameter> n'est pas
+ Cette fonction retourne <literal>FALSE</literal> si
+<parameter>parser</parameter> n'est pas
valide, ou sinon, retourne l'index de l'octet d'analyse courante de
l'analyseur XML.
</para>
@@ -1613,21 +1624,23 @@
<literal>para</literal>. On analyse le tout, et on
affiche la structure générée :
<informalexample>
- <programlisting>
+ <programlisting role="php">
+<?php
$simple = "<para><note>simple note</note></para>";
$p = xml_parser_create();
-xml_parse_into_struct($p,$simple,&$vals,&$index);
+xml_parse_into_struct($p,$simple,$vals,$index);
xml_parser_free($p);
-echo "Index array\n";
+echo "Tableau d'index\n";
print_r($index);
-echo "\nVals array\n";
+echo "\nTableau de valeurs\n";
print_r($vals);
+?>
</programlisting>
</informalexample>
Lors de l'éxécution du code, l'affichage sera :
<informalexample>
- <programlisting>
-Index array
+ <computeroutput>
+Tableau d'index
Array
(
[PARA] => Array
@@ -1640,7 +1653,7 @@
[0] => 1
)
)
-Vals array
+Tableau de valeurs
Array
(
[0] => Array
@@ -1663,7 +1676,7 @@
[level] => 1
)
)
- </programlisting>
+ </computeroutput>
</informalexample>
</para>
<para>
@@ -1675,7 +1688,7 @@
de données XML :
<example>
<title>moldb.xml - Petite base de données moléculaire</title>
- <programlisting>
+ <programlisting role="xml">
<?xml version="1.0"?>
<moldb>
<molecule>
@@ -1708,7 +1721,7 @@
var $code; // code en une lettre
var $type; // hydrophobe, chargé ou neutre
function AminoAcid ($aa) {
- foreach ($aa as $k=>$v)
+ foreach ($aa as $k->$v)
$this->$k = $aa[$k];
}
}
@@ -1721,7 +1734,7 @@
xml_parse_into_struct($parser,$data,&$values,&$tags);
xml_parser_free($parser);
// parcourt les structures
- foreach ($tags as $key=>$val) {
+ foreach ($tags as $key->$val) {
if ($key == "molecule") {
$molranges = $val;
// chaque paire contigue sont les définitions supérieures
@@ -1752,7 +1765,7 @@
<varname>$db</varname> contient un tableau d'objets
<classname>AminoAcid</classname>, et l'affichage le confirme :
<informalexample>
- <programlisting>
+ <computeroutput>
** Database of AminoAcid objects:
Array
(
@@ -1771,7 +1784,7 @@
[type] => charged
)
)
- </programlisting>
+ </computeroutput>
</informalexample>
</para>
</refsect1>
@@ -1799,11 +1812,12 @@
</simpara>
</listitem>
</varlistentry>
- </variablelist></para>
+ </variablelist>
+ </para>
<para>
- Cette fonction retourne FALSE si <parameter>parser</parameter>
+ Cette fonction retourne <literal>FALSE</literal> si
+<parameter>parser</parameter>
n'est pas une référence valide, ou sinon, détruit
- l'analyseur et retourne TRUE.
+ l'analyseur et retourne <literal>TRUE</literal>.
</para>
</refsect1>
</refentry>
@@ -1851,10 +1865,10 @@
</variablelist>
</para>
<para>
- Cette fonction retourne FALSE si <parameter>parser</parameter> n'est pas une
+ Cette fonction retourne <literal>FALSE</literal> si
+<parameter>parser</parameter> n'est pas une
référence valide sur un analyseur XML, ou si l'option
n'a pas pu être modifiée. Sinon, l'option est effectivement
- modifiée, et la fonction retourne TRUE.
+ modifiée, et la fonction retourne <literal>TRUE</literal>.
</para>
<para>
Les options suivantes sont disponibles :
@@ -1925,30 +1939,29 @@
<term><parameter>option</parameter></term>
<listitem>
<simpara>
- L'option demandée. Reportez vous à
- <function>xml_parser_set_option</function> pour avoir la liste des
- options disponibles.
+ L'option demandée. Reportez vous à
+ <function>xml_parser_set_option</function> pour avoir la liste des
+ options disponibles.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
<para>
- Cette fonction retourne FALSE si <parameter>parser</parameter>
- n'est pas valide, ou sinon, retourne la valeur de l'option demandée.
+ <function>xml_parser_get_option</function> retourne <literal>FALSE</literal> si
+ <parameter>parser</parameter> n'est pas valide, ou sinon, retourne
+ la valeur de l'option demandée.
</para>
<para>
- Reportez vous à <function>xml_parser_set_option</function> pour avoir la
- liste des options disponibles.
+ Reportez vous à <function>xml_parser_set_option</function> pour avoir la
+ liste des options disponibles.
</para>
</refsect1>
</refentry>
<refentry id="function.utf8-decode">
<refnamediv>
<refname>utf8_decode</refname>
- <refpurpose>
- Converti un une chaîne UTF-8 en ISO-8859
- .</refpurpose>
+ <refpurpose>Convertit un une chaîne UTF-8 en ISO-8859.</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
@@ -1984,12 +1997,13 @@
</funcprototype>
</funcsynopsis>
<para>
- Cette fonction code la chaîne data au format <literal>UTF-8</literal>,
- et retourne la version codée. <literal>UTF-8</literal> est un
- mécanisme standardisé utilisé par Unicode pour
- coder les caractère de grande taille dans des flots d'octets.
- <literal>UTF-8</literal> est transparent pour les caractères
- <abbrev>ASCII</abbrev>, il est auto-synchronisé (c'est à
+ <function>utf8_encode</function> code la chaîne data au format
+ <literal>UTF-8</literal>, et retourne la version codée.
+ <literal>UTF-8</literal> est un mécanisme standardisé
+ utilisé par Unicode pour coder les caractère de grande
+ taille dans des flots d'octets. <literal>UTF-8</literal> est transparent
+ pour les caractères <abbrev>ASCII</abbrev>, il est
+ auto-synchronisé (c'est à
dire qu'un programme peut toujours savoir dans un flot d'octet oú
un caractère commence), et peut être utilisé pour
faire des comparaisons de chaînes standard, comme pour le tri. PHP
Index: phpdoc/fr/functions/xslt.xml
diff -u phpdoc/fr/functions/xslt.xml:1.4 phpdoc/fr/functions/xslt.xml:1.5
--- phpdoc/fr/functions/xslt.xml:1.4 Fri Dec 15 06:04:32 2000
+++ phpdoc/fr/functions/xslt.xml Mon Jan 22 03:58:33 2001
@@ -67,12 +67,13 @@
</simpara>
</listitem>
</varlistentry>
- </variablelist></para>
+ </variablelist>
+ </para>
<para>
- <function>xslt_closelog</function> retourne FALSE si
+ <function>xslt_closelog</function> retourne <literal>FALSE</literal> si
<parameter>xh</parameter> n'est pas un analyse XSLT valide, ou bien
si la fermeture du fichier d'historique a échoué. Sinon, retourne
- TRUE.
+ <literal>TRUE</literal>.
</para>
</refsect1>
</refentry>
@@ -299,8 +300,8 @@
<parameter>string xsl_data</parameter> comme feuille de style XSLT, et
des données XML dans <parameter>xml_data</parameter>. Le résultat
de la transformation sera placé dans <parameter>result</parameter>.
- <function>xslt_process</function> retourne TRUE en cas de succès, et
- FALSE sinon. Vous pourrez lire les erreurs survenues grâce aux
+ <function>xslt_process</function> retourne <literal>TRUE</literal> en cas de
+succès, et
+ <literal>FALSE</literal> sinon. Vous pourrez lire les erreurs survenues
+grâce aux
fonctions <function>xslt_errno</function> et
<function>xslt_error</function> functions.
</para>
@@ -330,7 +331,7 @@
</xsl:template>
</xsl:stylesheet>';
$xmlData = '
-<?xml version="1.0"?>
+<?xml version="1.0">
<article>
<title>Learning German</title>
<author>Sterling Hughes</author>
@@ -357,7 +358,7 @@
echo "\tMessage d'erreur : " . xslt_error() . "\n";
exit;
}
-?>
+?>
</programlisting>
</example>
</para>
Index: phpdoc/fr/functions/zlib.xml
diff -u phpdoc/fr/functions/zlib.xml:1.3 phpdoc/fr/functions/zlib.xml:1.4
--- phpdoc/fr/functions/zlib.xml:1.3 Mon Oct 30 10:58:01 2000
+++ phpdoc/fr/functions/zlib.xml Mon Jan 22 03:58:33 2001
@@ -3,27 +3,25 @@
<titleabbrev>Zlib</titleabbrev>
<partintro>
<para>
- Ce module utilise les fonctions de la librairie zlib
- (<ulink url="&url.zlib;">zlib</ulink>) de Jean-loup Gailly et Mark Adler pour
- lire et écrire, de manière transparente, des fichiers
+ Ce module utilise les fonctions de la librairie zlib
+ (<ulink url="&url.zlib;">zlib</ulink>) de Jean-loup Gailly et Mark Adler pour
+ lire et écrire, de manière transparente, des fichiers
compressés avec gzip (.gz).
Il faut utiliser la librairie zlib, de version >= 1.0.9.
</para>
<para>
Ce module contient des versions de la plus part des fonctions du chapitre
- <link linkend="ref.filesystem">système de fichier</link>.
- Mais celles-ci fonctionnent non seulement avec des fichiers
- compressés, mais aussi des fichiers décompressés
+ <link linkend="ref.filesystem">système de fichier</link>.
+ Mais celles-ci fonctionnent non seulement avec des fichiers
+ compressés, mais aussi des fichiers décompressés
(hormis les fonctions utilisant les sockets).
</para>
-
<sect1 id="zlib-example">
<title>Petit exemple</title>
<para>
Ouvre un fichier temporaire, écrit un texte et puis affiche deux
fois le contenu.
</para>
-
<example>
<title>Petit exemple</title>
<programlisting role="php">
@@ -50,12 +48,11 @@
}
unlink($filename);
print "<pre>\n</h1></body>\n</html>\n";
-?>
-</programlisting>
- </example></sect1>
-
+?>
+ </programlisting>
+ </example>
+ </sect1>
</partintro>
-
<refentry id="function.gzclose">
<refnamediv>
<refname>gzclose</refname>
@@ -70,21 +67,17 @@
<para>
<function>gzclose</function> ferme le pointeur <parameter>zp</parameter>.
</para>
-
<para>
- Retourne TRUE ou FALSE, suivant le succès ou l'echec.
+ <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
- référencer un fichier qui a été ouvert par
+ Le pointeur de fichier compressé doit être valide, et doit
+ référencer un fichier qui a été ouvert par
<function>gzopen</function>.
</para>
-
</refsect1>
</refentry>
-
-
<refentry id="function.gzeof">
<refnamediv>
<refname>gzeof</refname>
@@ -97,23 +90,19 @@
<paramdef>int <parameter>zp</parameter></paramdef>
</funcsynopsis>
<para>
- Retourne TRUE si le pointeur interne du fichier compressé est à
- la fin du fichier, sinon retourne FALSE.
+ Retourne <literal>TRUE</literal> si le pointeur interne du fichier
+compressé est à
+ la fin du fichier, sinon retourne <literal>FALSE</literal>.
</para>
-
<para>
- Le pointeur de fichier compressé doit être valide, et doit
- référencer un fichier qui a été ouvert par
+ Le pointeur de fichier compressé doit être valide, et doit
+ référencer un fichier qui a été ouvert par
<function>gzopen</function>.
</para>
-
</refsect1>
</refentry>
-
-
<refentry id="function.gzfile">
<refnamediv>
- <refname>gzfile</refname>
+ <refname>gzfile</refname>
<refpurpose>
Lit la totalité d'un fichier compressé dans un tableau.
</refpurpose>
@@ -125,24 +114,20 @@
<paramdef>string <parameter>filename</parameter></paramdef>
<paramdef>int
<parameter><optional>use_include_path</optional></parameter></paramdef>
</funcsynopsis>
- <para>
- Identique à <function>readgzfile</function>, mais
+ <para>
+ Identique à <function>readgzfile</function>, mais
<function>gzfile</function> retourne un tableau.
</para>
-
<para>
- Vous pouvez aussi utiliser le deuxième paramètre optionnel en
- le mettant à "1", si vous voulez rechercher le fichier dans le dossier
+ Vous pouvez aussi utiliser le deuxième paramètre optionnel en
+ le mettant à "1", si vous voulez rechercher le fichier dans le dossier
<link linkend="ini.include-path">include_path</link>.
</para>
-
- <para>
+ <para>
Voir aussi <function>readgzfile</function>, et <function>gzopen</function>.
</para>
</refsect1>
</refentry>
-
-
<refentry id="function.gzgetc">
<refnamediv>
<refname>gzgetc</refname>
@@ -155,26 +140,22 @@
<paramdef>int <parameter>zp</parameter></paramdef>
</funcsynopsis>
<para>
- Retourne une chaîne décompressée, qui contient un
+ Retourne une chaîne décompressée, qui contient un
caractère unique, lu depuis le fichier référencé
- par le pointeur <parameter>zp</parameter>. Retourne FALSE à
+ par le pointeur <parameter>zp</parameter>. Retourne <literal>FALSE</literal>
+à
la fin du fichier (voir <function>gzeof</function>).
</para>
<para>
- Le pointeur de fichier compressé doit être valide, et
- doit référencer un fichier qui a été
+ Le pointeur de fichier compressé doit être valide, et
+ doit référencer un fichier qui a été
ouvert par <function>gzopen</function>.
</para>
-
- <para>
+ <para>
Voir aussi
<function>gzopen</function>, et <function>gzgets</function>.
</para>
-
</refsect1>
</refentry>
-
-
<refentry id="function.gzgets">
<refnamediv>
<refname>gzgets</refname>
@@ -187,37 +168,30 @@
<paramdef>int <parameter>zp</parameter></paramdef>
<paramdef>int <parameter>length</parameter></paramdef>
</funcsynopsis>
-
<para>
- <function>gzgets</function> retourne une chaîne
- décompressée, de longueur inférieure ou égale
- à length - 1 octets, lue depuis de fichier
- référencé par le pointeur de fichier
- <parameter>zp</parameter>. La lecture s'interrompt lorsque
- <parameter>length</parameter> - 1 octets ont été lus, ou bien
- lorsqu'une nouvelle ligne a été rencontrée, ou bien
+ <function>gzgets</function> retourne une chaîne
+ décompressée, de longueur inférieure ou égale
+ à length - 1 octets, lue depuis de fichier
+ référencé par le pointeur de fichier
+ <parameter>zp</parameter>. La lecture s'interrompt lorsque
+ <parameter>length</parameter> - 1 octets ont été lus, ou bien
+ lorsqu'une nouvelle ligne a été rencontrée, ou bien
lorsque la fin du fichier a été atteinte.
</para>
-
- <para>
- Si une erreur survient, retourne false.
+ <para>
+ Si une erreur survient, retourne <literal>FALSE</literal>.
</para>
-
<para>
- Le pointeur de fichier compressé doit être valide, et
- doit référencer un fichier qui a été
+ Le pointeur de fichier compressé doit être valide, et
+ doit référencer un fichier qui a été
ouvert par <function>gzopen</function>.
</para>
-
- <para>
+ <para>
Voir aussi <function>gzopen</function>,
<function>gzgetc</function>, et <function>fgets</function>.
</para>
-
</refsect1>
</refentry>
-
-
<refentry id="function.gzgetss">
<refnamediv>
<refname>gzgetss</refname>
@@ -238,24 +212,21 @@
essaie de supprimer toutes les balises HTML et PHP du texte lu.
</para>
<para>
- Vous pouvez utiliser le troisième argument optionnel pour indiquer
+ Vous pouvez utiliser le troisième argument optionnel pour indiquer
les balises qui ne doivent pas être supprimées.
<note>
<para>
- <parameter>allowable_tags</parameter> a été ajouté
- dans PHP 3.0.13, PHP4B3.
+ <parameter>allowable_tags</parameter> a été ajouté
+ dans PHP 3.0.13, PHP 4.0B3.
</para>
- </note></para>
-
+ </note>
+ </para>
<para>
Voir aussi <function>gzgets</function>,
<function>gzopen</function>, et <function>strip_tags</function>.
</para>
-
</refsect1>
</refentry>
-
-
<refentry id="function.gzopen">
<refnamediv>
<refname>gzopen</refname>
@@ -270,56 +241,50 @@
<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
+ 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
+ <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
- fichier ouvert. Ce pointeur sera nécessaire pour toutes les
- opérations ultérieures sur ce fichier. Les opérations
+ <function>gzopen</function> retourne un pointeur de fichier sur le
+ fichier ouvert. Ce pointeur sera nécessaire pour toutes les
+ opérations ultérieures sur ce fichier. Les opérations
de compression/décompression seront transparaentes.
</para>
-
<para>
- Si l'ouverture échoue, la fonction retourne FALSE.
+ Si l'ouverture échoue, la fonction retourne <literal>FALSE</literal>.
</para>
-
<para>
- Vous pouvez utiliser le paramètre optionnel en le mettant
+ Vous pouvez utiliser le paramètre optionnel en le mettant
à "1", si vous voulez rechercher le fichier dans le dossier
<link linkend="ini.include-path">include_path</link>.
</para>
-
<para>
<example>
<title>Exemple <function>gzopen</function></title>
- <programlisting>
+ <programlisting role="php">
+<?php
$fp = gzopen("/tmp/file.gz", "r");
+?>
</programlisting>
</example>
</para>
<para>
Voir aussi <function>gzclose</function>.
</para>
-
</refsect1>
</refentry>
-
-
<refentry id="function.gzpassthru">
<refnamediv>
<refname>gzpassthru</refname>
@@ -334,27 +299,24 @@
<paramdef>int <parameter>zp</parameter></paramdef>
</funcsynopsis>
<para>
- Lit toutes les informations d'un fichier compressé jusqu'à
- EOF et écrit le résultat décompressé dans la
+ Lit toutes les informations d'un fichier compressé jusqu'à
+ EOF et écrit le résultat décompressé dans la
sortie standard.
</para>
<para>
- Si une erreur survient, retourne FALSE.
+ Si une erreur survient, retourne <literal>FALSE</literal>.
</para>
<para>
- Le pointeur de fichier doit être valide, et avoir été
+ Le pointeur de fichier doit être valide, et avoir été
ouvert par <function>gzopen</function>.
</para>
<para>
- Le fichier pointé est refermé par
- <function>gzpassthru</function> ce qui le rend inutilisable
+ Le fichier pointé est refermé par
+ <function>gzpassthru</function> ce qui le rend inutilisable
pour les opérations ultérieures.
</para>
-
</refsect1>
</refentry>
-
-
<refentry id="function.gzputs">
<refnamediv>
<refname>gzputs</refname>
@@ -368,16 +330,12 @@
<paramdef>string <parameter>str</parameter></paramdef>
<paramdef>int <parameter><optional>length</optional></parameter></paramdef>
</funcsynopsis>
-
<para>
- <function>gzputs</function>est un alias de <function>gzwrite</function>, et
+ <function>gzputs</function>est un alias de <function>gzwrite</function>, et
lui est identique en tous points.
</para>
-
</refsect1>
</refentry>
-
-
<refentry id="function.gzread">
<refnamediv>
<refname>gzread</refname>
@@ -391,33 +349,32 @@
<paramdef>int <parameter>length</parameter></paramdef>
</funcsynopsis>
<simpara>
- <function>gzread</function> lit jusqu'à <parameter>length</parameter>
- octets depuis le fichier compressé référencé
- par <parameter>zp</parameter>. La lecture stoppe lorsque
- <parameter>length</parameter> octets décompressés ont
- été lus, ou que la fin du fichier a été
+ <function>gzread</function> lit jusqu'à <parameter>length</parameter>
+ octets depuis le fichier compressé référencé
+ par <parameter>zp</parameter>. La lecture stoppe lorsque
+ <parameter>length</parameter> octets décompressés ont
+ été lus, ou que la fin du fichier a été
trouvée.
</simpara>
-
<para>
<informalexample>
- <programlisting>
+ <programlisting role="php">
+<?php
// lis le contenu d'un fichier compressé et le met dans une chaîne
$filename = "/usr/local/something.txt.gz";
$zd = gzopen( $filename, "r" );
$contents = gzread( $zd, 10000 );
gzclose( $zd );
+?>
</programlisting>
- </informalexample></para>
-
+ </informalexample>
+ </para>
<simpara>
Voir aussi <function>gzwrite</function>, <function>gzopen</function>,
<function>gzgets</function>, <function>gzgetss</function>,
<function>gzfile</function>, et <function>gzpassthru</function>.</simpara>
</refsect1>
</refentry>
-
-
<refentry id="function.gzrewind">
<refnamediv>
<refname>gzrewind</refname>
@@ -429,17 +386,16 @@
<funcdef>int <function>gzrewind</function></funcdef>
<paramdef>int <parameter>zp</parameter></paramdef>
</funcsynopsis>
- <para>
- <function>gzrewind</function> positionne le pointeur interne du fichier
+ <para>
+ <function>gzrewind</function> positionne le pointeur interne du fichier
au début du fichier compressé.
</para>
-
<para>
Si une erreur survient, retourne 0.
</para>
- <para>
- Le pointeur de fichier doit être valide, et avoir
- été retourné par la fonction
+ <para>
+ Le pointeur de fichier doit être valide, et avoir
+ été retourné par la fonction
<function>gzopen</function>.
</para>
<para>
@@ -447,7 +403,6 @@
</para>
</refsect1>
</refentry>
-
<refentry id="function.gzseek">
<refnamediv>
<refname>gzseek</refname>
@@ -463,29 +418,26 @@
<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
+ 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>.
</para>
<para>
- Si le fichier est ouvert en lecture seule, cette fonction
- émulée peut être extrêmement lente. Si
+ 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
+ (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
+ Retourne 0 en cas de succès, sinon retourne -1. Notez positionner
le pointeur au delà de la fin du fichier est une erreur.
</para>
<para>
Voir aussi <function>gztell</function> et <function>gzrewind</function>.
</para>
-
</refsect1>
</refentry>
-
-
<refentry id="function.gztell">
<refnamediv>
<refname>gztell</refname>
@@ -498,29 +450,24 @@
<paramdef>int <parameter>zp</parameter></paramdef>
</funcsynopsis>
<para>
- <function>gztell</function> retourne la position du pointeur interne
- du fichier référencé par zp, i.e., son offset en
+ <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.
</para>
-
<para>
- Si une erreur survient, retourne FALSE.
+ Si une erreur survient, retourne <literal>FALSE</literal>.
</para>
-
<para>
- Le pointeur de fichier doit être valide, et doit avoir
- été retourné par la fonction
+ Le pointeur de fichier doit être valide, et doit avoir
+ été retourné par la fonction
<function>gzopen</function>.
</para>
-
- <para>
+ <para>
Voir aussi <function>gzopen</function>,
<function>gzseek</function> et <function>gzrewind</function>.
</para>
-
</refsect1>
</refentry>
-
<refentry id="function.gzwrite">
<refnamediv>
<refname>gzwrite</refname>
@@ -535,30 +482,27 @@
<paramdef>int <parameter><optional>length</optional></parameter></paramdef>
</funcsynopsis>
<simpara>
- <function>gzwrite</function> écrit le contenu de la chaîne
- <parameter>string</parameter> dans le fichier compressé
- référencé par le pointeur <parameter>zp</parameter>.
- Si l'argument <parameter>length</parameter> est donné,
- l'écriture cessera après avoir écrit
- <parameter>length</parameter> octets (non compressé), ou bien si
+ <function>gzwrite</function> écrit le contenu de la chaîne
+ <parameter>string</parameter> dans le fichier compressé
+ référencé par le pointeur <parameter>zp</parameter>.
+ Si l'argument <parameter>length</parameter> est donné,
+ l'écriture cessera après avoir écrit
+ <parameter>length</parameter> octets (non compressé), ou bien si
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
+ 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>
<simpara>
Voir aussi <function>gzread</function>, <function>gzopen</function>,
et <function>gzputs</function>.
</simpara>
</refsect1>
</refentry>
-
<refentry id="function.readgzfile">
<refnamediv>
<refname>readgzfile</refname>
@@ -571,42 +515,36 @@
<paramdef>string <parameter>filename</parameter></paramdef>
<paramdef>int
<parameter><optional>use_include_path</optional></parameter></paramdef>
</funcsynopsis>
- <para>
- Lit un fichier, le décompresse et l'écrit dans la sortie
+ <para>
+ Lit un fichier, le décompresse et l'écrit dans la sortie
standard.
</para>
-
<para>
- <function>readgzfile</function> peut être utilisé pour
- lire un fichier qui n'est pas au format gzip, car dans ce cas, la
+ <function>readgzfile</function> peut être utilisé pour
+ lire un fichier qui n'est pas au format gzip, car dans ce cas, la
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 FALSE, et à moins que la fonction
- n'ai été appelée avec @readgzfile, l'erreur est
+ <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.
</para>
-
<para>
- Le fichier <parameter>filename</parameter> sera ouvert et son contenu
+ Le fichier <parameter>filename</parameter> sera ouvert et son contenu
sera écrit danas la sortie standard.
</para>
-
<para>
- Vous pouvez utiliser le paramètre optionnel en le mettant
+ Vous pouvez utiliser le paramètre optionnel en le mettant
à "1", si vous voulez rechercher le fichier dans le dossier
<link linkend="ini.include-path">include_path</link>.
</para>
-
<para>
Voir aussi <function>gzpassthru</function>,
<function>gzfile</function>, et <function>gzopen</function>.
</para>
</refsect1>
</refentry>
-
<refentry id="function.gzcompress">
<refnamediv>
<refname>gzcompress</refname>
@@ -618,14 +556,14 @@
<funcprototype>
<funcdef>string <function>gzcompress</function></funcdef>
<paramdef>string <parameter>data</parameter></paramdef>
- <paramdef>int
+ <paramdef>int
<parameter><optional>level</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
- Cette fonction retourne la version compressé GZ de la chaîne
- <parameter>data</parameter>, ou false en cas d'erreur. Le paramètre
+ 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).
</para>
@@ -634,7 +572,6 @@
</para>
</refsect1>
</refentry>
-
<refentry id="function.gzuncompress">
<refnamediv>
<refname>gzuncompress</refname>
@@ -646,19 +583,19 @@
<funcprototype>
<funcdef>string <function>gzuncompress</function></funcdef>
<paramdef>string <parameter>data</parameter></paramdef>
- <paramdef>int
+ <paramdef>int
<parameter><optional>length</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
- <para>
- <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 FALSE en cas d'erreur. Cette fonction retournera une erreur si
+ <para>
+ <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
- <parameter>data</parameter> ou plus que le paramètre optionnel
+ 256 fois la longueur de la chaîne compressée
+ <parameter>data</parameter> ou plus que le paramètre optionnel
<parameter>length</parameter>.
</para>
<para>
@@ -666,9 +603,7 @@
</para>
</refsect1>
</refentry>
-
</reference>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Index: phpdoc/fr/functions/shmop.xml
diff -u phpdoc/fr/functions/shmop.xml:1.4 phpdoc/fr/functions/shmop.xml:1.5
--- phpdoc/fr/functions/shmop.xml:1.4 Mon Nov 6 06:08:24 2000
+++ phpdoc/fr/functions/shmop.xml Mon Jan 22 03:58:33 2001
@@ -1,59 +1,51 @@
<reference id="ref.shmop">
<title>Mémoire partagée</title>
<titleabbrev>shmop</titleabbrev>
-
<partintro>
<para>
- Shmop est un ensemble de fonctions simples pour gérer
- la mémoire partagée avec PHP (lecture,
- écriture, création et suppressions de segments de
+ Shmop est un ensemble de fonctions simples pour gérer
+ la mémoire partagée avec PHP (lecture,
+ écriture, création et suppressions de segments de
mémoire paragée UNIX). Ces fonctions ne fonctionnent pas
- sous Windows, car ce système d'exploitation ne supporte pas
- la mémoire partagée. Pour utiliser les fonctions
+ sous Windows, car ce système d'exploitation ne supporte pas
+ la mémoire partagée. Pour utiliser les fonctions
shmop, compilez PHP avec l'option --enable-shmop parameter.
</para>
<para>
<example>
- <title>Introduction à la mémoire partagée</title>
+ <title>Introduction à la mémoire partagée</title>
<programlisting role="php">
<?php
-
-// Crée 100 octets de mémoire partagée avec
+// Crée 100 octets de mémoire partagée avec
// un identifiant système "0xff3"
$shm_id = shm_open(0xff3, "c", 0644, 100);
if(!$shm_id) {
echo "Impossible de créer la mémoire partagée\n";
}
-
// Lire la taille de la mémoire partagée
$shm_size = shm_size($shm_id);
echo "Un bloc de SHM de taille ".$shm_size. " a été
créé.\n";
-
// Ecriture d'une chaîne de test dans ce segment
$shm_bytes_written = shm_write($shm_id, "mon bloc de mémoire partagée",
0);
if($shm_bytes_written != strlen("mon bloc de mémoire partagée")) {
echo "Impossible d'écrire toutes les données en
mémoire\n";
}
-
// Lecture du segment
$my_string = shm_read($shm_id, 0, $shm_size);
if(!$my_string) {
echo "Impossible de lire toutes les données en mémoire\n";
}
echo "Les données mis en mémoire partagées sont :
".$my_string."\n";
-
//Maintenant, effacons le bloc, et fermons le segment de mémoire
if(!shm_delete($shm_id)) {
echo "Impossible d'effacer le segment de mémoire";
}
shm_close($shm_id);
-
?>
</programlisting>
</example>
</para>
- </partintro>
-
+ </partintro>
<refentry id="function.shm-open">
<refnamediv>
<refname>shm_open</refname>
@@ -73,15 +65,15 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>shm_open</function> peut créer ou ouvrir un bloc
+ <function>shm_open</function> peut créer ou ouvrir un bloc
de mémoire partagée.
</para>
<para>
- <function>shm_open</function> prend 4 paramètres: la
- clé, qui sera l'identifiant système pour le bloc.
+ <function>shm_open</function> prend 4 paramètres: la
+ clé, qui sera l'identifiant système pour le bloc.
Ce parmaètre peut être passé comme
- un décimal ou un héxadécimal. Le
- deuxième paramètre est un groupe d'options :
+ un décimal ou un héxadécimal. Le
+ deuxième paramètre est un groupe d'options :
<itemizedlist>
<listitem>
<simpara>
@@ -96,22 +88,22 @@
</simpara>
</listitem>
</itemizedlist>
- Le troisième paramètre est le mode, c'est à
- dire les permissions que vous donnez à ce bloc. Ce sont
- les mêmes que pour les fichiers. Ces permissions doivent
+ Le troisième paramètre est le mode, c'est à
+ dire les permissions que vous donnez à ce bloc. Ce sont
+ les mêmes que pour les fichiers. Ces permissions doivent
être passées sous forme d'octal (i.e. 0644).
- Le dernier parmètre est la taille du bloc de mémoire,
+ Le dernier parmètre est la taille du bloc de mémoire,
en ocets.
<note>
<simpara>
- Note: Les troisième et quatrième parmaètres
- doivent être passés à 0 si vous voulez ouvrir
+ Note: Les troisième et quatrième parmaètres
+ doivent être passés à 0 si vous voulez ouvrir
un bloc de mémoire partagée déjà existant.
- En cas de succès <function>shm_open</function> retourne un
- identifiant que vous pouvez utiliser pour accéder à
+ En cas de succès <function>shm_open</function> retourne un
+ identifiant que vous pouvez utiliser pour accéder à
la mémoire que vous venez de créer.
</simpara></note>
- </para>
+ </para>
<para>
<example>
<title>Créer un nouveau bloc</title>
@@ -127,8 +119,7 @@
dont l'identifiant est 0x0fff.
</para>
</refsect1>
- </refentry>
-
+ </refentry>
<refentry id="function.shm-read">
<refnamediv>
<refname>shm_read</refname>
@@ -149,14 +140,14 @@
mémoire partagée.
</para>
<para>
- <function>shm_read</function> prend 3 paramètres:
- <parameter>shmid</parameter>, qui est un identifiant de
- mémoire partagée, créé par
- <function>shm_open</function>, <parameter>start</parameter>
- qui est la position à partir de laquelle on commence
+ <function>shm_read</function> prend 3 paramètres:
+ <parameter>shmid</parameter>, qui est un identifiant de
+ mémoire partagée, créé par
+ <function>shm_open</function>, <parameter>start</parameter>
+ qui est la position à partir de laquelle on commence
à lire dans la mémoire et <parameter>count</parameter>,
le nombre d'octets à lire.
- </para>
+ </para>
<para>
<example>
<title>Lire un bloc de mémoire partagée</title>
@@ -168,12 +159,11 @@
</example>
</para>
<para>
- Cet exemple lit 50 octets dans le bloc de mémoire partagée
+ Cet exemple lit 50 octets dans le bloc de mémoire partagée
<literal>$shm_data</literal>.
</para>
</refsect1>
</refentry>
-
<refentry id="function.shm-write">
<refnamediv>
<refname>shm_write</refname>
@@ -190,19 +180,19 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>shm_write</function> écrit une chaîne dans
+ <function>shm_write</function> écrit une chaîne dans
un bloc de mémoire partagée.
</para>
<para>
- <function>shm_write</function> prend 3 paramètres:
- <parameter>shmid</parameter>, qui est un identifiant de
- mémoire partagée, créé par
- <function>shm_open</function>, <parameter>data</parameter>
+ <function>shm_write</function> prend 3 paramètres:
+ <parameter>shmid</parameter>, qui est un identifiant de
+ mémoire partagée, créé par
+ <function>shm_open</function>, <parameter>data</parameter>
qui est la chaîne à écrire dans la
- mémoire et <parameter>offset</parameter>, la
+ mémoire et <parameter>offset</parameter>, la
position à partir de laquelle il faut commencer
à écrire.
- </para>
+ </para>
<para>
<example>
<title>Ecrire un bloc de mémoire partagée</title>
@@ -214,14 +204,13 @@
</example>
</para>
<para>
- Cet exemple écrit les données de la chaîne
- <literal>$my_string</literal> dans un bloc de mémoire
- partagée. <literal>$shm_bytes_written</literal>
+ Cet exemple écrit les données de la chaîne
+ <literal>$my_string</literal> dans un bloc de mémoire
+ partagée. <literal>$shm_bytes_written</literal>
représentera le nombre d'octets écrits.
</para>
</refsect1>
</refentry>
-
<refentry id="function.shm-size">
<refnamediv>
<refname>shm_size</refname>
@@ -236,15 +225,15 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>shm_size</function> sert à connaître
+ <function>shm_size</function> sert à connaître
la taille, en octets, d'un bloc de mémoire partagée.
</para>
<para>
<function>shm_size</function> prend comme argument <parameter>shmid</parameter>,
- un identifiant de bloc de mémoire partagée
- créé par <function>shm_open</function>, et retourne
+ un identifiant de bloc de mémoire partagée
+ créé par <function>shm_open</function>, et retourne
un entier, qui représente le taille de ce bloc.
- </para>
+ </para>
<para>
<example>
<title>Lire la taille d'un bloc de mémoire partagée</title>
@@ -261,7 +250,6 @@
</para>
</refsect1>
</refentry>
-
<refentry id="function.shm-delete">
<refnamediv>
<refname>shm_delete</refname>
@@ -278,15 +266,15 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>shm_delete</function> sert à détruire un
+ <function>shm_delete</function> sert à détruire un
bloc de mémoire partagée.
</para>
<para>
- <function>shm_delete</function> prend un identifiant de
- mémoire partagée <parameter>shmid</parameter>,
+ <function>shm_delete</function> prend un identifiant de
+ mémoire partagée <parameter>shmid</parameter>,
créé par <function>shm_open</function>.
En cas de succès, la fonction retourne 1, et sinon, 0.
- </para>
+ </para>
<para>
<example>
<title>Effacement d'un bloc de mémoire partagée</title>
@@ -303,7 +291,6 @@
</para>
</refsect1>
</refentry>
-
<refentry id="function.shm-close">
<refnamediv>
<refname>shm_close</refname>
@@ -318,14 +305,14 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>shm_close</function> sert à fermer un bloc de
+ <function>shm_close</function> sert à fermer un bloc de
mémoire partagée.
</para>
<para>
<function>shm_close</function> prend un identifiant de mémoire
- partagée, <parameter>shmid</parameter>, créé par
+ partagée, <parameter>shmid</parameter>, créé par
<function>shm_open</function>.
- </para>
+ </para>
<para>
<example>
<title>Fermeture d'un bloc de mémoire partagée</title>
@@ -337,13 +324,12 @@
</example>
</para>
<para>
- Cet exemple ferme le bloc de mémoire partagée
+ Cet exemple ferme le bloc de mémoire partagée
identifié par <literal>$shm_id</literal>.
</para>
</refsect1>
</refentry>
- </reference>
-
+ </reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
