VladPolskiy/php-doc-ru
1
0
Fork 0
mirror of https://github.com/php/doc-ru.git synced 2025-08-16 18:22:04 +00:00
Code Issues Packages Projects Releases Wiki Activity

DsMap: review

Browse Source 
git-svn-id: https://svn.php.net/repository/phpdoc/ru/trunk@344759 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Alexey Pyltsyn
2018-04-20 06:30:45 +00:00
parent 36332d487a
commit 9fecd57794
39 changed files with 128 additions and 128 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
reference/ds/ds.map.xml
View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: e9366ee458b2900c53a503b1ad97664e1d9a8859 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<phpdoc:classref xml:id="class.ds-map" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
@ -13,7 +13,7 @@
<section xml:id="ds-map.intro">
&reftitle.intro;
<para>
Коллекция пар - это последовательная коллекция, содержащая пары ключ/значение,
Коллекция пар - это последовательная коллекция, содержащая пары ключ-значение,
практически идентичная массиву и используется для тех же целей.
Ключи могут быть любого типа, но должны быть уникальными. Если добавить
пару с уже существующим ключем, то она будет заменена.
@ -23,14 +23,14 @@
<section xml:id="ds-map.strengths">
<title xmlns="http://docbook.org/ns/docbook">Сильный стороны</title>
<title xmlns="http://docbook.org/ns/docbook">Сильные стороны</title>
<para>
<simplelist>
<member>Ключи и значения могут быть любого типа, включая объекты.</member>
<member>Поддерживает синтаксис массива (квадратные скобки).</member>
<member>Сохраняется порядок вставки.</member>
<member>Скорость и потребление памяти сравнимо с использованием массива.</member>
<member>Автоматически высвобождает память, когда количество элементов уменьшается.</member>
<member>Автоматически освобождает память, когда количество элементов уменьшается.</member>
</simplelist>
</para>
</section>

6
reference/ds/ds/map/allocate.xml
View File

@ -1,11 +1,11 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="ds-map.allocate" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>Ds\Map::allocate</refname>
<refpurpose>Выделяет необходимое количество памяти, под требуюмую вместимость</refpurpose>
<refpurpose>Выделяет необходимое количество памяти под требуюмую вместимость</refpurpose>
</refnamediv>
<refsect1 role="description">
@ -15,7 +15,7 @@
<methodparam><type>int</type><parameter>capacity</parameter></methodparam>
</methodsynopsis>
<para>
Выделяет необходимое количество памяти, под требуюмую вместимость.
Выделяет необходимое количество памяти под требуюмую вместимость.
</para>
</refsect1>

2
reference/ds/ds/map/apply.xml
View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="ds-map.apply" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>

2
reference/ds/ds/map/capacity.xml
View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="ds-map.capacity" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>

2
reference/ds/ds/map/clear.xml
View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="ds-map.clear" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>

10
reference/ds/ds/map/construct.xml
View File

@ -1,11 +1,11 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="ds-map.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>Ds\Map::__construct</refname>
<refpurpose>Создает новый экземпляр класса</refpurpose>
<refpurpose>Создает новый экземпляр</refpurpose>
</refnamediv>
<refsect1 role="description">
@ -15,8 +15,8 @@
<methodparam choice="opt"><type>mixed</type><parameter>...values</parameter></methodparam>
</constructorsynopsis>
<para>
Создает новый экземпляр класса, используя либо объект реализующий
<classname>traversable</classname>, либо массив, переданные в качестве параметра
Создает новый экземпляр, используя либо объект, реализующий
<classname>traversable</classname>, либо массив, переданный в качестве параметра
<parameter>values</parameter>.
</para>
@ -29,7 +29,7 @@
<term><parameter>values</parameter></term>
<listitem>
<para>
Объект, реализующий интерфейс "traversable" или массив.
Объект, реализующий интерфейс traversable или массив.
</para>
</listitem>
</varlistentry>

2
reference/ds/ds/map/copy.xml
View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="ds-map.copy" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>

4
reference/ds/ds/map/count.xml
View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="ds-map.count" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@ -10,7 +10,7 @@
<refsect1 role="description">
<para>
Смотри описание функции <function>Countable::count</function>
См. описание функции <function>Countable::count</function>
</para>
</refsect1>

2
reference/ds/ds/map/diff.xml
View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="ds-map.diff" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>

10
reference/ds/ds/map/filter.xml
View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="ds-map.filter" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@ -37,13 +37,13 @@
</methodsynopsis>
</para>
<para>
Опциональный аргумент типа <type>callable</type>, который возвращает &true; если
Опциональный аргумент типа <type>callable</type>, который возвращает &true;, если
пара должна быть включена и &false;, если нет.
</para>
<para>
Если callback-функция не задана, то будут включены только элементы, которые
приводятся к логическому значению &true;
(мотри <link linkend="language.types.boolean.casting">приведение к boolean</link>).
(смотрите раздел с <link linkend="language.types.boolean.casting">приведением к boolean</link>).
</para>
</listitem>
</varlistentry>
@ -53,8 +53,8 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Новая коллекция пар, содержащая значения, для которых функция
<parameter>callback</parameter> вернула &true;, или все елементы, которые при
Новая коллекция пар, содержащая значения, для которых
<parameter>callback</parameter>-функция вернула &true;, или все элементы, которые при
приведении к логическому типу становятся &true;, если параметр
<parameter>callback</parameter> не задан.
</para>

4
reference/ds/ds/map/first.xml
View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="ds-map.first" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@ -35,7 +35,7 @@
<refsect1 role="errors">
&reftitle.errors;
<para>
Бросает исключение <classname>UnderflowException</classname>, если коллекция пуста.
Выбрасывает исключение <classname>UnderflowException</classname>, если коллекция пуста.
</para>
</refsect1>

16
reference/ds/ds/map/get.xml
View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="ds-map.get" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@ -16,7 +16,7 @@
<methodparam choice="opt"><type>mixed</type><parameter>default</parameter></methodparam>
</methodsynopsis>
<para>
Возвращает значение по заданному ключу, или, опционально, заданное значение
Возвращает значение по заданному ключу, или необязательное значение
по умолчанию, если ключ не найден.
</para>
@ -28,7 +28,7 @@
проверка производится путем вызова метода объекта <code>equals</code>.
Если объект не реализует интерфейс <classname>Ds\Hashable</classname>,
объекты должны ссылаться на один и тот-же экземпляр класса.
объекты должны ссылаться на один и тот же экземпляр класса.
</para>
</note>
@ -41,13 +41,13 @@
<caution>
<para>
Будьте осторожны используя синтаксис массива. Скалярные ключи будут приведены
к целым ядром PHP. К примеру, <code>$map["1"]</code> будет пытаться обратиться
Будьте осторожны при использовании синтаксиса массива. Скалярные ключи будут приведены
к целым движком PHP. К примеру, <code>$map["1"]</code> будет пытаться обратиться
к <code>int(1)</code>, тогда как <code>$map-&gt;get("1")</code> обратится к
правильному элементу.
</para>
<para>
Смотри раздел <link linkend="language.types.array">Массивы</link>.
Смотрите раздел <link linkend="language.types.array">Массивы</link>.
</para>
</caution>
@ -68,7 +68,7 @@
<term><parameter>default</parameter></term>
<listitem>
<para>
Опциональное значение, которое вернется, если элемент с заданным ключем отсутствует.
Необязательное значение, которое вернется, если элемент с заданным ключем отсутствует.
</para>
</listitem>
</varlistentry>
@ -101,7 +101,7 @@
$map = new \Ds\Map(["a" => 1, "b" => 2, "c" => 3]);
var_dump($map->get("a")); // 1
var_dump($map->get("d", 10)); // 10 (default used)
var_dump($map->get("d", 10)); // 10 (используется по умолчанию)
?>
]]>
</programlisting>

4
reference/ds/ds/map/haskey.xml
View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="ds-map.haskey" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@ -37,7 +37,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Возвращает &true;,если ключ найден, иначе &false;.
Возвращает &true;, если ключ найден, иначе &false;.
</para>
</refsect1>

4
reference/ds/ds/map/hasvalue.xml
View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="ds-map.hasvalue" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@ -37,7 +37,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Возвращает &true;,если ключ найден, иначе &false;.
Возвращает &true;, если ключ найден, иначе &false;.
</para>
</refsect1>

8
reference/ds/ds/map/intersect.xml
View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="ds-map.intersect" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@ -16,7 +16,7 @@
</methodsynopsis>
<para>
Создает новую коллекцию пар из текущей, содержащую элементы, ключи которых
присутствують как в текущей коллекции, так и в переданнов в параметре
присутствуют как в текущей коллекции, так и в переданной в параметре
<parameter>map</parameter>.
Другими словами, возвращает копию текущей коллекции, из которой удалены все
@ -50,7 +50,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Пересечение текущей коллекции и переданнй в <parameter>map</parameter>.
Пересечение текущей коллекции и переданной в <parameter>map</parameter>.
</para>
</refsect1>
@ -58,7 +58,7 @@
<title xmlns="http://docbook.org/ns/docbook">Также смотрите</title>
<para>
<simplelist>
<member><link xlink:href="https://en.wikipedia.org/wiki/Intersection_(set_theory)">Пересечение</link> на Wikipedia</member>
<member><link xlink:href="https://ru.wikipedia.org/wiki/%D0%9F%D0%B5%D1%80%D0%B5%D1%81%D0%B5%D1%87%D0%B5%D0%BD%D0%B8%D0%B5_%D0%BC%D0%BD%D0%BE%D0%B6%D0%B5%D1%81%D1%82%D0%B2">Пересечение</link> на Википедия</member>
</simplelist>
</para>
</refsect1>

4
reference/ds/ds/map/isempty.xml
View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: e9366ee458b2900c53a503b1ad97664e1d9a8859 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="ds-map.isempty" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@ -27,7 +27,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Возвращает &true; если коллекция пуста, и &false; в противном случае.
Возвращает &true;, если коллекция пуста, и &false; в противном случае.
</para>
</refsect1>

4
reference/ds/ds/map/jsonserialize.xml
View File

@ -1,11 +1,11 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="ds-map.jsonserialize" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>Ds\Map::jsonSerialize</refname>
<refpurpose>Возвращает коллекцию в JSON представлении</refpurpose>
<refpurpose>Возвращает коллекцию в JSON-представлении</refpurpose>
</refnamediv>
<refsect1 role="description">

2
reference/ds/ds/map/keys.xml
View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="ds-map.keys" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>

6
reference/ds/ds/map/ksort.xml
View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="ds-map.ksort" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@ -35,7 +35,7 @@
&callback.cmp;
<caution>
<para>
<emphasis>Не целое</emphasis> значение возвращенное из функции сравнения,
<emphasis>Не целое</emphasis> значение, возвращенное из функции сравнения,
такого как <type>float</type>, будет приведено к целому. Так что значения типа
0.99 и 0.1 будут приведены к 0, что будет означать равенство сравниваемых значений.
</para>
@ -100,7 +100,7 @@ Ds\Map Object
<?php
$map = new \Ds\Map([1 => "x", 2 => "y", 0 => "z"]);
// Реверс
// Обратный порядок
$map->ksort(function($a, $b) {
return $b <=> $a;
});

4
reference/ds/ds/map/ksorted.xml
View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="ds-map.ksorted" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@ -98,7 +98,7 @@ Ds\Map Object
<?php
$map = new \Ds\Map([1 => "x", 2 => "y", 0 => "z"]);
// Реверс
// Обратный порядок
$sorted = $map->ksorted(function($a, $b) {
return $b <=> $a;
});

4
reference/ds/ds/map/last.xml
View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="ds-map.last" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@ -35,7 +35,7 @@
<refsect1 role="errors">
&reftitle.errors;
<para>
Бросает исключение <classname>UnderflowException</classname>, если коллекция пуста.
Выбрасывает исключение <classname>UnderflowException</classname>, если коллекция пуста.
</para>
</refsect1>

2
reference/ds/ds/map/map.xml
View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="ds-map.map" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>

6
reference/ds/ds/map/merge.xml
View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="ds-map.merge" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@ -16,7 +16,7 @@
</methodsynopsis>
<para>
Возвращает результат добавления всех ключей переданного объекта класса
<classname>traversable</classname> или массива ассоциированых с соответствующими
<classname>traversable</classname> или массива (&array;) с соответствующими
значениями в текущую коллекцию.
</para>
@ -46,7 +46,7 @@
&reftitle.returnvalues;
<para>
Возвращает результат добавления всех ключей переданного объекта класса
<classname>traversable</classname> или массива ассоциированых с соответствующими
<classname>traversable</classname> или массива с соответствующими
значениями в текущую коллекцию
</para>
<note>

6
reference/ds/ds/map/pairs.xml
View File

@ -1,11 +1,11 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="ds-map.pairs" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>Ds\Map::pairs</refname>
<refpurpose>Возвращает последовательность, содержащую все пары коллекции пар</refpurpose>
<refpurpose>Возвращает последовательность, содержащую все пары коллекции</refpurpose>
</refnamediv>
<refsect1 role="description">
@ -15,7 +15,7 @@
<void />
</methodsynopsis>
<para>
Возвращает <classname>Ds\Sequence</classname>, содержащую все пары коллекции пар.
Возвращает <classname>Ds\Sequence</classname>, содержащую все пары коллекции.
</para>
</refsect1>

16
reference/ds/ds/map/put.xml
View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="ds-map.put" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@ -16,7 +16,7 @@
<methodparam><type>mixed</type><parameter>value</parameter></methodparam>
</methodsynopsis>
<para>
Ассоциирует ключ <parameter>key</parameter> со значением
Связывает ключ <parameter>key</parameter> со значением
<parameter>value</parameter>, если элемент с таким ключем уже существует - его
значение перезаписывается.
</para>
@ -29,7 +29,7 @@
проверка производится путем вызова метода объекта <code>equals</code>.
Если объект не реализует интерфейс <classname>Ds\Hashable</classname>,
объекты должны ссылаться на один и тот-же экземпляр класса.
объекты должны ссылаться на один и тот же экземпляр класса.
</para>
</note>
@ -42,13 +42,13 @@
<caution>
<para>
Будьте осторожны используя синтаксис массива. Скалярные ключи будут приведены
к целым ядром PHP. К примеру, <code>$map["1"]</code> будет пытаться обратиться
Будьте осторожны при использовании синтаксиса массива. Скалярные ключи будут приведены
к целым движком PHP. К примеру, <code>$map["1"]</code> будет пытаться обратиться
к <code>int(1)</code>, тогда как <code>$map-&gt;get("1")</code> обратится к
правильному элементу.
</para>
<para>
Смотри раздел <link linkend="language.types.array">Массивы</link>.
Смотрите раздел <link linkend="language.types.array">Массивы</link>.
</para>
</caution>
@ -169,8 +169,8 @@ $map->put($obj, 2);
$map->put(new \stdClass(), 3);
$map->put(new \stdClass(), 4);
// Использование объектов с одинаковыми хешами несколько раз будет каждый раз
// перезаписывать значение
// Использование одинаковых hashable-экземпляров несколько раз будет перезаписывать
// предыдущие значения
$map->put(new \HashableObject(1), 5);
$map->put(new \HashableObject(1), 6);
$map->put(new \HashableObject(2), 7);

8
reference/ds/ds/map/putAll.xml
View File

@ -1,11 +1,11 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="ds-map.putall" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>Ds\Map::putAll</refname>
<refpurpose>Вносит в коллекцию все пары ключ/значение из объекта класса traversable или массива</refpurpose>
<refpurpose>Связывает с коллекцией все пары ключ-значение из объекта класса traversable или массива</refpurpose>
</refnamediv>
<refsect1 role="description">
@ -15,7 +15,7 @@
<methodparam><type>mixed</type><parameter>pairs</parameter></methodparam>
</methodsynopsis>
<para>
Вносит в коллекцию все пары ключ/значение <parameter>pairs</parameter>
Связывает с коллекцией все пары ключ-значение <parameter>pairs</parameter>
из объекта класса <classname>traversable</classname> или &array;.
</para>
@ -27,7 +27,7 @@
проверка производится путем вызова метода объекта <code>equals</code>.
Если объект не реализует интерфейс <classname>Ds\Hashable</classname>,
объекты должны ссылаться на один и тот-же экземпляр класса.
объекты должны ссылаться на один и тот же экземпляр класса.
</para>
</note>

20
reference/ds/ds/map/reduce.xml
View File

@ -1,11 +1,11 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="ds-map.reduce" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>Ds\Map::reduce</refname>
<refpurpose>Схлопывает коллекцию до одного значения используя callback-функцию</refpurpose>
<refpurpose>Уменьшает коллекцию до одного значения, используя callback-функцию</refpurpose>
</refnamediv>
<refsect1 role="description">
@ -16,7 +16,7 @@
<methodparam choice="opt"><type>mixed</type><parameter>initial</parameter></methodparam>
</methodsynopsis>
<para>
Схлопывает коллекцию до одного значения используя callback-функцию.
Уменьшает коллекцию до одного значения, используя callback-функцию.
</para>
</refsect1>
@ -39,8 +39,8 @@
<term><parameter>carry</parameter></term>
<listitem>
<para>
Значение вохвращенное предыдущим запуском функции, или
<parameter>initial</parameter>, если функция запущена первый раз.
Значение, возвращенное предыдущим запуском функции или
<parameter>initial</parameter>, если функция запущена в первый раз.
</para>
</listitem>
</varlistentry>
@ -48,7 +48,7 @@
<term><parameter>key</parameter></term>
<listitem>
<para>
The key of the current iteration.
Ключ текущей итерации.
</para>
</listitem>
</varlistentry>
@ -68,7 +68,7 @@
<term><parameter>initial</parameter></term>
<listitem>
<para>
Начальное значение параметра carry.Можно указать &null;.
Начальное значение для параметра carry. Можно указать &null;.
</para>
</listitem>
</varlistentry>
@ -78,7 +78,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Значение возвращенное финальным запуском callback-функции.
Значение, возвращенное окончательным запуском callback-функции.
</para>
</refsect1>
@ -97,7 +97,7 @@ $callback = function($carry, $key, $value) {
var_dump($map->reduce($callback, 5));
// Iterations:
// Итерации:
//
// $carry = $initial = 5
//
@ -125,7 +125,7 @@ var_dump($map->reduce(function($carry, $key, $value) {
return $carry + $value + 5;
}));
// Iterations:
// Итерации:
//
// $carry = $initial = null
//

20
reference/ds/ds/map/remove.xml
View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="ds-map.remove" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@ -16,7 +16,7 @@
<methodparam choice="opt"><type>mixed</type><parameter>default</parameter></methodparam>
</methodsynopsis>
<para>
Удаляет и возвращает значение по ключу, либо, опционально, возвращает
Удаляет и возвращает значение по ключу, либо возвращает необязательное
значение по умолчанию, если ключ не найден.
</para>
@ -28,7 +28,7 @@
проверка производится путем вызова метода объекта <code>equals</code>.
Если объект не реализует интерфейс <classname>Ds\Hashable</classname>,
объекты должны ссылаться на один и тот-же экземпляр класса.
объекты должны ссылаться на один и тот же экземпляр класса.
</para>
</note>
@ -41,13 +41,13 @@
<caution>
<para>
Будьте осторожны используя синтаксис массива. Скалярные ключи будут приведены
к целым ядром PHP. К примеру, <code>$map["1"]</code> будет пытаться обратиться
Будьте осторожны при использовании синтаксиса массива. Скалярные ключи будут приведены
к целым движком PHP. К примеру, <code>$map["1"]</code> будет пытаться обратиться
к <code>int(1)</code>, тогда как <code>$map-&gt;get("1")</code> обратится к
правильному элементу.
</para>
<para>
Смотри раздел <link linkend="language.types.array">Массивы</link>.
Смотрите раздел <link linkend="language.types.array">Массивы</link>.
</para>
</caution>
@ -68,7 +68,7 @@
<term><parameter>default</parameter></term>
<listitem>
<para>
Необязательный параметр, задающий возвращаемое значение по умолчанию, если ключ не найден.
Необязательный параметр, устанавливающий возвращаемое значение по умолчанию, если ключ не найден.
</para>
</listitem>
</varlistentry>
@ -78,7 +78,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Удаленное значение, или <parameter>default</parameter>, если задано и ключ
Удаленное значение или <parameter>default</parameter>, если он указан, а ключ
<parameter>key</parameter> не найден.
</para>
</refsect1>
@ -86,7 +86,7 @@
<refsect1 role="errors">
&reftitle.errors;
<para>
Бросает исключение <classname>OutOfRangeException</classname>, если ключ не найден и
Выбрасывает исключение <classname>OutOfRangeException</classname>, если ключ не найден и
не задано значение по умолчанию.
</para>
</refsect1>
@ -101,7 +101,7 @@
$map = new \Ds\Map(["a" => 1, "b" => 2, "c" => 3]);
var_dump($map->remove("a")); // 1
var_dump($map->remove("e", 10)); // 10 (default used)
var_dump($map->remove("e", 10)); // 10 (используется по умолчанию)
?>
]]>
</programlisting>

2
reference/ds/ds/map/reverse.xml
View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="ds-map.reverse" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>

2
reference/ds/ds/map/reversed.xml
View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="ds-map.reversed" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>

4
reference/ds/ds/map/skip.xml
View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="ds-map.skip" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@ -46,7 +46,7 @@
<refsect1 role="errors">
&reftitle.errors;
<para>
Бросает исключение <classname>OutOfRangeException</classname>, если индекс некорректен.
Выбрасывает исключение <classname>OutOfRangeException</classname>, если индекс некорректен.
</para>
</refsect1>

20
reference/ds/ds/map/slice.xml
View File

@ -1,12 +1,12 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="ds-map.slice" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>Ds\Map::slice</refname>
<refpurpose>
Возвращает под-коллекцию из заданного диапазона
Возвращает подмножество коллекции из заданного диапазона
</refpurpose>
</refnamediv>
@ -18,7 +18,7 @@
<methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam>
</methodsynopsis>
<para>
Возвращает под-коллекцию из диапазона, заданного начальным индексом
Возвращает подмножество коллекции из диапазона, заданного начальным индексом
<parameter>index</parameter> и длиной <parameter>length</parameter>.
</para>
@ -47,7 +47,7 @@
Если количество элементов коллекции меньше заданного значения, вернется
столько элементов, сколько есть.
Отрицательное значение задаст индекс, отсчитанный от конца коллекции,
Отрицательное значение установит индекс, отсчитанный от конца коллекции,
определяющий конец диапазона.
Если длина не задана, то будут возвращены все элементы коллекции от
@ -61,7 +61,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Под-коллекция из заданного диапазона.
Подмножество коллекции из заданного диапазона.
</para>
</refsect1>
@ -74,19 +74,19 @@
<?php
$map = new \Ds\Map(["a" => 1, "b" => 2, "c" => 3, "d" => 4, "e" => 5]);
// Slice from 2 onwards
// Подмножество после индекса 2
print_r($map->slice(2)->toArray());
// Slice from 1, for a length of 3
// Подмножество, начиная с индекса 1 с длиной 3
print_r($map->slice(1, 3)->toArray());
// Slice from 1 onwards
// Подмножество после индекса 1
print_r($map->slice(1)->toArray());
// Slice from 2 from the end onwards
// Подмножество после индекса 2 с конца
print_r($map->slice(-2)->toArray());
// Slice from 1 to 1 from the end
// Подмножество после индекса 1, отсчитывая с конца
print_r($map->slice(1, -1)->toArray());
?>
]]>

6
reference/ds/ds/map/sort.xml
View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="ds-map.sort" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@ -17,7 +17,7 @@
<methodparam choice="opt"><type>callable</type><parameter>comparator</parameter></methodparam>
</methodsynopsis>
<para>
Сортирует коллекцию по значениям, опционально используя callback-функцию
Сортирует коллекцию по значениям, необязательно используя callback-функцию
<parameter>comparator</parameter>.
</para>
@ -35,7 +35,7 @@
&callback.cmp;
<caution>
<para>
<emphasis>Не целое</emphasis> значение возвращенное из функции сравнения,
<emphasis>Не целое</emphasis> значение, возвращенное из функции сравнения,
такого как <type>float</type>, будет приведено к целому. Так что значения типа
0.99 и 0.1 будут приведены к 0, что будет означать равенство сравниваемых значений.
</para>

6
reference/ds/ds/map/sorted.xml
View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="ds-map.sorted" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@ -15,7 +15,7 @@
<methodparam choice="opt"><type>callable</type><parameter>comparator</parameter></methodparam>
</methodsynopsis>
<para>
Возвращает отсортированную по значению копию коллекции, опционально используя
Возвращает отсортированную по значению копию коллекции, необязательно используя
callback-функцию <parameter>comparator</parameter>.
</para>
@ -33,7 +33,7 @@
&callback.cmp;
<caution>
<para>
<emphasis>Не целое</emphasis> значение возвращенное из функции сравнения,
<emphasis>Не целое</emphasis> значение, возвращенное из функции сравнения,
такого как <type>float</type>, будет приведено к целому. Так что значения типа
0.99 и 0.1 будут приведены к 0, что будет означать равенство сравниваемых значений.
</para>

2
reference/ds/ds/map/sum.xml
View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="ds-map.sum" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>

10
reference/ds/ds/map/toarray.xml
View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="ds-map.toarray" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@ -21,13 +21,13 @@
</para>
<caution>
<para>
Коллекции пар, содержащие нескалярные ключи не могут быть сконвертированы
в &array;.
Коллекции пар, содержащие нескалярные ключи не могут быть преобразованы
в массив (&array;).
</para>
</caution>
<caution>
<para>
&array; будет считать все числовые ключи за целочисленные,
Массив (&array;) будет считать все числовые ключи за целочисленные,
т.е. оба ключа <code>"1"</code> и <code>1</code> будут восприняты как
<code>1</code> и только один из элементов попадет в результирующий массив.
</para>
@ -48,7 +48,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&array;, содержащий все элементы коллекции с сохранением их порядка.
Массив (&array;), содержащий все элементы коллекции с сохранением их порядка.
</para>
</refsect1>

6
reference/ds/ds/map/union.xml
View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="ds-map.union" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@ -53,10 +53,10 @@
</refsect1>
<refsect1 role="seealso">
<title xmlns="http://docbook.org/ns/docbook">Также смотри</title>
<title xmlns="http://docbook.org/ns/docbook">Также смотрите</title>
<para>
<simplelist>
<member><link xlink:href="https://en.wikipedia.org/wiki/Union_(set_theory)">Объединение</link> в Wikipedia</member>
<member><link xlink:href="https://ru.wikipedia.org/wiki/%D0%9E%D0%B1%D1%8A%D0%B5%D0%B4%D0%B8%D0%BD%D0%B5%D0%BD%D0%B8%D0%B5_%D0%BC%D0%BD%D0%BE%D0%B6%D0%B5%D1%81%D1%82%D0%B2">Объединение</link> в Википедия</member>
</simplelist>
</para>
</refsect1>

6
reference/ds/ds/map/values.xml
View File

@ -1,11 +1,11 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="ds-map.values" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>Ds\Map::values</refname>
<refpurpose>Возвращает последовательность значений коллекции пар</refpurpose>
<refpurpose>Возвращает последовательность значений коллекции</refpurpose>
</refnamediv>
<refsect1 role="description">
@ -15,7 +15,7 @@
<void />
</methodsynopsis>
<para>
Возвращает последовательность значений коллекции пар, сохраняя их порядок.
Возвращает последовательность значений коллекции, сохраняя их порядок.
</para>
</refsect1>

6
reference/ds/ds/map/xor.xml
View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="ds-map.xor" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@ -46,10 +46,10 @@
</refsect1>
<refsect1 role="seealso">
<title xmlns="http://docbook.org/ns/docbook">Также смотри</title>
<title xmlns="http://docbook.org/ns/docbook">Также смотрите</title>
<para>
<simplelist>
<member><link xlink:href="https://en.wikipedia.org/wiki/Symmetric_difference">Симметрическая разность</link> в Wikipedia</member>
<member><link xlink:href="https://ru.wikipedia.org/wiki/%D0%A1%D0%B8%D0%BC%D0%BC%D0%B5%D1%82%D1%80%D0%B8%D1%87%D0%B5%D1%81%D0%BA%D0%B0%D1%8F_%D1%80%D0%B0%D0%B7%D0%BD%D0%BE%D1%81%D1%82%D1%8C">Симметрическая разность</link> в Википедия</member>
</simplelist>
</para>
</refsect1>