com doc/ru: Обновлен ие до англи йской верси и: reference/strings/functions/implode.xml referen
ce/strings/functions/levenshtein.xml
| From: | Sergey Panteleev | Date: | Fri, 22 Jan 2021 09:48:11 +0000 |
| Subject: | com doc/ru: Обновлен ие до англи йской верси и: reference/strings/functions/implode.xml referen ce/strings/functions/levenshtein.xml |
||
| Groups: | php.doc.ru | ||
| Request: | Send a blank email to doc-ru+get-8766@lists.php.net to get a copy of this message | ||
Commit: db9732921c604edb757882210ad87118152bfc1f
Author: Sergey Panteleev <sergey@php.net> Fri, 22 Jan 2021 12:45:57 +0300
Parents: aa08117754a70769fe02a06a718b020c57826ff1
Branches: master
Link: http://git.php.net/?p=doc/ru.git;a=commitdiff;h=db9732921c604edb757882210ad87118152bfc1f
Log:
Обновление до английской версии
Changed paths:
M reference/strings/functions/implode.xml
M reference/strings/functions/levenshtein.xml
diff --git a/reference/strings/functions/implode.xml b/reference/strings/functions/implode.xml index dadb8bc83..f3bdca865 100644 --- a/reference/strings/functions/implode.xml +++ b/reference/strings/functions/implode.xml @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: e50c87114588f058084e4cca47b95ddbe4a3bb1c Maintainer: shein Status: ready --> +<!-- EN-Revision: 3c969c420f1232ac0946c70d3d6bb90d7f4e9c31 Maintainer: shein Status: ready --> <!-- Reviewed: yes --> <!-- $Revision$ --> -<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.implode"> +<refentry xml:id="function.implode" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>implode</refname> <refpurpose>Объединяет элементы массива в строку</refpurpose> @@ -12,24 +12,23 @@ &reftitle.description; <methodsynopsis> <type>string</type><methodname>implode</methodname> - <methodparam><type>string</type><parameter>glue</parameter></methodparam> - <methodparam><type>array</type><parameter>pieces</parameter></methodparam> + <methodparam><type>string</type><parameter>separator</parameter></methodparam> + <methodparam><type>array</type><parameter>array</parameter></methodparam> </methodsynopsis> + <simpara>Альтернативная сигнатура (не поддерживается с именованными аргументами):</simpara> <methodsynopsis> <type>string</type><methodname>implode</methodname> - <methodparam><type>array</type><parameter>pieces</parameter></methodparam> + <methodparam><type>array</type><parameter>array</parameter></methodparam> + </methodsynopsis> + <simpara>Устаревшая сигнатура (устарела с PHP 7.4.0, удалена в PHP 8.0.0):</simpara> + <methodsynopsis> + <type>string</type><methodname>implode</methodname> + <methodparam><type>array</type><parameter>array</parameter></methodparam> + <methodparam><type>string</type><parameter>separator</parameter></methodparam> </methodsynopsis> <para> - Объединяет элементы массива с помощью строки <parameter>glue</parameter>. + Объединяет элементы массива с помощью строки <parameter>separator</parameter>. </para> - <note> - <para> - По историческим причинам функции <function>implode</function> можно - передавать аргументы в любом порядке, однако для согласованности с - функцией <function>explode</function> <emphasis>не рекомендуется</emphasis> использовать - недокументированный порядок аргументов. - </para> - </note> </refsect1> <refsect1 role="parameters"> @@ -37,7 +36,7 @@ <para> <variablelist> <varlistentry> - <term><parameter>glue</parameter></term> + <term><parameter>separator</parameter></term> <listitem> <para> По умолчанию равен пустой строке. @@ -45,7 +44,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>pieces</parameter></term> + <term><parameter>array</parameter></term> <listitem> <para> Массив объединяемых строк. @@ -60,7 +59,7 @@ &reftitle.returnvalues; <para> Возвращает строку, содержащую строковое представление - всех элементов массива в указанном порядке, со строкой glue + всех элементов массива в указанном порядке, с разделителем между каждым элементом. </para> </refsect1> @@ -77,9 +76,16 @@ </thead> <tbody> <row> + <entry>8.0.0</entry> + <entry> + Передача <parameter>separator</parameter> после <parameter>array</parameter> + больше не поддерживается. + </entry> + </row> + <row> <entry>7.4.0</entry> <entry> - Передача <parameter>glue</parameter> после <parameter>pieces</parameter> + Передача <parameter>separator</parameter> после <parameter>array</parameter> (т.е. использование недокументированного порядка параметров) устарела. </entry> </row> @@ -129,7 +135,6 @@ var_dump(implode('hello', array())); // string(0) "" </refsect1> </refentry> - <!-- Keep this comment at the end of the file Local variables: mode: sgml diff --git a/reference/strings/functions/levenshtein.xml b/reference/strings/functions/levenshtein.xml index 142e55463..a79bf5035 100644 --- a/reference/strings/functions/levenshtein.xml +++ b/reference/strings/functions/levenshtein.xml @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: af4410a7e15898c3dbe83d6ea38246745ed9c6fb Maintainer: shein Status: ready --> +<!-- EN-Revision: 2a7c919451f9a536431ba2117f8f90ae814c1c5f Maintainer: shein Status: ready --> <!-- Reviewed: yes --> <!-- $Revision$ --> -<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.levenshtein" xmlns:xlink="http://www.w3.org/1999/xlink"> +<refentry xml:id="function.levenshtein" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>levenshtein</refname> <refpurpose>Вычисляет расстояние Левенштейна между двумя строками</refpurpose> @@ -12,37 +12,27 @@ &reftitle.description; <methodsynopsis> <type>int</type><methodname>levenshtein</methodname> - <methodparam><type>string</type><parameter>str1</parameter></methodparam> - <methodparam><type>string</type><parameter>str2</parameter></methodparam> - </methodsynopsis> - <methodsynopsis> - <type>int</type><methodname>levenshtein</methodname> - <methodparam><type>string</type><parameter>str1</parameter></methodparam> - <methodparam><type>string</type><parameter>str2</parameter></methodparam> - <methodparam><type>int</type><parameter>cost_ins</parameter></methodparam> - <methodparam><type>int</type><parameter>cost_rep</parameter></methodparam> - <methodparam><type>int</type><parameter>cost_del</parameter></methodparam> + <methodparam><type>string</type><parameter>string1</parameter></methodparam> + <methodparam><type>string</type><parameter>string2</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>insertion_cost</parameter><initializer>1</initializer></methodparam> + <methodparam choice="opt"><type>int</type><parameter>replacement_cost</parameter><initializer>1</initializer></methodparam> + <methodparam choice="opt"><type>int</type><parameter>deletion_cost</parameter><initializer>1</initializer></methodparam> </methodsynopsis> <para> Расстояние Левенштейна - это минимальное количество вставок, замен и удалений символов, необходимое для преобразования - <parameter>str1</parameter> в <parameter>str2</parameter>. + <parameter>string1</parameter> в <parameter>string2</parameter>. Сложность алгоритма равна <literal>O(m*n)</literal>, где <literal>n</literal> и <literal>m</literal> - длины строк - <parameter>str1</parameter> и <parameter>str2</parameter> (неплохо по - сравнению с <function>similar_text</function>, имеющей сложность O(max(n,m)**3), + <parameter>string1</parameter> и <parameter>string2</parameter> (неплохо по + сравнению с <function>similar_text</function>, имеющей сложность <literal>O(max(n,m)**3)</literal>, но всё же довольно много). </para> <para> - В простейшей форме функция принимает в качестве аргументов две строки - и возвращает минимальное количество вставок, замен и - удалений символов, необходимое для преобразования - <parameter>str1</parameter> в <parameter>str2</parameter>. - </para> - <para> - Второй вариант принимает три дополнительных аргумента, задающих - стоимость операций вставки, замены и удаления. Этот вариант - универсальнее первого, но не так эффективен. + Если <parameter>insertion_cost</parameter>, <parameter>replacement_cost</parameter> и/или <parameter>deletion_cost</parameter> не равны <literal>1</literal>, + алгоритм адаптируется для выбора самых дешёвых преобразований. + Например. если <code>$insertion_cost + $deletion_cost < $replacement_cost</code>, + замены не будут выполняться, вместо этого будут выполняться вставки и удаления. </para> </refsect1> @@ -51,7 +41,7 @@ <para> <variablelist> <varlistentry> - <term><parameter>str1</parameter></term> + <term><parameter>string1</parameter></term> <listitem> <para> Одна из строк, для которых вычисляется расстояние Левенштейна. @@ -59,7 +49,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>str2</parameter></term> + <term><parameter>string2</parameter></term> <listitem> <para> Одна из строк, для которых вычисляется расстояние Левенштейна. @@ -67,7 +57,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>cost_ins</parameter></term> + <term><parameter>insertion_cost</parameter></term> <listitem> <para> Определяет стоимость вставки. @@ -75,7 +65,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>cost_rep</parameter></term> + <term><parameter>replacement_cost</parameter></term> <listitem> <para> Определяет стоимость замены. @@ -83,7 +73,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>cost_del</parameter></term> + <term><parameter>deletion_cost</parameter></term> <listitem> <para> Определяет стоимость удаления. @@ -102,6 +92,29 @@ </para> </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>8.0.0</entry> + <entry> + До этой версии <function>levenshtein</function> нужно было вызывать + с двумя или пятью аргументами. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </refsect1> + <refsect1 role="examples"> &reftitle.examples; <para> @@ -179,7 +192,6 @@ if ($shortest == 0) { </refsect1> </refentry> - <!-- Keep this comment at the end of the file Local variables: mode: sgml
diff --git a/reference/strings/functions/implode.xml b/reference/strings/functions/implode.xml index dadb8bc83..f3bdca865 100644 --- a/reference/strings/functions/implode.xml +++ b/reference/strings/functions/implode.xml @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: e50c87114588f058084e4cca47b95ddbe4a3bb1c Maintainer: shein Status: ready --> +<!-- EN-Revision: 3c969c420f1232ac0946c70d3d6bb90d7f4e9c31 Maintainer: shein Status: ready --> <!-- Reviewed: yes --> <!-- $Revision$ --> -<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.implode"> +<refentry xml:id="function.implode" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>implode</refname> <refpurpose>Объединяет элементы массива в строку</refpurpose> @@ -12,24 +12,23 @@ &reftitle.description; <methodsynopsis> <type>string</type><methodname>implode</methodname> - <methodparam><type>string</type><parameter>glue</parameter></methodparam> - <methodparam><type>array</type><parameter>pieces</parameter></methodparam> + <methodparam><type>string</type><parameter>separator</parameter></methodparam> + <methodparam><type>array</type><parameter>array</parameter></methodparam> </methodsynopsis> + <simpara>Альтернативная сигнатура (не поддерживается с именованными аргументами):</simpara> <methodsynopsis> <type>string</type><methodname>implode</methodname> - <methodparam><type>array</type><parameter>pieces</parameter></methodparam> + <methodparam><type>array</type><parameter>array</parameter></methodparam> + </methodsynopsis> + <simpara>Устаревшая сигнатура (устарела с PHP 7.4.0, удалена в PHP 8.0.0):</simpara> + <methodsynopsis> + <type>string</type><methodname>implode</methodname> + <methodparam><type>array</type><parameter>array</parameter></methodparam> + <methodparam><type>string</type><parameter>separator</parameter></methodparam> </methodsynopsis> <para> - Объединяет элементы массива с помощью строки <parameter>glue</parameter>. + Объединяет элементы массива с помощью строки <parameter>separator</parameter>. </para> - <note> - <para> - По историческим причинам функции <function>implode</function> можно - передавать аргументы в любом порядке, однако для согласованности с - функцией <function>explode</function> <emphasis>не рекомендуется</emphasis> использовать - недокументированный порядок аргументов. - </para> - </note> </refsect1> <refsect1 role="parameters"> @@ -37,7 +36,7 @@ <para> <variablelist> <varlistentry> - <term><parameter>glue</parameter></term> + <term><parameter>separator</parameter></term> <listitem> <para> По умолчанию равен пустой строке. @@ -45,7 +44,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>pieces</parameter></term> + <term><parameter>array</parameter></term> <listitem> <para> Массив объединяемых строк. @@ -60,7 +59,7 @@ &reftitle.returnvalues; <para> Возвращает строку, содержащую строковое представление - всех элементов массива в указанном порядке, со строкой glue + всех элементов массива в указанном порядке, с разделителем между каждым элементом. </para> </refsect1> @@ -77,9 +76,16 @@ </thead> <tbody> <row> + <entry>8.0.0</entry> + <entry> + Передача <parameter>separator</parameter> после <parameter>array</parameter> + больше не поддерживается. + </entry> + </row> + <row> <entry>7.4.0</entry> <entry> - Передача <parameter>glue</parameter> после <parameter>pieces</parameter> + Передача <parameter>separator</parameter> после <parameter>array</parameter> (т.е. использование недокументированного порядка параметров) устарела. </entry> </row> @@ -129,7 +135,6 @@ var_dump(implode('hello', array())); // string(0) "" </refsect1> </refentry> - <!-- Keep this comment at the end of the file Local variables: mode: sgml diff --git a/reference/strings/functions/levenshtein.xml b/reference/strings/functions/levenshtein.xml index 142e55463..a79bf5035 100644 --- a/reference/strings/functions/levenshtein.xml +++ b/reference/strings/functions/levenshtein.xml @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: af4410a7e15898c3dbe83d6ea38246745ed9c6fb Maintainer: shein Status: ready --> +<!-- EN-Revision: 2a7c919451f9a536431ba2117f8f90ae814c1c5f Maintainer: shein Status: ready --> <!-- Reviewed: yes --> <!-- $Revision$ --> -<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.levenshtein" xmlns:xlink="http://www.w3.org/1999/xlink"> +<refentry xml:id="function.levenshtein" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>levenshtein</refname> <refpurpose>Вычисляет расстояние Левенштейна между двумя строками</refpurpose> @@ -12,37 +12,27 @@ &reftitle.description; <methodsynopsis> <type>int</type><methodname>levenshtein</methodname> - <methodparam><type>string</type><parameter>str1</parameter></methodparam> - <methodparam><type>string</type><parameter>str2</parameter></methodparam> - </methodsynopsis> - <methodsynopsis> - <type>int</type><methodname>levenshtein</methodname> - <methodparam><type>string</type><parameter>str1</parameter></methodparam> - <methodparam><type>string</type><parameter>str2</parameter></methodparam> - <methodparam><type>int</type><parameter>cost_ins</parameter></methodparam> - <methodparam><type>int</type><parameter>cost_rep</parameter></methodparam> - <methodparam><type>int</type><parameter>cost_del</parameter></methodparam> + <methodparam><type>string</type><parameter>string1</parameter></methodparam> + <methodparam><type>string</type><parameter>string2</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>insertion_cost</parameter><initializer>1</initializer></methodparam> + <methodparam choice="opt"><type>int</type><parameter>replacement_cost</parameter><initializer>1</initializer></methodparam> + <methodparam choice="opt"><type>int</type><parameter>deletion_cost</parameter><initializer>1</initializer></methodparam> </methodsynopsis> <para> Расстояние Левенштейна - это минимальное количество вставок, замен и удалений символов, необходимое для преобразования - <parameter>str1</parameter> в <parameter>str2</parameter>. + <parameter>string1</parameter> в <parameter>string2</parameter>. Сложность алгоритма равна <literal>O(m*n)</literal>, где <literal>n</literal> и <literal>m</literal> - длины строк - <parameter>str1</parameter> и <parameter>str2</parameter> (неплохо по - сравнению с <function>similar_text</function>, имеющей сложность O(max(n,m)**3), + <parameter>string1</parameter> и <parameter>string2</parameter> (неплохо по + сравнению с <function>similar_text</function>, имеющей сложность <literal>O(max(n,m)**3)</literal>, но всё же довольно много). </para> <para> - В простейшей форме функция принимает в качестве аргументов две строки - и возвращает минимальное количество вставок, замен и - удалений символов, необходимое для преобразования - <parameter>str1</parameter> в <parameter>str2</parameter>. - </para> - <para> - Второй вариант принимает три дополнительных аргумента, задающих - стоимость операций вставки, замены и удаления. Этот вариант - универсальнее первого, но не так эффективен. + Если <parameter>insertion_cost</parameter>, <parameter>replacement_cost</parameter> и/или <parameter>deletion_cost</parameter> не равны <literal>1</literal>, + алгоритм адаптируется для выбора самых дешёвых преобразований. + Например. если <code>$insertion_cost + $deletion_cost < $replacement_cost</code>, + замены не будут выполняться, вместо этого будут выполняться вставки и удаления. </para> </refsect1> @@ -51,7 +41,7 @@ <para> <variablelist> <varlistentry> - <term><parameter>str1</parameter></term> + <term><parameter>string1</parameter></term> <listitem> <para> Одна из строк, для которых вычисляется расстояние Левенштейна. @@ -59,7 +49,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>str2</parameter></term> + <term><parameter>string2</parameter></term> <listitem> <para> Одна из строк, для которых вычисляется расстояние Левенштейна. @@ -67,7 +57,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>cost_ins</parameter></term> + <term><parameter>insertion_cost</parameter></term> <listitem> <para> Определяет стоимость вставки. @@ -75,7 +65,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>cost_rep</parameter></term> + <term><parameter>replacement_cost</parameter></term> <listitem> <para> Определяет стоимость замены. @@ -83,7 +73,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>cost_del</parameter></term> + <term><parameter>deletion_cost</parameter></term> <listitem> <para> Определяет стоимость удаления. @@ -102,6 +92,29 @@ </para> </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>8.0.0</entry> + <entry> + До этой версии <function>levenshtein</function> нужно было вызывать + с двумя или пятью аргументами. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </refsect1> + <refsect1 role="examples"> &reftitle.examples; <para> @@ -179,7 +192,6 @@ if ($shortest == 0) { </refsect1> </refentry> - <!-- Keep this comment at the end of the file Local variables: mode: sgml