cvs: phpdoc-ru /language oop5.xml /reference/array/functions range.xml usort.xml

From: Date: Wed, 23 Feb 2005 20:41:36 +0000
Subject: cvs: phpdoc-ru /language oop5.xml /reference/array/functions range.xml usort.xml
Groups: php.doc.ru 
Request: Send a blank email to doc-ru+get-628@lists.php.net to get a copy of this message
freespace Wed Feb 23 15:41:36 2005 EDT Added files: /phpdoc-ru/reference/array/functions range.xml usort.xml Modified files: /phpdoc-ru/language oop5.xml Log: New contributions by Sveta Smirnova.

http://cvs.php.net/diff.php/phpdoc-ru/language/oop5.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-ru/language/oop5.xml diff -u phpdoc-ru/language/oop5.xml:1.3 phpdoc-ru/language/oop5.xml:1.4 --- phpdoc-ru/language/oop5.xml:1.3 Wed Dec 29 07:53:41 2004 +++ phpdoc-ru/language/oop5.xml Wed Feb 23 15:41:34 2005 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="windows-1251"?> -<!-- EN-Revision: 1.6 Maintainer: tronic Status: ready --> -<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.10 Maintainer: tronic Status: ready --> +<!-- $Revision: 1.4 $ --> <chapter id="language.oop5"> <title>Êëàññû è îáúåêòû (PHP 5)</title> @@ -13,6 +13,7 @@ </sect1> &language.oop5.basic; + &language.oop5.autoload; &language.oop5.decon; &language.oop5.visibility; &language.oop5.paamayim-nekudotayim; @@ -22,11 +23,13 @@ &language.oop5.interfaces; &language.oop5.overloading; &language.oop5.iterations; + &language.oop5.patterns; &language.oop5.magic; &language.oop5.final; &language.oop5.cloning; &language.oop5.object-comparison; &language.oop5.reflection; + &language.oop5.typehinting; </chapter> <!-- Keep this comment at the end of the file @@ -49,3 +52,4 @@ vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> + http://cvs.php.net/co.php/phpdoc-ru/reference/array/functions/range.xml?r=1.1&p=1 Index: phpdoc-ru/reference/array/functions/range.xml +++ phpdoc-ru/reference/array/functions/range.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.15 Maintainer: sveta Status: ready --> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/array.xml, last change in rev 1.2 --> <refentry id="function.range"> <refnamediv> <refname>range</refname> <refpurpose> Ñîçäàòü ìàññèâ, ñîäåðæàùèé äèàïàçîí ýëåìåíòîâ </refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>array</type><methodname>range</methodname> <methodparam><type>number</type><parameter>low</parameter></methodparam> <methodparam><type>number</type><parameter>high</parameter></methodparam> <methodparam choice="opt"><type>number</type><parameter>step</parameter></methodparam> </methodsynopsis> <para> <function>range</function> âîçâðàùàåò ìàññèâ ýëåìåíòîâ ñ <parameter>low</parameter> ïî <parameter>high</parameter>, âêëþ÷èòåëüíî. Åñëè low > high, ïîñëåäîâàòåëüíîñòü áóäåò óáûâàþùåé. </para> <note> <title>New parameter</title> <simpara> Äîïîëíèòåëüíûé ïàðàìåòð <parameter>step</parameter> áûë äîáàâëåí â PHP 5.0.0. </simpara> </note> <para> Åñëè óêàçàí ïàðàìåòð <parameter>step</parameter>, îí áóäåò èñïîëüçîâàòüñÿ êàê èíêðåìåíò ìåæäó ýëåìåíòàìè ïîñëåäîâàòåëüíîñòè. <parameter>step</parameter> äîëæåí áûòü ïîëîæèòåëüíûì ÷èñëîì. Åñëè <parameter>step</parameter> íå óêàçàí, îí ïðèíèìàåò çíà÷åíèå ïî óìîë÷àíèþ 1. </para> <para> <example> <title>Ïðèìåðû èñïîëüçîâàíèÿ <function>range</function></title> <programlisting role="php"> <![CDATA[ <?php // array(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12) foreach (range(0, 12) as $number) { echo $number; } // Ïàðàìåòð step áûë äîáàâëåí â 5.0.0 // array(0, 10, 20, 30, 40, 50, 60, 70, 80, 90, 100) foreach (range(0, 100, 10) as $number) { echo $number; } // Èñïîëüçîâàíèå ïîñëåäîâàòåëüíîñòè çíàêîâ áûëî äîáàâëåíî â âåðñèè 4.1.0 // array('a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i'); foreach (range('a', 'i') as $letter) { echo $letter; } // array('c', 'b', 'a'); foreach (range('c', 'a') as $letter) { echo $letter; } ?> ]]> </programlisting> </example> </para> <note> <para> Äî ïîÿâëåíèÿ PHP 4.1.0, <function>range</function> ñîçäàâàëà òîëüêî ìàññèâû, ñîäåðæàùèå äèàïàçîí ÷èñåë â ïîðÿäêå âîçðàñòàíèÿ. Ïîääåðæêà ïîñëåäîâàòåëüíîñòåé çíàêîâ è ñîçäàíèÿ äèàïàçîíà â ïîðÿäêå óáûâàíèÿ áûëà äîáàâëåíà â âåðñèè 4.1.0. Äèàïàçîí çíàêîâ ìîæíî çàäàòü òîëüêî ïðè ïîìîùè ñòðîêè èç îäíîãî çíàêà. Åñëè äëèíà òàêîé ñòðîêè áóäåò áîëåå îäíîãî çíàêà, áóäåò èñïîëüçîâàí ïåðâûé çíàê. </para> </note> <caution> <para>  PHP âåðñèé ñ 4.1.0 ïî 4.3.2, <function>range</function> ðàññìàòðèâàë ÷èñëîâûå ñòðîêè èìåííî êàê ñòðîêè, à íå ÷èñëà. Âìåñòî íèõ èñïîëüçîâàëàñü ïîñëåäîâàòåëüíîñòü çíàêîâ. Íàïðèìåð, <literal>"4242"</literal> òðàêòîâàëîñü <literal>"4"</literal>. </para> </caution> <para> Ñì. òàêæå <function>shuffle</function>, <function>array_fill</function> è <link linkend="control-structures.foreach">foreach</link>. </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/array/functions/usort.xml?r=1.1&p=1 Index: phpdoc-ru/reference/array/functions/usort.xml +++ phpdoc-ru/reference/array/functions/usort.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.21 Maintainer: sveta Status: ready --> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/array.xml, last change in rev 1.2 --> <refentry id="function.usort"> <refnamediv> <refname>usort</refname> <refpurpose> Îòñîðòèðîâàòü ìàññèâ ïî çíà÷åíèÿì èñïîëüçóÿ ïîëüçîâàòåëüñêóþ ôóíêöèþ äëÿ ñðàâíåíèÿ ýëåìåíòîâ </refpurpose> </refnamediv> <refsect1> <title>Îïèñàíèå</title> <methodsynopsis> <type>bool</type><methodname>usort</methodname> <methodparam><type>array</type><parameter role="reference">array</parameter></methodparam> <methodparam><type>callback</type><parameter>cmp_function</parameter></methodparam> </methodsynopsis> <para> Ýòà ôóíêöèÿ ñîðòèðóåò ýëåìåíòû ìàññèâà, èñïîëüçóÿ äëÿ ñðàâíåíèÿ çíà÷åíèé ïîëüçîâàòåëüñêóþ ôóíêöèþ. Åñëè âàì íóæíî îòñîðòèðîâàòü ìàññèâ ïî íåîáû÷íîìó êðèòåðèþ, âû äîëæíû èñïîëüçîâàòü ýòó ôóíêöèþ. </para> <para> Ôóíêöèÿ, èñïîëüçóåìàÿ äëÿ ñðàâíåíèÿ, äîëæíà âîçâðàùàòü öåëîå ÷èñëî, ìåíüøåå, ðàâíîå èëè áîëüøåå íóëÿ, åñëè ïåðâûé àðãóìåíò ñîîòâåòñòâåííî ìåíüøå, ðàâåí èëè áîëüøå âòîðîãî. </para> <para> <note> <para> Åñëè äâà ýëåìåíòà èñõîäíîãî ìàññèâà ðàâíû, èõ ïîðÿäîê â îòñîðòèðîâàííîì ìàññèâå íåîïðåäåë¸í. Äî PHP 4.0.6 ïîëüçîâàòåëüñêèå ôóíêöèè ñîõðàíÿëè äëÿ òàêèõ ýëåìåíîâ ïîðÿäîê â îðèãèíàëüíîì ìàññèâå, íî íîâûé àëãîðèòì ñîðòèðîâêè, ïîÿâèâøåéñÿ â âåðñèè 4.1.0 áîëüøå íå èñïîëüçóåò ýòî ðåøåíèå è íå èìååò äðóãîãî ýôôåêòèâíîãî. </para> </note> </para> <para> &return.success; </para> <para> <example> <title>Ïðèìåð èñïîëüçîâàíèÿ <function>usort</function></title> <programlisting role="php"> <![CDATA[ <?php function cmp($a, $b) { if ($a == $b) { return 0; } return ($a < $b) ? -1 : 1; } $a = array(3, 2, 5, 6, 1); usort($a, "cmp"); while (list($key, $value) = each($a)) { echo "$key: $value "; } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ 0: 1 1: 2 2: 3 3: 5 4: 6 ]]> </screen> </example> </para> <note> <para> Î÷åâèäíî, ÷òî äëÿ ýòîãî òðèâèàëüíîãî ñëó÷àÿ áîëåå ïîäõîäèò ôóíêöèÿ <function>sort</function>. </para> </note> <para> <example> <title> Ïðèìåð èñïîëüçîâàíèÿ ôóíêöèåé <function>usort</function> ìíîãîìåðíûõ ìàññèâîâ </title> <programlisting role="php"> <![CDATA[ <?php function cmp($a, $b) { return strcmp($a["fruit"], $b["fruit"]); } $fruits[0]["fruit"] = "lemons"; $fruits[1]["fruit"] = "apples"; $fruits[2]["fruit"] = "grapes"; usort($fruits, "cmp"); while (list($key, $value) = each($fruits)) { echo "\$fruits[$key]: " . $value["fruit"] . " "; } ?> ]]> </programlisting> <para> Ïðè ñîðòèðîâêå ìíîãîìåðíîãî ìàññèâà ïåðåìåííûå <varname>$a</varname> è <varname>$b</varname> ñîäåðæàò ññûëêè íà ïåðâûå äâà èíäåêñà ìàññèâà. </para> &example.outputs; <screen> <![CDATA[ $fruits[0]: apples $fruits[1]: grapes $fruits[2]: lemons ]]> </screen> </example> </para> <para> <example> <title> Ïðèìåð èñïîëüçîâàíèÿ <function>usort</function> ñ ìåòîäîì êëàññà </title> <programlisting role="php"> <![CDATA[ <?php class TestObj { var $name; function TestObj($name) { $this->name = $name; } /* This is the static comparing function: */ function cmp_obj($a, $b) { $al = strtolower($a->name); $bl = strtolower($b->name); if ($al == $bl) { return 0; } return ($al > $bl) ? +1 : -1; } } $a[] = new TestObj("c"); $a[] = new TestObj("b"); $a[] = new TestObj("d"); usort($a, array("TestObj", "cmp_obj")); foreach ($a as $item) { echo $item->name . " "; } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ b c d ]]> </screen> </example> </para> <para> Ñì. òàêæå <function>uasort</function>, <function>uksort</function>, <function>sort</function>, <function>asort</function>, <function>arsort</function>,<function>ksort</function>, <function>natsort</function> è <function>rsort</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 -->
« previous php.doc.ru (#628) next »