cvs: phpdoc /fr/functions shmop.xml
| From: | Damien Seguy | Date: | Wed, 01 Aug 2001 08:08:18 +0000 |
| Subject: | cvs: phpdoc /fr/functions shmop.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969336660@lists.php.net to get a copy of this message | ||
dams Wed Aug 1 04:08:18 2001 EDT
Modified files:
/phpdoc/fr/functions shmop.xml
Log:
Typos
Index: phpdoc/fr/functions/shmop.xml diff -u phpdoc/fr/functions/shmop.xml:1.6 phpdoc/fr/functions/shmop.xml:1.7 --- phpdoc/fr/functions/shmop.xml:1.6 Fri Mar 16 11:17:44 2001 +++ phpdoc/fr/functions/shmop.xml Wed Aug 1 04:08:17 2001 @@ -11,6 +11,14 @@ la mémoire partagée. Pour utiliser les fonctions shmop, compilez PHP avec l'option --enable-shmop parameter. </para> + <note> + <simpara> + Toutes les fonctions décrites ci-dessous commencent par + <literal>shm_</literal> poru les versions jusqu'à PHP 4.0.3, + mais en PHP 4.0.4 et plus récent, elles sont préfixées par + <literal>shmop_</literal>. + </simpara> + </note> <para> <example> <title>Introduction à la mémoire partagée</title> @@ -18,37 +26,37 @@ <?php // Crée 100 octets de mémoire partagée avec // un identifiant système "0xff3" -$shm_id = shm_open(0xff3, "c", 0644, 100); +$shm_id = shmop_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); +$shm_size = shmop_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); +$shm_bytes_written = shmop_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); +$my_string = shmop_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)) { +if(!shmop_delete($shm_id)) { echo "Impossible d'effacer le segment de mémoire"; } -shm_close($shm_id); +shmop_close($shm_id); ?> </programlisting> </example> </para> </partintro> - <refentry id="function.shm-open"> + <refentry id="function.shmop-open"> <refnamediv> - <refname>shm_open</refname> + <refname>shmop_open</refname> <refpurpose> Crée ou ouvre un bloc de mémoire partagée </refpurpose> @@ -57,7 +65,7 @@ <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>resource <function>shm_open</function></funcdef> + <funcdef>resource <function>shmop_open</function></funcdef> <paramdef>int <parameter>key</parameter></paramdef> <paramdef>string <parameter>flags</parameter></paramdef> <paramdef>int <parameter>mode</parameter></paramdef> @@ -65,20 +73,20 @@ </funcprototype> </funcsynopsis> <para> - <function>shm_open</function> peut créer ou ouvrir un bloc + <function>shmop_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 + <function>shmop_open</function> prend 4 paramètres: la clé, qui sera l'identifiant système pour le bloc. - Ce parmaètre peut être passé comme + Ce paramètre peut être passé comme un décimal ou un héxadécimal. Le deuxième paramètre est un groupe d'options : <itemizedlist> <listitem> <simpara> "a" pour accès (utilise IPC_EXCL) - utilisez cette option pour ouvrir un bloc déjà éxistant. + utilisez cette option pour ouvrir un bloc déjà existant. </simpara> </listitem> <listitem> @@ -92,14 +100,14 @@ 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 paramètre est la taille du bloc de mémoire, en ocets. <note> <simpara> - Note: Les troisième et quatrième parmaètres + Les troisième et quatrième paramè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 + En cas de succès <function>shmop_open</function> retourne un identifiant que vous pouvez utiliser pour accéder à la mémoire que vous venez de créer. </simpara></note> @@ -109,7 +117,7 @@ <title>Créer un nouveau bloc</title> <programlisting role="php"> <?php -$shm_id = shm_open(0x0fff, "c", 0644, 100); +$shm_id = shmop_open(0x0fff, "c", 0644, 100); ?> </programlisting> </example> @@ -120,30 +128,30 @@ </para> </refsect1> </refentry> - <refentry id="function.shm-read"> + <refentry id="function.shmop-read"> <refnamediv> - <refname>shm_read</refname> + <refname>shmop_read</refname> <refpurpose>Lit un bloc</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>string <function>shm_read</function></funcdef> + <funcdef>string <function>shmop_read</function></funcdef> <paramdef>resource <parameter>shmid</parameter></paramdef> <paramdef>int <parameter>start</parameter></paramdef> <paramdef>int <parameter>count</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>shm_read</function> lit une chaîne dans une bloc de + <function>shmop_read</function> lit une chaîne dans une bloc de mémoire partagée. </para> <para> - <function>shm_read</function> prend 3 paramètres: + <function>shmop_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> + <function>shmop_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. @@ -153,7 +161,7 @@ <title>Lire un bloc de mémoire partagée</title> <programlisting role="php"> <?php -$shm_data = shm_read($shm_id, 0, 50); +$shm_data = shmop_read($shm_id, 0, 50); ?> </programlisting> </example> @@ -164,30 +172,30 @@ </para> </refsect1> </refentry> - <refentry id="function.shm-write"> + <refentry id="function.shmop-write"> <refnamediv> - <refname>shm_write</refname> + <refname>shmop_write</refname> <refpurpose>Ecrire dans un bloc de mémoire partagée</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>shm_write</function></funcdef> + <funcdef>int <function>shmop_write</function></funcdef> <paramdef>resource <parameter>shmid</parameter></paramdef> <paramdef>string <parameter>data</parameter></paramdef> <paramdef>int <parameter>offset</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>shm_write</function> écrit une chaîne dans + <function>shmop_write</function> écrit une chaîne dans un bloc de mémoire partagée. </para> <para> - <function>shm_write</function> prend 3 paramètres: + <function>shmop_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>shmop_open</function>, <parameter>data</parameter> qui est la chaîne à écrire dans la mémoire et <parameter>offset</parameter>, la position à partir de laquelle il faut commencer @@ -198,7 +206,7 @@ <title>Ecrire un bloc de mémoire partagée</title> <programlisting role="php"> <?php -$shm_bytes_written = shm_write($shm_id, $my_string, 0); +$shm_bytes_written = shmop_write($shm_id, $my_string, 0); ?> </programlisting> </example> @@ -211,27 +219,27 @@ </para> </refsect1> </refentry> - <refentry id="function.shm-size"> + <refentry id="function.shmop-size"> <refnamediv> - <refname>shm_size</refname> + <refname>shmop_size</refname> <refpurpose>Lire la taille du bloc de mémoire partagée</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>shm_size</function></funcdef> + <funcdef>int <function>shmop_size</function></funcdef> <paramdef>resource <parameter>shmid</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>shm_size</function> sert à connaître + <function>shmop_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>, + <function>shmop_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 + créé par <function>shmop_open</function>, et retourne un entier, qui représente le taille de ce bloc. </para> <para> @@ -239,7 +247,7 @@ <title>Lire la taille d'un bloc de mémoire partagée</title> <programlisting role="php"> <?php -$shm_size = shm_size($shm_id); +$shm_size = shmop_size($shm_id); ?> </programlisting> </example> @@ -250,9 +258,9 @@ </para> </refsect1> </refentry> - <refentry id="function.shm-delete"> + <refentry id="function.shmop-delete"> <refnamediv> - <refname>shm_delete</refname> + <refname>shmop_delete</refname> <refpurpose> Détruit un bloc de mémoire partagée </refpurpose> @@ -261,18 +269,18 @@ <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>shm_delete</function></funcdef> + <funcdef>int <function>shmop_delete</function></funcdef> <paramdef>resource <parameter>shmid</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>shm_delete</function> sert à détruire un + <function>shmop_delete</function> sert à détruire un bloc de mémoire partagée. </para> <para> - <function>shm_delete</function> prend un identifiant de + <function>shmop_delete</function> prend un identifiant de mémoire partagée <parameter>shmid</parameter>, - créé par <function>shm_open</function>. + créé par <function>shmop_open</function>. En cas de succès, la fonction retourne 1, et sinon, 0. </para> <para> @@ -280,7 +288,7 @@ <title>Effacement d'un bloc de mémoire partagée</title> <programlisting role="php"> <?php -shm_delete($shm_id); +shmop_delete($shm_id); ?> </programlisting> </example> @@ -291,34 +299,34 @@ </para> </refsect1> </refentry> - <refentry id="function.shm-close"> + <refentry id="function.shmop-close"> <refnamediv> - <refname>shm_close</refname> + <refname>shmop_close</refname> <refpurpose>Ferme un bloc de mémoire partagée</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>shm_close</function></funcdef> + <funcdef>int <function>shmop_close</function></funcdef> <paramdef>resource <parameter>shmid</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>shm_close</function> sert à fermer un bloc de + <function>shmop_close</function> sert à fermer un bloc de mémoire partagée. </para> <para> - <function>shm_close</function> prend un identifiant de mémoire + <function>shmop_close</function> prend un identifiant de mémoire partagée, <parameter>shmid</parameter>, créé par - <function>shm_open</function>. + <function>shmop_open</function>. </para> <para> <example> <title>Fermeture d'un bloc de mémoire partagée</title> <programlisting role="php"> <?php -shm_close($shm_id); +shmop_close($shm_id); ?> </programlisting> </example>
Index: phpdoc/fr/functions/shmop.xml diff -u phpdoc/fr/functions/shmop.xml:1.6 phpdoc/fr/functions/shmop.xml:1.7 --- phpdoc/fr/functions/shmop.xml:1.6 Fri Mar 16 11:17:44 2001 +++ phpdoc/fr/functions/shmop.xml Wed Aug 1 04:08:17 2001 @@ -11,6 +11,14 @@ la mémoire partagée. Pour utiliser les fonctions shmop, compilez PHP avec l'option --enable-shmop parameter. </para> + <note> + <simpara> + Toutes les fonctions décrites ci-dessous commencent par + <literal>shm_</literal> poru les versions jusqu'à PHP 4.0.3, + mais en PHP 4.0.4 et plus récent, elles sont préfixées par + <literal>shmop_</literal>. + </simpara> + </note> <para> <example> <title>Introduction à la mémoire partagée</title> @@ -18,37 +26,37 @@ <?php // Crée 100 octets de mémoire partagée avec // un identifiant système "0xff3" -$shm_id = shm_open(0xff3, "c", 0644, 100); +$shm_id = shmop_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); +$shm_size = shmop_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); +$shm_bytes_written = shmop_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); +$my_string = shmop_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)) { +if(!shmop_delete($shm_id)) { echo "Impossible d'effacer le segment de mémoire"; } -shm_close($shm_id); +shmop_close($shm_id); ?> </programlisting> </example> </para> </partintro> - <refentry id="function.shm-open"> + <refentry id="function.shmop-open"> <refnamediv> - <refname>shm_open</refname> + <refname>shmop_open</refname> <refpurpose> Crée ou ouvre un bloc de mémoire partagée </refpurpose> @@ -57,7 +65,7 @@ <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>resource <function>shm_open</function></funcdef> + <funcdef>resource <function>shmop_open</function></funcdef> <paramdef>int <parameter>key</parameter></paramdef> <paramdef>string <parameter>flags</parameter></paramdef> <paramdef>int <parameter>mode</parameter></paramdef> @@ -65,20 +73,20 @@ </funcprototype> </funcsynopsis> <para> - <function>shm_open</function> peut créer ou ouvrir un bloc + <function>shmop_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 + <function>shmop_open</function> prend 4 paramètres: la clé, qui sera l'identifiant système pour le bloc. - Ce parmaètre peut être passé comme + Ce paramètre peut être passé comme un décimal ou un héxadécimal. Le deuxième paramètre est un groupe d'options : <itemizedlist> <listitem> <simpara> "a" pour accès (utilise IPC_EXCL) - utilisez cette option pour ouvrir un bloc déjà éxistant. + utilisez cette option pour ouvrir un bloc déjà existant. </simpara> </listitem> <listitem> @@ -92,14 +100,14 @@ 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 paramètre est la taille du bloc de mémoire, en ocets. <note> <simpara> - Note: Les troisième et quatrième parmaètres + Les troisième et quatrième paramè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 + En cas de succès <function>shmop_open</function> retourne un identifiant que vous pouvez utiliser pour accéder à la mémoire que vous venez de créer. </simpara></note> @@ -109,7 +117,7 @@ <title>Créer un nouveau bloc</title> <programlisting role="php"> <?php -$shm_id = shm_open(0x0fff, "c", 0644, 100); +$shm_id = shmop_open(0x0fff, "c", 0644, 100); ?> </programlisting> </example> @@ -120,30 +128,30 @@ </para> </refsect1> </refentry> - <refentry id="function.shm-read"> + <refentry id="function.shmop-read"> <refnamediv> - <refname>shm_read</refname> + <refname>shmop_read</refname> <refpurpose>Lit un bloc</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>string <function>shm_read</function></funcdef> + <funcdef>string <function>shmop_read</function></funcdef> <paramdef>resource <parameter>shmid</parameter></paramdef> <paramdef>int <parameter>start</parameter></paramdef> <paramdef>int <parameter>count</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>shm_read</function> lit une chaîne dans une bloc de + <function>shmop_read</function> lit une chaîne dans une bloc de mémoire partagée. </para> <para> - <function>shm_read</function> prend 3 paramètres: + <function>shmop_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> + <function>shmop_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. @@ -153,7 +161,7 @@ <title>Lire un bloc de mémoire partagée</title> <programlisting role="php"> <?php -$shm_data = shm_read($shm_id, 0, 50); +$shm_data = shmop_read($shm_id, 0, 50); ?> </programlisting> </example> @@ -164,30 +172,30 @@ </para> </refsect1> </refentry> - <refentry id="function.shm-write"> + <refentry id="function.shmop-write"> <refnamediv> - <refname>shm_write</refname> + <refname>shmop_write</refname> <refpurpose>Ecrire dans un bloc de mémoire partagée</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>shm_write</function></funcdef> + <funcdef>int <function>shmop_write</function></funcdef> <paramdef>resource <parameter>shmid</parameter></paramdef> <paramdef>string <parameter>data</parameter></paramdef> <paramdef>int <parameter>offset</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>shm_write</function> écrit une chaîne dans + <function>shmop_write</function> écrit une chaîne dans un bloc de mémoire partagée. </para> <para> - <function>shm_write</function> prend 3 paramètres: + <function>shmop_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>shmop_open</function>, <parameter>data</parameter> qui est la chaîne à écrire dans la mémoire et <parameter>offset</parameter>, la position à partir de laquelle il faut commencer @@ -198,7 +206,7 @@ <title>Ecrire un bloc de mémoire partagée</title> <programlisting role="php"> <?php -$shm_bytes_written = shm_write($shm_id, $my_string, 0); +$shm_bytes_written = shmop_write($shm_id, $my_string, 0); ?> </programlisting> </example> @@ -211,27 +219,27 @@ </para> </refsect1> </refentry> - <refentry id="function.shm-size"> + <refentry id="function.shmop-size"> <refnamediv> - <refname>shm_size</refname> + <refname>shmop_size</refname> <refpurpose>Lire la taille du bloc de mémoire partagée</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>shm_size</function></funcdef> + <funcdef>int <function>shmop_size</function></funcdef> <paramdef>resource <parameter>shmid</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>shm_size</function> sert à connaître + <function>shmop_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>, + <function>shmop_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 + créé par <function>shmop_open</function>, et retourne un entier, qui représente le taille de ce bloc. </para> <para> @@ -239,7 +247,7 @@ <title>Lire la taille d'un bloc de mémoire partagée</title> <programlisting role="php"> <?php -$shm_size = shm_size($shm_id); +$shm_size = shmop_size($shm_id); ?> </programlisting> </example> @@ -250,9 +258,9 @@ </para> </refsect1> </refentry> - <refentry id="function.shm-delete"> + <refentry id="function.shmop-delete"> <refnamediv> - <refname>shm_delete</refname> + <refname>shmop_delete</refname> <refpurpose> Détruit un bloc de mémoire partagée </refpurpose> @@ -261,18 +269,18 @@ <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>shm_delete</function></funcdef> + <funcdef>int <function>shmop_delete</function></funcdef> <paramdef>resource <parameter>shmid</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>shm_delete</function> sert à détruire un + <function>shmop_delete</function> sert à détruire un bloc de mémoire partagée. </para> <para> - <function>shm_delete</function> prend un identifiant de + <function>shmop_delete</function> prend un identifiant de mémoire partagée <parameter>shmid</parameter>, - créé par <function>shm_open</function>. + créé par <function>shmop_open</function>. En cas de succès, la fonction retourne 1, et sinon, 0. </para> <para> @@ -280,7 +288,7 @@ <title>Effacement d'un bloc de mémoire partagée</title> <programlisting role="php"> <?php -shm_delete($shm_id); +shmop_delete($shm_id); ?> </programlisting> </example> @@ -291,34 +299,34 @@ </para> </refsect1> </refentry> - <refentry id="function.shm-close"> + <refentry id="function.shmop-close"> <refnamediv> - <refname>shm_close</refname> + <refname>shmop_close</refname> <refpurpose>Ferme un bloc de mémoire partagée</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>shm_close</function></funcdef> + <funcdef>int <function>shmop_close</function></funcdef> <paramdef>resource <parameter>shmid</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>shm_close</function> sert à fermer un bloc de + <function>shmop_close</function> sert à fermer un bloc de mémoire partagée. </para> <para> - <function>shm_close</function> prend un identifiant de mémoire + <function>shmop_close</function> prend un identifiant de mémoire partagée, <parameter>shmid</parameter>, créé par - <function>shm_open</function>. + <function>shmop_open</function>. </para> <para> <example> <title>Fermeture d'un bloc de mémoire partagée</title> <programlisting role="php"> <?php -shm_close($shm_id); +shmop_close($shm_id); ?> </programlisting> </example>