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

tony2001 Mon Mar 28 02:07:57 2005 EDT Modified files: /phpdoc-ru/reference/array/functions range.xml usort.xml Log: win1251 -> utf8

http://cvs.php.net/diff.php/phpdoc-ru/reference/array/functions/range.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc-ru/reference/array/functions/range.xml diff -u phpdoc-ru/reference/array/functions/range.xml:1.1 phpdoc-ru/reference/array/functions/range.xml:1.2 --- phpdoc-ru/reference/array/functions/range.xml:1.1 Wed Feb 23 15:41:36 2005 +++ phpdoc-ru/reference/array/functions/range.xml Mon Mar 28 02:07:56 2005 @@ -1,16 +1,16 @@ -<?xml version="1.0" encoding="windows-1251"?> +<?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: 1.15 Maintainer: sveta Status: ready --> -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> <!-- 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> + <title>Описание</title> <methodsynopsis> <type>array</type><methodname>range</methodname> <methodparam><type>number</type><parameter>low</parameter></methodparam> @@ -18,25 +18,25 @@ <methodparam choice="opt"><type>number</type><parameter>step</parameter></methodparam> </methodsynopsis> <para> - <function>range</function> âîçâðàùàåò ìàññèâ ýëåìåíòîâ ñ - <parameter>low</parameter> ïî <parameter>high</parameter>, - âêëþ÷èòåëüíî. Åñëè low > high, ïîñëåäîâàòåëüíîñòü áóäåò óáûâàþùåé. + <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. + Дополнительный параметр <parameter>step</parameter> был добавлен в PHP 5.0.0. </simpara> </note> <para> - Åñëè óêàçàí ïàðàìåòð <parameter>step</parameter>, îí áóäåò èñïîëüçîâàòüñÿ êàê - èíêðåìåíò ìåæäó ýëåìåíòàìè ïîñëåäîâàòåëüíîñòè. <parameter>step</parameter> - äîëæåí áûòü ïîëîæèòåëüíûì ÷èñëîì. Åñëè - <parameter>step</parameter> íå óêàçàí, îí ïðèíèìàåò çíà÷åíèå ïî óìîë÷àíèþ 1. + Если указан параметр <parameter>step</parameter>, он будет использоваться как + инкремент между элементами последовательности. <parameter>step</parameter> + должен быть положительным числом. Если + <parameter>step</parameter> не указан, он принимает значение по умолчанию 1. </para> <para> <example> - <title>Ïðèìåðû èñïîëüçîâàíèÿ <function>range</function></title> + <title>Примеры использования <function>range</function></title> <programlisting role="php"> <![CDATA[ <?php @@ -45,13 +45,13 @@ echo $number; } -// Ïàðàìåòð step áûë äîáàâëåí â 5.0.0 +// Параметр 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 +// Использование последовательности знаков было добавлено в версии 4.1.0 // array('a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i'); foreach (range('a', 'i') as $letter) { echo $letter; @@ -67,25 +67,25 @@ </para> <note> <para> - Äî ïîÿâëåíèÿ PHP 4.1.0, <function>range</function> ñîçäàâàëà - òîëüêî ìàññèâû, ñîäåðæàùèå äèàïàçîí ÷èñåë â ïîðÿäêå âîçðàñòàíèÿ. - Ïîääåðæêà ïîñëåäîâàòåëüíîñòåé çíàêîâ è ñîçäàíèÿ äèàïàçîíà â ïîðÿäêå - óáûâàíèÿ áûëà äîáàâëåíà â âåðñèè 4.1.0. Äèàïàçîí çíàêîâ ìîæíî - çàäàòü òîëüêî ïðè ïîìîùè ñòðîêè èç îäíîãî çíàêà. Åñëè äëèíà òàêîé ñòðîêè áóäåò áîëåå - îäíîãî çíàêà, áóäåò èñïîëüçîâàí ïåðâûé çíàê. + До появления 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>. + В 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> è + См. также <function>shuffle</function>, + <function>array_fill</function> и <link linkend="control-structures.foreach">foreach</link>. </para> </refsect1> http://cvs.php.net/diff.php/phpdoc-ru/reference/array/functions/usort.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc-ru/reference/array/functions/usort.xml diff -u phpdoc-ru/reference/array/functions/usort.xml:1.1 phpdoc-ru/reference/array/functions/usort.xml:1.2 --- phpdoc-ru/reference/array/functions/usort.xml:1.1 Wed Feb 23 15:41:36 2005 +++ phpdoc-ru/reference/array/functions/usort.xml Mon Mar 28 02:07:56 2005 @@ -1,40 +1,40 @@ -<?xml version="1.0" encoding="windows-1251"?> +<?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: 1.21 Maintainer: sveta Status: ready --> -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> <!-- 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> + <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 áîëüøå íå èñïîëüçóåò ýòî ðåøåíèå - è íå èìååò äðóãîãî ýôôåêòèâíîãî. + Если два элемента исходного массива равны, их порядок в отсортированном + массиве неопределён. До PHP 4.0.6 пользовательские функции сохраняли + для таких элеменов порядок в оригинальном массиве, но новый алгоритм + сортировки, появившейся в версии 4.1.0 больше не использует это решение + и не имеет другого эффективного. </para> </note> </para> @@ -43,7 +43,7 @@ </para> <para> <example> - <title>Ïðèìåð èñïîëüçîâàíèÿ <function>usort</function></title> + <title>Пример использования <function>usort</function></title> <programlisting role="php"> <![CDATA[ <?php @@ -80,14 +80,14 @@ </para> <note> <para> - Î÷åâèäíî, ÷òî äëÿ ýòîãî òðèâèàëüíîãî ñëó÷àÿ áîëåå ïîäõîäèò ôóíêöèÿ + Очевидно, что для этого тривиального случая более подходит функция <function>sort</function>. </para> </note> <para> <example> <title> - Ïðèìåð èñïîëüçîâàíèÿ ôóíêöèåé <function>usort</function> ìíîãîìåðíûõ ìàññèâîâ + Пример использования функцией <function>usort</function> многомерных массивов </title> <programlisting role="php"> <![CDATA[ @@ -111,8 +111,8 @@ ]]> </programlisting> <para> - Ïðè ñîðòèðîâêå ìíîãîìåðíîãî ìàññèâà ïåðåìåííûå <varname>$a</varname> è - <varname>$b</varname> ñîäåðæàò ññûëêè íà ïåðâûå äâà èíäåêñà ìàññèâà. + При сортировке многомерного массива переменные <varname>$a</varname> и + <varname>$b</varname> содержат ссылки на первые два индекса массива. </para> &example.outputs; <screen> @@ -128,7 +128,7 @@ <para> <example> <title> - Ïðèìåð èñïîëüçîâàíèÿ <function>usort</function> ñ ìåòîäîì êëàññà + Пример использования <function>usort</function> с методом класса </title> <programlisting role="php"> <![CDATA[ @@ -178,11 +178,11 @@ </para> <para> - Ñì. òàêæå <function>uasort</function>, + См. также <function>uasort</function>, <function>uksort</function>, <function>sort</function>, <function>asort</function>, <function>arsort</function>,<function>ksort</function>, - <function>natsort</function> è <function>rsort</function>. + <function>natsort</function> и <function>rsort</function>. </para> </refsect1> </refentry>