svn: /phpdoc/ru/trunk/reference/strings/functions/ strcspn.xml strip-tags.xml stripcslashes.xml stripos.xml stripslashes.xml stristr.xml strnatcasecmp.xml strnatcmp.xml strpbrk.xml strpos.xml strrchr.xml strripos.xml strrpos.xml strspn.xml strstr.xml
[email protected] (Sergey Panteleev) Sun, 06 Dec 2020 12:45:05 +0000
| Newsgroups | php.doc.ru |
|---|---|
| Message-ID | <[email protected]> |
sergey Sun, 06 Dec 2020 12:45:05 +0000
Revision: http://svn.php.net/viewvc?view=revision&revision=351923
Log:
docs(ru): Updated to English revision
Changed paths:
U phpdoc/ru/trunk/reference/strings/functions/strcspn.xml
U phpdoc/ru/trunk/reference/strings/functions/strip-tags.xml
U phpdoc/ru/trunk/reference/strings/functions/stripcslashes.xml
U phpdoc/ru/trunk/reference/strings/functions/stripos.xml
U phpdoc/ru/trunk/reference/strings/functions/stripslashes.xml
U phpdoc/ru/trunk/reference/strings/functions/stristr.xml
U phpdoc/ru/trunk/reference/strings/functions/strnatcasecmp.xml
U phpdoc/ru/trunk/reference/strings/functions/strnatcmp.xml
U phpdoc/ru/trunk/reference/strings/functions/strpbrk.xml
U phpdoc/ru/trunk/reference/strings/functions/strpos.xml
U phpdoc/ru/trunk/reference/strings/functions/strrchr.xml
U phpdoc/ru/trunk/reference/strings/functions/strripos.xml
U phpdoc/ru/trunk/reference/strings/functions/strrpos.xml
U phpdoc/ru/trunk/reference/strings/functions/strspn.xml
U phpdoc/ru/trunk/reference/strings/functions/strstr.xml
svn-diffs-351923.txt
(text/x-diff, 49.2 KB)
Modified: phpdoc/ru/trunk/reference/strings/functions/strcspn.xml
===================================================================
--- phpdoc/ru/trunk/reference/strings/functions/strcspn.xml 2020-12-06 08:25:21 UTC (rev 351922)
+++ phpdoc/ru/trunk/reference/strings/functions/strcspn.xml 2020-12-06 12:45:05 UTC (rev 351923)
@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 338016 Maintainer: kyaniv Status: ready -->
+<!-- EN-Revision: 351904 Maintainer: kyaniv Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strcspn">
+<refentry xml:id="function.strcspn" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>strcspn</refname>
<refpurpose>Возвращает длину участка в начале строки, не соответствующего маске</refpurpose>
@@ -12,22 +12,22 @@
&reftitle.description;
<methodsynopsis>
<type>int</type><methodname>strcspn</methodname>
- <methodparam><type>string</type><parameter>subject</parameter></methodparam>
- <methodparam><type>string</type><parameter>mask</parameter></methodparam>
- <methodparam choice="opt"><type>int</type><parameter>start</parameter></methodparam>
- <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam>
+ <methodparam><type>string</type><parameter>string</parameter></methodparam>
+ <methodparam><type>string</type><parameter>characters</parameter></methodparam>
+ <methodparam choice="opt"><type>int</type><parameter>offset</parameter><initializer>0</initializer></methodparam>
+ <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>length</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
- Возвращает длину участка в начале строки <parameter>subject</parameter>, который
+ Возвращает длину участка в начале строки <parameter>string</parameter>, который
<emphasis>не содержит</emphasis> ни одного символа из строки
- <parameter>mask</parameter>.
+ <parameter>characters</parameter>.
</para>
<para>
- Если параметры <parameter>start</parameter> и <parameter>length</parameter>
- не указаны, то все содержимое <parameter>subject</parameter> будет исследовано.
+ Если параметры <parameter>offset</parameter> и <parameter>length</parameter>
+ не указаны, то все содержимое <parameter>string</parameter> будет исследовано.
Если же эти параметры указаны, то эффект будет таким же, как при вызове
<literal>strcspn(substr($subject, $start, $length), $mask)</literal>
- (см. <xref linkend="function.substr" /> для дополнительной информации).
+ (см. <xref linkend="function.substr"/> для дополнительной информации).
</para>
</refsect1>
@@ -36,7 +36,7 @@
<para>
<variablelist>
<varlistentry>
- <term><parameter>subject</parameter></term>
+ <term><parameter>string</parameter></term>
<listitem>
<para>
Строка для исследования.
@@ -44,7 +44,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><parameter>mask</parameter></term>
+ <term><parameter>characters</parameter></term>
<listitem>
<para>
Строка, содержащая каждый из запрещенных символов.
@@ -52,24 +52,24 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><parameter>start</parameter></term>
+ <term><parameter>offset</parameter></term>
<listitem>
<para>
- Позиция в строке <parameter>subject</parameter>, с которой начинается поиск.
+ Позиция в строке <parameter>string</parameter>, с которой начинается поиск.
</para>
<para>
- Если <parameter>start</parameter> указан и не является отрицательным значением,
+ Если <parameter>offset</parameter> указан и не является отрицательным значением,
тогда <function>strcspn</function> начнет обследование строки
- <parameter>subject</parameter> с позиции, указанной в <parameter>start</parameter>.
+ <parameter>string</parameter> с позиции, указанной в <parameter>offset</parameter>.
Например: в строке '<literal>abcdef</literal>', символ в позиции <literal>0</literal> это
'<literal>a</literal>', символ в позиции <literal>2</literal> это '<literal>c</literal>',
и так далее.
</para>
<para>
- Если <parameter>start</parameter> указан, но является отрицательным числом,
+ Если <parameter>offset</parameter> указан, но является отрицательным числом,
то <function>strspn</function> начнет обследование строки
- <parameter>subject</parameter> с позиции, указанной в параметре
- <parameter>start</parameter>, начиная с конца строки <parameter>subject</parameter>.
+ <parameter>string</parameter> с позиции, указанной в параметре
+ <parameter>offset</parameter>, начиная с конца строки <parameter>string</parameter>.
</para>
</listitem>
</varlistentry>
@@ -77,13 +77,13 @@
<term><parameter>length</parameter></term>
<listitem>
<para>
- Длина фрагмента из <parameter>subject</parameter> для обследования.
+ Длина фрагмента из <parameter>string</parameter> для обследования.
</para>
<para>
Если параметр <parameter>length</parameter> указан
и не является отрицательным значением, тогда
будет обследовано <parameter>length</parameter>
- символов из <parameter>subject</parameter>, отсчитывая от
+ символов из <parameter>string</parameter>, отсчитывая от
стартовой позиции.
</para>
<para>
@@ -90,7 +90,7 @@
Если <parameter>length</parameter> передан и значение отрицательное,
то будут проверяться символы, начиная со стартовой позиции и до
<parameter>length</parameter>
- с конца <parameter>subject</parameter>.
+ с конца <parameter>string</parameter>.
</para>
</listitem>
</varlistentry>
@@ -101,17 +101,39 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
- Возвращает длину начального фрагмента строки <parameter>subject</parameter>, которая
- состоит полностью из символов, <emphasis>не</emphasis> включенных в параметр <parameter>mask</parameter>.
+ Возвращает длину начального фрагмента строки <parameter>string</parameter>, которая
+ состоит полностью из символов, <emphasis>не</emphasis> включенных в параметр <parameter>characters</parameter>.
</para>
<note>
<para>
- Когда параметр <parameter>start</parameter> указан, возвращаемая длина определяется,
- начиная с этой позиции, а не с начала строки <parameter>subject</parameter>.
+ Когда параметр <parameter>offset</parameter> указан, возвращаемая длина определяется,
+ начиная с этой позиции, а не с начала строки <parameter>string</parameter>.
</para>
</note>
</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>length</parameter> теперь допускает значение null.
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </refsect1>
<refsect1 role="examples">
&reftitle.examples;
@@ -165,7 +187,6 @@
</refsect1>
</refentry>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/ru/trunk/reference/strings/functions/strip-tags.xml
===================================================================
--- phpdoc/ru/trunk/reference/strings/functions/strip-tags.xml 2020-12-06 08:25:21 UTC (rev 351922)
+++ phpdoc/ru/trunk/reference/strings/functions/strip-tags.xml 2020-12-06 12:45:05 UTC (rev 351923)
@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 350655 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 351904 Maintainer: shein Status: ready -->
<!-- Reviewed: yes Maintainer: sergey -->
<!-- $Revision$ -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strip-tags">
+<refentry xml:id="function.strip-tags" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>strip_tags</refname>
<refpurpose>Удаляет теги HTML и PHP из строки</refpurpose>
@@ -12,12 +12,12 @@
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>strip_tags</methodname>
- <methodparam><type>string</type><parameter>str</parameter></methodparam>
- <methodparam choice="opt"><type>mixed</type><parameter>allowable_tags</parameter></methodparam>
+ <methodparam><type>string</type><parameter>string</parameter></methodparam>
+ <methodparam choice="opt"><type class="union"><type>array</type><type>string</type><type>null</type></type><parameter>allowed_tags</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
- функция пытается возвратить строку, из которой
- удалены все NULL-байты, HTML- и PHP-теги. Для удаления тегов используется тот же механизм,
+ Функция пытается возвратить строку, из которой
+ удалены все NULL-байты, HTML- и PHP-теги из заданной строки (<parameter>string</parameter>). Для удаления тегов используется тот же механизм,
что и в функции <function>fgetss</function>.
</para>
</refsect1>
@@ -27,7 +27,7 @@
<para>
<variablelist>
<varlistentry>
- <term><parameter>str</parameter></term>
+ <term><parameter>string</parameter></term>
<listitem>
<para>
Входная строка.
@@ -35,7 +35,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><parameter>allowable_tags</parameter></term>
+ <term><parameter>allowed_tags</parameter></term>
<listitem>
<para>
Второй необязательный параметр может быть использован для
@@ -47,7 +47,7 @@
<para>
Комментарии HTML и PHP-теги также будут удалены. Это жестко
задано в коде и не может быть изменено с помощью параметра
- <parameter>allowable_tags</parameter>.
+ <parameter>allowed_tags</parameter>.
</para>
</note>
<note>
@@ -54,7 +54,7 @@
<para>
В PHP 5.3.4 и новее, самозакрывающиеся (такие как <br/>) теги XHTML игнорируются
и только не самозакрывающиеся теги должны быть использованы в
- <parameter>allowable_tags</parameter>.
+ <parameter>allowed_tags</parameter>.
К примеру, для разрешения как <literal><br></literal>, так и
<literal><br/></literal> нужно сделать следующее:
</para>
@@ -94,9 +94,15 @@
</thead>
<tbody>
<row>
+ <entry>8.0.0</entry>
+ <entry>
+ <parameter>allowed_tags</parameter> теперь допускает значение null.
+ </entry>
+ </row>
+ <row>
<entry>7.4.0</entry>
<entry>
- <parameter>allowable_tags</parameter> теперь альтернативно принимает массив (&array;).
+ <parameter>allowed_tags</parameter> теперь альтернативно принимает массив (&array;).
</entry>
</row>
</tbody>
@@ -155,7 +161,7 @@
<warning>
<para>
Эта функция не изменяет атрибуты тегов, разрешенных с помощью
- <parameter>allowable_tags</parameter>, включая такие атрибуты
+ <parameter>allowed_tags</parameter>, включая такие атрибуты
как <literal>style</literal> и <literal>onmouseover</literal>, которые
могут быть использованы озорными пользователями при отправке текста,
отображаемого также и другим пользователям.
@@ -164,7 +170,7 @@
<note>
<para>
Имена тегов в HTML превышающие 1023 байта будут рассматриваться как невалидные
- независимо от параметра <parameter>allowable_tags</parameter>.
+ независимо от параметра <parameter>allowed_tags</parameter>.
</para>
</note>
</refsect1>
@@ -179,7 +185,6 @@
</refsect1>
</refentry>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/ru/trunk/reference/strings/functions/stripcslashes.xml
===================================================================
--- phpdoc/ru/trunk/reference/strings/functions/stripcslashes.xml 2020-12-06 08:25:21 UTC (rev 351922)
+++ phpdoc/ru/trunk/reference/strings/functions/stripcslashes.xml 2020-12-06 12:45:05 UTC (rev 351923)
@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 297028 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 351904 Maintainer: shein Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.stripcslashes">
+<refentry xml:id="function.stripcslashes" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>stripcslashes</refname>
<refpurpose>Удаляет экранирование символов, произведенное функцией <function>addcslashes</function></refpurpose>
@@ -12,7 +12,7 @@
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>stripcslashes</methodname>
- <methodparam><type>string</type><parameter>str</parameter></methodparam>
+ <methodparam><type>string</type><parameter>string</parameter></methodparam>
</methodsynopsis>
<para>
Удаляет экранирующие обратные слеши. Распознает экранирование в стиле
@@ -26,7 +26,7 @@
<para>
<variablelist>
<varlistentry>
- <term><parameter>str</parameter></term>
+ <term><parameter>string</parameter></term>
<listitem>
<para>
Строка, у которой нужно убрать экранирование.
@@ -54,7 +54,6 @@
</refsect1>
</refentry>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/ru/trunk/reference/strings/functions/stripos.xml
===================================================================
--- phpdoc/ru/trunk/reference/strings/functions/stripos.xml 2020-12-06 08:25:21 UTC (rev 351922)
+++ phpdoc/ru/trunk/reference/strings/functions/stripos.xml 2020-12-06 12:45:05 UTC (rev 351923)
@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 351730 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 351904 Maintainer: shein Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.stripos">
+<refentry xml:id="function.stripos" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>stripos</refname>
<refpurpose>Возвращает позицию первого вхождения подстроки без учета регистра</refpurpose>
@@ -11,9 +11,9 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
- <type>int</type><methodname>stripos</methodname>
+ <type class="union"><type>int</type><type>false</type></type><methodname>stripos</methodname>
<methodparam><type>string</type><parameter>haystack</parameter></methodparam>
- <methodparam><type>mixed</type><parameter>needle</parameter></methodparam>
+ <methodparam><type>string</type><parameter>needle</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>offset</parameter><initializer>0</initializer></methodparam>
</methodsynopsis>
<para>
@@ -87,6 +87,12 @@
</thead>
<tbody>
<row>
+ <entry>8.0.0</entry>
+ <entry>
+ Передача целого числа (&integer;) в <parameter>needle</parameter> больше не поддерживается.
+ </entry>
+ </row>
+ <row>
<entry>7.3.0</entry>
<entry>
Передача целого числа (&integer;) в <parameter>needle</parameter> объявлена устаревшей.
@@ -159,7 +165,6 @@
</refsect1>
</refentry>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/ru/trunk/reference/strings/functions/stripslashes.xml
===================================================================
--- phpdoc/ru/trunk/reference/strings/functions/stripslashes.xml 2020-12-06 08:25:21 UTC (rev 351922)
+++ phpdoc/ru/trunk/reference/strings/functions/stripslashes.xml 2020-12-06 12:45:05 UTC (rev 351923)
@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 350650 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 351904 Maintainer: shein Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.stripslashes">
+<refentry xml:id="function.stripslashes" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>stripslashes</refname>
<refpurpose>Удаляет экранирование символов</refpurpose>
@@ -12,7 +12,7 @@
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>stripslashes</methodname>
- <methodparam><type>string</type><parameter>str</parameter></methodparam>
+ <methodparam><type>string</type><parameter>string</parameter></methodparam>
</methodsynopsis>
<para>
Удаляет экранирующие символы.
@@ -33,7 +33,7 @@
<para>
<variablelist>
<varlistentry>
- <term><parameter>str</parameter></term>
+ <term><parameter>string</parameter></term>
<listitem>
<para>
Входная строка.
@@ -133,7 +133,6 @@
</refsect1>
</refentry>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/ru/trunk/reference/strings/functions/stristr.xml
===================================================================
--- phpdoc/ru/trunk/reference/strings/functions/stristr.xml 2020-12-06 08:25:21 UTC (rev 351922)
+++ phpdoc/ru/trunk/reference/strings/functions/stristr.xml 2020-12-06 12:45:05 UTC (rev 351923)
@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 351730 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 351904 Maintainer: shein Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.stristr">
+<refentry xml:id="function.stristr" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>stristr</refname>
<refpurpose>Регистронезависимый вариант функции <function>strstr</function></refpurpose>
@@ -11,9 +11,9 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
- <type>string</type><methodname>stristr</methodname>
+ <type class="union"><type>string</type><type>false</type></type><methodname>stristr</methodname>
<methodparam><type>string</type><parameter>haystack</parameter></methodparam>
- <methodparam><type>mixed</type><parameter>needle</parameter></methodparam>
+ <methodparam><type>string</type><parameter>needle</parameter></methodparam>
<methodparam choice="opt"><type>bool</type><parameter>before_needle</parameter><initializer>&false;</initializer></methodparam>
</methodsynopsis>
<para>
@@ -79,6 +79,12 @@
</thead>
<tbody>
<row>
+ <entry>8.0.0</entry>
+ <entry>
+ Передача целого числа (&integer;) в <parameter>needle</parameter> больше не поддерживается.
+ </entry>
+ </row>
+ <row>
<entry>7.3.0</entry>
<entry>
Передача целого числа (&integer;) в <parameter>needle</parameter> объявлена устаревшей.
@@ -157,7 +163,6 @@
</refsect1>
</refentry>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/ru/trunk/reference/strings/functions/strnatcasecmp.xml
===================================================================
--- phpdoc/ru/trunk/reference/strings/functions/strnatcasecmp.xml 2020-12-06 08:25:21 UTC (rev 351922)
+++ phpdoc/ru/trunk/reference/strings/functions/strnatcasecmp.xml 2020-12-06 12:45:05 UTC (rev 351923)
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 297028 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 351904 Maintainer: shein Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" xml:id="function.strnatcasecmp">
@@ -12,8 +12,8 @@
&reftitle.description;
<methodsynopsis>
<type>int</type><methodname>strnatcasecmp</methodname>
- <methodparam><type>string</type><parameter>str1</parameter></methodparam>
- <methodparam><type>string</type><parameter>str2</parameter></methodparam>
+ <methodparam><type>string</type><parameter>string1</parameter></methodparam>
+ <methodparam><type>string</type><parameter>string2</parameter></methodparam>
</methodsynopsis>
<para>
Эта функция реализует алгоритм сравнения, упорядочивающий
@@ -20,7 +20,7 @@
алфавитно-цифровые строки подобно тому, как это сделал бы
человек. Эта функция подобна <function>strnatcmp</function>, за
исключением того, что сравнение происходит без учета регистра
- символов. Для получения дополнительной информации см. <link
+ символов. Для получения дополнительной информации смотрите <link
xlink:href="&url.strnatcmp;">Natural Order String Comparison</link>.
</para>
</refsect1>
@@ -30,7 +30,7 @@
<para>
<variablelist>
<varlistentry>
- <term><parameter>str1</parameter></term>
+ <term><parameter>string1</parameter></term>
<listitem>
<para>
Первая строка.
@@ -38,7 +38,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><parameter>str2</parameter></term>
+ <term><parameter>string2</parameter></term>
<listitem>
<para>
Вторая строка.
@@ -53,10 +53,10 @@
&reftitle.returnvalues;
<para>
Подобно другим функциям сравнения строк, данная функция
- возвращает отрицательное число, если <parameter>str1</parameter>
- меньше <parameter>str2</parameter>, положительное число,
- если <parameter>str1</parameter> больше
- <parameter>str2</parameter>, и 0, если строки равны.
+ возвращает отрицательное число, если <parameter>string1</parameter>
+ меньше <parameter>string2</parameter>, положительное число,
+ если <parameter>string1</parameter> больше
+ <parameter>string2</parameter>, и 0, если строки равны.
</para>
</refsect1>
@@ -78,7 +78,6 @@
</refsect1>
</refentry>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/ru/trunk/reference/strings/functions/strnatcmp.xml
===================================================================
--- phpdoc/ru/trunk/reference/strings/functions/strnatcmp.xml 2020-12-06 08:25:21 UTC (rev 351922)
+++ phpdoc/ru/trunk/reference/strings/functions/strnatcmp.xml 2020-12-06 12:45:05 UTC (rev 351923)
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 297028 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 351904 Maintainer: shein Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" xml:id="function.strnatcmp">
@@ -12,8 +12,8 @@
&reftitle.description;
<methodsynopsis>
<type>int</type><methodname>strnatcmp</methodname>
- <methodparam><type>string</type><parameter>str1</parameter></methodparam>
- <methodparam><type>string</type><parameter>str2</parameter></methodparam>
+ <methodparam><type>string</type><parameter>string1</parameter></methodparam>
+ <methodparam><type>string</type><parameter>string2</parameter></methodparam>
</methodsynopsis>
<para>
Эта функция реализует алгоритм сравнения, упорядочивающий
@@ -28,7 +28,7 @@
<para>
<variablelist>
<varlistentry>
- <term><parameter>str1</parameter></term>
+ <term><parameter>string1</parameter></term>
<listitem>
<para>
Первая строка.
@@ -36,7 +36,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><parameter>str2</parameter></term>
+ <term><parameter>string2</parameter></term>
<listitem>
<para>
Вторая строка.
@@ -51,10 +51,10 @@
&reftitle.returnvalues;
<para>
Подобно другим функциям сравнения строк, данная функция
- возвращает отрицательное число, если <parameter>str1</parameter>
- меньше, чем <parameter>str2</parameter>, положительное число,
- если <parameter>str1</parameter> больше, чем
- <parameter>str2</parameter>, и 0 если строки равны.
+ возвращает отрицательное число, если <parameter>string1</parameter>
+ меньше, чем <parameter>string2</parameter>, положительное число,
+ если <parameter>string1</parameter> больше, чем
+ <parameter>string2</parameter>, и 0 если строки равны.
</para>
</refsect1>
@@ -126,7 +126,6 @@
</refsect1>
</refentry>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/ru/trunk/reference/strings/functions/strpbrk.xml
===================================================================
--- phpdoc/ru/trunk/reference/strings/functions/strpbrk.xml 2020-12-06 08:25:21 UTC (rev 351922)
+++ phpdoc/ru/trunk/reference/strings/functions/strpbrk.xml 2020-12-06 12:45:05 UTC (rev 351923)
@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 334762 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 351904 Maintainer: shein Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strpbrk">
+<refentry xml:id="function.strpbrk" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>strpbrk</refname>
<refpurpose>Ищет в строке любой символ из заданного набора</refpurpose>
@@ -11,13 +11,13 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
- <type>string</type><methodname>strpbrk</methodname>
- <methodparam><type>string</type><parameter>haystack</parameter></methodparam>
- <methodparam><type>string</type><parameter>char_list</parameter></methodparam>
+ <type class="union"><type>string</type><type>false</type></type><methodname>strpbrk</methodname>
+ <methodparam><type>string</type><parameter>string</parameter></methodparam>
+ <methodparam><type>string</type><parameter>characters</parameter></methodparam>
</methodsynopsis>
<para>
- <function>strpbrk</function> ищет в строке <parameter>haystack</parameter>
- символы из набора <parameter>char_list</parameter>.
+ <function>strpbrk</function> ищет в строке <parameter>string</parameter>
+ символы из набора <parameter>characters</parameter>.
</para>
</refsect1>
@@ -26,15 +26,15 @@
<para>
<variablelist>
<varlistentry>
- <term><parameter>haystack</parameter></term>
+ <term><parameter>string</parameter></term>
<listitem>
<para>
- Строка, в которой производится поиск <parameter>char_list</parameter>.
+ Строка, в которой производится поиск <parameter>characters</parameter>.
</para>
</listitem>
</varlistentry>
<varlistentry>
- <term><parameter>char_list</parameter></term>
+ <term><parameter>characters</parameter></term>
<listitem>
<para>
Данный параметр чувствителен к регистру.
@@ -88,7 +88,6 @@
</refsect1>
</refentry>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/ru/trunk/reference/strings/functions/strpos.xml
===================================================================
--- phpdoc/ru/trunk/reference/strings/functions/strpos.xml 2020-12-06 08:25:21 UTC (rev 351922)
+++ phpdoc/ru/trunk/reference/strings/functions/strpos.xml 2020-12-06 12:45:05 UTC (rev 351923)
@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 351730 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 351904 Maintainer: shein Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strpos">
+<refentry xml:id="function.strpos" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>strpos</refname>
<refpurpose>Возвращает позицию первого вхождения подстроки</refpurpose>
@@ -11,9 +11,9 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
- <type>int</type><methodname>strpos</methodname>
+ <type class="union"><type>int</type><type>false</type></type><methodname>strpos</methodname>
<methodparam><type>string</type><parameter>haystack</parameter></methodparam>
- <methodparam><type>mixed</type><parameter>needle</parameter></methodparam>
+ <methodparam><type>string</type><parameter>needle</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>offset</parameter><initializer>0</initializer></methodparam>
</methodsynopsis>
<para>
@@ -79,6 +79,12 @@
</thead>
<tbody>
<row>
+ <entry>8.0.0</entry>
+ <entry>
+ Передача целого числа (&integer;) в <parameter>needle</parameter> больше не поддерживается.
+ </entry>
+ </row>
+ <row>
<entry>7.3.0</entry>
<entry>
Передача целого числа (&integer;) в <parameter>needle</parameter> объявлена устаревшей.
@@ -182,7 +188,6 @@
</refsect1>
</refentry>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/ru/trunk/reference/strings/functions/strrchr.xml
===================================================================
--- phpdoc/ru/trunk/reference/strings/functions/strrchr.xml 2020-12-06 08:25:21 UTC (rev 351922)
+++ phpdoc/ru/trunk/reference/strings/functions/strrchr.xml 2020-12-06 12:45:05 UTC (rev 351923)
@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 350636 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 351904 Maintainer: shein Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strrchr">
+<refentry xml:id="function.strrchr" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>strrchr</refname>
<refpurpose>Находит последнее вхождение символа в строке</refpurpose>
@@ -11,9 +11,9 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
- <type>string</type><methodname>strrchr</methodname>
+ <type class="union"><type>string</type><type>false</type></type><methodname>strrchr</methodname>
<methodparam><type>string</type><parameter>haystack</parameter></methodparam>
- <methodparam><type>mixed</type><parameter>needle</parameter></methodparam>
+ <methodparam><type>string</type><parameter>needle</parameter></methodparam>
</methodsynopsis>
<para>
Возвращает подстроку строки <parameter>haystack</parameter>, начиная с
@@ -68,6 +68,12 @@
</thead>
<tbody>
<row>
+ <entry>8.0.0</entry>
+ <entry>
+ Передача целого числа (&integer;) в <parameter>needle</parameter> больше не поддерживается.
+ </entry>
+ </row>
+ <row>
<entry>7.3.0</entry>
<entry>
Передача целого числа (&integer;) в <parameter>needle</parameter> объявлена устаревшей.
@@ -115,7 +121,6 @@
</refsect1>
</refentry>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/ru/trunk/reference/strings/functions/strripos.xml
===================================================================
--- phpdoc/ru/trunk/reference/strings/functions/strripos.xml 2020-12-06 08:25:21 UTC (rev 351922)
+++ phpdoc/ru/trunk/reference/strings/functions/strripos.xml 2020-12-06 12:45:05 UTC (rev 351923)
@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 351730 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 351904 Maintainer: shein Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strripos">
+<refentry xml:id="function.strripos" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>strripos</refname>
<refpurpose>Возвращает позицию последнего вхождения подстроки без учета регистра</refpurpose>
@@ -11,9 +11,9 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
- <type>int</type><methodname>strripos</methodname>
+ <type class="union"><type>int</type><type>false</type></type><methodname>strripos</methodname>
<methodparam><type>string</type><parameter>haystack</parameter></methodparam>
- <methodparam><type>mixed</type><parameter>needle</parameter></methodparam>
+ <methodparam><type>string</type><parameter>needle</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>offset</parameter><initializer>0</initializer></methodparam>
</methodsynopsis>
<para>
@@ -100,6 +100,12 @@
</thead>
<tbody>
<row>
+ <entry>8.0.0</entry>
+ <entry>
+ Передача целого числа (&integer;) в <parameter>needle</parameter> больше не поддерживается.
+ </entry>
+ </row>
+ <row>
<entry>7.3.0</entry>
<entry>
Передача целого числа (&integer;) в <parameter>needle</parameter> объявлена устаревшей.
@@ -158,7 +164,6 @@
</refsect1>
</refentry>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/ru/trunk/reference/strings/functions/strrpos.xml
===================================================================
--- phpdoc/ru/trunk/reference/strings/functions/strrpos.xml 2020-12-06 08:25:21 UTC (rev 351922)
+++ phpdoc/ru/trunk/reference/strings/functions/strrpos.xml 2020-12-06 12:45:05 UTC (rev 351923)
@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 351730 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 351904 Maintainer: shein Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strrpos">
+<refentry xml:id="function.strrpos" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>strrpos</refname>
<refpurpose>Возвращает позицию последнего вхождения подстроки в строке</refpurpose>
@@ -11,9 +11,9 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
- <type>int</type><methodname>strrpos</methodname>
+ <type class="union"><type>int</type><type>false</type></type><methodname>strrpos</methodname>
<methodparam><type>string</type><parameter>haystack</parameter></methodparam>
- <methodparam><type>mixed</type><parameter>needle</parameter></methodparam>
+ <methodparam><type>string</type><parameter>needle</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>offset</parameter><initializer>0</initializer></methodparam>
</methodsynopsis>
<para>
@@ -96,6 +96,12 @@
</thead>
<tbody>
<row>
+ <entry>8.0.0</entry>
+ <entry>
+ Передача целого числа (&integer;) в <parameter>needle</parameter> больше не поддерживается.
+ </entry>
+ </row>
+ <row>
<entry>7.3.0</entry>
<entry>
Передача целого числа (&integer;) в <parameter>needle</parameter> объявлена устаревшей.
@@ -178,7 +184,6 @@
</refsect1>
</refentry>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/ru/trunk/reference/strings/functions/strspn.xml
===================================================================
--- phpdoc/ru/trunk/reference/strings/functions/strspn.xml 2020-12-06 08:25:21 UTC (rev 351922)
+++ phpdoc/ru/trunk/reference/strings/functions/strspn.xml 2020-12-06 12:45:05 UTC (rev 351923)
@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 343888 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 351904 Maintainer: shein Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strspn">
+<refentry xml:id="function.strspn" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>strspn</refname>
<refpurpose>
@@ -14,21 +14,21 @@
&reftitle.description;
<methodsynopsis>
<type>int</type><methodname>strspn</methodname>
- <methodparam><type>string</type><parameter>subject</parameter></methodparam>
- <methodparam><type>string</type><parameter>mask</parameter></methodparam>
- <methodparam choice="opt"><type>int</type><parameter>start</parameter></methodparam>
- <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam>
+ <methodparam><type>string</type><parameter>string</parameter></methodparam>
+ <methodparam><type>string</type><parameter>characters</parameter></methodparam>
+ <methodparam choice="opt"><type>int</type><parameter>offset</parameter><initializer>0</initializer></methodparam>
+ <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>length</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
- Возвращает длину участка от начала строки <parameter>subject</parameter>,
- содержащий <emphasis>только</emphasis> символы из <parameter>mask</parameter>.
+ Возвращает длину участка от начала строки <parameter>string</parameter>,
+ содержащий <emphasis>только</emphasis> символы из <parameter>characters</parameter>.
</para>
<para>
- Если параметры <parameter>start</parameter> и <parameter>length</parameter>
- не указаны, то будет исследована вся строка <parameter>subject</parameter>.
+ Если параметры <parameter>offset</parameter> и <parameter>length</parameter>
+ не указаны, то будет исследована вся строка <parameter>string</parameter>.
Если они указаны, то эффект будет аналогичен вызову
<literal>strspn(substr($subject, $start, $length), $mask)</literal>
- (подробнее см. функцию <xref linkend="function.substr" />).
+ (подробнее смотрите функцию <xref linkend="function.substr" />).
</para>
<para>
Строка кода:
@@ -42,7 +42,7 @@
</programlisting>
</informalexample>
присвоит <literal>2</literal> переменной <varname>$var</varname>,
- так как "42" - это начальный участок строки <parameter>subject</parameter>,
+ так как "42" - это начальный участок строки <parameter>string</parameter>,
состоящий только из символов "1234567890".
</para>
</refsect1>
@@ -52,7 +52,7 @@
<para>
<variablelist>
<varlistentry>
- <term><parameter>subject</parameter></term>
+ <term><parameter>string</parameter></term>
<listitem>
<para>
Исследуемая строка.
@@ -60,7 +60,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><parameter>mask</parameter></term>
+ <term><parameter>characters</parameter></term>
<listitem>
<para>
Список из разрешенных символов.
@@ -68,16 +68,16 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><parameter>start</parameter></term>
+ <term><parameter>offset</parameter></term>
<listitem>
<para>
Позиция начала поиска в <parameter>subject</parameter>.
</para>
<para>
- Если <parameter>start</parameter> указан и неотрицателен,
+ Если <parameter>offset</parameter> указан и неотрицателен,
то <function>strspn</function> начнет искать в строке
- <parameter>subject</parameter>, начиная с позиции
- <parameter>start</parameter>. К примеру, в
+ <parameter>string</parameter>, начиная с позиции
+ <parameter>offset</parameter>. К примеру, в
строке '<literal>abcdef</literal>', символом с позицией
<literal>0</literal> является '<literal>a</literal>', символом
с позицией <literal>2</literal> является
@@ -84,11 +84,11 @@
'<literal>c</literal>' и т.д.
</para>
<para>
- Если <parameter>start</parameter> указан и отрицателен,
+ Если <parameter>offset</parameter> указан и отрицателен,
то <function>strspn</function> начнет поиск
- в строке <parameter>subject</parameter> с позиции, отстоящей
- на <parameter>start</parameter> символов с конца
- <parameter>subject</parameter>.
+ в строке <parameter>string</parameter> с позиции, отстоящей
+ на <parameter>offset</parameter> символов с конца
+ <parameter>string</parameter>.
</para>
</listitem>
</varlistentry>
@@ -96,19 +96,19 @@
<term><parameter>length</parameter></term>
<listitem>
<para>
- Длина исследуемого фрагмента <parameter>subject</parameter>.
+ Длина исследуемого фрагмента <parameter>string</parameter>.
</para>
<para>
Если <parameter>length</parameter> указан и неотрицателен,
- то строка <parameter>subject</parameter> будет исследована
+ то строка <parameter>string</parameter> будет исследована
в течение <parameter>length</parameter> после стартовой позиции.
</para>
<para>
Если <parameter>length</parameter> указан и отрицателен,
- то строка <parameter>subject</parameter> будет исследована
+ то строка <parameter>string</parameter> будет исследована
начиная со стартовой позиции до позиции, отстоящей на
<parameter>length</parameter> символов с конца
- <parameter>subject</parameter>.
+ <parameter>string</parameter>.
</para>
</listitem>
</varlistentry>
@@ -119,17 +119,39 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
- Возвращает длину первого участка <parameter>subject</parameter>,
- состоящего целиком из символов в <parameter>mask</parameter>.
+ Возвращает длину первого участка <parameter>string</parameter>,
+ состоящего целиком из символов в <parameter>characters</parameter>.
</para>
<note>
<para>
- Когда <parameter>start</parameter> указан, возращаемая длина строки определяется,
- начиная с этой позиции, а не с начала строки <parameter>subject</parameter>.
+ Когда <parameter>offset</parameter> указан, возращаемая длина строки определяется,
+ начиная с этой позиции, а не с начала строки <parameter>string</parameter>.
</para>
</note>
</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>length</parameter> теперь допускает значение null.
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </refsect1>
+
<refsect1 role="examples">
&reftitle.examples;
<para>
@@ -176,7 +198,6 @@
</refsect1>
</refentry>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/ru/trunk/reference/strings/functions/strstr.xml
===================================================================
--- phpdoc/ru/trunk/reference/strings/functions/strstr.xml 2020-12-06 08:25:21 UTC (rev 351922)
+++ phpdoc/ru/trunk/reference/strings/functions/strstr.xml 2020-12-06 12:45:05 UTC (rev 351923)
@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 350655 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 351904 Maintainer: shein Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strstr">
+<refentry xml:id="function.strstr" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>strstr</refname>
<refpurpose>Находит первое вхождение подстроки</refpurpose>
@@ -11,9 +11,9 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
- <type>string</type><methodname>strstr</methodname>
+ <type class="union"><type>string</type><type>false</type></type><methodname>strstr</methodname>
<methodparam><type>string</type><parameter>haystack</parameter></methodparam>
- <methodparam><type>mixed</type><parameter>needle</parameter></methodparam>
+ <methodparam><type>string</type><parameter>needle</parameter></methodparam>
<methodparam choice="opt"><type>bool</type><parameter>before_needle</parameter><initializer>&false;</initializer></methodparam>
</methodsynopsis>
<para>
@@ -90,6 +90,12 @@
</thead>
<tbody>
<row>
+ <entry>8.0.0</entry>
+ <entry>
+ Передача целого числа (&integer;) в <parameter>needle</parameter> больше не поддерживается.
+ </entry>
+ </row>
+ <row>
<entry>7.3.0</entry>
<entry>
Передача целого числа (&integer;) в <parameter>needle</parameter> объявлена устаревшей.
@@ -136,7 +142,6 @@
</refsect1>
</refentry>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml