cvs: phpdoc /cs/functions shmop.xml
| From: | Roman Neuhauser | Date: | Mon, 05 Feb 2001 12:46:49 +0000 |
| Subject: | cvs: phpdoc /cs/functions shmop.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969334175@lists.php.net to get a copy of this message | ||
cynic Mon Feb 5 04:46:49 2001 EDT
Added files:
/phpdoc/cs/functions shmop.xml
Log:
should be completely translated
Index: phpdoc/cs/functions/shmop.xml +++ phpdoc/cs/functions/shmop.xml <reference id="ref.shmop"> <title>Funkce pro práci se sdílenou pamìtí</title> <titleabbrev>shmop</titleabbrev> <partintro> <para> Shmop snadno pou¾itelná sada funkcí, která PHP umo¾òuje èíst, zapisovat, vytváøet a mazat segmenty UNIXové sdílené pamìti. Tyto funkce na Windows nefungují, proto¾e tento systém nepodporuje sdílenou pamì». Pokud chcete shmop pou¾ívat, budete muset PHP zkompilovat s <option role="configure">--enable-shmop</option>. </para> <note> <simpara> Názvy funkcí popisovaných v této kapitole zaèínají v PHP 4.0.3 na <function>shm_</function>, ale od PHP 4.0.4 se jejich názvy zmìnily na <function>shmop_</function>. </simpara> </note> <para> <example> <title>Pøehled operací se sdílenou pamìtí</title> <programlisting role="php"> <?php // Vytvoøit 100 bytový blok sdílené pamìti se system id 0xff3 $shm_id = shmop_open(0xff3, "c", 0644, 100); if(!$shm_id) { echo "Nepodaøilo se vytvoøit segment sdílené pamìti\n"; } // Zjistit velikost bloku sdílené pamìti $shm_size = shmop_size($shm_id); echo "SHM blok o velikosti : ".$shm_size. " byl vytvoøen.\n"; // Zapí¹eme do sdílené pamìti zku¹ební øetìzec $shm_bytes_written = shmop_write($shm_id, "my shared memory block", 0); if($shm_bytes_written != strlen("mùj blok sdílené pamìti")) { echo "Nepodaøilo se zapsat kompletní data\n"; } // Naèteme øetìzec zpátky $my_string = shmop_read($shm_id, 0, $shm_size); if(!$my_string) { echo "Nepodaøilo se èíst z bloku sdílené pamìti\n"; } echo "Data ve sdílené pamìti byla: ".$my_string."\n"; //Sma¾eme tento blok a zavøeme segment sdílené pamìti if(!shmop_delete($shm_id)) { echo "Nepodaøilo se smazat blok sdílené pamìti."; } shmop_close($shm_id); ?> </programlisting> </example> </para> </partintro> <refentry id="function.shmop_open"> <refnamediv> <refname>shmop_open</refname> <refpurpose>Vytvoøit nebo otevøít blok sdílené pamìti</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>int <function>shmop_open</function></funcdef> <paramdef>int <parameter>key</parameter></paramdef> <paramdef>string <parameter>flags</parameter></paramdef> <paramdef>int <parameter>mode</parameter></paramdef> <paramdef>int <parameter>size</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>shmop_open</function> vytvoøí nebo otevøe blok sdílené pamìti. </para> <para> <function>shmop_open</function> pøijímá 4 argumenty: klíè, co¾ je system id bloku sdílené pamìti; tento argument mù¾e být pøedán jako desítkové nebo hexadecimální èíslo. Druhý argument jsou parametry: <itemizedlist> <listitem> <simpara> "a" pro pøístup (nastavuje IPC_EXCL) tento parametr pou¾ijte, pokud chcete otevøít existující segment sdílené pamìti </simpara> </listitem> <listitem> <simpara> "c" pro vytvoøení (nastavuje IPC_CREATE) tento parametr pou¾ijte, pokud chcete vytvoøit nový segment sdílené pamìti </simpara> </listitem> </itemizedlist> Tøetí argument je mód, co¾ jsou pøístupová práva, která chcete tomuto segmentu pøiøadit; jsou stejná jako práva pro soubory. Pøístupová práva musí být pøedána jako oktalové èíslo, napø. 0644. Poslední argument je velikost bloku sdílené pamìti, který chcete vytvoøit, v bytech. <note><simpara> Pozn.: Pokud otvíráte existující segment pamìti, 3. 4. argument by mìly být pøedány jako 0. Pøi úspìchu <function>shmop_open</function> vrací id, které mù¾ete pou¾ít k pøístupu na tento segment sdílené pamìti. </simpara></note> </para> <para> <example> <title>Vytvoøení bloku sdílené pamìti</title> <programlisting role="php"> <?php $shm_id = shmop_open(0x0fff, "c", 0644, 100); ?> </programlisting> </example> </para> <para> Tato ukázka otevøela blok sdílené pamìti se system id 0x0fff. </para> </refsect1> </refentry> <refentry id="function.shmop_read"> <refnamediv> <refname>shmop_read</refname> <refpurpose>Pøeèíst data z bloku sdílené pamìti</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>string <function>shmop_read</function></funcdef> <paramdef>int <parameter>shmid</parameter></paramdef> <paramdef>int <parameter>start</parameter></paramdef> <paramdef>int <parameter>count</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>shmop_read</function> ète øetìzec z bloku sdílené pamìti. </para> <para> <function>shmop_read</function> pøijímá 3 argumenty: <parameter>shmid</parameter>, co¾ je id bloku sdílené pamìti vytvoøeného funkcí <function>shmop_open</function>, <parameter>start</parameter>, co¾ je offset na kterém má ètení zaèít, a <parameter>count</parameter>, co¾ je poèet bytù, které se mají pøeèíst. </para> <para> <example> <title>Ètení bloku sdílené pamìti</title> <programlisting role="php"> <?php $shm_data = shmop_read($shm_id, 0, 50); ?> </programlisting> </example> </para> <para> Tato ukázka pøeète z bloku sdílené pamìti 50 bytù a umístí naètená data do <literal>$shm_data</literal>. </para> </refsect1> </refentry> <refentry id="function.shmop_write"> <refnamediv> <refname>shmop_write</refname> <refpurpose>Zapsat data do bloku sdílené pamìti</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>int <function>shmop_write</function></funcdef> <paramdef>int <parameter>shmid</parameter></paramdef> <paramdef>string <parameter>data</parameter></paramdef> <paramdef>int <parameter>offset</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>shmop_write</function> zapí¹e øetìzec do bloku sdílené pamìti. </para> <para> <function>shmop_write</function> pøijímá 3 argumenty: <parameter>shmid</parameter>, co¾ je id bloku sdílené pamìti vytvoøeného funkcí <function>shmop_open</function>, <parameter>data</parameter>, co¾ je øetìzec, který se zapí¹e do bloku sdílené pamìti, a <parameter>offset</parameter>, co¾ je offset na kterém má zápis zaèít. </para> <para> <example> <title>Zápis do bloku sdílené pamìti</title> <programlisting role="php"> <?php $shm_bytes_written = shmop_write($shm_id, $my_string, 0); ?> </programlisting> </example> </para> <para> Tato ukázka zapí¹e data obsa¾ená v <literal>$my_string</literal> do bloku sdílené pamìti, a <literal>$shm_bytes_written</literal> obsahuje poèet zapsaných bytù. </para> </refsect1> </refentry> <refentry id="function.size"> <refnamediv> <refname>shmop_size</refname> <refpurpose>Zjistit velikost bloku sdílené pamìti</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>int <function>shmop_size</function></funcdef> <paramdef>int <parameter>shmid</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>shmop_size</function> se pou¾ívá ke zji¹tìní velikosti bloku sdílené pamìti v bytech. </para> <para> <function>shmop_size</function> pøijímá <parameter>shmid</parameter>, co¾ je idenfifikátor vytvoøený funkcí <function>shmop_open</function>. <function>shmop_size</function> vrací integer pøedstavující poèet bytù, které blok sdílené pamìti zabírá. </para> <para> <example> <title>Zji¹tìní velikosti bloku sdílené pamìti</title> <programlisting role="php"> <?php $shm_size = shmop_size($shm_id); ?> </programlisting> </example> </para> <para> Tato ukázka zapí¹e velikost bloku sdílené pamìti urèeného identifikátorem <literal>$shm_id</literal> do <literal>$shm_size</literal>. </para> </refsect1> </refentry> <refentry id="function.shmop_delete"> <refnamediv> <refname>shmop_delete</refname> <refpurpose>Smazat blok sdílené pamìti</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>int <function>shmop_delete</function></funcdef> <paramdef>int <parameter>shmid</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>shmop_delete</function> se pou¾ívá ke smazání bloku sdílené pamìti. </para> <para> <function>shmop_delete</function> pøijímá <parameter>shmid</parameter>, co¾ je identifikátor bloku sdílené pamìti vytvoøený funkcí <function>shmop_open</function>. Pøi úspìchu vrací 1, jinak 0. </para> <para> <example> <title>Smazání bloku sdílené pamìti</title> <programlisting role="php"> <?php shmop_delete($shm_id); ?> </programlisting> </example> </para> <para> Tato ukázka sma¾e blok sdílené pamìti pojmenovaný <literal>$shm_id</literal>. </para> </refsect1> </refentry> <refentry id="function.shmop_close"> <refnamediv> <refname>shmop_close</refname> <refpurpose>Zavøít blok sdílené pamìti</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>int <function>shmop_close</function></funcdef> <paramdef>int <parameter>shmid</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>shmop_close</function> se pou¾ívá k zavøení bloku sdílené pamìti. </para> <para> <function>shmop_close</function> pøijímá <parameter>shmid</parameter>, co¾ je identifikátor bloku sdílené pamìti vytvoøený funkcí <function>shmop_open</function>. </para> <para> <example> <title>Zavøení bloku sdílené pamìti</title> <programlisting role="php"> <?php shmop_close($shm_id); ?> </programlisting> </example> </para> <para> Tato ukázka zavøe blok sdílené pamìti pojmenovaný <literal>$shm_id</literal>. </para> </refsect1> </refentry> </reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: -->
Index: phpdoc/cs/functions/shmop.xml +++ phpdoc/cs/functions/shmop.xml <reference id="ref.shmop"> <title>Funkce pro práci se sdílenou pamìtí</title> <titleabbrev>shmop</titleabbrev> <partintro> <para> Shmop snadno pou¾itelná sada funkcí, která PHP umo¾òuje èíst, zapisovat, vytváøet a mazat segmenty UNIXové sdílené pamìti. Tyto funkce na Windows nefungují, proto¾e tento systém nepodporuje sdílenou pamì». Pokud chcete shmop pou¾ívat, budete muset PHP zkompilovat s <option role="configure">--enable-shmop</option>. </para> <note> <simpara> Názvy funkcí popisovaných v této kapitole zaèínají v PHP 4.0.3 na <function>shm_</function>, ale od PHP 4.0.4 se jejich názvy zmìnily na <function>shmop_</function>. </simpara> </note> <para> <example> <title>Pøehled operací se sdílenou pamìtí</title> <programlisting role="php"> <?php // Vytvoøit 100 bytový blok sdílené pamìti se system id 0xff3 $shm_id = shmop_open(0xff3, "c", 0644, 100); if(!$shm_id) { echo "Nepodaøilo se vytvoøit segment sdílené pamìti\n"; } // Zjistit velikost bloku sdílené pamìti $shm_size = shmop_size($shm_id); echo "SHM blok o velikosti : ".$shm_size. " byl vytvoøen.\n"; // Zapí¹eme do sdílené pamìti zku¹ební øetìzec $shm_bytes_written = shmop_write($shm_id, "my shared memory block", 0); if($shm_bytes_written != strlen("mùj blok sdílené pamìti")) { echo "Nepodaøilo se zapsat kompletní data\n"; } // Naèteme øetìzec zpátky $my_string = shmop_read($shm_id, 0, $shm_size); if(!$my_string) { echo "Nepodaøilo se èíst z bloku sdílené pamìti\n"; } echo "Data ve sdílené pamìti byla: ".$my_string."\n"; //Sma¾eme tento blok a zavøeme segment sdílené pamìti if(!shmop_delete($shm_id)) { echo "Nepodaøilo se smazat blok sdílené pamìti."; } shmop_close($shm_id); ?> </programlisting> </example> </para> </partintro> <refentry id="function.shmop_open"> <refnamediv> <refname>shmop_open</refname> <refpurpose>Vytvoøit nebo otevøít blok sdílené pamìti</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>int <function>shmop_open</function></funcdef> <paramdef>int <parameter>key</parameter></paramdef> <paramdef>string <parameter>flags</parameter></paramdef> <paramdef>int <parameter>mode</parameter></paramdef> <paramdef>int <parameter>size</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>shmop_open</function> vytvoøí nebo otevøe blok sdílené pamìti. </para> <para> <function>shmop_open</function> pøijímá 4 argumenty: klíè, co¾ je system id bloku sdílené pamìti; tento argument mù¾e být pøedán jako desítkové nebo hexadecimální èíslo. Druhý argument jsou parametry: <itemizedlist> <listitem> <simpara> "a" pro pøístup (nastavuje IPC_EXCL) tento parametr pou¾ijte, pokud chcete otevøít existující segment sdílené pamìti </simpara> </listitem> <listitem> <simpara> "c" pro vytvoøení (nastavuje IPC_CREATE) tento parametr pou¾ijte, pokud chcete vytvoøit nový segment sdílené pamìti </simpara> </listitem> </itemizedlist> Tøetí argument je mód, co¾ jsou pøístupová práva, která chcete tomuto segmentu pøiøadit; jsou stejná jako práva pro soubory. Pøístupová práva musí být pøedána jako oktalové èíslo, napø. 0644. Poslední argument je velikost bloku sdílené pamìti, který chcete vytvoøit, v bytech. <note><simpara> Pozn.: Pokud otvíráte existující segment pamìti, 3. 4. argument by mìly být pøedány jako 0. Pøi úspìchu <function>shmop_open</function> vrací id, které mù¾ete pou¾ít k pøístupu na tento segment sdílené pamìti. </simpara></note> </para> <para> <example> <title>Vytvoøení bloku sdílené pamìti</title> <programlisting role="php"> <?php $shm_id = shmop_open(0x0fff, "c", 0644, 100); ?> </programlisting> </example> </para> <para> Tato ukázka otevøela blok sdílené pamìti se system id 0x0fff. </para> </refsect1> </refentry> <refentry id="function.shmop_read"> <refnamediv> <refname>shmop_read</refname> <refpurpose>Pøeèíst data z bloku sdílené pamìti</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>string <function>shmop_read</function></funcdef> <paramdef>int <parameter>shmid</parameter></paramdef> <paramdef>int <parameter>start</parameter></paramdef> <paramdef>int <parameter>count</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>shmop_read</function> ète øetìzec z bloku sdílené pamìti. </para> <para> <function>shmop_read</function> pøijímá 3 argumenty: <parameter>shmid</parameter>, co¾ je id bloku sdílené pamìti vytvoøeného funkcí <function>shmop_open</function>, <parameter>start</parameter>, co¾ je offset na kterém má ètení zaèít, a <parameter>count</parameter>, co¾ je poèet bytù, které se mají pøeèíst. </para> <para> <example> <title>Ètení bloku sdílené pamìti</title> <programlisting role="php"> <?php $shm_data = shmop_read($shm_id, 0, 50); ?> </programlisting> </example> </para> <para> Tato ukázka pøeète z bloku sdílené pamìti 50 bytù a umístí naètená data do <literal>$shm_data</literal>. </para> </refsect1> </refentry> <refentry id="function.shmop_write"> <refnamediv> <refname>shmop_write</refname> <refpurpose>Zapsat data do bloku sdílené pamìti</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>int <function>shmop_write</function></funcdef> <paramdef>int <parameter>shmid</parameter></paramdef> <paramdef>string <parameter>data</parameter></paramdef> <paramdef>int <parameter>offset</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>shmop_write</function> zapí¹e øetìzec do bloku sdílené pamìti. </para> <para> <function>shmop_write</function> pøijímá 3 argumenty: <parameter>shmid</parameter>, co¾ je id bloku sdílené pamìti vytvoøeného funkcí <function>shmop_open</function>, <parameter>data</parameter>, co¾ je øetìzec, který se zapí¹e do bloku sdílené pamìti, a <parameter>offset</parameter>, co¾ je offset na kterém má zápis zaèít. </para> <para> <example> <title>Zápis do bloku sdílené pamìti</title> <programlisting role="php"> <?php $shm_bytes_written = shmop_write($shm_id, $my_string, 0); ?> </programlisting> </example> </para> <para> Tato ukázka zapí¹e data obsa¾ená v <literal>$my_string</literal> do bloku sdílené pamìti, a <literal>$shm_bytes_written</literal> obsahuje poèet zapsaných bytù. </para> </refsect1> </refentry> <refentry id="function.size"> <refnamediv> <refname>shmop_size</refname> <refpurpose>Zjistit velikost bloku sdílené pamìti</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>int <function>shmop_size</function></funcdef> <paramdef>int <parameter>shmid</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>shmop_size</function> se pou¾ívá ke zji¹tìní velikosti bloku sdílené pamìti v bytech. </para> <para> <function>shmop_size</function> pøijímá <parameter>shmid</parameter>, co¾ je idenfifikátor vytvoøený funkcí <function>shmop_open</function>. <function>shmop_size</function> vrací integer pøedstavující poèet bytù, které blok sdílené pamìti zabírá. </para> <para> <example> <title>Zji¹tìní velikosti bloku sdílené pamìti</title> <programlisting role="php"> <?php $shm_size = shmop_size($shm_id); ?> </programlisting> </example> </para> <para> Tato ukázka zapí¹e velikost bloku sdílené pamìti urèeného identifikátorem <literal>$shm_id</literal> do <literal>$shm_size</literal>. </para> </refsect1> </refentry> <refentry id="function.shmop_delete"> <refnamediv> <refname>shmop_delete</refname> <refpurpose>Smazat blok sdílené pamìti</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>int <function>shmop_delete</function></funcdef> <paramdef>int <parameter>shmid</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>shmop_delete</function> se pou¾ívá ke smazání bloku sdílené pamìti. </para> <para> <function>shmop_delete</function> pøijímá <parameter>shmid</parameter>, co¾ je identifikátor bloku sdílené pamìti vytvoøený funkcí <function>shmop_open</function>. Pøi úspìchu vrací 1, jinak 0. </para> <para> <example> <title>Smazání bloku sdílené pamìti</title> <programlisting role="php"> <?php shmop_delete($shm_id); ?> </programlisting> </example> </para> <para> Tato ukázka sma¾e blok sdílené pamìti pojmenovaný <literal>$shm_id</literal>. </para> </refsect1> </refentry> <refentry id="function.shmop_close"> <refnamediv> <refname>shmop_close</refname> <refpurpose>Zavøít blok sdílené pamìti</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>int <function>shmop_close</function></funcdef> <paramdef>int <parameter>shmid</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>shmop_close</function> se pou¾ívá k zavøení bloku sdílené pamìti. </para> <para> <function>shmop_close</function> pøijímá <parameter>shmid</parameter>, co¾ je identifikátor bloku sdílené pamìti vytvoøený funkcí <function>shmop_open</function>. </para> <para> <example> <title>Zavøení bloku sdílené pamìti</title> <programlisting role="php"> <?php shmop_close($shm_id); ?> </programlisting> </example> </para> <para> Tato ukázka zavøe blok sdílené pamìti pojmenovaný <literal>$shm_id</literal>. </para> </refsect1> </refentry> </reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: -->