svn: /phpdoc/ru/trunk/reference/iconv/functions/ iconv-get-encoding.xml iconv-mime-decode-headers.xml iconv-mime-decode.xml iconv-mime-encode.xml iconv-set-encoding.xml iconv-strlen.xml iconv-strpos.xml iconv-strrpos.xml iconv-substr.xml iconv.xml

Modified: phpdoc/ru/trunk/reference/iconv/functions/iconv-get-encoding.xml
===================================================================
--- phpdoc/ru/trunk/reference/iconv/functions/iconv-get-encoding.xml	2020-11-23 08:51:12 UTC (rev 351530)
+++ phpdoc/ru/trunk/reference/iconv/functions/iconv-get-encoding.xml	2020-11-23 09:07:46 UTC (rev 351531)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 297028 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 351503 Maintainer: shein Status: ready -->
 <!-- Reviewed: yes -->
 <!-- $Revision$ -->
 <refentry xml:id="function.iconv-get-encoding" xmlns="http://docbook.org/ns/docbook">
@@ -11,7 +11,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>mixed</type><methodname>iconv_get_encoding</methodname>
+   <type class="union"><type>array</type><type>string</type><type>false</type></type><methodname>iconv_get_encoding</methodname>
    <methodparam choice="opt"><type>string</type><parameter>type</parameter><initializer>"all"</initializer></methodparam>
   </methodsynopsis>
   <para>
@@ -98,7 +98,6 @@
  </refsect1>

 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

Modified: phpdoc/ru/trunk/reference/iconv/functions/iconv-mime-decode-headers.xml
===================================================================
--- phpdoc/ru/trunk/reference/iconv/functions/iconv-mime-decode-headers.xml	2020-11-23 08:51:12 UTC (rev 351530)
+++ phpdoc/ru/trunk/reference/iconv/functions/iconv-mime-decode-headers.xml	2020-11-23 09:07:46 UTC (rev 351531)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 334762 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 351503 Maintainer: shein Status: ready -->
 <!-- Reviewed: no -->
 <!-- $Revision$ -->
 <refentry xml:id="function.iconv-mime-decode-headers" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -11,10 +11,10 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>array</type><methodname>iconv_mime_decode_headers</methodname>
-   <methodparam><type>string</type><parameter>encoded_headers</parameter></methodparam>
+   <type class="union"><type>array</type><type>false</type></type><methodname>iconv_mime_decode_headers</methodname>
+   <methodparam><type>string</type><parameter>headers</parameter></methodparam>
    <methodparam choice="opt"><type>int</type><parameter>mode</parameter><initializer>0</initializer></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>charset</parameter><initializer>ini_get("iconv.internal_encoding")</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>encoding</parameter><initializer>&null;</initializer></methodparam>
   </methodsynopsis>
   <para>
    Декодирует несколько полей заголовка <literal>MIME</literal> за один раз.
@@ -26,7 +26,7 @@
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter>encoded_headers</parameter></term>
+     <term><parameter>headers</parameter></term>
      <listitem>
       <para>
        Закодированные заголовки в виде строки.
@@ -79,10 +79,10 @@
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>charset</parameter></term>
+     <term><parameter>encoding</parameter></term>
      <listitem>
       <para>
-       Необязательный параметр <parameter>charset</parameter> указывает
+       Необязательный параметр <parameter>encoding</parameter> указывает
        кодировку, в которой будет представлен результат. Если опущен,
        будет использовано значение директивы
        <link linkend="iconv.configuration">iconv.internal_encoding</link>.
@@ -98,7 +98,7 @@
   <para>
    В случае успеха возвращает ассоциативный массив с полями
    <literal>MIME</literal>-заголовков, указанных параметром
-   <parameter>encoded_headers</parameter>, или &false; в случае ошибки.
+   <parameter>headers</parameter>, или &false; в случае ошибки.
   </para>
   <para>
    Каждый ключ элемента возвращаемого массива представляет собой
@@ -109,6 +109,28 @@
    в порядке их обработки.
   </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>
+       <parameter>encoding</parameter> теперь допускает значение null.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>

  <refsect1 role="examples">
   &reftitle.examples;
@@ -172,7 +194,6 @@
  </refsect1>

 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

Modified: phpdoc/ru/trunk/reference/iconv/functions/iconv-mime-decode.xml
===================================================================
--- phpdoc/ru/trunk/reference/iconv/functions/iconv-mime-decode.xml	2020-11-23 08:51:12 UTC (rev 351530)
+++ phpdoc/ru/trunk/reference/iconv/functions/iconv-mime-decode.xml	2020-11-23 09:07:46 UTC (rev 351531)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 334762 Maintainer: tmn Status: ready -->
+<!-- EN-Revision: 351503 Maintainer: tmn Status: ready -->
 <!-- Reviewed: yes Maintainer: sergey -->
 <!-- $Revision$ -->
 <refentry xml:id="function.iconv-mime-decode" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -11,10 +11,10 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>string</type><methodname>iconv_mime_decode</methodname>
-   <methodparam><type>string</type><parameter>encoded_header</parameter></methodparam>
+   <type class="union"><type>string</type><type>false</type></type><methodname>iconv_mime_decode</methodname>
+   <methodparam><type>string</type><parameter>string</parameter></methodparam>
    <methodparam choice="opt"><type>int</type><parameter>mode</parameter><initializer>0</initializer></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>charset</parameter><initializer>ini_get("iconv.internal_encoding")</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>encoding</parameter><initializer>&null;</initializer></methodparam>
   </methodsynopsis>
   <para>
    Декодирует поле <literal>MIME</literal>-заголовка.
@@ -26,7 +26,7 @@
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter>encoded_header</parameter></term>
+     <term><parameter>string</parameter></term>
      <listitem>
       <para>
        Закодированный заголовок в виде строки.
@@ -79,10 +79,10 @@
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>charset</parameter></term>
+     <term><parameter>encoding</parameter></term>
      <listitem>
       <para>
-       Необязательный аргумент <parameter>charset</parameter> задает набор символов,
+       Необязательный аргумент <parameter>encoding</parameter> задает набор символов,
        в котором будет представлен результат. Если аргумент опущен, будет
        использоваться <link
        linkend="iconv.configuration">iconv.internal_encoding</link>.
@@ -100,6 +100,28 @@
    или &false; в случае возникновения ошибки.
   </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>
+       <parameter>encoding</parameter> теперь допускает значение null.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>

  <refsect1 role="examples">
   &reftitle.examples;
@@ -133,7 +155,6 @@
  </refsect1>

 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

Modified: phpdoc/ru/trunk/reference/iconv/functions/iconv-mime-encode.xml
===================================================================
--- phpdoc/ru/trunk/reference/iconv/functions/iconv-mime-encode.xml	2020-11-23 08:51:12 UTC (rev 351530)
+++ phpdoc/ru/trunk/reference/iconv/functions/iconv-mime-encode.xml	2020-11-23 09:07:46 UTC (rev 351531)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 351133 Maintainer: tmn Status: ready -->
+<!-- EN-Revision: 351503 Maintainer: tmn Status: ready -->
 <!-- Reviewed: no -->
 <!-- $Revision$ -->
 <refentry xml:id="function.iconv-mime-encode" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -11,10 +11,10 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>string</type><methodname>iconv_mime_encode</methodname>
+   <type class="union"><type>string</type><type>false</type></type><methodname>iconv_mime_encode</methodname>
    <methodparam><type>string</type><parameter>field_name</parameter></methodparam>
    <methodparam><type>string</type><parameter>field_value</parameter></methodparam>
-   <methodparam choice="opt"><type>array</type><parameter>preferences</parameter><initializer>&null;</initializer></methodparam>
+   <methodparam choice="opt"><type>array</type><parameter>options</parameter><initializer>[]</initializer></methodparam>
   </methodsynopsis>
   <para>
    Создает и возвращает корректное поле <literal>MIME</literal>-заголовка в виде строки вида:
@@ -49,13 +49,13 @@
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>preferences</parameter></term>
+     <term><parameter>options</parameter></term>
      <listitem>
       <para>
        Есть возможность контролировать поведение функции
        <function>iconv_mime_encode</function> посредством передачи массива с
        настройками в качестве третьего аргумента
-       <parameter>preferences</parameter>. Возможные значения этого массива,
+       <parameter>options</parameter>. Возможные значения этого массива,
        поддерживаемые функцией <function>iconv_mime_encode</function>,
        перечислены ниже. Обратите внимание, что имена элементов чувствительны
        к регистру символов.
@@ -199,7 +199,6 @@
  </refsect1>

 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

Modified: phpdoc/ru/trunk/reference/iconv/functions/iconv-set-encoding.xml
===================================================================
--- phpdoc/ru/trunk/reference/iconv/functions/iconv-set-encoding.xml	2020-11-23 08:51:12 UTC (rev 351530)
+++ phpdoc/ru/trunk/reference/iconv/functions/iconv-set-encoding.xml	2020-11-23 09:07:46 UTC (rev 351531)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 323195 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 351503 Maintainer: shein Status: ready -->
 <!-- $Revision$ -->
 <!-- Reviewed: no -->
 <refentry xml:id="function.iconv-set-encoding" xmlns="http://docbook.org/ns/docbook">
@@ -13,11 +13,11 @@
   <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>
+   <methodparam><type>string</type><parameter>encoding</parameter></methodparam>
   </methodsynopsis>
   <para>
    Изменяет значение указанной параметром <parameter>type</parameter>
-   внутренней переменной конфигурации на <parameter>charset</parameter>.
+   внутренней переменной конфигурации на <parameter>encoding</parameter>.
   </para>
  </refsect1>

@@ -39,7 +39,7 @@
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>charset</parameter></term>
+     <term><parameter>encoding</parameter></term>
      <listitem>
       <para>
        Набор символов.
@@ -85,7 +85,6 @@
  </refsect1>

 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

Modified: phpdoc/ru/trunk/reference/iconv/functions/iconv-strlen.xml
===================================================================
--- phpdoc/ru/trunk/reference/iconv/functions/iconv-strlen.xml	2020-11-23 08:51:12 UTC (rev 351530)
+++ phpdoc/ru/trunk/reference/iconv/functions/iconv-strlen.xml	2020-11-23 09:07:46 UTC (rev 351531)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 334762 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 351503 Maintainer: shein Status: ready -->
 <!-- Reviewed: yes -->
 <!-- $Revision$ -->
 <refentry xml:id="function.iconv-strlen" xmlns="http://docbook.org/ns/docbook">
@@ -11,14 +11,14 @@
  <refsect1 role="description">
   &reftitle.description;
   <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><initializer>ini_get("iconv.internal_encoding")</initializer></methodparam>
+   <type class="union"><type>int</type><type>false</type></type><methodname>iconv_strlen</methodname>
+   <methodparam><type>string</type><parameter>string</parameter></methodparam>
+   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>encoding</parameter><initializer>&null;</initializer></methodparam>
   </methodsynopsis>
   <para>
    В отличие от <function>strlen</function>,
    <function>iconv_strlen</function> учитывает кодировку строки.
-   Длина строки не обязательно будет соответствовать количеству байт в ней,
+   Длина <parameter>string</parameter> не обязательно будет соответствовать количеству байт в ней,
    так как в различных кодировках различные символы кодируются различным количеством байт,
    например, юникод может быть и двух-, и четырёхбайтным.
   </para>
@@ -29,7 +29,7 @@
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter>str</parameter></term>
+     <term><parameter>string</parameter></term>
      <listitem>
       <para>
        Строка.
@@ -37,11 +37,11 @@
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>charset</parameter></term>
+     <term><parameter>encoding</parameter></term>
      <listitem>
       <para>
-       Если параметр <parameter>charset</parameter> опущен, предполагается, что кодировка строки
-       <parameter>str</parameter> эквивалентна значению
+       Если параметр <parameter>encoding</parameter> опущен, предполагается, что кодировка строки
+       <parameter>string</parameter> эквивалентна значению
        <link linkend="iconv.configuration">iconv.internal_encoding</link>.
       </para>
      </listitem>
@@ -53,9 +53,32 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Возвращает количество символов в <parameter>str</parameter> как целое число.
+   Возвращает количество символов в <parameter>string</parameter> как целое число или
+   &false; в случае возникновения ошибки при кодировании.
   </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>
+       <parameter>encoding</parameter> теперь допускает значение null.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>

  <refsect1 role="seealso">
   &reftitle.seealso;
@@ -69,7 +92,6 @@
  </refsect1>

 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

Modified: phpdoc/ru/trunk/reference/iconv/functions/iconv-strpos.xml
===================================================================
--- phpdoc/ru/trunk/reference/iconv/functions/iconv-strpos.xml	2020-11-23 08:51:12 UTC (rev 351530)
+++ phpdoc/ru/trunk/reference/iconv/functions/iconv-strpos.xml	2020-11-23 09:07:46 UTC (rev 351531)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 340032 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 351503 Maintainer: shein Status: ready -->
 <!-- Reviewed: no -->
 <!-- $Revision$ -->
 <refentry xml:id="function.iconv-strpos" xmlns="http://docbook.org/ns/docbook">
@@ -11,11 +11,11 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>int</type><methodname>iconv_strpos</methodname>
+   <type class="union"><type>int</type><type>false</type></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><initializer>0</initializer></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>charset</parameter><initializer>ini_get("iconv.internal_encoding")</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>encoding</parameter><initializer>&null;</initializer></methodparam>
   </methodsynopsis>
   <para>
    Возвращает позицию первого вхождения подстроки
@@ -25,7 +25,7 @@
    В отличие от <function>strpos</function>, <function>iconv_strpos</function>
    возвращает смещение перед искомой строкой в символах, а не
    в байтах. Количество символов трактуется в зависимости от указанной
-   параметром <parameter>charset</parameter> кодировки.
+   параметром <parameter>encoding</parameter> кодировки.
   </para>
  </refsect1>

@@ -61,10 +61,10 @@
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>charset</parameter></term>
+     <term><parameter>encoding</parameter></term>
      <listitem>
       <para>
-       Если параметр <parameter>charset</parameter> не указан,
+       Если параметр <parameter>encoding</parameter> не указан,
        то подразумевается, что <parameter>string</parameter>
        имеет кодировку <link linkend="iconv.configuration">iconv.internal_encoding</link>.
       </para>
@@ -104,6 +104,12 @@
     </thead>
     <tbody>
      <row>
+      <entry>8.0.0</entry>
+      <entry>
+       <parameter>encoding</parameter> теперь допускает значение null.
+      </entry>
+     </row>
+     <row>
       <entry>7.1.0</entry>
       <entry>
        Поддержка отрицательных значений <parameter>offset</parameter>.
@@ -126,7 +132,6 @@
  </refsect1>

 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

Modified: phpdoc/ru/trunk/reference/iconv/functions/iconv-strrpos.xml
===================================================================
--- phpdoc/ru/trunk/reference/iconv/functions/iconv-strrpos.xml	2020-11-23 08:51:12 UTC (rev 351530)
+++ phpdoc/ru/trunk/reference/iconv/functions/iconv-strrpos.xml	2020-11-23 09:07:46 UTC (rev 351531)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 334762 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 351503 Maintainer: shein Status: ready -->
 <!-- Reviewed: no -->
 <!-- $Revision$ -->
 <refentry xml:id="function.iconv-strrpos" xmlns="http://docbook.org/ns/docbook">
@@ -11,10 +11,10 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>int</type><methodname>iconv_strrpos</methodname>
+   <type class="union"><type>int</type><type>false</type></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><initializer>ini_get("iconv.internal_encoding")</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>encoding</parameter><initializer>&null;</initializer></methodparam>
   </methodsynopsis>
   <para>
    Находит последнюю позицию подстроки <parameter>needle</parameter>
@@ -24,7 +24,7 @@
    В отличие от <function>strrpos</function>, <function>iconv_strrpos</function>
    возвращает смещение перед искомой строкой в символах, а не
    в байтах. Количество символов трактуется в зависимости от указанной
-   параметром <parameter>charset</parameter> кодировки.
+   параметром <parameter>encoding</parameter> кодировки.
   </para>
  </refsect1>

@@ -49,10 +49,10 @@
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>charset</parameter></term>
+     <term><parameter>encoding</parameter></term>
      <listitem>
       <para>
-       Если параметр <parameter>charset</parameter> не указан,
+       Если параметр <parameter>encoding</parameter> не указан,
        то подразумевается, что <parameter>string</parameter>
        имеет кодировку <link linkend="iconv.configuration">iconv.internal_encoding</link>.
       </para>
@@ -79,6 +79,28 @@
   </para>
   &return.falseproblem;
  </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>
+       <parameter>encoding</parameter> теперь допускает значение null.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>

  <refsect1 role="seealso">
   &reftitle.seealso;
@@ -92,7 +114,6 @@
  </refsect1>

 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

Modified: phpdoc/ru/trunk/reference/iconv/functions/iconv-substr.xml
===================================================================
--- phpdoc/ru/trunk/reference/iconv/functions/iconv-substr.xml	2020-11-23 08:51:12 UTC (rev 351530)
+++ phpdoc/ru/trunk/reference/iconv/functions/iconv-substr.xml	2020-11-23 09:07:46 UTC (rev 351531)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 341328 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 351503 Maintainer: shein Status: ready -->
 <!-- Reviewed: yes -->
 <!-- $Revision$ -->
 <refentry xml:id="function.iconv-substr" xmlns="http://docbook.org/ns/docbook">
@@ -11,14 +11,14 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>string</type><methodname>iconv_substr</methodname>
-   <methodparam><type>string</type><parameter>str</parameter></methodparam>
+   <type class="union"><type>string</type><type>false</type></type><methodname>iconv_substr</methodname>
+   <methodparam><type>string</type><parameter>string</parameter></methodparam>
    <methodparam><type>int</type><parameter>offset</parameter></methodparam>
-   <methodparam choice="opt"><type>int</type><parameter>length</parameter><initializer>iconv_strlen($str, $charset)</initializer></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>charset</parameter><initializer>ini_get("iconv.internal_encoding")</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>length</parameter><initializer>&null;</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>encoding</parameter><initializer>&null;</initializer></methodparam>
   </methodsynopsis>
   <para>
-   Получает часть строки <parameter>str</parameter>, определенную
+   Получает часть строки <parameter>string</parameter>, определенную
    параметрами <parameter>offset</parameter> и <parameter>length</parameter>.
   </para>
  </refsect1>
@@ -28,7 +28,7 @@
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter>str</parameter></term>
+     <term><parameter>string</parameter></term>
      <listitem>
       <para>
        Изначальная строка.
@@ -41,7 +41,7 @@
       <para>
        Если <parameter>offset</parameter> неотрицателен,
        <function>iconv_substr</function> получает часть строки
-       <parameter>str</parameter> начиная с символа с порядковым номером
+       <parameter>string</parameter> начиная с символа с порядковым номером
        <parameter>offset</parameter> (нумерация начинается с нуля).
       </para>
       <para>
@@ -48,7 +48,7 @@
        Если <parameter>offset</parameter> отрицателен,
        <function>iconv_substr</function> получает часть строки
        начиная с позиции, отстоящую от конца строки
-       <parameter>str</parameter> на <parameter>offset</parameter>
+       <parameter>string</parameter> на <parameter>offset</parameter>
        символов.
       </para>
      </listitem>
@@ -65,7 +65,7 @@
       <para>
        Если указан отрицательный <parameter>length</parameter>,
        <function>iconv_substr</function> получает часть строки
-       <parameter>str</parameter>, начиная с <parameter>offset</parameter>
+       <parameter>string</parameter>, начиная с <parameter>offset</parameter>
        символа и до символа, отстоящего от конца строки на
        <parameter>length</parameter> символов.
        В случае, если <parameter>offset</parameter> также отрицателен,
@@ -75,10 +75,10 @@
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>charset</parameter></term>
+     <term><parameter>encoding</parameter></term>
      <listitem>
       <para>
-       Если параметр <parameter>charset</parameter> не указан,
+       Если параметр <parameter>encoding</parameter> не указан,
        предполагается, что строка <parameter>string</parameter>
        имеет кодировку
        <link linkend="iconv.configuration">iconv.internal_encoding</link>.
@@ -86,7 +86,7 @@
       <para>
        Обратите внимание, что и <parameter>offset</parameter>,
        и <parameter>length</parameter> основываются на размере символа,
-       рассчитанного исходя из кодировки текста,
+       рассчитанного исходя из кодировки текста (<parameter>encoding</parameter>),
        в то время как схожая функция <function>substr</function>
        всегда рассматривает их побайтовое смещение.
       </para>
@@ -99,14 +99,14 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Возвращает часть строки <parameter>str</parameter>, определенную
+   Возвращает часть строки <parameter>string</parameter>, определенную
    параметрами <parameter>offset</parameter> и <parameter>length</parameter>.
   </para>
   <para>
-   Если строка <parameter>str</parameter> имеет меньшую длину, чем
+   Если строка <parameter>string</parameter> имеет меньшую длину, чем
    параметр <parameter>offset</parameter>, будет возвращено
    &false;.
-   Если <parameter>str</parameter> имеет длину равную <parameter>offset</parameter>,
+   Если <parameter>string</parameter> имеет длину равную <parameter>offset</parameter>,
    будет возвращена пустая строка.
   </para>
  </refsect1>
@@ -124,9 +124,15 @@
       </thead>
       <tbody>
        <row>
+      <entry>8.0.0</entry>
+      <entry>
+       <parameter>length</parameter> и <parameter>encoding</parameter> теперь допускают значение null.
+      </entry>
+     </row>
+       <row>
         <entry>7.0.11</entry>
         <entry>
-         Если <parameter>str</parameter> имеет длину равную <parameter>offset</parameter>,
+         Если <parameter>string</parameter> имеет длину равную <parameter>offset</parameter>,
          будет возвращена пустая строка. Ранее в подобных случаех возвращалось &false;.
         </entry>
        </row>
@@ -148,7 +154,6 @@
  </refsect1>

 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

Modified: phpdoc/ru/trunk/reference/iconv/functions/iconv.xml
===================================================================
--- phpdoc/ru/trunk/reference/iconv/functions/iconv.xml	2020-11-23 08:51:12 UTC (rev 351530)
+++ phpdoc/ru/trunk/reference/iconv/functions/iconv.xml	2020-11-23 09:07:46 UTC (rev 351531)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 351135 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 351503 Maintainer: shein Status: ready -->
 <!-- Reviewed: yes Maintainer: lex -->
 <!-- $Revision$ -->
 <refentry xml:id="function.iconv" xmlns="http://docbook.org/ns/docbook">
@@ -12,14 +12,14 @@
   &reftitle.description;
   <methodsynopsis>
    <type class="union"><type>string</type><type>false</type></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>
+   <methodparam><type>string</type><parameter>from_encoding</parameter></methodparam>
+   <methodparam><type>string</type><parameter>to_encoding</parameter></methodparam>
+   <methodparam><type>string</type><parameter>string</parameter></methodparam>
   </methodsynopsis>
   <para>
    Преобразует набор символов строки
-   <parameter>str</parameter> из кодировки <parameter>in_charset</parameter>
-   в <parameter>out_charset</parameter>.
+   <parameter>string</parameter> из кодировки <parameter>from_encoding</parameter>
+   в <parameter>to_encoding</parameter>.
   </para>
  </refsect1>

@@ -28,7 +28,7 @@
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter>in_charset</parameter></term>
+     <term><parameter>from_encoding</parameter></term>
      <listitem>
       <para>
        Кодировка входной строки.
@@ -36,13 +36,13 @@
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>out_charset</parameter></term>
+     <term><parameter>to_encoding</parameter></term>
      <listitem>
       <para>
        Требуемая на выходе кодировка.
       </para>
       <para>
-       Если добавить к <parameter>out_charset</parameter>
+       Если добавить к <parameter>to_encoding</parameter>
        строку <literal>//TRANSLIT</literal>, включается режим
        транслитерации. Это значит, что в случае, если символ
        не может быть представлен в требуемой кодировке,
@@ -61,13 +61,13 @@
         системной реализации iconv() (<constant>ICONV_IMPL</constant>).
         Известны некоторые реализации, которые просто игнорируют
         <literal>//TRANSLIT</literal>, так что конвертация для символов некорректных
-        для <parameter>out_charset</parameter> скорее всего закончится ошибкой.
+        для <parameter>to_encoding</parameter> скорее всего закончится ошибкой.
        </para>
       </caution>
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>str</parameter></term>
+     <term><parameter>string</parameter></term>
      <listitem>
       <para>
        Строка, которую необходимо преобразовать.
@@ -118,7 +118,6 @@
  </refsect1>

 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml