cvs: phpdoc-ru /language references.xml /reference/iconv configure.xml constants.xml ini.xml reference.xml /reference/iconv/functions
iconv-get-encoding.xml iconv-mime-decode-headers.xml iconv-set-encoding.xml iconv-strlen.xml iconv-strpos.xml iconv-strrpos.xml iconv-substr.xml
iconv.xml /reference/math constants.xml reference.xml /reference/math/functions abs.xml ceil.xml floor.xml fmod.xml getrandmax.xml max.xml min.xml
pi.xml rand.xml round.xml srand.xml
| From: | Alexander Voytsekhovskyy | Date: | Sun, 20 Feb 2005 07:32:10 +0000 |
| Subject: | cvs: phpdoc-ru /language references.xml /reference/iconv configure.xml constants.xml ini.xml reference.xml /reference/iconv/functions iconv-get-encoding.xml iconv-mime-decode-headers.xml iconv-set-encoding.xml iconv-strlen.xml iconv-strpos.xml iconv-strrpos.xml iconv-substr.xml iconv.xml /reference/math constants.xml reference.xml /reference/math/functions abs.xml ceil.xml floor.xml fmod.xml getrandmax.xml max.xml min.xml pi.xml rand.xml round.xml srand.xml |
||
| Groups: | php.doc.ru | ||
| Request: | Send a blank email to doc-ru+get-619@lists.php.net to get a copy of this message | ||
young Sun Feb 20 02:32:10 2005 EDT
Added files:
/phpdoc-ru/language references.xml
/phpdoc-ru/reference/math constants.xml reference.xml
/phpdoc-ru/reference/math/functions abs.xml ceil.xml floor.xml
fmod.xml getrandmax.xml max.xml
min.xml pi.xml rand.xml
round.xml srand.xml
/phpdoc-ru/reference/iconv configure.xml constants.xml ini.xml
reference.xml
/phpdoc-ru/reference/iconv/functions iconv-get-encoding.xml
iconv-mime-decode-headers.xml
iconv-set-encoding.xml
iconv-strlen.xml
iconv-strpos.xml
iconv-strrpos.xml
iconv-substr.xml iconv.xml
Log:
Add new files translated by Nick Shaforostoff
http://cvs.php.net/co.php/phpdoc-ru/language/references.xml?r=1.1&p=1 Index: phpdoc-ru/language/references.xml +++ phpdoc-ru/language/references.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.37 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <chapter id="language.references"> <title>Ññûëêè. Ðàçúÿñíåíèÿ</title> <sect1 id="language.references.whatare"> <title>×òî òàêîå ññûëêè</title> <simpara> Ññûëêè â PHP - ýòî ñðåäñòâî äîñòóïà ê ñîäåðæèìîìó îäíîé ïåðåìåííîé ïîä ðàçíûìè èìåíàìè. Îíè íå ïîõîæè íà óêàçàòåëè C è íå ÿâëÿþòñÿ ïñåâäîíèìàìè òàáëèöû ñèìâîëîâ.  PHP èìÿ ïåðåìåííîé è å¸ ñîäåðæèìîå - ýòî ðàçíûå âåùè, ïîýòîìó îäíî ñîäåðæèìîå ìîæåò èìåòü ðàçíûå èìåíà. Áëèæàéøàÿ àíàëîãèÿ - èìåíà ôàéëîâ Unix è ôàéëû - èìåíà ïåðåìåííûõ ÿâëÿþòñÿ ýëåìåíòàìè êàòàëîãîâ, à ñîäåðæèìîå ïåðåìåííûõ ýòî ñàìè ôàéëû. Ññûëêè â PHP - àíàëîã æ¸ñòêèõ ññûëîê (hardlinks) â ôàéëîâûõ ñèñòåìàõ Unix. </simpara> </sect1> <sect1 id="language.references.whatdo"> <title>×òî äåëàþò ññûëêè</title> <para> Ññûëêè â PHP äàþò âîçìîæíîñòü äâóì ïåðåìåííûì ññûëàòüñÿ íà îäíî ñîäåðæèìîå. Íàïðèìåð: <informalexample> <programlisting role="php"> <![CDATA[ <?php $a =& $b; ?> ]]> </programlisting> </informalexample> îçíà÷àåò, ÷òî <varname>$a</varname> óêàçûâàåò íà òî æå ñîäåðæàíèå, ÷òî è <varname>$b</varname>. <note> <para> <varname>$a</varname> è <varname>$b</varname> çäåñü àáñîëþòíî ýêâèâàëåíòíû, íî ýòî íå îçíà÷àåò, ÷òî $a óêàçûâàåò íà $b èëè íàîáîðîò. Ýòî îçíà÷àåò, ÷òî $a è $b óêàçûâàþò íà îäíî ìåñòî. </para> </note> </para> <note> <para> Ïðè êîïèðîâàíèè ìàññèâà ññûëîê, îíè íå ðàçûìåíîâûâàþòñÿ. Ýòî òàêæå êàñàåòñÿ ìàññèâîâ, ïåðåäàâàåìûõ ôóíêöèÿì ïî çíà÷åíèþ. </para> </note> <para> Òàêîé æå ñèíòàêñèñ ìîæíî èñïîëüçîâàòü è â ôóíêöèÿõ, âîçâðàùàÿ ññûëêè, à òàê æå â îïåðàòîðå <literal>new</literal> (íà÷èíàÿ ñ PHP 4.0.4): <informalexample> <programlisting role="php"> <![CDATA[ <?php $bar =& new fooclass(); $foo =& find_var($bar); ?> ]]> </programlisting> </informalexample> </para> <note> <para> Åñëè îïóñòèòü <literal>&</literal>, ýòî ïðèâåä¸ò ê êîïèðîâàíèþ îáúåêòà. Åñëè âû èñïîëüçóåòå <literal>$this</literal> â êëàññå, îïåðàöèÿ ïðîâîäèòñÿ íàä òåêóùèì ýêçåìïëÿðîì ýòîãî êëàññà. Ïðèñâîåíèå áåç <literal>&</literal> ïðèâåä¸ò ê êîïèðîâàíèþ ýêçåìïëÿðà, è <literal>$this</literal> áóäåò ðàáîòàòü ñ êîïèåé, ÷òî íå âñåãäà æåëàòåëüíî. Îáû÷íî, âàì íóæíî èìåòü îäèí ýêçåìïëÿð, èç ñîîáðàæåíèé ïðîèçâîäèòåëüíîñòè è èñïîëüçîâàíèÿ ïàìÿòè. </para> <para> Îïåðàöèÿ <literal>@</literal>, êîòîðàÿ <emphasis>ñêðûâàåò</emphasis> ñîîáùåíèÿ îá îøèáêàõ, íàïðèìåð â êîíñòðóêòîðå <literal>@new</literal>, íå ìîæåò áûòü èñïîëüçîâàíà ñîâìåñòíî ñ îïåðàöèåé <literal>&</literal> (<literal>&new</literal>). Ýòî îãðàíè÷åíèå èíòåðïðåòàòîðà Zend. </para> </note> <warning> <para> Åñëè ïåðåìåííîé, îáúÿâëåííîé âíóòðè ôóíêöèè êàê <literal>global</literal>, áóäåò ïðèñâîåíà ññûëêà, îíà áóäåò âèäíà òîëüêî â ôóíêöèè. ×òîáû èçáåæàòü ýòî, âîñïîëüçóéòåñü ìàññèâîì <varname>$GLOBALS</varname>. <example> <title>Ïðèñâîåíèå ññûëîê ãëîáàëüíûì ïåðåìåííûì âíóòðè ôóíêöèè</title> <programlisting role="php"> <![CDATA[ <?php $var1 = "Example variable"; $var2 = ""; function global_references($use_globals) { global $var1, $var2; if (!$use_globals) { $var2 =& $var1; // òîëüêî ëîêàëüíî } else { $GLOBALS["var2"] =& $var1; // ãëîáàëüíî } } global_references(false); echo "çíà÷åíèå var2: '$var2'\n"; // çíà÷åíèå var2: '' global_references(true); echo "çíà÷åíèå var2: '$var2'\n"; // çíà÷åíèå var2: 'Example variable' ?> ]]> </programlisting> </example> Äóìàéòå î <literal>global $var;</literal> êàê î ñîêðàùåíèè îò <literal>$var =& $GLOBALS['var'];</literal>. Òàêèì îáðàçîì, ïðèñâîåíèå <literal>$var</literal> äðóãîé ññûëêè âëèÿåò ëèøü íà ëîêàëüíóþ ïåðåìåííóþ. </para> </warning> <note> <para> Ïðè èñïîëüçîâàíèè ïåðåìåííîé-ññûëêè â <link linkend="control-structures.foreach">foreach</link>, èçìåíÿåòñÿ ñîäåðæàíèå, íà êîòîðîå îíà ññûëàåòñÿ. <example> <title>Ññûëêè è foreach</title> <programlisting role="php"> <![CDATA[ <?php $ref = 0; $row =& $ref; foreach (array(1, 2, 3) as $row) { // do something } echo $ref; // 3 - ïîñëåäíåå çíà÷åíèå, èñïîëüçóåìîå â öèêëå ?> ]]> </programlisting> </example> </para> </note> <warning> <para> Ñëîæíûå ìàññèâû â íåêîòîðûõ ñëó÷àÿõ ìîãóò êîïèðîâàòüñÿ âìåñòî ñîçäàíèÿ ññûëîê. íàïðèìåð, ñëåäóþùèé ïðèìåð íå áóäåò ðàáîòàòü êàê îæèäàëîñü. <example> <title>Ññûëêè è ñëîæíûå ìàññèâû</title> <programlisting role="php"> <![CDATA[ <?php $top = array( 'A' => array(), 'B' => array( 'B_b' => array(), ), ); $top['A']['parent'] = &$top; $top['B']['parent'] = &$top; $top['B']['B_b']['data'] = 'test'; print_r($top['A']['parent']['B']['B_b']); // array() ?> ]]> </programlisting> </example> </para> </warning> <para> Âòîðîå, ÷òî äåëàþò ññûëêè - ïåðåäà÷à ïàðàìåòðîâ ïî ññûëêå. Ïðè ýòîì ëîêàëüíàÿ ïåðåìåííàÿ â ôóíêöèè è ïåðåìåííàÿ â îáëàñòè âèäèìîñòè âûçûâàòåëÿ ññûëàþòñÿ íà îäíî è òî æå ñîäåðæèìîå. Ïðèìåð: <informalexample> <programlisting role="php"> <![CDATA[ <?php function foo(&$var) { $var++; } $a=5; foo($a); ?> ]]> </programlisting> </informalexample> Ýòîò êîä ïðèñâîèò <varname>$a</varname> çíà÷åíèå 6. Ýòî ïðîèñõîäèò, ïîòîìó ÷òî â ôóíêöèè <varname>foo</varname> ïåðåìåííàÿ <varname>$var</varname> ññûëàåòñÿ íà òî æå ñîäåðæèìîå, ÷òî è ïåðåìåííàÿ <varname>$a</varname>. Ñì. òàêæå äåòàëüíîå îáúÿñíåíèå <link linkend="language.references.pass">ïåðåäà÷è ïî ññûëêå</link>. </para> <simpara> Òðåòüå, ÷òî ìîãóò ññûëê - <link linkend="language.references.return">âîçâðàùåíèå çíà÷åíèå ïî ññûëêå</link>. </simpara> </sect1> <sect1 id="language.references.arent"> <title>×åì ññûëêè íå ÿâëÿþòñÿ</title> <para> Êàê óæå áûëî ñêàçàíî, ññûëêè íå ÿâëÿþòñÿ óêàçàòåëÿìè. Ýòî îçíà÷àåò, ÷òî ñëåäóþùàÿ êîíñòðóêöèÿ íå áóäåò äåëàòü òî, ÷òî âû îæèäàåòå: <informalexample> <programlisting role="php"> <![CDATA[ <?php function foo(&$var) { $var =& $GLOBALS["baz"]; } foo($bar); ?> ]]> </programlisting> </informalexample> </para> <simpara> Ïåðåìåííàÿ <varname>$var</varname> â ôóêíöèè <varname>foo</varname> áóäåò ñâÿçàíà ñ <varname>$bar</varname> â âûçûâàòåëå, íî çàòåì îíà áóäåò ïåðåïðèâÿçàíà ê <varname>$GLOBALS["baz"]</varname>. Íåò ñïîñîáà ñâÿçàòü <varname>$bar</varname> â îáëàñòè âèäèìîñòè âûçûâàòåëÿ ñ ÷åì-ëèáî åù¸ ïóò¸ì èñïîëüçîâàíèÿ ìåõàíèçìà ññûëîê, ïîñêîëüêó <varname>$bar</varname> íå äîñòóïíà â ôóíêöèè <varname>foo</varname> (äîñòóïíî ëèøü å¸ çíà÷åíèå ÷åðåç <varname>$var</varname>). Âû ìîæåòå âîñïîëüçîâàòüñÿ <link linkend="language.references.return">âîçâðàùåíèåì ññûëîê</link> èç ôóíêöèè äëÿ ïðèâÿçêè âíåøíåé ïåðìåííîé ê äðóãîìó çíà÷åíèþ. </simpara> </sect1> <sect1 id="language.references.pass"> <title>Ïåðåäà÷à ïî ññûëêå</title> <para> Âû ìîæåòå ïåðåäàâàòü ïåðåìåííûå â ôóíêöèþ ïî ññûëêå, è ôóíêöèÿ ñìîæåò èçìåíÿòü ñâîè àðãóìåíòû. Ñèíòàêñèñ òàêîâ: <informalexample> <programlisting role="php"> <![CDATA[ <?php function foo(&$var) { $var++; } $a=5; foo($a); // $a çäåñü ðàâíî 6 ?> ]]> </programlisting> </informalexample> Çàìåòüòå, ÷òî â âûçîâå ôóíêöèè îòñóòñòâóåò çíàê ññûëêè - îí åñòü òîëüêî â îïðåäåëåíèè ôóíêöèè. Ýòîãî äîñòàòî÷íî äëÿ êîððåêòíîé ïåðåäà÷è àðãóìåíòîâ ïî ññûëêå. </para> <para> Ïî ññûëêå ìîæíî ïåðåäàâàòü: <itemizedlist> <listitem> <simpara> Ïåðåìåííûå, íàïðèìåð <literal>foo($a)</literal> </simpara> </listitem> <listitem> <simpara> Îïåðàòîð new, íàïðèìåð <literal>foo(new foobar())</literal> </simpara> </listitem> <listitem> <para> Ññûëêè, âîçâðàùàåìûå ôóíêöèåé, íàïðèìåð: <informalexample> <programlisting role="php"> <![CDATA[ <?php function &bar() { $a = 5; return $a; } foo(bar()); ?> ]]> </programlisting> </informalexample> Ñì. òàêæå îáúÿñíåíèå <link linkend="language.references.return">âîçâðàùåíèÿ ïî ññûëêå</link>. </para> </listitem> </itemizedlist> </para> <para> Ëþáîå äðóãîå âûðàæåíèå íå äîëæíî ïåðåäàâàòüñÿ ïî ññûëêå, òàê êàê ðåçóëüòàò íå îïðåäåë¸í. Íàïðèìåð, ñëåäóþùàÿ ïåðåäà÷à ïî ññûëêå ÿâëÿåòñÿ íåïðàâèëüíîé: <informalexample> <programlisting role="php"> <![CDATA[ <?php function bar() // Îïåðàöèÿ & îòñóòñòâóåò { $a = 5; return $a; } foo(bar()); foo($a = 5); // Âûðàæåíèå, à íå ïåðåìåííàÿ foo(5); // Êîíñòàíòà, à íå ïåðåìåííàÿ ?> ]]> </programlisting> </informalexample> Ýòè òðåáîâàíèÿ äëÿ PHP 4.0.4 è ïîçæå. </para> </sect1> <sect1 id="language.references.return"> <title>Âîçâðàùåíèå ïî ññûëêå</title> <para> Âîçâðàùåíèå ïî ññûëêå èñïîëüçóåòñÿ â òåõ ñëó÷àÿõ, êîãäà âû õîòèòå èñïîëüçîâàòü ôóíêöèþ äëÿ âûáîðà ïåðåìåííîé, ñ êîòîðîé äîëæíà áûòü ñâÿçàíà äàííàÿ ññûëêà. Ïðè âîçâðàùåíèè ïî ññûëêå èñïîëüçóéòå òàêîé ñèíòàêñèñ: <informalexample> <programlisting role="php"> <![CDATA[ <?php function &find_var($param) { /* ... êîä ... */ return $found_var; } $foo =& find_var($bar); $foo->x = 2; ?> ]]> </programlisting> </informalexample>  ýòîì ïðèìåðå óñòàíàâëèâàåòñÿ ñâîéñòâî îáúåêòà, âîçâðàù¸ííîãî ôóíêöèåé <varname>find_var</varname>, à íå åãî êîïèè, êàê áûëî áû áåç èñïîëüçîâàíèÿ ññûëîê. </para> <note> <simpara>  îòëè÷èå îò ïåðåäà÷è ïàðàìåòðîâ ïî ññûëêå, <literal>&</literal> çäåñü íóæíî èñïîëüçîâàòü â îáîèõ ìåñòàõ - äëÿ óêàçàíèÿ íà òî, ÷òî âû âîçâðàùàåòå ññûëêó, à íå êîïèþ, êàê îáû÷íî, è äëÿ óêàçàíèÿ òîãî, ÷òî ïðîèñõîäèò ñâÿçûâàíèå ïî ññûëêå, à íå îáû÷íîå ïðèñâîåíèå. </simpara> </note> </sect1> <sect1 id="language.references.unset"> <title>Ñáðîñ ïåðåìåííûõ-ññûëîê</title> <para> Ïðè ñáðîñå ññûëêè, ïðîñòî ðàçðûâàåòñÿ ñâÿçü èìåíè è ñîäåðæèìîãî ïåðåìåííîé. Ýòî íå îçíà÷àåò, ÷òî ñîäåðæèìîå ïåðåìåííîé áóäåò ðàçðóøåíî. Íàïðèìåð: <informalexample> <programlisting role="php"> <![CDATA[ <?php $a = 1; $b =& $a; unset($a); ?> ]]> </programlisting> </informalexample> Ýòîò êîä íå ñáðîñèò <varname>$b</varname>, à òîëüêî <varname>$a</varname>. </para> <simpara> Îïÿòü æå, ìîæíî ïðîâåñòè àíàëîãèþ ñ âûçîâîì <command>unlink</command> (â Unix). </simpara> </sect1> <sect1 id="language.references.spot"> <title>Íåÿâíîå èñïîëüçîâàíèå ìåõàíèçìà ññûëîê</title> <simpara> Ìíîãèå ñèíòàêñè÷åñêèå êîíñòðóêöèè PHP ðåàëèçîâàíû ÷åðåç ìåõàíèçì ññûëîê, ïîýòîìó âñ¸ ñêàçàííîå âûøå î ññûëî÷íîì ñâÿçûâàíèè ïðèìåíèìî òàêæå è ê ýòèì êîíñòðóêöèÿì. Íåêîòîðûå êîíñòðóêöèè, âðîäå ïåðåäàþùèõ è âîçâðàùàþùèõ ïî ññûëêå, ðàññìîòðåíû ðàíåå. Äðóãèå êîíñòðóêöèè, èñïîëüçóþùèå ññûëêè: </simpara> <sect2 id="references.global"> <title>Ññûëêè <literal>global</literal></title> <para> Åñëè âû îáúÿâëÿåòå ïåðåìåííóþ êàê <command>global $var</command>, âû ôàêòè÷åñêè ñîçäà¸òå ññûëêó íà ãëîáàëüíóþ ïåðåìåííóþ. Ýòî îçíà÷àåò òî æå ñàìîå, ÷òî: <informalexample> <programlisting role="php"> <![CDATA[ <?php $var =& $GLOBALS["var"]; ?> ]]> </programlisting> </informalexample> </para> <simpara> Ýòî çíà÷èò, íàïðèìåð, ÷òî ñáðîñ (unset) <varname>$var</varname> íå ïðèâåä¸ò ê ñáðîñó ãëîáàëüíîé ïåðåìåííîé. </simpara> </sect2> <sect2 id="references.this"> <title><literal>$this</literal></title> <simpara>  ìåòîäàõ îáúåêòà, <varname>$this</varname> âñåãäà ÿâëÿåòñÿ ññûëêîé íà âûçûâàþùèé îáúåêò. </simpara> </sect2> </sect1> </chapter> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/math/constants.xml?r=1.1&p=1 Index: phpdoc-ru/reference/math/constants.xml +++ phpdoc-ru/reference/math/constants.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.2 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <section id="math.constants"> &reftitle.constants; &extension.constants.core; <para> <table> <title>Ìàòåìàòè÷åñêèå êîíñòàíòû</title> <tgroup cols="3"> <thead> <row> <entry>Êîíñòàíòà</entry> <entry>Çíà÷åíèå</entry> <entry>Îïèñàíèå</entry> </row> </thead> <tbody> <row> <entry>M_PI</entry> <entry>3.14159265358979323846</entry> <entry>÷èñëî ïè</entry> </row> <row> <entry>M_E</entry> <entry>2.7182818284590452354</entry> <entry>÷èñëî Ýéëåðà</entry> </row> <row> <entry>M_LOG2E</entry> <entry>1.4426950408889634074</entry> <entry>log_2 e</entry> </row> <row> <entry>M_LOG10E</entry> <entry>0.43429448190325182765</entry> <entry>lg e</entry> </row> <row> <entry>M_LN2</entry> <entry>0.69314718055994530942</entry> <entry>ln 2</entry> </row> <row> <entry>M_LN10</entry> <entry>2.30258509299404568402</entry> <entry>ln 10</entry> </row> <row> <entry>M_PI_2</entry> <entry>1.57079632679489661923</entry> <entry>ïè/2</entry> </row> <row> <entry>M_PI_4</entry> <entry>0.78539816339744830962</entry> <entry>ïè/4</entry> </row> <row> <entry>M_1_PI</entry> <entry>0.31830988618379067154</entry> <entry>1/ïè</entry> </row> <row> <entry>M_2_PI</entry> <entry>0.63661977236758134308</entry> <entry>2/ïè</entry> </row> <row> <entry>M_SQRTPI</entry> <entry>1.77245385090551602729</entry> <entry>sqrt(ïè) [4.0.2]</entry> </row> <row> <entry>M_2_SQRTPI</entry> <entry>1.12837916709551257390</entry> <entry>2/sqrt(ïè)</entry> </row> <row> <entry>M_SQRT2</entry> <entry>1.41421356237309504880</entry> <entry>sqrt(2)</entry> </row> <row> <entry>M_SQRT3</entry> <entry>1.73205080756887729352</entry> <entry>sqrt(3) [4.0.2]</entry> </row> <row> <entry>M_SQRT1_2</entry> <entry>0.70710678118654752440</entry> <entry>1/sqrt(2)</entry> </row> <row> <entry>M_LNPI</entry> <entry>1.14472988584940017414</entry> <entry>ln ïè [4.0.2]</entry> </row> <row> <entry>M_EULER</entry> <entry>0.57721566490153286061</entry> <entry>Ïîñòîÿííàÿ ýéëåðà [4.0.2]</entry> </row> </tbody> </tgroup> </table>  âåðñèÿõ PHP äî 4.0.0 âêëþ÷èòåëüíî äîñòóïíà òîëüêî M_PI. Âñå îñòàëüíûå áûëè äîáàâëåíû ñ ñëåäóþùåé âåðñèè, êðîìå êîíñòàíò ñ ïîìåòêîé [4.0.2], êîòîðûå áûëè äîáàâëåíû â âåðñèè PHP 4.0.2. </para> </section> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/math/reference.xml?r=1.1&p=1 Index: phpdoc-ru/reference/math/reference.xml +++ phpdoc-ru/reference/math/reference.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.6 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <reference id="ref.math"> <title>Ìàòåìàòè÷åñêèå ôóíêöèè</title> <titleabbrev>Math</titleabbrev> <partintro> <section id="math.intro"> &reftitle.intro; <para> Äàííûå ôóíêöèè ðàáîòàþò ñ ÷èñëàìè â äèàïàçîíàõ òèïîâ <type>integer</type> è <type>float</type> íà âàøåé ìàøèíå (ýòî îòâå÷àåò C-òèïàì long è double). Åñëè âàì íóæíî ðàáîòàòü ñ áîëüøèìè ÷èñëàìè, îáðàòèòåñü ê ðàçäåëó <xref linkend="ref.bc"/>. </para> <simpara> Ñì. òàêæå <xref linkend="language.operators.arithmetic"/>. </simpara> </section> <section id="math.requirements"> &reftitle.required; &no.requirement; </section> <section id="math.installation"> &reftitle.install; &no.install; </section> <section id="math.configuration"> &reftitle.runtime; &no.config; </section> <section id="math.resources"> &reftitle.resources; &no.resource; </section> &reference.math.constants; </partintro> &reference.math.functions; </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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/math/functions/abs.xml?r=1.1&p=1 Index: phpdoc-ru/reference/math/functions/abs.xml +++ phpdoc-ru/reference/math/functions/abs.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.5 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <refentry id="function.abs"> <refnamediv> <refname>abs</refname> <refpurpose>Ìîäóëü ÷èñëà</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>number</type><methodname>abs</methodname> <methodparam><type>mixed</type><parameter>number</parameter></methodparam> </methodsynopsis> <para> Âîçâðàùàåò àáñîëþòíîå çíà÷åíèå <parameter>number</parameter>. Åñëè <parameter>number</parameter> èìååò òèï <type>float</type>, âîçâðàùàåìîå çíà÷åíèå òàêæå áóäåò èìåòü òèï <type>float</type>, èíà÷å - <type>integer</type>. </para> <example> <title>Ïðèìåð</title> <programlisting role="php"> <![CDATA[ <?php $abs = abs(-4.2); // $abs = 4.2; (double/float) $abs2 = abs(5); // $abs2 = 5; (integer) $abs3 = abs(-5); // $abs3 = 5; (integer) ?> ]]> </programlisting> </example> </refsect1> </refentry> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/math/functions/ceil.xml?r=1.1&p=1 Index: phpdoc-ru/reference/math/functions/ceil.xml +++ phpdoc-ru/reference/math/functions/ceil.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.5 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <refentry id="function.ceil"> <refnamediv> <refname>ceil</refname> <refpurpose>Îêðóãëÿåò äðîáü â áîëüøóþ ñòîðîíó</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>float</type><methodname>ceil</methodname> <methodparam><type>float</type><parameter>value</parameter></methodparam> </methodsynopsis> <simpara> Âîçâðàùàåò áëèæàéøåå áîëüøåå öåëîå îò <parameter>value</parameter>. Òèï âîçâðàùàåìîãî çíà÷åíèÿ îñòà¸òñÿ <type>float</type> ò.ê. äèàïàçîí <type>float</type> áîëüøå <type>integer</type>. </simpara> <para> <example> <title>Ïðèìåð ôóíêöèè <function>ceil</function></title> <programlisting role="php"> <![CDATA[ <?php echo ceil(4.3); // 5 echo ceil(9.999); // 10 echo ceil(3.0); // 3 ?> ]]> </programlisting> </example> </para> <simpara> Ñì. òàêæå <function>floor</function> è <function>round</function>. </simpara> </refsect1> </refentry> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/math/functions/floor.xml?r=1.1&p=1 Index: phpdoc-ru/reference/math/functions/floor.xml +++ phpdoc-ru/reference/math/functions/floor.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.5 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <refentry id="function.floor"> <refnamediv> <refname>floor</refname> <refpurpose>Îêðóãëÿåò äðîáü â ìåíüøóþ ñòîðîíó</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>float</type><methodname>floor</methodname> <methodparam><type>float</type><parameter>value</parameter></methodparam> </methodsynopsis> <simpara> Âîçâðàùàåò áëèæàéøåå ìåíüøåå öåëîå îò <parameter>value</parameter>. Òèï âîçâðàùàåìîãî çíà÷åíèÿ îñòà¸òñÿ <type>float</type> ò.ê. äèàïàçîí <type>float</type> áîëüøå <type>integer</type>. </simpara> <para> <example> <title>Ïðèìåð ôóíêöèè <function>floor</function></title> <programlisting role="php"> <![CDATA[ <?php echo floor(4.3); // 4 echo floor(9.999); // 9 echo floor(5.0); // 5 ?> ]]> </programlisting> </example> </para> <simpara> Ñì. òàêæå <function>ceil</function> è <function>round</function>. </simpara> </refsect1> </refentry> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/math/functions/fmod.xml?r=1.1&p=1 Index: phpdoc-ru/reference/math/functions/fmod.xml +++ phpdoc-ru/reference/math/functions/fmod.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.5 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <refentry id="function.fmod"> <refnamediv> <refname>fmod</refname> <refpurpose>Âîçâðàùàåò äðîáíûé îñòàòîê îò äåëåíèÿ</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>float</type><methodname>fmod</methodname> <methodparam><type>float</type><parameter>x</parameter></methodparam> <methodparam><type>float</type><parameter>y</parameter></methodparam> </methodsynopsis> <para> Âîçâðàùàåò äðîáíûé îñòàòîê îò äåëåíèÿ äåñÿòè÷íûõ äðîáåé <parameter>x</parameter> è <parameter>y</parameter>). Îñòàòîê (<varname>r</varname>) îïðåäåëÿåòñÿ òàê: x = i * y + r, ãäå <varname>i</varname> - íåêîòîðîå öåëîå. <varname>r</varname> âñåãäà èìååò òàêîåé æå çíàê, êàê è <parameter>x</parameter> è ìîäóëü, ìåíüøèé èëè ðàâíûé ìîäóëþ <parameter>y</parameter>. </para> <para> <example> <title>Ïðèìåð èñïîëüçîâàíèÿ <function>fmod</function></title> <programlisting role="php"> <![CDATA[ <?php $x = 5.7; $y = 1.3; $r = fmod($x, $y); // $r ðàíâî 0.5, ò.ê. 4 * 1.3 + 0.5 = 5.7 ?> ]]> </programlisting> </example> </para> </refsect1> </refentry> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/math/functions/getrandmax.xml?r=1.1&p=1 Index: phpdoc-ru/reference/math/functions/getrandmax.xml +++ phpdoc-ru/reference/math/functions/getrandmax.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.3 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <refentry id="function.getrandmax"> <refnamediv> <refname>getrandmax</refname> <refpurpose>Âîâçðàùàåò ìàêñèìàëüíî âîçìîæíîå ñëó÷àéíîå ÷èñëî</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>int</type><methodname>getrandmax</methodname> <void/> </methodsynopsis> <simpara> Âîçâðàùàåò ìàêñèìàëüíîå çíà÷åíèå, êîòîðîå ìîæíî ïîëó÷èòü ôóíêöèåé <function>rand</function>. </simpara> <simpara> Ñì. òàêæå <function>rand</function>, <function>srand</function> è <function>mt_getrandmax</function>. </simpara> </refsect1> </refentry> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/math/functions/max.xml?r=1.1&p=1 Index: phpdoc-ru/reference/math/functions/max.xml +++ phpdoc-ru/reference/math/functions/max.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.6 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <refentry id="function.max"> <refnamediv> <refname>max</refname> <refpurpose>Íàõîäèò íàèáîëüøåå çíà÷åíèå</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>mixed</type><methodname>max</methodname> <methodparam><type>number</type><parameter>arg1</parameter></methodparam> <methodparam><type>number</type><parameter>arg2</parameter></methodparam> <methodparam choice="opt"><type>number</type><parameter>...</parameter></methodparam> </methodsynopsis> <methodsynopsis> <type>mixed</type><methodname>max</methodname> <methodparam><type>array</type><parameter>numbers</parameter></methodparam> </methodsynopsis> <para> Âîçâðàùàåò íàèáîëüøåå èç ïðåäëîæåííûõ ÷èñåë. </para> <para> Åñëè â êà÷åñòâå àðãóìåíòîâ ïåðåäàí òîëüêî îäèí - ìàññèâ ÷èñåë, <function>max</function> âîçâðàùàåò íàèáîëüøåå èç íèõ. Åñëè ïåðâûé àðãóìåíò - integer èëè float, òî îáÿçàòåëüíî äîëæåí áûòü õîòÿ áû åù¸ îäèí.  ýòîì ñëó÷àå ôóíêöèÿ âåðí¸ò íàèáîëüøåå èç íèõ. Ìîæíî ñðàâíèâàòü íåîãðàíè÷åííîå êîëè÷åñòâî ÷èñåë. </para> <note> <para> PHP ñ÷èòàåò ñòðîêó, êîòîðóþ íå óäàëîñü ïðåîáðàçîâàòü â ÷èñëî, êàê <literal>0</literal>, íî âåðí¸ò ñàìó ñòðîêó, â ñëó÷àå, åñëè âñå îñòàëüíûå ÷èñëà îòðèöàòåëüíûå. Åñëè óêàçàíî íåñêîëüêî ýëåìåíòîâ, ýêâèâàëåíòíûõ <literal>0</literal>, <function>max</function> âåðí¸ò ïåðâûé èç íèõ (ñàìûé ëåâûé). </para> </note> <para> <example> <title>Ïðèìåðû èñïîëüçîâàíèÿ <function>max</function></title> <programlisting role="php"> <![CDATA[ <?php echo max(1, 3, 5, 6, 7); // 7 echo max(array(2, 4, 5)); // 5 echo max(0, 'hello'); // 0 echo max('hello', 0); // hello echo max(-1, 'hello'); // hello // Ïðè óêàçàíèè íåñêîëüêèõ ìàññèâîâ, îíè ñðàâíèâàþòñÿ ïîëíîñòüþ // â íàøåì ïðèìåðå: 2 == 2, íî 4 < 5 $val = max(array(2, 4, 8), array(2, 5, 7)); // array(2, 5, 7) // Ïðè óêàçàíèè ìàññèâà è îòäåëüíûõ ÷èñåë, // âñåãäà âîçâðàùàåòñÿ ìàññèâ, ò.ê. îí ñ÷èòàåòñÿ ñàìûì áîëüøèì $val = max('string', array(2, 5, 7), 42); // array(2, 5, 7) ?> ]]> </programlisting> </example> </para> <para> Ñì òàêæå <function>min</function> è <function>count</function>. </para> </refsect1> </refentry> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/math/functions/min.xml?r=1.1&p=1 Index: phpdoc-ru/reference/math/functions/min.xml +++ phpdoc-ru/reference/math/functions/min.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.5 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <refentry id="function.min"> <refnamediv> <refname>min</refname> <refpurpose>Íàõîäèò íàèìåíüøåå çíà÷åíèå</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>mixed</type><methodname>min</methodname> <methodparam><type>number</type><parameter>arg1</parameter></methodparam> <methodparam><type>number</type><parameter>arg2</parameter></methodparam> <methodparam choice="opt"><type>number</type><parameter>...</parameter></methodparam> </methodsynopsis> <methodsynopsis> <type>mixed</type><methodname>min</methodname> <methodparam><type>array</type><parameter>numbers</parameter></methodparam> </methodsynopsis> <para> Âîçâðàùàåò íàèìåíüøåå èç ïðåäëîæåííûõ ÷èñåë. </para> <para> Åñëè â êà÷åñòâå àðãóìåíòîâ ïåðåäàí òîëüêî îäèí - ìàññèâ ÷èñåë, <function>min</function> âîçâðàùàåò íàèìåíüøåå èç íèõ. Åñëè ïåðâûé àðãóìåíò - integer èëè float, òî îáÿçàòåëüíî äîëæåí áûòü õîòÿ áû åù¸ îäèí.  ýòîì ñëó÷àå ôóíêöèÿ âåðí¸ò íàèìåíüøåå èç íèõ. Ìîæíî ñðàâíèâàòü íåîãðàíè÷åííîå êîëè÷åñòâî ÷èñåë. </para> <note> <para> PHP ñ÷èòàåò ñòðîêó, êîòîðóþ íå óäàëîñü ïðåîáðàçîâàòü â ÷èñëî, êàê <literal>0</literal>, íî âåðí¸ò ñàìó ñòðîêó, â ñëó÷àå, åñëè âñå îñòàëüíûå ÷èñëà ïîëîæèòåëüíûå. Åñëè óêàçàíî íåñêîëüêî ýëåìåíòîâ, ýêâèâàëåíòíûõ <literal>0</literal>, <function>min</function> âåðí¸ò ïåðâûé èç íèõ (ñàìûé ëåâûé). </para> </note> <para> <example> <title>Ïðèìåðû èñïîëüçîâàíèÿ <function>min</function></title> <programlisting role="php"> <![CDATA[ <?php echo min(2, 3, 1, 6, 7); // 1 echo min(array(2, 4, 5)); // 2 echo min(0, 'hello'); // 0 echo min('hello', 0); // hello echo min('hello', -1); // -1 // Ïðè óêàçàíèè íåñêîëüêèõ ìàññèâîâ, îíè ñðàâíèâàþòñÿ ïîëíîñòüþ // â íàøåì ïðèìåðå: 2 == 2, íî 4 < 5 $val = min(array(2, 4, 8), array(2, 5, 1)); // array(2, 4, 8) // Ïðè óêàçàíèè ìàññèâà è îòäåëüíûõ ÷èñåë, // ïåðâûé íèêîãäà íå âîçâðàùàåòñÿ, ò.ê. ñ÷èòàåòñÿ ñàìûì áîëüøèì $val = min('string', array(2, 5, 7), 42); // string ?> ]]> </programlisting> </example> </para> <para> Ñì òàêæå <function>max</function> è <function>count</function>. </para> </refsect1> </refentry> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/math/functions/pi.xml?r=1.1&p=1 Index: phpdoc-ru/reference/math/functions/pi.xml +++ phpdoc-ru/reference/math/functions/pi.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.5 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <refentry id="function.pi"> <refnamediv> <refname>pi</refname> <refpurpose>Âîçâðàùàåò ÷èñëî Ïè</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>float</type><methodname>pi</methodname> <void/> </methodsynopsis> <simpara> Âîçâðàùàåò ÷èñëî Ïè ñ òî÷íîñòüþ, îïðåäåëÿåìîé äèðåêòèâîé <link linkend="ini.precision">precision</link> â &php.ini;, çíà÷åíèå ïî óìîë÷àíèþ êîòîðîé <literal>14</literal>. Êîíñòàíòà <constant>M_PI</constant> äà¸ò èäåíòè÷íûé ðåçóëüòàò. </simpara> <para> <example> <title>Ïðèìåð <function>pi</function></title> <programlisting role="php"> <![CDATA[ <?php echo pi(); // 3.1415926535898 echo M_PI; // 3.1415926535898 ?> ]]> </programlisting> </example> </para> </refsect1> </refentry> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/math/functions/rand.xml?r=1.1&p=1 Index: phpdoc-ru/reference/math/functions/rand.xml +++ phpdoc-ru/reference/math/functions/rand.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.14 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <refentry id="function.rand"> <refnamediv> <refname>rand</refname> <refpurpose>Ãåíåðèðóåò ñëó÷àéíîå ÷èñëî</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>int</type><methodname>rand</methodname> <methodparam choice="opt"><type>int</type><parameter>min</parameter></methodparam> <methodparam><type>int</type><parameter>max</parameter></methodparam> </methodsynopsis> <simpara> Ïðè âûçîâå áåç ïàðàìåòðîâ <parameter>min</parameter> è <parameter>max</parameter>, âîçâðàùàåò ïñåâäîñëó÷àéíîå öåëîå â äèàïàçîíå îò 0 äî <constant>RAND_MAX</constant>. Íàïðèìåð, åñëè âàì íóæíî ñëó÷àéíîå ÷èñëî ìåæäó 5 è 15 (âêëþ÷èòåëüíî), âûçîâèòå <literal>rand (5, 15)</literal>. </simpara> <para> <example> <title>Ïðèìåð</title> <programlisting role="php"> <![CDATA[ <?php echo rand() . "\n"; echo rand() . "\n"; echo rand(5, 15); ?> ]]> </programlisting> <para> Ïðèìåð âûøå âûâåäåò ÷òî-òî íàïîäîáèå ýòîãî: </para> <screen> <![CDATA[ 7771 22264 11 ]]> </screen> </example> </para> <note> <simpara> Íà íåêîòîðûõ ïëàòôîðìàõ (òàêèõ êàê Windows) <constant>RAND_MAX</constant> âñåãî ëèøü 32768. ×òîáû ðàñøèðèòü äèàïàçîí, èñïîëüçóéòå ïàðàìåòðû <parameter>min</parameter> è <parameter>max</parameter>, èëè îáðàòèòåñü ê ôóíêöèè <function>mt_rand</function>. </simpara> </note> ¬e.randomseed; <note> <para>  âåðñèÿõ äî 3.0.7 <parameter>max</parameter> îïðåäåëÿëî äèàïàçîí ãåíåðèðîâàíèÿ. Íàïðèìåð, ÷òîáû ïîëó÷èòü ÷èñëî îò 5 äî 15, íóæíî áûëî âûçâàòü <literal>rand (5, 11)</literal>. </para> </note> <simpara> Ñì. òàêæå: <function>srand</function>, <function>getrandmax</function> è <function>mt_rand</function>. </simpara> </refsect1> </refentry> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/math/functions/round.xml?r=1.1&p=1 Index: phpdoc-ru/reference/math/functions/round.xml +++ phpdoc-ru/reference/math/functions/round.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.9 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <refentry id="function.round"> <refnamediv> <refname>round</refname> <refpurpose>Îêðóãëÿåò ÷èñëî òèïà float</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>float</type><methodname>round</methodname> <methodparam><type>float</type><parameter>val</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>precision</parameter></methodparam> </methodsynopsis> <para> Âîçâðàùàåò îêðóãë¸ííîå çíà÷åíèå <parameter>val</parameter> ñ óêàçàííîé òî÷íîñòüþ <parameter>precision</parameter> (êîëè÷åñòâî öèôð ïîñëå çàïÿòîé). Ïîñëåäíÿÿ ìîæåò áûòü îòðèöàòåëüíîé èëè íóë¸ì (ïî óìîë÷àíèþ). </para> <para> <example> <title>Ïðèìåðû ôóíêöèè <function>round</function></title> <programlisting role="php"> <![CDATA[ <?php echo round(3.4); // 3 echo round(3.5); // 4 echo round(3.6); // 4 echo round(3.6, 0); // 4 echo round(1.95583, 2); // 1.96 echo round(1241757, -3); // 1242000 echo round(5.045, 2); // 5.05 echo round(5.055, 2); // 5.06 ?> ]]> </programlisting> </example> </para> <!-- It's not true <para> <caution> <simpara> When rounding on exact halves <function>round</function> rounds down on evens and up on odds. If you want to always force it in one direction on a .5 (or .05 in your case) add or substract a tiny fuzz factor. The reason behind rounding half the values down and the other half up is to avoid the classical banking problem where if you always rounded down you would be stealing money from your customers, or if you always rounded up you would end up over time losing money. By averaging it out through evens and odds you statistically break even. </simpara> </caution> </para> --> <para> <note> <simpara> PHP ïî óìîë÷àíèþ íå ìîæåò ïðàâèëüíî îáðàáàòûâàòü ñòðîêè òèïà <literal>"12,300.2"</literal>. Äëÿ ïîäðîáíîñòåé ñì. <xref linkend="language.types.string.conversion"/>. </simpara> </note> </para> <para> <note> <simpara> ïàðàìåòð <parameter>precision</parameter> áûë äîáàâëåí â PHP 4. </simpara> </note> </para> <simpara> Ñì. òàêæå: <function>ceil</function>, <function>floor</function> è <function>number_format</function>. </simpara> </refsect1> </refentry> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/math/functions/srand.xml?r=1.1&p=1 Index: phpdoc-ru/reference/math/functions/srand.xml +++ phpdoc-ru/reference/math/functions/srand.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.8 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <refentry id="function.srand"> <refnamediv> <refname>srand</refname> <refpurpose>Èçìåíÿåò íà÷àëüíîå ÷èñëî ãåíåðàòîðà ïñåâäîñëó÷àéíûõ ÷èñåë</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>void</type><methodname>srand</methodname> <methodparam choice="opt"><type>int</type><parameter>seed</parameter></methodparam> </methodsynopsis> <para> Óñòàíàâëèâàåò íà÷àëüíîå ÷èñëî ãåíåðàòîðà ñëó÷àéíûõ ÷èñåë â <parameter>seed</parameter>. Íà÷èíàÿ ñ PHP 4.2.0, <parameter>seed</parameter> - íåîáÿçàòåëüíûé ïàðàìåòð, åñëè îí íå óêàçàí, áåð¸òñÿ ñëó÷àéíîå ÷èñëî. </para> <para> <example> <title>Ïðèìåð <function>srand</function></title> <programlisting role="php"> <![CDATA[ <?php // ðàíäîìèçèðîâàòü ìèêðîñåêóíäàìè function make_seed() { list($usec, $sec) = explode(' ', microtime()); return (float) $sec + ((float) $usec * 100000); } srand(make_seed()); $randval = rand(); ?> ]]> </programlisting> </example> </para> ¬e.randomseed; <simpara> Ñì. òàêæå: <function>rand</function>, <function>getrandmax</function> è <function>mt_srand</function>. </simpara> </refsect1> </refentry> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/iconv/configure.xml?r=1.1&p=1 Index: phpdoc-ru/reference/iconv/configure.xml +++ phpdoc-ru/reference/iconv/configure.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.5 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <section id="iconv.installation"> &reftitle.install; <para> ×òîáû ðàñøèðåíèå áûëî äîñòóïíî, íóæíî óêàçàòü êëþ÷ <option role="configure">--with-iconv[=DIR]</option> ïðè çàïóñêå ñöåíàðèÿ êîíôèãóðèðîâàíèÿ. </para> <note> <title>Ïðèìå÷àíèå äëÿ ïîëüçîâàòåëåé Windows®</title> <simpara> ×òîáû ðàñøèðåíèå áûëî äîñòóïíî, ïîìåñòèòå áèáëèîòåêó ñ èìåíåì <emphasis>iconv.dll</emphasis> èëè <emphasis>iconv-1.3.dll</emphasis> (äëÿ âåðñèé äî 4.2.1), êîòîðàÿ âõîäèò â ïîñòàâêó PHP äëÿ Windows®, â îäíó èç å¸ ñèñòåìíûõ ïàïîê. </simpara> <simpara> Ýòîò ìîäóëü ÿâëÿåòñÿ ÷àñòüþ PHP íà÷èíàÿ ñ âåðñèè 5, òàê ÷òî áèáëèîòåêè <emphasis>iconv.dll</emphasis> è <emphasis>php_iconv.dll</emphasis> áîëåå íå íóæíû. </simpara> </note> </section> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/iconv/constants.xml?r=1.1&p=1 Index: phpdoc-ru/reference/iconv/constants.xml +++ phpdoc-ru/reference/iconv/constants.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.4 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --><section id="iconv.constants"> &reftitle.constants; <para> Íà÷èíàÿ ñ <application>PHP</application> 4.3.0 âîçìîæíî óçíàòü âî âðåìÿ âûïîëíåíèÿ, êàêàÿ ðåàëèçàöèÿ <literal>iconv</literal> èñïîëüçóåòñÿ ðàñøèðåíèåì. <table> <title>Êîíñòàíòû <literal>iconv</literal></title> <tgroup cols="3"> <thead> <row> <entry>Èìÿ</entry> <entry>Òèï</entry> <entry>Îïèñàíèå</entry> </row> </thead> <tbody> <row> <entry>ICONV_IMPL</entry> <entry><type>string</type></entry> <entry>Ðåàëèçàöèÿ</entry> </row> <row> <entry>ICONV_VERSION</entry> <entry><type>string</type></entry> <entry>Âåðñèÿ ðåàëèçàöèè</entry> </row> </tbody> </tgroup> </table> </para> <note> <para> Èñïîëüçóéòå ýòè êîíñòàíòû äëÿ íàïèñàíèÿ ñöåíàðèåâ, íåçàâèñèìûõ îò ðåàëèçàöèè. </para> </note> <para> Íà÷èíàÿ ñ <application>PHP</application> 5.0.0, äîñòóïíû òàêæå ñëåäóþùèå êîíñòàíòû: <table> <title>êîíñòàíòû <literal>iconv</literal>, äîñòóïíûå íà÷èíàÿ ñ PHP 5.0.0</title> <tgroup cols="3"> <thead> <row> <entry>Èìÿ</entry> <entry>Òèï</entry> <entry>Îïèñàíèå</entry> </row> </thead> <tbody> <row> <entry>ICONV_MIME_DECODE_STRICT</entry> <entry><type>integer</type></entry> <entry>Áèòîâàÿ ìàñêà, èñïîëüçóåìàÿ äëÿ <function>iconv_mime_decode</function></entry> </row> <row> <entry>ICONV_MIME_DECODE_CONTINUE_ON_ERROR</entry> <entry><type>integer</type></entry> <entry>Áèòîâàÿ ìàñêà, èñïîëüçóåìàÿ äëÿ <function>iconv_mime_decode</function></entry> </row> </tbody> </tgroup> </table> </para> </section> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: --> http://cvs.php.net/co.php/phpdoc-ru/reference/iconv/ini.xml?r=1.1&p=1 Index: phpdoc-ru/reference/iconv/ini.xml +++ phpdoc-ru/reference/iconv/ini.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.2 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --><section id="iconv.configuration"> &reftitle.runtime; &extension.runtime; <para> <table> <title>Êîíôèãóðàöèîííûå ïàðàìåòðû, êàñàþùèåñÿ Iconv</title> <tgroup cols="3"> <thead> <row> <entry>Ïàðàìåòð</entry> <entry>Çíà÷åíèå ïî óìîë÷àíèþ</entry> <entry>Ïåðåìåííàÿ îêðóæåíèÿ</entry> </row> </thead> <tbody> <row> <entry>iconv.input_encoding</entry> <entry>ICONV_INPUT_ENCODING</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>iconv.output_encoding</entry> <entry>ICONV_OUTPUT_ENCODING</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>iconv.internal_encoding</entry> <entry>ICONV_INTERNAL_ENCODING</entry> <entry>PHP_INI_ALL</entry> </row> </tbody> </tgroup> </table> Äëÿ ïîäðîáíîñòåé î êîíñòàíòàõ PHP_INI_* ñì. <function>ini_set</function>. </para> <note> <para> Íà äàííûé ìîìåíò <parameter>iconv.input_encoding</parameter> íèêàê íå èñïîëüçóåòñÿ. </para> </note> </section> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/iconv/reference.xml?r=1.1&p=1 Index: phpdoc-ru/reference/iconv/reference.xml +++ phpdoc-ru/reference/iconv/reference.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.16 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <reference id="ref.iconv"> <title>Ôóíêöèè iconv</title> <titleabbrev>iconv</titleabbrev> <partintro> <section id="iconv.intro"> &reftitle.intro; <para> Ýòî ðàñøèðåíèå ïðåäîñòàâëÿåò èíòåðôåéñ ê áèáëèîòåêå ïðåîáðàçîâàíèÿ êîäèðîâîê iconv. Íàáîð ïîääåðæèâàåìûõ êîäèðîâîê çàâèñèò îò ðåàëèçàöèè iconv â âàøåé ñèñòåìå. Íà íåêîòîðûõ ïëàòôîðìàõ iconv ìîæåò ðàáîòàòü íåíîðìàëüíî, â òàêèõ ñëó÷àÿõ ðåêîìåíäóåòñÿ óñòàíîâèòü áèáëèîòåêó <ulink url="&url.libiconv;">GNU libiconv</ulink>. </para> <para> Íà÷èíàÿ ñ <application>PHP</application> 5.0.0, ýòî â ðàñøèðåíèå äîáàâëåíû íåêîòîðûå âñïîìîãàòåëüíûå ôóíêöèè, ïîìîãàþùèå ïðè íàïèñàíèè ñöåíàðèåâ, ðàáîòàþùèõ ñ íåñêîëüêèìè ÿçûêàìè. </para> </section> <section id="iconv.requirements"> &reftitle.required; <para> Îïåðàöèîííûå ñèñòåìû, îòâå÷àþùèå ñòàíäàðòàì POSIX, ïîñòàâëÿþòñÿ ñ C-áèáëèîòåêàìè, ïðåäîñòàâëÿþùèìè ôóíêöèîíàëüíîñòü iconv. Èíà÷å, âàì ïðèä¸òñÿ óñòàíîâèòü áèáëèîòåêó <ulink url="&url.libiconv;">libiconv îò GNU</ulink>. </para> </section> &reference.iconv.configure; &reference.iconv.ini; <section id="iconv.resources"> &reftitle.resources; &no.resource; </section> &reference.iconv.constants; <section id="iconv.seealso"> &reftitle.seealso; <para> Ñì. òàêæå <link linkend="ref.recode">Ôóíêöèè GNU Recode</link>. </para> </section> </partintro> &reference.iconv.functions; </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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/iconv/functions/iconv-get-encoding.xml?r=1.1&p=1 Index: phpdoc-ru/reference/iconv/functions/iconv-get-encoding.xml +++ phpdoc-ru/reference/iconv/functions/iconv-get-encoding.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.8 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <refentry id="function.iconv-get-encoding"> <refnamediv> <refname>iconv_get_encoding</refname> <refpurpose>Âîçâðàùàåò çíà÷åíèå âíóòðåííèõ ïåðåìåííûõ ðàñøèðåíèÿ</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>mixed</type><methodname>iconv_get_encoding</methodname> <methodparam choice="opt"><type>string</type><parameter>type</parameter></methodparam> </methodsynopsis> <para> Âîçâðàùàåò òåêóùåå çíà÷åíèå óêàçàííîé âíóòðåííåé ïåðåìåííîé, è &false; â ñëó÷àå îøèáêè. </para> <para> Âîçìîæíûå çíà÷åíèÿ íåîáÿçàòåëüíîãî ïàðàìåòðà <parameter>type</parameter>: <simplelist> <member>all</member> <member>input_encoding</member> <member>output_encoding</member> <member>internal_encoding</member> </simplelist> </para> <para> Åñëè <parameter>type</parameter> íå óêàçàí, èëè ðàâåí "all", <function>iconv_get_encoding</function> âåðí¸ò ìàññèâ ñî ñíà÷åíèÿìè âñåõ ïåðåìåííûõ. </para> <para> <example> <title>Ïðèìåð èñïîëüçîâàíèÿ <function>iconv_get_encoding</function></title> <programlisting role="php"> <![CDATA[ <pre> <?php iconv_set_encoding("internal_encoding", "UTF-8"); iconv_set_encoding("input_encoding", "WINDOWS-1251"); iconv_set_encoding("output_encoding", "KOI8-U"); var_dump(iconv_get_encoding('all')); ?> </pre> ]]> </programlisting> <para> Ðåçóëüòàò âûïîëíåíèÿ ïðèâåäåííûõ âûøå êîìàíä: </para> <screen> <![CDATA[ Array ( [input_encoding] => WINDOWS-1251 [output_encoding] => KOI8-U [internal_encoding] => UTF-8 ) ]]> </screen> </example> </para> <para> Ñì. òàêæå <function>iconv_set_encoding</function> è <function>ob_iconv_handler</function>. </para> </refsect1> </refentry> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/iconv/functions/iconv-mime-decode-headers.xml?r=1.1&p=1 Index: phpdoc-ru/reference/iconv/functions/iconv-mime-decode-headers.xml +++ phpdoc-ru/reference/iconv/functions/iconv-mime-decode-headers.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.10 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <refentry id="function.iconv-mime-decode-headers"> <refnamediv> <refname>iconv_mime_decode_headers</refname> <refpurpose> Äåêîäèðóåò íåñêîëüêî ïîëåé çàãîëîâêà <literal>MIME</literal> </refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>array</type><methodname>iconv_mime_decode_headers</methodname> <methodparam><type>string</type><parameter>encoded_headers</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>mode</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>charset</parameter></methodparam> </methodsynopsis> <para> Âîçâðàùàåò àññîöèàòèâíûé ìàññèâ ñ ïîëÿìè <literal>MIME</literal>-çàãîëîâêà, ïåðåäàííîãî ïàðàìåòðîì <parameter>encoded_headers</parameter>, èëè &false; â ñëó÷àå îøèáêè. </para> <para> Êàæäûé êëþ÷ ýëåìåíòà âîçâðàùàåìîãî ìàññèâà ïðåäñòàâëÿåò îòäåëüíîå èìÿ ïîëÿ, à ñàì ýëåìåíò - åãî çíà÷åíèå. åñëè â çàãîëîâêå íåñêîëüêî ïîëåé ñ îäèíàêîâûì èìåíåì, îíè ïîìåùàþòñÿ â ïîä÷èí¸ííûé ìàññèâ ñ ÷èñëîâûìè èíäåêñàìè. </para> <para> Ïàðàìåòð <parameter>mode</parameter> îïðåäåëÿåò ïîâåäåíèå â ñëó÷àå îáíàðóæåíèÿ íåïðàâèëüíîãî ïîëÿ çàãîëîâêà. ìîæíî óêàçàòü ëþáóþ êîìáèíàöèþ ñëåäóþùèõ áèòîâûõ ìàñîê. <table> <title>Áèòîâûå ìàñêè <function>iconv_mime_decode_headers</function></title> <tgroup cols="3"> <thead> <row> <entry>Çíà÷åíèå</entry> <entry>Êîíñòàíòà</entry> <entry>Îïèñàíèå</entry> </row> </thead> <tbody> <row> <entry>1</entry> <entry>ICONV_MIME_DECODE_STRICT</entry> <entry> Ñòðîãî ñëåäîâàòü ñòàíäàðòàì, îïðåäåë¸ííûì â <ulink url="&url.rfc;2047">RFC2047</ulink>. Ê ñîæàëåíèþ, ìíîãî ïðîïðèåòàðíûõ ïðîãðàì ýëåêòðîííîé ïî÷òû íå ñëåäóþò ñòàíäàðòàì, è, ÷òîáû ïîòîêàòü èì, ýòîò ðåæèì ïî óìîë÷àíèþ îòêëþ÷¸í. </entry> </row> <row> <entry>2</entry> <entry>ICONV_MIME_DECODE_CONTINUE_ON_ERROR</entry> <entry> Ïîïûòàòüñÿ ïðîäîëæèòü îáðàáîòêó â ñëó÷àå îáíàðóæåíèÿ îøèáêè. </entry> </row> </tbody> </tgroup> </table> </para> <para> Åñëè ïàðàìåòð <parameter>charset</parameter> îïóùåí, ïðåäïîëàãàåòñÿ, ÷òî êîäèðîâêà ñòðîêè <parameter>string</parameter> ðàâíà <link linkend="iconv.configuration">iconv.internal_charset</link>. </para> <example> <title>Ïðèìåð <function>iconv_mime_decode_headers</function></title> <programlisting role="php"> <![CDATA[ <?php $headers_string = <<<EOF Subject: =?UTF-8?B?UHLDvGZ1bmcgUHLDvGZ1bmc=?= To: example@example.com Date: Thu, 1 Jan 1970 00:00:00 +0000 Message-Id: <example@example.com> Received: from localhost (localhost [127.0.0.1]) by localhost with SMTP id example for <example@example.com> Thu, 1 Jan 1970 00:00:00 +0000 (UTC) (envelope-from example-return-0000-example=example.com@example.com) Received: (qmail 0 invoked by uid 65534); 1 Thu 2003 00:00:00 +0000 EOF; $headers = iconv_mime_decode_headers($headers_string, 0, "ISO-8859-1"); print_r($headers); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ Array ( [Subject] => Prüfung Prüfung [To] => example@example.com [Date] => Thu, 1 Jan 1970 00:00:00 +0000 [Message-Id] => <example@example.com> [Received] => Array ( [0] => from localhost (localhost [127.0.0.1]) by localhost with SMTP id example for <example@example.com>; Thu, 1 Jan 1970 00:00:00 +0000 (UTC) (envelope-from example-return-0000-example=example.com@example.com) [1] => (qmail 0 invoked by uid 65534); 1 Thu 2003 00:00:00 +0000 ) ) ]]> </screen> </example> <para> Ñì. òàêæå <function>iconv_mime_decode</function>, <function>mb_decode_mimeheader</function>, <function>imap_mime_header_decode</function>, <function>imap_base64</function> è <function>imap_qprint</function>. </para> </refsect1> </refentry> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/iconv/functions/iconv-set-encoding.xml?r=1.1&p=1 Index: phpdoc-ru/reference/iconv/functions/iconv-set-encoding.xml +++ phpdoc-ru/reference/iconv/functions/iconv-set-encoding.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.7 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <refentry id="function.iconv-set-encoding"> <refnamediv> <refname>iconv_set_encoding</refname> <refpurpose>Óñòàíàâëèâàåò çíà÷åíèå îäíîé èç âíóòðåííèõ ïåðåìåííûõ</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>bool</type><methodname>iconv_set_encoding</methodname> <methodparam><type>string</type><parameter>type</parameter></methodparam> <methodparam><type>string</type><parameter>charset</parameter></methodparam> </methodsynopsis> <para> Èçìåíÿåò çíà÷åíèå âíóòðåííåé ïåðåìåííîé, óêàçàííîé ïàðàìåòðîì <parameter>type</parameter>, íà <parameter>charset</parameter>. &return.success; </para> <para> Âîçìîæíûå çíà÷åíèÿ ïàðàìåòðà <parameter>type</parameter>: <simplelist> <member>input_encoding</member> <member>output_encoding</member> <member>internal_encoding</member> </simplelist> </para> <para> <example> <title>Ïðèìåð èñïîëüçîâàíèÿ <function>iconv_set_encoding</function></title> <programlisting role="php"> <![CDATA[ <?php iconv_set_encoding("internal_encoding", "UTF-8"); iconv_set_encoding("output_encoding", "WINDOWS-1251"); ?> ]]> </programlisting> </example> </para> <para> Ñì. òàêæå <function>iconv_get_encoding</function> è <function>ob_iconv_handler</function>. </para> </refsect1> </refentry> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/iconv/functions/iconv-strlen.xml?r=1.1&p=1 Index: phpdoc-ru/reference/iconv/functions/iconv-strlen.xml +++ phpdoc-ru/reference/iconv/functions/iconv-strlen.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.5 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <refentry id="function.iconv-strlen"> <refnamediv> <refname>iconv_strlen</refname> <refpurpose> Âîçâðàùàåò êîëè÷åñòâî ñèìâîëîâ â ñòðîêå </refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>int</type><methodname>iconv_strlen</methodname> <methodparam><type>string</type><parameter>str</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>charset</parameter></methodparam> </methodsynopsis> <para> Âîçâðàùàåò êîëè÷åñòâî ñèìâîëîâ â <parameter>str</parameter>. </para> <para>  îòëè÷èå îò <function>strlen</function>, <function>iconv_strlen</function> ó÷èòûâàåò êîäèðîâêó ñòðîêè (íàïðèìåð, þíèêîä ìîæåò áûòü è äâóõ-, è ÷åòûð¸õáàéòíûì). </para> <para> Åñëè ïàðàìåòð <parameter>charset</parameter> îïóùåí, ïðåäïîëàãàåòñÿ, ÷òî êîäèðîâêà ñòðîêè <parameter>str</parameter> ðàâíà <link linkend="iconv.configuration">iconv.internal_charset</link>. </para> <para> Ñì. òàêæå <function>strlen</function> è <function>mb_strlen</function>. </para> </refsect1> </refentry> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/iconv/functions/iconv-strpos.xml?r=1.1&p=1 Index: phpdoc-ru/reference/iconv/functions/iconv-strpos.xml +++ phpdoc-ru/reference/iconv/functions/iconv-strpos.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.7 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <refentry id="function.iconv-strpos"> <refnamediv> <refname>iconv_strpos</refname> <refpurpose> Âîçâðàùàåò ïîçèöèþ ïåðâîãî âõîæäåíèÿ ïîäñòðîêè </refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>int</type><methodname>iconv_strpos</methodname> <methodparam><type>string</type><parameter>haystack</parameter></methodparam> <methodparam><type>string</type><parameter>needle</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>offset</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>charset</parameter></methodparam> </methodsynopsis> <para> Âîçâðàùàåò ïîçèöèþ ïåðâîãî âõîæäåíèÿ ïîäñòðîêè <parameter>needle</parameter> â ñòðîêó <parameter>haystack</parameter>. </para> <para> Íåîáÿçàòåëüíûé àðãóìåíò <parameter>offset</parameter> ïîçâîëÿåò óêàçàòü, ñ êàêîãî ïî ñ÷¸òó ñèìâîëà ñòðîêè íà÷èíàòü ïîèñê. </para> <para> Åñëè ïîäñòðîêà <parameter>needle</parameter> íå íàéäåíà, <function>iconv_strpos</function> âîçâðàùàåò &false;. </para> &return.falseproblem; <para> Åñëè <parameter>haystack</parameter> èëè <parameter>needle</parameter> íå ÿâëÿåòñÿ ñòðîêîé, îí ïðèâîäèòñÿ ê öåëîìó è òðàêòóåòñÿ êàê êîä ñèìâîëà. </para> <para>  îòëè÷èå îò <function>strpos</function>, <function>iconv_strpos</function> âîçâðàùàåò êîëè÷åñòâî ñèìâîëîâ äî ïîäñòðîêè, â íå ïîçèöèþ âõîæäåíèÿ â áàéòàõ. Ñèìâîëû ñ÷èòàþòñÿ ñ ó÷¸òîì èõ êîäèðîâêè <parameter>charset</parameter>. </para> <para> Åñëè ïàðàìåòð <parameter>charset</parameter> îïóùåí, ïðåäïîëàãàåòñÿ, ÷òî êîäèðîâêà ñòðîêè <parameter>string</parameter> ðàâíà <link linkend="iconv.configuration">iconv.internal_charset</link>. </para> <para> Ñì. òàêæå <function>strpos</function>, <function>iconv_strrpos</function> è <function>mb_strpos</function>. </para> </refsect1> </refentry> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/iconv/functions/iconv-strrpos.xml?r=1.1&p=1 Index: phpdoc-ru/reference/iconv/functions/iconv-strrpos.xml +++ phpdoc-ru/reference/iconv/functions/iconv-strrpos.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.4 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <refentry id="function.iconv-strrpos"> <refnamediv> <refname>iconv_strrpos</refname> <refpurpose> Âîçâðàùàåò ïîçèöèþ ïîñëåäíåãî âõîæäåíèÿ ñèìâîëà </refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>string</type><methodname>iconv_strrpos</methodname> <methodparam><type>string</type><parameter>haystack</parameter></methodparam> <methodparam><type>string</type><parameter>needle</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>charset</parameter></methodparam> </methodsynopsis> <para> Âîçâðàùàåò ïîçèöèþ ïîñëåäíåãî âõîæäåíèÿ <parameter>needle</parameter> â ñòðîêó <parameter>haystack</parameter>. </para> <para> Åñëè ïîäñòðîêà <parameter>needle</parameter> íå íàéäåíà, âîçâðàùàåò &false;. </para> &return.falseproblem; <para> Åñëè <parameter>haystack</parameter> èëè <parameter>needle</parameter> íå ÿâëÿåòñÿ ñòðîêîé, îí ïðèâîäèòñÿ ê öåëîìó è òðàêòóåòñÿ êàê êîä ñèìâîëà. </para> <para>  îòëè÷èå îò <function>strpos</function>, <function>iconv_strrpos</function> âîçâðàùàåò êîëè÷åñòâî ñèìâîëîâ äî ïîäñòðîêè, â íå ïîçèöèþ âõîæäåíèÿ â áàéòàõ. Ñèìâîëû ñ÷èòàþòñÿ ñ ó÷¸òîì èõ êîäèðîâêè <parameter>charset</parameter>. </para> <para> Ñì. òàêæå <function>strrpos</function>, <function>iconv_strpos</function> è <function>mb_strrpos</function>. </para> </refsect1> </refentry> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/iconv/functions/iconv-substr.xml?r=1.1&p=1 Index: phpdoc-ru/reference/iconv/functions/iconv-substr.xml +++ phpdoc-ru/reference/iconv/functions/iconv-substr.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.4 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <refentry id="function.iconv-substr"> <refnamediv> <refname>iconv_substr</refname> <refpurpose> Âîçâðàùàåò ïîäñòðîêó </refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>string</type><methodname>iconv_substr</methodname> <methodparam><type>string</type><parameter>str</parameter></methodparam> <methodparam><type>int</type><parameter>offset</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>charset</parameter></methodparam> </methodsynopsis> <para> Âîçâðàùàåò ïîäñòðîêó ñòðîêè <parameter>str</parameter> äëèíîé <parameter>length</parameter>, íà÷èíàþùóþñÿ ñ ïîçèöèè <parameter>start</parameter>. </para> <para> Åñëè <parameter>start</parameter> íåîòðèöàòåëåí, âîçâðàùàåìàÿ ïîäñòðîêà íà÷èíàåòñÿ â ïîçèöèè ñ èíäåêñîì <parameter>start</parameter> îò íà÷àëà ñòðîêè, ñ÷èòàÿ îò íóëÿ. </para> <para> Åñëè <parameter>start</parameter> îòðèöàòåëüíûé, âîçâðàùàåìàÿ ïîäñòðîêà íà÷èíàåòñÿ ñ ïîçèöèè <parameter>start</parameter> ñ÷èòàÿ ñ êîíöà ñòðîêè <parameter>str</parameter>. </para> <para> Åñëè <parameter>length</parameter> ïîëîæèòåëüíûé, âîçâðàùàåìàÿ ñòðîêà áóäåò íå äëèííåå <parameter>length</parameter> ñèìâîëîâ. Åñëè äëèíà ñòðîêè <parameter>str</parameter> ìåíüøå äëèíû <parameter>start</parameter>, âîçâðàùàåòñÿ &false;. </para> <para> Åñëè ïåðåäàí îòðèöàòåëüíûé <parameter>length</parameter> áóäåò âîçâðàùåíî óêàçàííîå ýòèì àðãóìåíòîì ÷èñëî ñèìâîëîâ íà÷èíàÿ ñ ïîçèöèè <parameter>start</parameter> è çàêàí÷èâàÿ <parameter>length</parameter> â íàïðàâëåíèè îò êîíöà. Åñëè <parameter>start</parameter> òàêæå îòðèöàòåëåí, íà÷àëüíàÿ ïîçèöèÿ ñ÷èòàåòñÿ îòíîñèòåëüíî êîíöà ñòðîêè. </para> <para> Îáðàòèòå âíìàíèå, ÷òî ïàðàìåòðû <parameter>offset</parameter> è <parameter>length</parameter> âñåãäà ïðåäñòàâëÿþò êîëè÷åñòâî ñèìâîëîâ (â òîé èëè èíîé êîäèðîâêå), à â <function>substr</function> - êîëè÷åñòâî áàéò. Åñëè ïàðàìåòð <parameter>charset</parameter> îïóùåí, ïðåäïîëàãàåòñÿ, ÷òî êîäèðîâêà ñòðîêè <parameter>str</parameter> ðàâíà <link linkend="iconv.configuration">iconv.internal_charset</link>. </para> <para> Ñì. òàêæå <function>substr</function>, <function>mb_substr</function> è <function>mb_strcut</function>. </para> </refsect1> </refentry> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/iconv/functions/iconv.xml?r=1.1&p=1 Index: phpdoc-ru/reference/iconv/functions/iconv.xml +++ phpdoc-ru/reference/iconv/functions/iconv.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.10 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <refentry id="function.iconv"> <refnamediv> <refname>iconv</refname> <refpurpose>Ïðåîáðàçîâûâàåò ñèìâîëû ñòðîêè â äðóãóþ êîäèðîâêó</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>string</type><methodname>iconv</methodname> <methodparam><type>string</type><parameter>in_charset</parameter></methodparam> <methodparam><type>string</type><parameter>out_charset</parameter></methodparam> <methodparam><type>string</type><parameter>str</parameter></methodparam> </methodsynopsis> <para> Ïðîèçâîäèò ïðåîáðàçîâàíèå êîäèðîâêè ñèìâîëîâ ñòðîêè <parameter>str</parameter> èç íà÷àëüíîé êîäèðîâêè <parameter>in_charset</parameter> â êîíå÷íóþ <parameter>out_charset</parameter>. Âîçâðàùàåò ñòðîêó â íîâîé êîäèðîâêå, èëè &false; â ñëó÷àå îøèáêè. </para> <para> Åñëè äîáàâèòü <literal>//TRANSLIT</literal> ê ïàðàìåòðó <parameter>out_charset</parameter> áóäåò âêëþ÷åíà òðàíñëèòåðèçàöèÿ. Ýòî îçíà÷àåò, ÷òî âñëó÷àå, êîãäà ñèìâîëà íåò â êîíå÷íîé êîäèðîâêå, îí çàìåíÿåòñÿ îäíèì èëè íåñêîëüêèìè àíàëîãàìè. Åñëè äîáàâèòü <literal>//IGNORE</literal>, òî ñèìâîëû, êîòîðûõ íåò â êîíå÷íîé êîäèðîâêå, áóäóò îïóùåíû. Èíà÷å, áóäåò âîçâðàùåíà ñòðîêà <parameter>str</parameter>, îáðåçàííàÿ äî ïåðâîãî íåäîïóñòèìîãî ñèìâîëà. </para> <para> <example> <title>Ïðèìåð èñïîëüçîâàíèÿ <function>iconv</function>:</title> <programlisting role="php"> <![CDATA[ <?php echo iconv("KOI8-U", "UTF-8", "Ïîðà ïåðåõîäèòü íà þíèêîä."); ?> ]]> </programlisting> </example> </para> </refsect1> </refentry> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->
http://cvs.php.net/co.php/phpdoc-ru/language/references.xml?r=1.1&p=1 Index: phpdoc-ru/language/references.xml +++ phpdoc-ru/language/references.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.37 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <chapter id="language.references"> <title>Ññûëêè. Ðàçúÿñíåíèÿ</title> <sect1 id="language.references.whatare"> <title>×òî òàêîå ññûëêè</title> <simpara> Ññûëêè â PHP - ýòî ñðåäñòâî äîñòóïà ê ñîäåðæèìîìó îäíîé ïåðåìåííîé ïîä ðàçíûìè èìåíàìè. Îíè íå ïîõîæè íà óêàçàòåëè C è íå ÿâëÿþòñÿ ïñåâäîíèìàìè òàáëèöû ñèìâîëîâ.  PHP èìÿ ïåðåìåííîé è å¸ ñîäåðæèìîå - ýòî ðàçíûå âåùè, ïîýòîìó îäíî ñîäåðæèìîå ìîæåò èìåòü ðàçíûå èìåíà. Áëèæàéøàÿ àíàëîãèÿ - èìåíà ôàéëîâ Unix è ôàéëû - èìåíà ïåðåìåííûõ ÿâëÿþòñÿ ýëåìåíòàìè êàòàëîãîâ, à ñîäåðæèìîå ïåðåìåííûõ ýòî ñàìè ôàéëû. Ññûëêè â PHP - àíàëîã æ¸ñòêèõ ññûëîê (hardlinks) â ôàéëîâûõ ñèñòåìàõ Unix. </simpara> </sect1> <sect1 id="language.references.whatdo"> <title>×òî äåëàþò ññûëêè</title> <para> Ññûëêè â PHP äàþò âîçìîæíîñòü äâóì ïåðåìåííûì ññûëàòüñÿ íà îäíî ñîäåðæèìîå. Íàïðèìåð: <informalexample> <programlisting role="php"> <![CDATA[ <?php $a =& $b; ?> ]]> </programlisting> </informalexample> îçíà÷àåò, ÷òî <varname>$a</varname> óêàçûâàåò íà òî æå ñîäåðæàíèå, ÷òî è <varname>$b</varname>. <note> <para> <varname>$a</varname> è <varname>$b</varname> çäåñü àáñîëþòíî ýêâèâàëåíòíû, íî ýòî íå îçíà÷àåò, ÷òî $a óêàçûâàåò íà $b èëè íàîáîðîò. Ýòî îçíà÷àåò, ÷òî $a è $b óêàçûâàþò íà îäíî ìåñòî. </para> </note> </para> <note> <para> Ïðè êîïèðîâàíèè ìàññèâà ññûëîê, îíè íå ðàçûìåíîâûâàþòñÿ. Ýòî òàêæå êàñàåòñÿ ìàññèâîâ, ïåðåäàâàåìûõ ôóíêöèÿì ïî çíà÷åíèþ. </para> </note> <para> Òàêîé æå ñèíòàêñèñ ìîæíî èñïîëüçîâàòü è â ôóíêöèÿõ, âîçâðàùàÿ ññûëêè, à òàê æå â îïåðàòîðå <literal>new</literal> (íà÷èíàÿ ñ PHP 4.0.4): <informalexample> <programlisting role="php"> <![CDATA[ <?php $bar =& new fooclass(); $foo =& find_var($bar); ?> ]]> </programlisting> </informalexample> </para> <note> <para> Åñëè îïóñòèòü <literal>&</literal>, ýòî ïðèâåä¸ò ê êîïèðîâàíèþ îáúåêòà. Åñëè âû èñïîëüçóåòå <literal>$this</literal> â êëàññå, îïåðàöèÿ ïðîâîäèòñÿ íàä òåêóùèì ýêçåìïëÿðîì ýòîãî êëàññà. Ïðèñâîåíèå áåç <literal>&</literal> ïðèâåä¸ò ê êîïèðîâàíèþ ýêçåìïëÿðà, è <literal>$this</literal> áóäåò ðàáîòàòü ñ êîïèåé, ÷òî íå âñåãäà æåëàòåëüíî. Îáû÷íî, âàì íóæíî èìåòü îäèí ýêçåìïëÿð, èç ñîîáðàæåíèé ïðîèçâîäèòåëüíîñòè è èñïîëüçîâàíèÿ ïàìÿòè. </para> <para> Îïåðàöèÿ <literal>@</literal>, êîòîðàÿ <emphasis>ñêðûâàåò</emphasis> ñîîáùåíèÿ îá îøèáêàõ, íàïðèìåð â êîíñòðóêòîðå <literal>@new</literal>, íå ìîæåò áûòü èñïîëüçîâàíà ñîâìåñòíî ñ îïåðàöèåé <literal>&</literal> (<literal>&new</literal>). Ýòî îãðàíè÷åíèå èíòåðïðåòàòîðà Zend. </para> </note> <warning> <para> Åñëè ïåðåìåííîé, îáúÿâëåííîé âíóòðè ôóíêöèè êàê <literal>global</literal>, áóäåò ïðèñâîåíà ññûëêà, îíà áóäåò âèäíà òîëüêî â ôóíêöèè. ×òîáû èçáåæàòü ýòî, âîñïîëüçóéòåñü ìàññèâîì <varname>$GLOBALS</varname>. <example> <title>Ïðèñâîåíèå ññûëîê ãëîáàëüíûì ïåðåìåííûì âíóòðè ôóíêöèè</title> <programlisting role="php"> <![CDATA[ <?php $var1 = "Example variable"; $var2 = ""; function global_references($use_globals) { global $var1, $var2; if (!$use_globals) { $var2 =& $var1; // òîëüêî ëîêàëüíî } else { $GLOBALS["var2"] =& $var1; // ãëîáàëüíî } } global_references(false); echo "çíà÷åíèå var2: '$var2'\n"; // çíà÷åíèå var2: '' global_references(true); echo "çíà÷åíèå var2: '$var2'\n"; // çíà÷åíèå var2: 'Example variable' ?> ]]> </programlisting> </example> Äóìàéòå î <literal>global $var;</literal> êàê î ñîêðàùåíèè îò <literal>$var =& $GLOBALS['var'];</literal>. Òàêèì îáðàçîì, ïðèñâîåíèå <literal>$var</literal> äðóãîé ññûëêè âëèÿåò ëèøü íà ëîêàëüíóþ ïåðåìåííóþ. </para> </warning> <note> <para> Ïðè èñïîëüçîâàíèè ïåðåìåííîé-ññûëêè â <link linkend="control-structures.foreach">foreach</link>, èçìåíÿåòñÿ ñîäåðæàíèå, íà êîòîðîå îíà ññûëàåòñÿ. <example> <title>Ññûëêè è foreach</title> <programlisting role="php"> <![CDATA[ <?php $ref = 0; $row =& $ref; foreach (array(1, 2, 3) as $row) { // do something } echo $ref; // 3 - ïîñëåäíåå çíà÷åíèå, èñïîëüçóåìîå â öèêëå ?> ]]> </programlisting> </example> </para> </note> <warning> <para> Ñëîæíûå ìàññèâû â íåêîòîðûõ ñëó÷àÿõ ìîãóò êîïèðîâàòüñÿ âìåñòî ñîçäàíèÿ ññûëîê. íàïðèìåð, ñëåäóþùèé ïðèìåð íå áóäåò ðàáîòàòü êàê îæèäàëîñü. <example> <title>Ññûëêè è ñëîæíûå ìàññèâû</title> <programlisting role="php"> <![CDATA[ <?php $top = array( 'A' => array(), 'B' => array( 'B_b' => array(), ), ); $top['A']['parent'] = &$top; $top['B']['parent'] = &$top; $top['B']['B_b']['data'] = 'test'; print_r($top['A']['parent']['B']['B_b']); // array() ?> ]]> </programlisting> </example> </para> </warning> <para> Âòîðîå, ÷òî äåëàþò ññûëêè - ïåðåäà÷à ïàðàìåòðîâ ïî ññûëêå. Ïðè ýòîì ëîêàëüíàÿ ïåðåìåííàÿ â ôóíêöèè è ïåðåìåííàÿ â îáëàñòè âèäèìîñòè âûçûâàòåëÿ ññûëàþòñÿ íà îäíî è òî æå ñîäåðæèìîå. Ïðèìåð: <informalexample> <programlisting role="php"> <![CDATA[ <?php function foo(&$var) { $var++; } $a=5; foo($a); ?> ]]> </programlisting> </informalexample> Ýòîò êîä ïðèñâîèò <varname>$a</varname> çíà÷åíèå 6. Ýòî ïðîèñõîäèò, ïîòîìó ÷òî â ôóíêöèè <varname>foo</varname> ïåðåìåííàÿ <varname>$var</varname> ññûëàåòñÿ íà òî æå ñîäåðæèìîå, ÷òî è ïåðåìåííàÿ <varname>$a</varname>. Ñì. òàêæå äåòàëüíîå îáúÿñíåíèå <link linkend="language.references.pass">ïåðåäà÷è ïî ññûëêå</link>. </para> <simpara> Òðåòüå, ÷òî ìîãóò ññûëê - <link linkend="language.references.return">âîçâðàùåíèå çíà÷åíèå ïî ññûëêå</link>. </simpara> </sect1> <sect1 id="language.references.arent"> <title>×åì ññûëêè íå ÿâëÿþòñÿ</title> <para> Êàê óæå áûëî ñêàçàíî, ññûëêè íå ÿâëÿþòñÿ óêàçàòåëÿìè. Ýòî îçíà÷àåò, ÷òî ñëåäóþùàÿ êîíñòðóêöèÿ íå áóäåò äåëàòü òî, ÷òî âû îæèäàåòå: <informalexample> <programlisting role="php"> <![CDATA[ <?php function foo(&$var) { $var =& $GLOBALS["baz"]; } foo($bar); ?> ]]> </programlisting> </informalexample> </para> <simpara> Ïåðåìåííàÿ <varname>$var</varname> â ôóêíöèè <varname>foo</varname> áóäåò ñâÿçàíà ñ <varname>$bar</varname> â âûçûâàòåëå, íî çàòåì îíà áóäåò ïåðåïðèâÿçàíà ê <varname>$GLOBALS["baz"]</varname>. Íåò ñïîñîáà ñâÿçàòü <varname>$bar</varname> â îáëàñòè âèäèìîñòè âûçûâàòåëÿ ñ ÷åì-ëèáî åù¸ ïóò¸ì èñïîëüçîâàíèÿ ìåõàíèçìà ññûëîê, ïîñêîëüêó <varname>$bar</varname> íå äîñòóïíà â ôóíêöèè <varname>foo</varname> (äîñòóïíî ëèøü å¸ çíà÷åíèå ÷åðåç <varname>$var</varname>). Âû ìîæåòå âîñïîëüçîâàòüñÿ <link linkend="language.references.return">âîçâðàùåíèåì ññûëîê</link> èç ôóíêöèè äëÿ ïðèâÿçêè âíåøíåé ïåðìåííîé ê äðóãîìó çíà÷åíèþ. </simpara> </sect1> <sect1 id="language.references.pass"> <title>Ïåðåäà÷à ïî ññûëêå</title> <para> Âû ìîæåòå ïåðåäàâàòü ïåðåìåííûå â ôóíêöèþ ïî ññûëêå, è ôóíêöèÿ ñìîæåò èçìåíÿòü ñâîè àðãóìåíòû. Ñèíòàêñèñ òàêîâ: <informalexample> <programlisting role="php"> <![CDATA[ <?php function foo(&$var) { $var++; } $a=5; foo($a); // $a çäåñü ðàâíî 6 ?> ]]> </programlisting> </informalexample> Çàìåòüòå, ÷òî â âûçîâå ôóíêöèè îòñóòñòâóåò çíàê ññûëêè - îí åñòü òîëüêî â îïðåäåëåíèè ôóíêöèè. Ýòîãî äîñòàòî÷íî äëÿ êîððåêòíîé ïåðåäà÷è àðãóìåíòîâ ïî ññûëêå. </para> <para> Ïî ññûëêå ìîæíî ïåðåäàâàòü: <itemizedlist> <listitem> <simpara> Ïåðåìåííûå, íàïðèìåð <literal>foo($a)</literal> </simpara> </listitem> <listitem> <simpara> Îïåðàòîð new, íàïðèìåð <literal>foo(new foobar())</literal> </simpara> </listitem> <listitem> <para> Ññûëêè, âîçâðàùàåìûå ôóíêöèåé, íàïðèìåð: <informalexample> <programlisting role="php"> <![CDATA[ <?php function &bar() { $a = 5; return $a; } foo(bar()); ?> ]]> </programlisting> </informalexample> Ñì. òàêæå îáúÿñíåíèå <link linkend="language.references.return">âîçâðàùåíèÿ ïî ññûëêå</link>. </para> </listitem> </itemizedlist> </para> <para> Ëþáîå äðóãîå âûðàæåíèå íå äîëæíî ïåðåäàâàòüñÿ ïî ññûëêå, òàê êàê ðåçóëüòàò íå îïðåäåë¸í. Íàïðèìåð, ñëåäóþùàÿ ïåðåäà÷à ïî ññûëêå ÿâëÿåòñÿ íåïðàâèëüíîé: <informalexample> <programlisting role="php"> <![CDATA[ <?php function bar() // Îïåðàöèÿ & îòñóòñòâóåò { $a = 5; return $a; } foo(bar()); foo($a = 5); // Âûðàæåíèå, à íå ïåðåìåííàÿ foo(5); // Êîíñòàíòà, à íå ïåðåìåííàÿ ?> ]]> </programlisting> </informalexample> Ýòè òðåáîâàíèÿ äëÿ PHP 4.0.4 è ïîçæå. </para> </sect1> <sect1 id="language.references.return"> <title>Âîçâðàùåíèå ïî ññûëêå</title> <para> Âîçâðàùåíèå ïî ññûëêå èñïîëüçóåòñÿ â òåõ ñëó÷àÿõ, êîãäà âû õîòèòå èñïîëüçîâàòü ôóíêöèþ äëÿ âûáîðà ïåðåìåííîé, ñ êîòîðîé äîëæíà áûòü ñâÿçàíà äàííàÿ ññûëêà. Ïðè âîçâðàùåíèè ïî ññûëêå èñïîëüçóéòå òàêîé ñèíòàêñèñ: <informalexample> <programlisting role="php"> <![CDATA[ <?php function &find_var($param) { /* ... êîä ... */ return $found_var; } $foo =& find_var($bar); $foo->x = 2; ?> ]]> </programlisting> </informalexample>  ýòîì ïðèìåðå óñòàíàâëèâàåòñÿ ñâîéñòâî îáúåêòà, âîçâðàù¸ííîãî ôóíêöèåé <varname>find_var</varname>, à íå åãî êîïèè, êàê áûëî áû áåç èñïîëüçîâàíèÿ ññûëîê. </para> <note> <simpara>  îòëè÷èå îò ïåðåäà÷è ïàðàìåòðîâ ïî ññûëêå, <literal>&</literal> çäåñü íóæíî èñïîëüçîâàòü â îáîèõ ìåñòàõ - äëÿ óêàçàíèÿ íà òî, ÷òî âû âîçâðàùàåòå ññûëêó, à íå êîïèþ, êàê îáû÷íî, è äëÿ óêàçàíèÿ òîãî, ÷òî ïðîèñõîäèò ñâÿçûâàíèå ïî ññûëêå, à íå îáû÷íîå ïðèñâîåíèå. </simpara> </note> </sect1> <sect1 id="language.references.unset"> <title>Ñáðîñ ïåðåìåííûõ-ññûëîê</title> <para> Ïðè ñáðîñå ññûëêè, ïðîñòî ðàçðûâàåòñÿ ñâÿçü èìåíè è ñîäåðæèìîãî ïåðåìåííîé. Ýòî íå îçíà÷àåò, ÷òî ñîäåðæèìîå ïåðåìåííîé áóäåò ðàçðóøåíî. Íàïðèìåð: <informalexample> <programlisting role="php"> <![CDATA[ <?php $a = 1; $b =& $a; unset($a); ?> ]]> </programlisting> </informalexample> Ýòîò êîä íå ñáðîñèò <varname>$b</varname>, à òîëüêî <varname>$a</varname>. </para> <simpara> Îïÿòü æå, ìîæíî ïðîâåñòè àíàëîãèþ ñ âûçîâîì <command>unlink</command> (â Unix). </simpara> </sect1> <sect1 id="language.references.spot"> <title>Íåÿâíîå èñïîëüçîâàíèå ìåõàíèçìà ññûëîê</title> <simpara> Ìíîãèå ñèíòàêñè÷åñêèå êîíñòðóêöèè PHP ðåàëèçîâàíû ÷åðåç ìåõàíèçì ññûëîê, ïîýòîìó âñ¸ ñêàçàííîå âûøå î ññûëî÷íîì ñâÿçûâàíèè ïðèìåíèìî òàêæå è ê ýòèì êîíñòðóêöèÿì. Íåêîòîðûå êîíñòðóêöèè, âðîäå ïåðåäàþùèõ è âîçâðàùàþùèõ ïî ññûëêå, ðàññìîòðåíû ðàíåå. Äðóãèå êîíñòðóêöèè, èñïîëüçóþùèå ññûëêè: </simpara> <sect2 id="references.global"> <title>Ññûëêè <literal>global</literal></title> <para> Åñëè âû îáúÿâëÿåòå ïåðåìåííóþ êàê <command>global $var</command>, âû ôàêòè÷åñêè ñîçäà¸òå ññûëêó íà ãëîáàëüíóþ ïåðåìåííóþ. Ýòî îçíà÷àåò òî æå ñàìîå, ÷òî: <informalexample> <programlisting role="php"> <![CDATA[ <?php $var =& $GLOBALS["var"]; ?> ]]> </programlisting> </informalexample> </para> <simpara> Ýòî çíà÷èò, íàïðèìåð, ÷òî ñáðîñ (unset) <varname>$var</varname> íå ïðèâåä¸ò ê ñáðîñó ãëîáàëüíîé ïåðåìåííîé. </simpara> </sect2> <sect2 id="references.this"> <title><literal>$this</literal></title> <simpara>  ìåòîäàõ îáúåêòà, <varname>$this</varname> âñåãäà ÿâëÿåòñÿ ññûëêîé íà âûçûâàþùèé îáúåêò. </simpara> </sect2> </sect1> </chapter> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/math/constants.xml?r=1.1&p=1 Index: phpdoc-ru/reference/math/constants.xml +++ phpdoc-ru/reference/math/constants.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.2 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <section id="math.constants"> &reftitle.constants; &extension.constants.core; <para> <table> <title>Ìàòåìàòè÷åñêèå êîíñòàíòû</title> <tgroup cols="3"> <thead> <row> <entry>Êîíñòàíòà</entry> <entry>Çíà÷åíèå</entry> <entry>Îïèñàíèå</entry> </row> </thead> <tbody> <row> <entry>M_PI</entry> <entry>3.14159265358979323846</entry> <entry>÷èñëî ïè</entry> </row> <row> <entry>M_E</entry> <entry>2.7182818284590452354</entry> <entry>÷èñëî Ýéëåðà</entry> </row> <row> <entry>M_LOG2E</entry> <entry>1.4426950408889634074</entry> <entry>log_2 e</entry> </row> <row> <entry>M_LOG10E</entry> <entry>0.43429448190325182765</entry> <entry>lg e</entry> </row> <row> <entry>M_LN2</entry> <entry>0.69314718055994530942</entry> <entry>ln 2</entry> </row> <row> <entry>M_LN10</entry> <entry>2.30258509299404568402</entry> <entry>ln 10</entry> </row> <row> <entry>M_PI_2</entry> <entry>1.57079632679489661923</entry> <entry>ïè/2</entry> </row> <row> <entry>M_PI_4</entry> <entry>0.78539816339744830962</entry> <entry>ïè/4</entry> </row> <row> <entry>M_1_PI</entry> <entry>0.31830988618379067154</entry> <entry>1/ïè</entry> </row> <row> <entry>M_2_PI</entry> <entry>0.63661977236758134308</entry> <entry>2/ïè</entry> </row> <row> <entry>M_SQRTPI</entry> <entry>1.77245385090551602729</entry> <entry>sqrt(ïè) [4.0.2]</entry> </row> <row> <entry>M_2_SQRTPI</entry> <entry>1.12837916709551257390</entry> <entry>2/sqrt(ïè)</entry> </row> <row> <entry>M_SQRT2</entry> <entry>1.41421356237309504880</entry> <entry>sqrt(2)</entry> </row> <row> <entry>M_SQRT3</entry> <entry>1.73205080756887729352</entry> <entry>sqrt(3) [4.0.2]</entry> </row> <row> <entry>M_SQRT1_2</entry> <entry>0.70710678118654752440</entry> <entry>1/sqrt(2)</entry> </row> <row> <entry>M_LNPI</entry> <entry>1.14472988584940017414</entry> <entry>ln ïè [4.0.2]</entry> </row> <row> <entry>M_EULER</entry> <entry>0.57721566490153286061</entry> <entry>Ïîñòîÿííàÿ ýéëåðà [4.0.2]</entry> </row> </tbody> </tgroup> </table>  âåðñèÿõ PHP äî 4.0.0 âêëþ÷èòåëüíî äîñòóïíà òîëüêî M_PI. Âñå îñòàëüíûå áûëè äîáàâëåíû ñ ñëåäóþùåé âåðñèè, êðîìå êîíñòàíò ñ ïîìåòêîé [4.0.2], êîòîðûå áûëè äîáàâëåíû â âåðñèè PHP 4.0.2. </para> </section> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/math/reference.xml?r=1.1&p=1 Index: phpdoc-ru/reference/math/reference.xml +++ phpdoc-ru/reference/math/reference.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.6 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <reference id="ref.math"> <title>Ìàòåìàòè÷åñêèå ôóíêöèè</title> <titleabbrev>Math</titleabbrev> <partintro> <section id="math.intro"> &reftitle.intro; <para> Äàííûå ôóíêöèè ðàáîòàþò ñ ÷èñëàìè â äèàïàçîíàõ òèïîâ <type>integer</type> è <type>float</type> íà âàøåé ìàøèíå (ýòî îòâå÷àåò C-òèïàì long è double). Åñëè âàì íóæíî ðàáîòàòü ñ áîëüøèìè ÷èñëàìè, îáðàòèòåñü ê ðàçäåëó <xref linkend="ref.bc"/>. </para> <simpara> Ñì. òàêæå <xref linkend="language.operators.arithmetic"/>. </simpara> </section> <section id="math.requirements"> &reftitle.required; &no.requirement; </section> <section id="math.installation"> &reftitle.install; &no.install; </section> <section id="math.configuration"> &reftitle.runtime; &no.config; </section> <section id="math.resources"> &reftitle.resources; &no.resource; </section> &reference.math.constants; </partintro> &reference.math.functions; </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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/math/functions/abs.xml?r=1.1&p=1 Index: phpdoc-ru/reference/math/functions/abs.xml +++ phpdoc-ru/reference/math/functions/abs.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.5 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <refentry id="function.abs"> <refnamediv> <refname>abs</refname> <refpurpose>Ìîäóëü ÷èñëà</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>number</type><methodname>abs</methodname> <methodparam><type>mixed</type><parameter>number</parameter></methodparam> </methodsynopsis> <para> Âîçâðàùàåò àáñîëþòíîå çíà÷åíèå <parameter>number</parameter>. Åñëè <parameter>number</parameter> èìååò òèï <type>float</type>, âîçâðàùàåìîå çíà÷åíèå òàêæå áóäåò èìåòü òèï <type>float</type>, èíà÷å - <type>integer</type>. </para> <example> <title>Ïðèìåð</title> <programlisting role="php"> <![CDATA[ <?php $abs = abs(-4.2); // $abs = 4.2; (double/float) $abs2 = abs(5); // $abs2 = 5; (integer) $abs3 = abs(-5); // $abs3 = 5; (integer) ?> ]]> </programlisting> </example> </refsect1> </refentry> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/math/functions/ceil.xml?r=1.1&p=1 Index: phpdoc-ru/reference/math/functions/ceil.xml +++ phpdoc-ru/reference/math/functions/ceil.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.5 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <refentry id="function.ceil"> <refnamediv> <refname>ceil</refname> <refpurpose>Îêðóãëÿåò äðîáü â áîëüøóþ ñòîðîíó</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>float</type><methodname>ceil</methodname> <methodparam><type>float</type><parameter>value</parameter></methodparam> </methodsynopsis> <simpara> Âîçâðàùàåò áëèæàéøåå áîëüøåå öåëîå îò <parameter>value</parameter>. Òèï âîçâðàùàåìîãî çíà÷åíèÿ îñòà¸òñÿ <type>float</type> ò.ê. äèàïàçîí <type>float</type> áîëüøå <type>integer</type>. </simpara> <para> <example> <title>Ïðèìåð ôóíêöèè <function>ceil</function></title> <programlisting role="php"> <![CDATA[ <?php echo ceil(4.3); // 5 echo ceil(9.999); // 10 echo ceil(3.0); // 3 ?> ]]> </programlisting> </example> </para> <simpara> Ñì. òàêæå <function>floor</function> è <function>round</function>. </simpara> </refsect1> </refentry> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/math/functions/floor.xml?r=1.1&p=1 Index: phpdoc-ru/reference/math/functions/floor.xml +++ phpdoc-ru/reference/math/functions/floor.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.5 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <refentry id="function.floor"> <refnamediv> <refname>floor</refname> <refpurpose>Îêðóãëÿåò äðîáü â ìåíüøóþ ñòîðîíó</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>float</type><methodname>floor</methodname> <methodparam><type>float</type><parameter>value</parameter></methodparam> </methodsynopsis> <simpara> Âîçâðàùàåò áëèæàéøåå ìåíüøåå öåëîå îò <parameter>value</parameter>. Òèï âîçâðàùàåìîãî çíà÷åíèÿ îñòà¸òñÿ <type>float</type> ò.ê. äèàïàçîí <type>float</type> áîëüøå <type>integer</type>. </simpara> <para> <example> <title>Ïðèìåð ôóíêöèè <function>floor</function></title> <programlisting role="php"> <![CDATA[ <?php echo floor(4.3); // 4 echo floor(9.999); // 9 echo floor(5.0); // 5 ?> ]]> </programlisting> </example> </para> <simpara> Ñì. òàêæå <function>ceil</function> è <function>round</function>. </simpara> </refsect1> </refentry> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/math/functions/fmod.xml?r=1.1&p=1 Index: phpdoc-ru/reference/math/functions/fmod.xml +++ phpdoc-ru/reference/math/functions/fmod.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.5 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <refentry id="function.fmod"> <refnamediv> <refname>fmod</refname> <refpurpose>Âîçâðàùàåò äðîáíûé îñòàòîê îò äåëåíèÿ</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>float</type><methodname>fmod</methodname> <methodparam><type>float</type><parameter>x</parameter></methodparam> <methodparam><type>float</type><parameter>y</parameter></methodparam> </methodsynopsis> <para> Âîçâðàùàåò äðîáíûé îñòàòîê îò äåëåíèÿ äåñÿòè÷íûõ äðîáåé <parameter>x</parameter> è <parameter>y</parameter>). Îñòàòîê (<varname>r</varname>) îïðåäåëÿåòñÿ òàê: x = i * y + r, ãäå <varname>i</varname> - íåêîòîðîå öåëîå. <varname>r</varname> âñåãäà èìååò òàêîåé æå çíàê, êàê è <parameter>x</parameter> è ìîäóëü, ìåíüøèé èëè ðàâíûé ìîäóëþ <parameter>y</parameter>. </para> <para> <example> <title>Ïðèìåð èñïîëüçîâàíèÿ <function>fmod</function></title> <programlisting role="php"> <![CDATA[ <?php $x = 5.7; $y = 1.3; $r = fmod($x, $y); // $r ðàíâî 0.5, ò.ê. 4 * 1.3 + 0.5 = 5.7 ?> ]]> </programlisting> </example> </para> </refsect1> </refentry> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/math/functions/getrandmax.xml?r=1.1&p=1 Index: phpdoc-ru/reference/math/functions/getrandmax.xml +++ phpdoc-ru/reference/math/functions/getrandmax.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.3 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <refentry id="function.getrandmax"> <refnamediv> <refname>getrandmax</refname> <refpurpose>Âîâçðàùàåò ìàêñèìàëüíî âîçìîæíîå ñëó÷àéíîå ÷èñëî</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>int</type><methodname>getrandmax</methodname> <void/> </methodsynopsis> <simpara> Âîçâðàùàåò ìàêñèìàëüíîå çíà÷åíèå, êîòîðîå ìîæíî ïîëó÷èòü ôóíêöèåé <function>rand</function>. </simpara> <simpara> Ñì. òàêæå <function>rand</function>, <function>srand</function> è <function>mt_getrandmax</function>. </simpara> </refsect1> </refentry> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/math/functions/max.xml?r=1.1&p=1 Index: phpdoc-ru/reference/math/functions/max.xml +++ phpdoc-ru/reference/math/functions/max.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.6 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <refentry id="function.max"> <refnamediv> <refname>max</refname> <refpurpose>Íàõîäèò íàèáîëüøåå çíà÷åíèå</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>mixed</type><methodname>max</methodname> <methodparam><type>number</type><parameter>arg1</parameter></methodparam> <methodparam><type>number</type><parameter>arg2</parameter></methodparam> <methodparam choice="opt"><type>number</type><parameter>...</parameter></methodparam> </methodsynopsis> <methodsynopsis> <type>mixed</type><methodname>max</methodname> <methodparam><type>array</type><parameter>numbers</parameter></methodparam> </methodsynopsis> <para> Âîçâðàùàåò íàèáîëüøåå èç ïðåäëîæåííûõ ÷èñåë. </para> <para> Åñëè â êà÷åñòâå àðãóìåíòîâ ïåðåäàí òîëüêî îäèí - ìàññèâ ÷èñåë, <function>max</function> âîçâðàùàåò íàèáîëüøåå èç íèõ. Åñëè ïåðâûé àðãóìåíò - integer èëè float, òî îáÿçàòåëüíî äîëæåí áûòü õîòÿ áû åù¸ îäèí.  ýòîì ñëó÷àå ôóíêöèÿ âåðí¸ò íàèáîëüøåå èç íèõ. Ìîæíî ñðàâíèâàòü íåîãðàíè÷åííîå êîëè÷åñòâî ÷èñåë. </para> <note> <para> PHP ñ÷èòàåò ñòðîêó, êîòîðóþ íå óäàëîñü ïðåîáðàçîâàòü â ÷èñëî, êàê <literal>0</literal>, íî âåðí¸ò ñàìó ñòðîêó, â ñëó÷àå, åñëè âñå îñòàëüíûå ÷èñëà îòðèöàòåëüíûå. Åñëè óêàçàíî íåñêîëüêî ýëåìåíòîâ, ýêâèâàëåíòíûõ <literal>0</literal>, <function>max</function> âåðí¸ò ïåðâûé èç íèõ (ñàìûé ëåâûé). </para> </note> <para> <example> <title>Ïðèìåðû èñïîëüçîâàíèÿ <function>max</function></title> <programlisting role="php"> <![CDATA[ <?php echo max(1, 3, 5, 6, 7); // 7 echo max(array(2, 4, 5)); // 5 echo max(0, 'hello'); // 0 echo max('hello', 0); // hello echo max(-1, 'hello'); // hello // Ïðè óêàçàíèè íåñêîëüêèõ ìàññèâîâ, îíè ñðàâíèâàþòñÿ ïîëíîñòüþ // â íàøåì ïðèìåðå: 2 == 2, íî 4 < 5 $val = max(array(2, 4, 8), array(2, 5, 7)); // array(2, 5, 7) // Ïðè óêàçàíèè ìàññèâà è îòäåëüíûõ ÷èñåë, // âñåãäà âîçâðàùàåòñÿ ìàññèâ, ò.ê. îí ñ÷èòàåòñÿ ñàìûì áîëüøèì $val = max('string', array(2, 5, 7), 42); // array(2, 5, 7) ?> ]]> </programlisting> </example> </para> <para> Ñì òàêæå <function>min</function> è <function>count</function>. </para> </refsect1> </refentry> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/math/functions/min.xml?r=1.1&p=1 Index: phpdoc-ru/reference/math/functions/min.xml +++ phpdoc-ru/reference/math/functions/min.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.5 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <refentry id="function.min"> <refnamediv> <refname>min</refname> <refpurpose>Íàõîäèò íàèìåíüøåå çíà÷åíèå</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>mixed</type><methodname>min</methodname> <methodparam><type>number</type><parameter>arg1</parameter></methodparam> <methodparam><type>number</type><parameter>arg2</parameter></methodparam> <methodparam choice="opt"><type>number</type><parameter>...</parameter></methodparam> </methodsynopsis> <methodsynopsis> <type>mixed</type><methodname>min</methodname> <methodparam><type>array</type><parameter>numbers</parameter></methodparam> </methodsynopsis> <para> Âîçâðàùàåò íàèìåíüøåå èç ïðåäëîæåííûõ ÷èñåë. </para> <para> Åñëè â êà÷åñòâå àðãóìåíòîâ ïåðåäàí òîëüêî îäèí - ìàññèâ ÷èñåë, <function>min</function> âîçâðàùàåò íàèìåíüøåå èç íèõ. Åñëè ïåðâûé àðãóìåíò - integer èëè float, òî îáÿçàòåëüíî äîëæåí áûòü õîòÿ áû åù¸ îäèí.  ýòîì ñëó÷àå ôóíêöèÿ âåðí¸ò íàèìåíüøåå èç íèõ. Ìîæíî ñðàâíèâàòü íåîãðàíè÷åííîå êîëè÷åñòâî ÷èñåë. </para> <note> <para> PHP ñ÷èòàåò ñòðîêó, êîòîðóþ íå óäàëîñü ïðåîáðàçîâàòü â ÷èñëî, êàê <literal>0</literal>, íî âåðí¸ò ñàìó ñòðîêó, â ñëó÷àå, åñëè âñå îñòàëüíûå ÷èñëà ïîëîæèòåëüíûå. Åñëè óêàçàíî íåñêîëüêî ýëåìåíòîâ, ýêâèâàëåíòíûõ <literal>0</literal>, <function>min</function> âåðí¸ò ïåðâûé èç íèõ (ñàìûé ëåâûé). </para> </note> <para> <example> <title>Ïðèìåðû èñïîëüçîâàíèÿ <function>min</function></title> <programlisting role="php"> <![CDATA[ <?php echo min(2, 3, 1, 6, 7); // 1 echo min(array(2, 4, 5)); // 2 echo min(0, 'hello'); // 0 echo min('hello', 0); // hello echo min('hello', -1); // -1 // Ïðè óêàçàíèè íåñêîëüêèõ ìàññèâîâ, îíè ñðàâíèâàþòñÿ ïîëíîñòüþ // â íàøåì ïðèìåðå: 2 == 2, íî 4 < 5 $val = min(array(2, 4, 8), array(2, 5, 1)); // array(2, 4, 8) // Ïðè óêàçàíèè ìàññèâà è îòäåëüíûõ ÷èñåë, // ïåðâûé íèêîãäà íå âîçâðàùàåòñÿ, ò.ê. ñ÷èòàåòñÿ ñàìûì áîëüøèì $val = min('string', array(2, 5, 7), 42); // string ?> ]]> </programlisting> </example> </para> <para> Ñì òàêæå <function>max</function> è <function>count</function>. </para> </refsect1> </refentry> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/math/functions/pi.xml?r=1.1&p=1 Index: phpdoc-ru/reference/math/functions/pi.xml +++ phpdoc-ru/reference/math/functions/pi.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.5 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <refentry id="function.pi"> <refnamediv> <refname>pi</refname> <refpurpose>Âîçâðàùàåò ÷èñëî Ïè</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>float</type><methodname>pi</methodname> <void/> </methodsynopsis> <simpara> Âîçâðàùàåò ÷èñëî Ïè ñ òî÷íîñòüþ, îïðåäåëÿåìîé äèðåêòèâîé <link linkend="ini.precision">precision</link> â &php.ini;, çíà÷åíèå ïî óìîë÷àíèþ êîòîðîé <literal>14</literal>. Êîíñòàíòà <constant>M_PI</constant> äà¸ò èäåíòè÷íûé ðåçóëüòàò. </simpara> <para> <example> <title>Ïðèìåð <function>pi</function></title> <programlisting role="php"> <![CDATA[ <?php echo pi(); // 3.1415926535898 echo M_PI; // 3.1415926535898 ?> ]]> </programlisting> </example> </para> </refsect1> </refentry> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/math/functions/rand.xml?r=1.1&p=1 Index: phpdoc-ru/reference/math/functions/rand.xml +++ phpdoc-ru/reference/math/functions/rand.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.14 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <refentry id="function.rand"> <refnamediv> <refname>rand</refname> <refpurpose>Ãåíåðèðóåò ñëó÷àéíîå ÷èñëî</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>int</type><methodname>rand</methodname> <methodparam choice="opt"><type>int</type><parameter>min</parameter></methodparam> <methodparam><type>int</type><parameter>max</parameter></methodparam> </methodsynopsis> <simpara> Ïðè âûçîâå áåç ïàðàìåòðîâ <parameter>min</parameter> è <parameter>max</parameter>, âîçâðàùàåò ïñåâäîñëó÷àéíîå öåëîå â äèàïàçîíå îò 0 äî <constant>RAND_MAX</constant>. Íàïðèìåð, åñëè âàì íóæíî ñëó÷àéíîå ÷èñëî ìåæäó 5 è 15 (âêëþ÷èòåëüíî), âûçîâèòå <literal>rand (5, 15)</literal>. </simpara> <para> <example> <title>Ïðèìåð</title> <programlisting role="php"> <![CDATA[ <?php echo rand() . "\n"; echo rand() . "\n"; echo rand(5, 15); ?> ]]> </programlisting> <para> Ïðèìåð âûøå âûâåäåò ÷òî-òî íàïîäîáèå ýòîãî: </para> <screen> <![CDATA[ 7771 22264 11 ]]> </screen> </example> </para> <note> <simpara> Íà íåêîòîðûõ ïëàòôîðìàõ (òàêèõ êàê Windows) <constant>RAND_MAX</constant> âñåãî ëèøü 32768. ×òîáû ðàñøèðèòü äèàïàçîí, èñïîëüçóéòå ïàðàìåòðû <parameter>min</parameter> è <parameter>max</parameter>, èëè îáðàòèòåñü ê ôóíêöèè <function>mt_rand</function>. </simpara> </note> ¬e.randomseed; <note> <para>  âåðñèÿõ äî 3.0.7 <parameter>max</parameter> îïðåäåëÿëî äèàïàçîí ãåíåðèðîâàíèÿ. Íàïðèìåð, ÷òîáû ïîëó÷èòü ÷èñëî îò 5 äî 15, íóæíî áûëî âûçâàòü <literal>rand (5, 11)</literal>. </para> </note> <simpara> Ñì. òàêæå: <function>srand</function>, <function>getrandmax</function> è <function>mt_rand</function>. </simpara> </refsect1> </refentry> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/math/functions/round.xml?r=1.1&p=1 Index: phpdoc-ru/reference/math/functions/round.xml +++ phpdoc-ru/reference/math/functions/round.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.9 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <refentry id="function.round"> <refnamediv> <refname>round</refname> <refpurpose>Îêðóãëÿåò ÷èñëî òèïà float</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>float</type><methodname>round</methodname> <methodparam><type>float</type><parameter>val</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>precision</parameter></methodparam> </methodsynopsis> <para> Âîçâðàùàåò îêðóãë¸ííîå çíà÷åíèå <parameter>val</parameter> ñ óêàçàííîé òî÷íîñòüþ <parameter>precision</parameter> (êîëè÷åñòâî öèôð ïîñëå çàïÿòîé). Ïîñëåäíÿÿ ìîæåò áûòü îòðèöàòåëüíîé èëè íóë¸ì (ïî óìîë÷àíèþ). </para> <para> <example> <title>Ïðèìåðû ôóíêöèè <function>round</function></title> <programlisting role="php"> <![CDATA[ <?php echo round(3.4); // 3 echo round(3.5); // 4 echo round(3.6); // 4 echo round(3.6, 0); // 4 echo round(1.95583, 2); // 1.96 echo round(1241757, -3); // 1242000 echo round(5.045, 2); // 5.05 echo round(5.055, 2); // 5.06 ?> ]]> </programlisting> </example> </para> <!-- It's not true <para> <caution> <simpara> When rounding on exact halves <function>round</function> rounds down on evens and up on odds. If you want to always force it in one direction on a .5 (or .05 in your case) add or substract a tiny fuzz factor. The reason behind rounding half the values down and the other half up is to avoid the classical banking problem where if you always rounded down you would be stealing money from your customers, or if you always rounded up you would end up over time losing money. By averaging it out through evens and odds you statistically break even. </simpara> </caution> </para> --> <para> <note> <simpara> PHP ïî óìîë÷àíèþ íå ìîæåò ïðàâèëüíî îáðàáàòûâàòü ñòðîêè òèïà <literal>"12,300.2"</literal>. Äëÿ ïîäðîáíîñòåé ñì. <xref linkend="language.types.string.conversion"/>. </simpara> </note> </para> <para> <note> <simpara> ïàðàìåòð <parameter>precision</parameter> áûë äîáàâëåí â PHP 4. </simpara> </note> </para> <simpara> Ñì. òàêæå: <function>ceil</function>, <function>floor</function> è <function>number_format</function>. </simpara> </refsect1> </refentry> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/math/functions/srand.xml?r=1.1&p=1 Index: phpdoc-ru/reference/math/functions/srand.xml +++ phpdoc-ru/reference/math/functions/srand.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.8 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <refentry id="function.srand"> <refnamediv> <refname>srand</refname> <refpurpose>Èçìåíÿåò íà÷àëüíîå ÷èñëî ãåíåðàòîðà ïñåâäîñëó÷àéíûõ ÷èñåë</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>void</type><methodname>srand</methodname> <methodparam choice="opt"><type>int</type><parameter>seed</parameter></methodparam> </methodsynopsis> <para> Óñòàíàâëèâàåò íà÷àëüíîå ÷èñëî ãåíåðàòîðà ñëó÷àéíûõ ÷èñåë â <parameter>seed</parameter>. Íà÷èíàÿ ñ PHP 4.2.0, <parameter>seed</parameter> - íåîáÿçàòåëüíûé ïàðàìåòð, åñëè îí íå óêàçàí, áåð¸òñÿ ñëó÷àéíîå ÷èñëî. </para> <para> <example> <title>Ïðèìåð <function>srand</function></title> <programlisting role="php"> <![CDATA[ <?php // ðàíäîìèçèðîâàòü ìèêðîñåêóíäàìè function make_seed() { list($usec, $sec) = explode(' ', microtime()); return (float) $sec + ((float) $usec * 100000); } srand(make_seed()); $randval = rand(); ?> ]]> </programlisting> </example> </para> ¬e.randomseed; <simpara> Ñì. òàêæå: <function>rand</function>, <function>getrandmax</function> è <function>mt_srand</function>. </simpara> </refsect1> </refentry> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/iconv/configure.xml?r=1.1&p=1 Index: phpdoc-ru/reference/iconv/configure.xml +++ phpdoc-ru/reference/iconv/configure.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.5 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <section id="iconv.installation"> &reftitle.install; <para> ×òîáû ðàñøèðåíèå áûëî äîñòóïíî, íóæíî óêàçàòü êëþ÷ <option role="configure">--with-iconv[=DIR]</option> ïðè çàïóñêå ñöåíàðèÿ êîíôèãóðèðîâàíèÿ. </para> <note> <title>Ïðèìå÷àíèå äëÿ ïîëüçîâàòåëåé Windows®</title> <simpara> ×òîáû ðàñøèðåíèå áûëî äîñòóïíî, ïîìåñòèòå áèáëèîòåêó ñ èìåíåì <emphasis>iconv.dll</emphasis> èëè <emphasis>iconv-1.3.dll</emphasis> (äëÿ âåðñèé äî 4.2.1), êîòîðàÿ âõîäèò â ïîñòàâêó PHP äëÿ Windows®, â îäíó èç å¸ ñèñòåìíûõ ïàïîê. </simpara> <simpara> Ýòîò ìîäóëü ÿâëÿåòñÿ ÷àñòüþ PHP íà÷èíàÿ ñ âåðñèè 5, òàê ÷òî áèáëèîòåêè <emphasis>iconv.dll</emphasis> è <emphasis>php_iconv.dll</emphasis> áîëåå íå íóæíû. </simpara> </note> </section> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/iconv/constants.xml?r=1.1&p=1 Index: phpdoc-ru/reference/iconv/constants.xml +++ phpdoc-ru/reference/iconv/constants.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.4 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --><section id="iconv.constants"> &reftitle.constants; <para> Íà÷èíàÿ ñ <application>PHP</application> 4.3.0 âîçìîæíî óçíàòü âî âðåìÿ âûïîëíåíèÿ, êàêàÿ ðåàëèçàöèÿ <literal>iconv</literal> èñïîëüçóåòñÿ ðàñøèðåíèåì. <table> <title>Êîíñòàíòû <literal>iconv</literal></title> <tgroup cols="3"> <thead> <row> <entry>Èìÿ</entry> <entry>Òèï</entry> <entry>Îïèñàíèå</entry> </row> </thead> <tbody> <row> <entry>ICONV_IMPL</entry> <entry><type>string</type></entry> <entry>Ðåàëèçàöèÿ</entry> </row> <row> <entry>ICONV_VERSION</entry> <entry><type>string</type></entry> <entry>Âåðñèÿ ðåàëèçàöèè</entry> </row> </tbody> </tgroup> </table> </para> <note> <para> Èñïîëüçóéòå ýòè êîíñòàíòû äëÿ íàïèñàíèÿ ñöåíàðèåâ, íåçàâèñèìûõ îò ðåàëèçàöèè. </para> </note> <para> Íà÷èíàÿ ñ <application>PHP</application> 5.0.0, äîñòóïíû òàêæå ñëåäóþùèå êîíñòàíòû: <table> <title>êîíñòàíòû <literal>iconv</literal>, äîñòóïíûå íà÷èíàÿ ñ PHP 5.0.0</title> <tgroup cols="3"> <thead> <row> <entry>Èìÿ</entry> <entry>Òèï</entry> <entry>Îïèñàíèå</entry> </row> </thead> <tbody> <row> <entry>ICONV_MIME_DECODE_STRICT</entry> <entry><type>integer</type></entry> <entry>Áèòîâàÿ ìàñêà, èñïîëüçóåìàÿ äëÿ <function>iconv_mime_decode</function></entry> </row> <row> <entry>ICONV_MIME_DECODE_CONTINUE_ON_ERROR</entry> <entry><type>integer</type></entry> <entry>Áèòîâàÿ ìàñêà, èñïîëüçóåìàÿ äëÿ <function>iconv_mime_decode</function></entry> </row> </tbody> </tgroup> </table> </para> </section> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: --> http://cvs.php.net/co.php/phpdoc-ru/reference/iconv/ini.xml?r=1.1&p=1 Index: phpdoc-ru/reference/iconv/ini.xml +++ phpdoc-ru/reference/iconv/ini.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.2 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --><section id="iconv.configuration"> &reftitle.runtime; &extension.runtime; <para> <table> <title>Êîíôèãóðàöèîííûå ïàðàìåòðû, êàñàþùèåñÿ Iconv</title> <tgroup cols="3"> <thead> <row> <entry>Ïàðàìåòð</entry> <entry>Çíà÷åíèå ïî óìîë÷àíèþ</entry> <entry>Ïåðåìåííàÿ îêðóæåíèÿ</entry> </row> </thead> <tbody> <row> <entry>iconv.input_encoding</entry> <entry>ICONV_INPUT_ENCODING</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>iconv.output_encoding</entry> <entry>ICONV_OUTPUT_ENCODING</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>iconv.internal_encoding</entry> <entry>ICONV_INTERNAL_ENCODING</entry> <entry>PHP_INI_ALL</entry> </row> </tbody> </tgroup> </table> Äëÿ ïîäðîáíîñòåé î êîíñòàíòàõ PHP_INI_* ñì. <function>ini_set</function>. </para> <note> <para> Íà äàííûé ìîìåíò <parameter>iconv.input_encoding</parameter> íèêàê íå èñïîëüçóåòñÿ. </para> </note> </section> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/iconv/reference.xml?r=1.1&p=1 Index: phpdoc-ru/reference/iconv/reference.xml +++ phpdoc-ru/reference/iconv/reference.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.16 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <reference id="ref.iconv"> <title>Ôóíêöèè iconv</title> <titleabbrev>iconv</titleabbrev> <partintro> <section id="iconv.intro"> &reftitle.intro; <para> Ýòî ðàñøèðåíèå ïðåäîñòàâëÿåò èíòåðôåéñ ê áèáëèîòåêå ïðåîáðàçîâàíèÿ êîäèðîâîê iconv. Íàáîð ïîääåðæèâàåìûõ êîäèðîâîê çàâèñèò îò ðåàëèçàöèè iconv â âàøåé ñèñòåìå. Íà íåêîòîðûõ ïëàòôîðìàõ iconv ìîæåò ðàáîòàòü íåíîðìàëüíî, â òàêèõ ñëó÷àÿõ ðåêîìåíäóåòñÿ óñòàíîâèòü áèáëèîòåêó <ulink url="&url.libiconv;">GNU libiconv</ulink>. </para> <para> Íà÷èíàÿ ñ <application>PHP</application> 5.0.0, ýòî â ðàñøèðåíèå äîáàâëåíû íåêîòîðûå âñïîìîãàòåëüíûå ôóíêöèè, ïîìîãàþùèå ïðè íàïèñàíèè ñöåíàðèåâ, ðàáîòàþùèõ ñ íåñêîëüêèìè ÿçûêàìè. </para> </section> <section id="iconv.requirements"> &reftitle.required; <para> Îïåðàöèîííûå ñèñòåìû, îòâå÷àþùèå ñòàíäàðòàì POSIX, ïîñòàâëÿþòñÿ ñ C-áèáëèîòåêàìè, ïðåäîñòàâëÿþùèìè ôóíêöèîíàëüíîñòü iconv. Èíà÷å, âàì ïðèä¸òñÿ óñòàíîâèòü áèáëèîòåêó <ulink url="&url.libiconv;">libiconv îò GNU</ulink>. </para> </section> &reference.iconv.configure; &reference.iconv.ini; <section id="iconv.resources"> &reftitle.resources; &no.resource; </section> &reference.iconv.constants; <section id="iconv.seealso"> &reftitle.seealso; <para> Ñì. òàêæå <link linkend="ref.recode">Ôóíêöèè GNU Recode</link>. </para> </section> </partintro> &reference.iconv.functions; </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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/iconv/functions/iconv-get-encoding.xml?r=1.1&p=1 Index: phpdoc-ru/reference/iconv/functions/iconv-get-encoding.xml +++ phpdoc-ru/reference/iconv/functions/iconv-get-encoding.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.8 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <refentry id="function.iconv-get-encoding"> <refnamediv> <refname>iconv_get_encoding</refname> <refpurpose>Âîçâðàùàåò çíà÷åíèå âíóòðåííèõ ïåðåìåííûõ ðàñøèðåíèÿ</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>mixed</type><methodname>iconv_get_encoding</methodname> <methodparam choice="opt"><type>string</type><parameter>type</parameter></methodparam> </methodsynopsis> <para> Âîçâðàùàåò òåêóùåå çíà÷åíèå óêàçàííîé âíóòðåííåé ïåðåìåííîé, è &false; â ñëó÷àå îøèáêè. </para> <para> Âîçìîæíûå çíà÷åíèÿ íåîáÿçàòåëüíîãî ïàðàìåòðà <parameter>type</parameter>: <simplelist> <member>all</member> <member>input_encoding</member> <member>output_encoding</member> <member>internal_encoding</member> </simplelist> </para> <para> Åñëè <parameter>type</parameter> íå óêàçàí, èëè ðàâåí "all", <function>iconv_get_encoding</function> âåðí¸ò ìàññèâ ñî ñíà÷åíèÿìè âñåõ ïåðåìåííûõ. </para> <para> <example> <title>Ïðèìåð èñïîëüçîâàíèÿ <function>iconv_get_encoding</function></title> <programlisting role="php"> <![CDATA[ <pre> <?php iconv_set_encoding("internal_encoding", "UTF-8"); iconv_set_encoding("input_encoding", "WINDOWS-1251"); iconv_set_encoding("output_encoding", "KOI8-U"); var_dump(iconv_get_encoding('all')); ?> </pre> ]]> </programlisting> <para> Ðåçóëüòàò âûïîëíåíèÿ ïðèâåäåííûõ âûøå êîìàíä: </para> <screen> <![CDATA[ Array ( [input_encoding] => WINDOWS-1251 [output_encoding] => KOI8-U [internal_encoding] => UTF-8 ) ]]> </screen> </example> </para> <para> Ñì. òàêæå <function>iconv_set_encoding</function> è <function>ob_iconv_handler</function>. </para> </refsect1> </refentry> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/iconv/functions/iconv-mime-decode-headers.xml?r=1.1&p=1 Index: phpdoc-ru/reference/iconv/functions/iconv-mime-decode-headers.xml +++ phpdoc-ru/reference/iconv/functions/iconv-mime-decode-headers.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.10 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <refentry id="function.iconv-mime-decode-headers"> <refnamediv> <refname>iconv_mime_decode_headers</refname> <refpurpose> Äåêîäèðóåò íåñêîëüêî ïîëåé çàãîëîâêà <literal>MIME</literal> </refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>array</type><methodname>iconv_mime_decode_headers</methodname> <methodparam><type>string</type><parameter>encoded_headers</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>mode</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>charset</parameter></methodparam> </methodsynopsis> <para> Âîçâðàùàåò àññîöèàòèâíûé ìàññèâ ñ ïîëÿìè <literal>MIME</literal>-çàãîëîâêà, ïåðåäàííîãî ïàðàìåòðîì <parameter>encoded_headers</parameter>, èëè &false; â ñëó÷àå îøèáêè. </para> <para> Êàæäûé êëþ÷ ýëåìåíòà âîçâðàùàåìîãî ìàññèâà ïðåäñòàâëÿåò îòäåëüíîå èìÿ ïîëÿ, à ñàì ýëåìåíò - åãî çíà÷åíèå. åñëè â çàãîëîâêå íåñêîëüêî ïîëåé ñ îäèíàêîâûì èìåíåì, îíè ïîìåùàþòñÿ â ïîä÷èí¸ííûé ìàññèâ ñ ÷èñëîâûìè èíäåêñàìè. </para> <para> Ïàðàìåòð <parameter>mode</parameter> îïðåäåëÿåò ïîâåäåíèå â ñëó÷àå îáíàðóæåíèÿ íåïðàâèëüíîãî ïîëÿ çàãîëîâêà. ìîæíî óêàçàòü ëþáóþ êîìáèíàöèþ ñëåäóþùèõ áèòîâûõ ìàñîê. <table> <title>Áèòîâûå ìàñêè <function>iconv_mime_decode_headers</function></title> <tgroup cols="3"> <thead> <row> <entry>Çíà÷åíèå</entry> <entry>Êîíñòàíòà</entry> <entry>Îïèñàíèå</entry> </row> </thead> <tbody> <row> <entry>1</entry> <entry>ICONV_MIME_DECODE_STRICT</entry> <entry> Ñòðîãî ñëåäîâàòü ñòàíäàðòàì, îïðåäåë¸ííûì â <ulink url="&url.rfc;2047">RFC2047</ulink>. Ê ñîæàëåíèþ, ìíîãî ïðîïðèåòàðíûõ ïðîãðàì ýëåêòðîííîé ïî÷òû íå ñëåäóþò ñòàíäàðòàì, è, ÷òîáû ïîòîêàòü èì, ýòîò ðåæèì ïî óìîë÷àíèþ îòêëþ÷¸í. </entry> </row> <row> <entry>2</entry> <entry>ICONV_MIME_DECODE_CONTINUE_ON_ERROR</entry> <entry> Ïîïûòàòüñÿ ïðîäîëæèòü îáðàáîòêó â ñëó÷àå îáíàðóæåíèÿ îøèáêè. </entry> </row> </tbody> </tgroup> </table> </para> <para> Åñëè ïàðàìåòð <parameter>charset</parameter> îïóùåí, ïðåäïîëàãàåòñÿ, ÷òî êîäèðîâêà ñòðîêè <parameter>string</parameter> ðàâíà <link linkend="iconv.configuration">iconv.internal_charset</link>. </para> <example> <title>Ïðèìåð <function>iconv_mime_decode_headers</function></title> <programlisting role="php"> <![CDATA[ <?php $headers_string = <<<EOF Subject: =?UTF-8?B?UHLDvGZ1bmcgUHLDvGZ1bmc=?= To: example@example.com Date: Thu, 1 Jan 1970 00:00:00 +0000 Message-Id: <example@example.com> Received: from localhost (localhost [127.0.0.1]) by localhost with SMTP id example for <example@example.com> Thu, 1 Jan 1970 00:00:00 +0000 (UTC) (envelope-from example-return-0000-example=example.com@example.com) Received: (qmail 0 invoked by uid 65534); 1 Thu 2003 00:00:00 +0000 EOF; $headers = iconv_mime_decode_headers($headers_string, 0, "ISO-8859-1"); print_r($headers); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ Array ( [Subject] => Prüfung Prüfung [To] => example@example.com [Date] => Thu, 1 Jan 1970 00:00:00 +0000 [Message-Id] => <example@example.com> [Received] => Array ( [0] => from localhost (localhost [127.0.0.1]) by localhost with SMTP id example for <example@example.com>; Thu, 1 Jan 1970 00:00:00 +0000 (UTC) (envelope-from example-return-0000-example=example.com@example.com) [1] => (qmail 0 invoked by uid 65534); 1 Thu 2003 00:00:00 +0000 ) ) ]]> </screen> </example> <para> Ñì. òàêæå <function>iconv_mime_decode</function>, <function>mb_decode_mimeheader</function>, <function>imap_mime_header_decode</function>, <function>imap_base64</function> è <function>imap_qprint</function>. </para> </refsect1> </refentry> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/iconv/functions/iconv-set-encoding.xml?r=1.1&p=1 Index: phpdoc-ru/reference/iconv/functions/iconv-set-encoding.xml +++ phpdoc-ru/reference/iconv/functions/iconv-set-encoding.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.7 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <refentry id="function.iconv-set-encoding"> <refnamediv> <refname>iconv_set_encoding</refname> <refpurpose>Óñòàíàâëèâàåò çíà÷åíèå îäíîé èç âíóòðåííèõ ïåðåìåííûõ</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>bool</type><methodname>iconv_set_encoding</methodname> <methodparam><type>string</type><parameter>type</parameter></methodparam> <methodparam><type>string</type><parameter>charset</parameter></methodparam> </methodsynopsis> <para> Èçìåíÿåò çíà÷åíèå âíóòðåííåé ïåðåìåííîé, óêàçàííîé ïàðàìåòðîì <parameter>type</parameter>, íà <parameter>charset</parameter>. &return.success; </para> <para> Âîçìîæíûå çíà÷åíèÿ ïàðàìåòðà <parameter>type</parameter>: <simplelist> <member>input_encoding</member> <member>output_encoding</member> <member>internal_encoding</member> </simplelist> </para> <para> <example> <title>Ïðèìåð èñïîëüçîâàíèÿ <function>iconv_set_encoding</function></title> <programlisting role="php"> <![CDATA[ <?php iconv_set_encoding("internal_encoding", "UTF-8"); iconv_set_encoding("output_encoding", "WINDOWS-1251"); ?> ]]> </programlisting> </example> </para> <para> Ñì. òàêæå <function>iconv_get_encoding</function> è <function>ob_iconv_handler</function>. </para> </refsect1> </refentry> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/iconv/functions/iconv-strlen.xml?r=1.1&p=1 Index: phpdoc-ru/reference/iconv/functions/iconv-strlen.xml +++ phpdoc-ru/reference/iconv/functions/iconv-strlen.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.5 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <refentry id="function.iconv-strlen"> <refnamediv> <refname>iconv_strlen</refname> <refpurpose> Âîçâðàùàåò êîëè÷åñòâî ñèìâîëîâ â ñòðîêå </refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>int</type><methodname>iconv_strlen</methodname> <methodparam><type>string</type><parameter>str</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>charset</parameter></methodparam> </methodsynopsis> <para> Âîçâðàùàåò êîëè÷åñòâî ñèìâîëîâ â <parameter>str</parameter>. </para> <para>  îòëè÷èå îò <function>strlen</function>, <function>iconv_strlen</function> ó÷èòûâàåò êîäèðîâêó ñòðîêè (íàïðèìåð, þíèêîä ìîæåò áûòü è äâóõ-, è ÷åòûð¸õáàéòíûì). </para> <para> Åñëè ïàðàìåòð <parameter>charset</parameter> îïóùåí, ïðåäïîëàãàåòñÿ, ÷òî êîäèðîâêà ñòðîêè <parameter>str</parameter> ðàâíà <link linkend="iconv.configuration">iconv.internal_charset</link>. </para> <para> Ñì. òàêæå <function>strlen</function> è <function>mb_strlen</function>. </para> </refsect1> </refentry> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/iconv/functions/iconv-strpos.xml?r=1.1&p=1 Index: phpdoc-ru/reference/iconv/functions/iconv-strpos.xml +++ phpdoc-ru/reference/iconv/functions/iconv-strpos.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.7 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <refentry id="function.iconv-strpos"> <refnamediv> <refname>iconv_strpos</refname> <refpurpose> Âîçâðàùàåò ïîçèöèþ ïåðâîãî âõîæäåíèÿ ïîäñòðîêè </refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>int</type><methodname>iconv_strpos</methodname> <methodparam><type>string</type><parameter>haystack</parameter></methodparam> <methodparam><type>string</type><parameter>needle</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>offset</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>charset</parameter></methodparam> </methodsynopsis> <para> Âîçâðàùàåò ïîçèöèþ ïåðâîãî âõîæäåíèÿ ïîäñòðîêè <parameter>needle</parameter> â ñòðîêó <parameter>haystack</parameter>. </para> <para> Íåîáÿçàòåëüíûé àðãóìåíò <parameter>offset</parameter> ïîçâîëÿåò óêàçàòü, ñ êàêîãî ïî ñ÷¸òó ñèìâîëà ñòðîêè íà÷èíàòü ïîèñê. </para> <para> Åñëè ïîäñòðîêà <parameter>needle</parameter> íå íàéäåíà, <function>iconv_strpos</function> âîçâðàùàåò &false;. </para> &return.falseproblem; <para> Åñëè <parameter>haystack</parameter> èëè <parameter>needle</parameter> íå ÿâëÿåòñÿ ñòðîêîé, îí ïðèâîäèòñÿ ê öåëîìó è òðàêòóåòñÿ êàê êîä ñèìâîëà. </para> <para>  îòëè÷èå îò <function>strpos</function>, <function>iconv_strpos</function> âîçâðàùàåò êîëè÷åñòâî ñèìâîëîâ äî ïîäñòðîêè, â íå ïîçèöèþ âõîæäåíèÿ â áàéòàõ. Ñèìâîëû ñ÷èòàþòñÿ ñ ó÷¸òîì èõ êîäèðîâêè <parameter>charset</parameter>. </para> <para> Åñëè ïàðàìåòð <parameter>charset</parameter> îïóùåí, ïðåäïîëàãàåòñÿ, ÷òî êîäèðîâêà ñòðîêè <parameter>string</parameter> ðàâíà <link linkend="iconv.configuration">iconv.internal_charset</link>. </para> <para> Ñì. òàêæå <function>strpos</function>, <function>iconv_strrpos</function> è <function>mb_strpos</function>. </para> </refsect1> </refentry> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/iconv/functions/iconv-strrpos.xml?r=1.1&p=1 Index: phpdoc-ru/reference/iconv/functions/iconv-strrpos.xml +++ phpdoc-ru/reference/iconv/functions/iconv-strrpos.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.4 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <refentry id="function.iconv-strrpos"> <refnamediv> <refname>iconv_strrpos</refname> <refpurpose> Âîçâðàùàåò ïîçèöèþ ïîñëåäíåãî âõîæäåíèÿ ñèìâîëà </refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>string</type><methodname>iconv_strrpos</methodname> <methodparam><type>string</type><parameter>haystack</parameter></methodparam> <methodparam><type>string</type><parameter>needle</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>charset</parameter></methodparam> </methodsynopsis> <para> Âîçâðàùàåò ïîçèöèþ ïîñëåäíåãî âõîæäåíèÿ <parameter>needle</parameter> â ñòðîêó <parameter>haystack</parameter>. </para> <para> Åñëè ïîäñòðîêà <parameter>needle</parameter> íå íàéäåíà, âîçâðàùàåò &false;. </para> &return.falseproblem; <para> Åñëè <parameter>haystack</parameter> èëè <parameter>needle</parameter> íå ÿâëÿåòñÿ ñòðîêîé, îí ïðèâîäèòñÿ ê öåëîìó è òðàêòóåòñÿ êàê êîä ñèìâîëà. </para> <para>  îòëè÷èå îò <function>strpos</function>, <function>iconv_strrpos</function> âîçâðàùàåò êîëè÷åñòâî ñèìâîëîâ äî ïîäñòðîêè, â íå ïîçèöèþ âõîæäåíèÿ â áàéòàõ. Ñèìâîëû ñ÷èòàþòñÿ ñ ó÷¸òîì èõ êîäèðîâêè <parameter>charset</parameter>. </para> <para> Ñì. òàêæå <function>strrpos</function>, <function>iconv_strpos</function> è <function>mb_strrpos</function>. </para> </refsect1> </refentry> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/iconv/functions/iconv-substr.xml?r=1.1&p=1 Index: phpdoc-ru/reference/iconv/functions/iconv-substr.xml +++ phpdoc-ru/reference/iconv/functions/iconv-substr.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.4 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <refentry id="function.iconv-substr"> <refnamediv> <refname>iconv_substr</refname> <refpurpose> Âîçâðàùàåò ïîäñòðîêó </refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>string</type><methodname>iconv_substr</methodname> <methodparam><type>string</type><parameter>str</parameter></methodparam> <methodparam><type>int</type><parameter>offset</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>charset</parameter></methodparam> </methodsynopsis> <para> Âîçâðàùàåò ïîäñòðîêó ñòðîêè <parameter>str</parameter> äëèíîé <parameter>length</parameter>, íà÷èíàþùóþñÿ ñ ïîçèöèè <parameter>start</parameter>. </para> <para> Åñëè <parameter>start</parameter> íåîòðèöàòåëåí, âîçâðàùàåìàÿ ïîäñòðîêà íà÷èíàåòñÿ â ïîçèöèè ñ èíäåêñîì <parameter>start</parameter> îò íà÷àëà ñòðîêè, ñ÷èòàÿ îò íóëÿ. </para> <para> Åñëè <parameter>start</parameter> îòðèöàòåëüíûé, âîçâðàùàåìàÿ ïîäñòðîêà íà÷èíàåòñÿ ñ ïîçèöèè <parameter>start</parameter> ñ÷èòàÿ ñ êîíöà ñòðîêè <parameter>str</parameter>. </para> <para> Åñëè <parameter>length</parameter> ïîëîæèòåëüíûé, âîçâðàùàåìàÿ ñòðîêà áóäåò íå äëèííåå <parameter>length</parameter> ñèìâîëîâ. Åñëè äëèíà ñòðîêè <parameter>str</parameter> ìåíüøå äëèíû <parameter>start</parameter>, âîçâðàùàåòñÿ &false;. </para> <para> Åñëè ïåðåäàí îòðèöàòåëüíûé <parameter>length</parameter> áóäåò âîçâðàùåíî óêàçàííîå ýòèì àðãóìåíòîì ÷èñëî ñèìâîëîâ íà÷èíàÿ ñ ïîçèöèè <parameter>start</parameter> è çàêàí÷èâàÿ <parameter>length</parameter> â íàïðàâëåíèè îò êîíöà. Åñëè <parameter>start</parameter> òàêæå îòðèöàòåëåí, íà÷àëüíàÿ ïîçèöèÿ ñ÷èòàåòñÿ îòíîñèòåëüíî êîíöà ñòðîêè. </para> <para> Îáðàòèòå âíìàíèå, ÷òî ïàðàìåòðû <parameter>offset</parameter> è <parameter>length</parameter> âñåãäà ïðåäñòàâëÿþò êîëè÷åñòâî ñèìâîëîâ (â òîé èëè èíîé êîäèðîâêå), à â <function>substr</function> - êîëè÷åñòâî áàéò. Åñëè ïàðàìåòð <parameter>charset</parameter> îïóùåí, ïðåäïîëàãàåòñÿ, ÷òî êîäèðîâêà ñòðîêè <parameter>str</parameter> ðàâíà <link linkend="iconv.configuration">iconv.internal_charset</link>. </para> <para> Ñì. òàêæå <function>substr</function>, <function>mb_substr</function> è <function>mb_strcut</function>. </para> </refsect1> </refentry> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/reference/iconv/functions/iconv.xml?r=1.1&p=1 Index: phpdoc-ru/reference/iconv/functions/iconv.xml +++ phpdoc-ru/reference/iconv/functions/iconv.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.10 Maintainer: Nick Shaforostoff Status: ready --> <!-- $Revision: 1.1 $ --> <refentry id="function.iconv"> <refnamediv> <refname>iconv</refname> <refpurpose>Ïðåîáðàçîâûâàåò ñèìâîëû ñòðîêè â äðóãóþ êîäèðîâêó</refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>string</type><methodname>iconv</methodname> <methodparam><type>string</type><parameter>in_charset</parameter></methodparam> <methodparam><type>string</type><parameter>out_charset</parameter></methodparam> <methodparam><type>string</type><parameter>str</parameter></methodparam> </methodsynopsis> <para> Ïðîèçâîäèò ïðåîáðàçîâàíèå êîäèðîâêè ñèìâîëîâ ñòðîêè <parameter>str</parameter> èç íà÷àëüíîé êîäèðîâêè <parameter>in_charset</parameter> â êîíå÷íóþ <parameter>out_charset</parameter>. Âîçâðàùàåò ñòðîêó â íîâîé êîäèðîâêå, èëè &false; â ñëó÷àå îøèáêè. </para> <para> Åñëè äîáàâèòü <literal>//TRANSLIT</literal> ê ïàðàìåòðó <parameter>out_charset</parameter> áóäåò âêëþ÷åíà òðàíñëèòåðèçàöèÿ. Ýòî îçíà÷àåò, ÷òî âñëó÷àå, êîãäà ñèìâîëà íåò â êîíå÷íîé êîäèðîâêå, îí çàìåíÿåòñÿ îäíèì èëè íåñêîëüêèìè àíàëîãàìè. Åñëè äîáàâèòü <literal>//IGNORE</literal>, òî ñèìâîëû, êîòîðûõ íåò â êîíå÷íîé êîäèðîâêå, áóäóò îïóùåíû. Èíà÷å, áóäåò âîçâðàùåíà ñòðîêà <parameter>str</parameter>, îáðåçàííàÿ äî ïåðâîãî íåäîïóñòèìîãî ñèìâîëà. </para> <para> <example> <title>Ïðèìåð èñïîëüçîâàíèÿ <function>iconv</function>:</title> <programlisting role="php"> <![CDATA[ <?php echo iconv("KOI8-U", "UTF-8", "Ïîðà ïåðåõîäèòü íà þíèêîä."); ?> ]]> </programlisting> </example> </para> </refsect1> </refentry> <!-- 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 indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->