svn: /phpdoc/ru/trunk/reference/strings/functions/ get-html-translation-table.xml substr-compare.xml substr-count.xml substr-replace.xml substr.xml trim.xml ucfirst.xml ucwords.xml vfprintf.xml vprintf.xml wordwrap.xml
[email protected] (Sergey Panteleev) Mon, 07 Dec 2020 05:04:12 +0000
| Newsgroups | php.doc.ru |
|---|---|
| Message-ID | <[email protected]> |
sergey Mon, 07 Dec 2020 05:04:12 +0000
Revision: http://svn.php.net/viewvc?view=revision&revision=351940
Log:
docs(ru): Updated to English revision
Changed paths:
U phpdoc/ru/trunk/reference/strings/functions/get-html-translation-table.xml
U phpdoc/ru/trunk/reference/strings/functions/substr-compare.xml
U phpdoc/ru/trunk/reference/strings/functions/substr-count.xml
U phpdoc/ru/trunk/reference/strings/functions/substr-replace.xml
U phpdoc/ru/trunk/reference/strings/functions/substr.xml
U phpdoc/ru/trunk/reference/strings/functions/trim.xml
U phpdoc/ru/trunk/reference/strings/functions/ucfirst.xml
U phpdoc/ru/trunk/reference/strings/functions/ucwords.xml
U phpdoc/ru/trunk/reference/strings/functions/vfprintf.xml
U phpdoc/ru/trunk/reference/strings/functions/vprintf.xml
U phpdoc/ru/trunk/reference/strings/functions/wordwrap.xml
svn-diffs-351940.txt
(text/x-diff, 37.4 KB)
Modified: phpdoc/ru/trunk/reference/strings/functions/get-html-translation-table.xml
===================================================================
--- phpdoc/ru/trunk/reference/strings/functions/get-html-translation-table.xml 2020-12-06 23:34:08 UTC (rev 351939)
+++ phpdoc/ru/trunk/reference/strings/functions/get-html-translation-table.xml 2020-12-07 05:04:12 UTC (rev 351940)
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 351904 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 351924 Maintainer: shein Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
<refentry xml:id="function.get-html-translation-table" xmlns="http://docbook.org/ns/docbook">
@@ -102,8 +102,7 @@
<listitem>
<para>
Используемая кодировка.
- Если не указана, то значением по умолчанию для этого аргумента является ISO-8859-1 в
- версиях PHP до 5.4.0 и UTF-8, начиная с версии 5.4.0 и выше.
+ Если не указана, то значением по умолчанию для этого аргумента является UTF-8.
</para>
&reference.strings.charsets;
</listitem>
Modified: phpdoc/ru/trunk/reference/strings/functions/substr-compare.xml
===================================================================
--- phpdoc/ru/trunk/reference/strings/functions/substr-compare.xml 2020-12-06 23:34:08 UTC (rev 351939)
+++ phpdoc/ru/trunk/reference/strings/functions/substr-compare.xml 2020-12-07 05:04:12 UTC (rev 351940)
@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 350645 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 351904 Maintainer: shein Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.substr-compare">
+<refentry xml:id="function.substr-compare" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>substr_compare</refname>
<refpurpose>Бинарно-безопасное сравнение 2 строк со смещением, с учетом или без учета регистра</refpurpose>
@@ -12,17 +12,17 @@
&reftitle.description;
<methodsynopsis>
<type>int</type><methodname>substr_compare</methodname>
- <methodparam><type>string</type><parameter>main_str</parameter></methodparam>
- <methodparam><type>string</type><parameter>str</parameter></methodparam>
+ <methodparam><type>string</type><parameter>haystack</parameter></methodparam>
+ <methodparam><type>string</type><parameter>needle</parameter></methodparam>
<methodparam><type>int</type><parameter>offset</parameter></methodparam>
- <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam>
- <methodparam choice="opt"><type>bool</type><parameter>case_insensitivity</parameter><initializer>&false;</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>bool</type><parameter>case_insensitive</parameter><initializer>&false;</initializer></methodparam>
</methodsynopsis>
<para>
<function>substr_compare</function> сравнивает строку
- <parameter>main_str</parameter> (начиная с позиции
+ <parameter>haystack</parameter> (начиная с позиции
<parameter>offset</parameter>) со строкой
- <parameter>str</parameter>. В сравнении участвуют максимум
+ <parameter>needle</parameter>. В сравнении участвуют максимум
<parameter>length</parameter> символов.
</para>
</refsect1>
@@ -32,7 +32,7 @@
<para>
<variablelist>
<varlistentry>
- <term><parameter>main_str</parameter></term>
+ <term><parameter>haystack</parameter></term>
<listitem>
<para>
Основная сравниваемая строка.
@@ -40,7 +40,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><parameter>str</parameter></term>
+ <term><parameter>needle</parameter></term>
<listitem>
<para>
Следующая сравниваемая строка.
@@ -61,7 +61,7 @@
<listitem>
<para>
Длина сравнения. По умолчанию используется максимальная из длин
- <parameter>str</parameter> и <parameter>main_str</parameter>
+ <parameter>needle</parameter> и <parameter>haystack</parameter>
минус <parameter>offset</parameter>.
</para>
</listitem>
@@ -83,12 +83,12 @@
&reftitle.returnvalues;
<para>
Возвращает отрицательное число, если строка
- <parameter>main_str</parameter> (начиная с символа
+ <parameter>haystack</parameter> (начиная с символа
<parameter>offset</parameter>) меньше, чем
- <parameter>str</parameter>; положительное число,
- если она больше <parameter>str</parameter>; 0, если строки равны.
+ <parameter>needle</parameter>; положительное число,
+ если она больше <parameter>needle</parameter>; 0, если строки равны.
Если <parameter>offset</parameter> больше (до PHP 7.2.18, 7.3.5) или равен длине
- <parameter>main_str</parameter> или <parameter>length</parameter> передан
+ <parameter>haystack</parameter> или <parameter>length</parameter> передан
и меньше 0 (или, д PHP 5.5.11, меньше 1), <function>substr_compare</function> выводит
предупреждение и возвращает &false;.
</para>
@@ -107,9 +107,15 @@
</thead>
<tbody>
<row>
+ <entry>8.0.0</entry>
+ <entry>
+ <parameter>length</parameter> теперь допускает значение null.
+ </entry>
+ </row>
+ <row>
<entry>7.2.18, 7.3.5</entry>
<entry>
- <parameter>offset</parameter> теперь может быть равным <parameter>main_str</parameter>.
+ <parameter>offset</parameter> теперь может быть равным <parameter>haystack</parameter>.
</entry>
</row>
</tbody>
@@ -150,7 +156,6 @@
</refsect1>
</refentry>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/ru/trunk/reference/strings/functions/substr-count.xml
===================================================================
--- phpdoc/ru/trunk/reference/strings/functions/substr-count.xml 2020-12-06 23:34:08 UTC (rev 351939)
+++ phpdoc/ru/trunk/reference/strings/functions/substr-count.xml 2020-12-07 05:04:12 UTC (rev 351940)
@@ -1,9 +1,9 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 351133 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 351904 Maintainer: shein Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
<!-- splitted from ./en/functions/strings.xml, last change in rev 1.27 -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.substr-count">
+<refentry xml:id="function.substr-count" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>substr_count</refname>
<refpurpose>Возвращает число вхождений подстроки</refpurpose>
@@ -15,7 +15,7 @@
<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>int</type><parameter>length</parameter></methodparam>
+ <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>length</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
<function>substr_count</function> возвращает число вхождений
@@ -95,6 +95,12 @@
</thead>
<tbody>
<row>
+ <entry>8.0.0</entry>
+ <entry>
+ <parameter>length</parameter> теперь допускает значение null.
+ </entry>
+ </row>
+ <row>
<entry>7.1.0</entry>
<entry>
Добавлена поддержка отрицательных значений <parameter>offset</parameter>
@@ -153,7 +159,6 @@
</para>
</refsect1>
</refentry>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/ru/trunk/reference/strings/functions/substr-replace.xml
===================================================================
--- phpdoc/ru/trunk/reference/strings/functions/substr-replace.xml 2020-12-06 23:34:08 UTC (rev 351939)
+++ phpdoc/ru/trunk/reference/strings/functions/substr-replace.xml 2020-12-07 05:04:12 UTC (rev 351940)
@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 342063 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 351904 Maintainer: shein Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.substr-replace">
+<refentry xml:id="function.substr-replace" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>substr_replace</refname>
<refpurpose>Заменяет часть строки</refpurpose>
@@ -11,18 +11,18 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
- <type>mixed</type><methodname>substr_replace</methodname>
- <methodparam><type>mixed</type><parameter>string</parameter></methodparam>
- <methodparam><type>mixed</type><parameter>replacement</parameter></methodparam>
- <methodparam><type>mixed</type><parameter>start</parameter></methodparam>
- <methodparam choice="opt"><type>mixed</type><parameter>length</parameter></methodparam>
+ <type class="union"><type>string</type><type>array</type></type><methodname>substr_replace</methodname>
+ <methodparam><type class="union"><type>array</type><type>string</type></type><parameter>string</parameter></methodparam>
+ <methodparam><type class="union"><type>array</type><type>string</type></type><parameter>replace</parameter></methodparam>
+ <methodparam><type class="union"><type>array</type><type>int</type></type><parameter>offset</parameter></methodparam>
+ <methodparam choice="opt"><type class="union"><type>array</type><type>int</type><type>null</type></type><parameter>length</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
<function>substr_replace</function> заменяет часть строки
<parameter>string</parameter>, начинающуюся с символа с порядковым
- номером <parameter>start</parameter> и (необязательной) длиной
+ номером <parameter>offset</parameter> и (необязательной) длиной
<parameter>length</parameter>, строкой
- <parameter>replacement</parameter> и возвращает результат.
+ <parameter>replace</parameter> и возвращает результат.
</para>
</refsect1>
@@ -39,8 +39,8 @@
<para>
Также можно указать массив строк, в этом случае замены будут
происходить с каждой предоставленной строкой. В этом случае
- параметры <parameter>replacement</parameter>,
- <parameter>start</parameter> и <parameter>length</parameter>
+ параметры <parameter>replace</parameter>,
+ <parameter>offset</parameter> и <parameter>length</parameter>
могут быть как скалярными значениями - в этом случае эти значения
будут применены к каждой строке, так и массивами - в этом
случае соответствующие элементы массивов будут применены к
@@ -49,7 +49,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><parameter>replacement</parameter></term>
+ <term><parameter>replace</parameter></term>
<listitem>
<para>
Строка замены.
@@ -57,17 +57,17 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><parameter>start</parameter></term>
+ <term><parameter>offset</parameter></term>
<listitem>
<para>
- Если <parameter>start</parameter> положителен, замена
- начинается с символа с порядковым номером <parameter>start</parameter>
+ Если <parameter>offset</parameter> положителен, замена
+ начинается с символа с порядковым номером <parameter>offset</parameter>
строки <parameter>string</parameter>.
</para>
<para>
- Если <parameter>start</parameter> отрицателен, замена
+ Если <parameter>offset</parameter> отрицателен, замена
начинается с символа с порядковым номером
- <parameter>start</parameter>, считая от конца строки
+ <parameter>offset</parameter>, считая от конца строки
<parameter>string</parameter>.
</para>
</listitem>
@@ -84,9 +84,9 @@
умолчанию равен strlen(<parameter>string</parameter>);, то есть замена
до конца строки <parameter>string</parameter>.
Разумеется, если <parameter>length</parameter> равен нулю,
- то это эквивалентно вставке <parameter>replacement</parameter>
+ то это эквивалентно вставке <parameter>replace</parameter>
в <parameter>string</parameter> на указанной позиции
- <parameter>start</parameter>.
+ <parameter>offset</parameter>.
</para>
</listitem>
</varlistentry>
@@ -102,6 +102,30 @@
</para>
</refsect1>
+ <refsect1 role="changelog">
+ &reftitle.changelog;
+ <para>
+ <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>
+ </para>
+ </refsect1>
+
<refsect1 role="examples">
&reftitle.examples;
<para>
@@ -184,7 +208,6 @@
</refsect1>
</refentry>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/ru/trunk/reference/strings/functions/substr.xml
===================================================================
--- phpdoc/ru/trunk/reference/strings/functions/substr.xml 2020-12-06 23:34:08 UTC (rev 351939)
+++ phpdoc/ru/trunk/reference/strings/functions/substr.xml 2020-12-07 05:04:12 UTC (rev 351940)
@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 351135 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 351904 Maintainer: shein Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.substr">
+<refentry xml:id="function.substr" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>substr</refname>
<refpurpose>Возвращает подстроку</refpurpose>
@@ -11,14 +11,14 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
- <type class="union"><type>string</type><type>false</type></type><methodname>substr</methodname>
+ <type>string</type><methodname>substr</methodname>
<methodparam><type>string</type><parameter>string</parameter></methodparam>
- <methodparam><type>int</type><parameter>start</parameter></methodparam>
- <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam>
+ <methodparam><type>int</type><parameter>offset</parameter></methodparam>
+ <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>length</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
Возвращает подстроку строки <parameter>string</parameter>, начинающейся
- с <parameter>start</parameter> символа по счету и длиной
+ с <parameter>offset</parameter> символа по счету и длиной
<parameter>length</parameter> символов.
</para>
</refsect1>
@@ -36,11 +36,11 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><parameter>start</parameter></term>
+ <term><parameter>offset</parameter></term>
<listitem>
<para>
- Если <parameter>start</parameter> неотрицателен, возвращаемая
- подстрока начинается с позиции <parameter>start</parameter> от начала
+ Если <parameter>offset</parameter> неотрицателен, возвращаемая
+ подстрока начинается с позиции <parameter>offset</parameter> от начала
строки, считая от нуля. Например, в строке
'<literal>abcdef</literal>', в позиции <literal>0</literal> находится
символ '<literal>a</literal>', в позиции <literal>2</literal> -
@@ -47,18 +47,18 @@
символ '<literal>c</literal>', и т.д.
</para>
<para>
- Если <parameter>start</parameter> отрицательный, возвращаемая
+ Если <parameter>offset</parameter> отрицательный, возвращаемая
подстрока начинается с позиции, отстоящей на
- <parameter>start</parameter> символов от конца
+ <parameter>offset</parameter> символов от конца
строки <parameter>string</parameter>.
</para>
<para>
Если <parameter>string</parameter> меньше
- <parameter>start</parameter> символов, будет возвращено &false;.
+ <parameter>offset</parameter> символов, будет возвращено &false;.
</para>
<para>
<example>
- <title>Использование отрицательного параметра <parameter>start</parameter></title>
+ <title>Использование отрицательного параметра <parameter>offset</parameter></title>
<programlisting role="php">
<![CDATA[
<?php
@@ -78,7 +78,7 @@
<para>
Если <parameter>length</parameter> положительный, возвращаемая строка
будет не длиннее <parameter>length</parameter> символов, начиная
- с параметра <parameter>start</parameter> (в зависимости от длины
+ с параметра <parameter>offset</parameter> (в зависимости от длины
<parameter>string</parameter>).
</para>
<para>
@@ -85,9 +85,9 @@
Если <parameter>length</parameter> отрицательный, то будет отброшено
указанное этим аргументом число символов с конца строки
<parameter>string</parameter> (после того как будет вычислена
- стартовая позиция, если <parameter>start</parameter> отрицателен).
+ стартовая позиция, если <parameter>offset</parameter> отрицателен).
Если при этом позиция начала
- подстроки, определяемая аргументом <parameter>start</parameter>,
+ подстроки, определяемая аргументом <parameter>offset</parameter>,
находится в отброшенной части строки или за ней, возвращается &false;.
</para>
<para>
@@ -98,7 +98,7 @@
<para>
Если параметр <parameter>length</parameter> опущен, то будет
возвращена подстрока, начинающаяся с позиции, указанной параметром
- <parameter>start</parameter> и длящейся до конца строки.
+ <parameter>offset</parameter> и длящейся до конца строки.
</para>
<example>
<title>Использование отрицательного параметра <parameter>length</parameter></title>
@@ -126,6 +126,34 @@
пустую строку.
</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>length</parameter> теперь допускает значение null.
+ </entry>
+ </row>
+ <row>
+ <entry>8.0.0</entry>
+ <entry>
+ Функция возвращает пустую строку там, где раньше возвращала &false;.
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </refsect1>
<refsect1 role="examples">
&reftitle.examples;
@@ -233,7 +261,6 @@
</refsect1>
</refentry>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/ru/trunk/reference/strings/functions/trim.xml
===================================================================
--- phpdoc/ru/trunk/reference/strings/functions/trim.xml 2020-12-06 23:34:08 UTC (rev 351939)
+++ phpdoc/ru/trunk/reference/strings/functions/trim.xml 2020-12-07 05:04:12 UTC (rev 351940)
@@ -1,9 +1,9 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 334605 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 351905 Maintainer: shein Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
<!-- splitted from ./en/functions/strings.xml, last change in rev 1.2 -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.trim">
+<refentry xml:id="function.trim" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>trim</refname>
<refpurpose>Удаляет пробелы (или другие символы) из начала и конца строки</refpurpose>
@@ -13,11 +13,11 @@
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>trim</methodname>
- <methodparam><type>string</type><parameter>str</parameter></methodparam>
- <methodparam choice="opt"><type>string</type><parameter>character_mask</parameter><initializer>" \t\n\r\0\x0B"</initializer></methodparam>
+ <methodparam><type>string</type><parameter>string</parameter></methodparam>
+ <methodparam choice="opt"><type>string</type><parameter>characters</parameter><initializer>" \n\r\t\v\0"</initializer></methodparam>
</methodsynopsis>
<para>
- Эта функция возвращает строку <parameter>str</parameter> с удаленными
+ Эта функция возвращает строку <parameter>string</parameter> с удаленными
из начала и конца строки пробелами.
Если второй параметр не передан,
<function>trim</function> удаляет следующие символы:
@@ -54,8 +54,8 @@
</simpara>
</listitem>
<listitem>
- <simpara> <!-- not \v, since not supported by PHP -->
- "\x0B" (<acronym>ASCII</acronym> <literal>11</literal>
+ <simpara>
+ "\v" (<acronym>ASCII</acronym> <literal>11</literal>
(<literal>0x0B</literal>)), вертикальная табуляция.
</simpara>
</listitem>
@@ -68,7 +68,7 @@
<para>
<variablelist>
<varlistentry>
- <term><parameter>str</parameter></term>
+ <term><parameter>string</parameter></term>
<listitem>
<para>
Обрезаемая строка (<type>string</type>).
@@ -76,11 +76,11 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><parameter>character_mask</parameter></term>
+ <term><parameter>characters</parameter></term>
<listitem>
<para>
Можно также задать список символов для удаления с помощью
- необязательного аргумента <parameter>character_mask</parameter>.
+ необязательного аргумента <parameter>characters</parameter>.
Просто перечислите все символы, которые вы хотите удалить.
Можно указать конструкцию <literal>..</literal> для обозначения
диапазона символов.
@@ -223,7 +223,6 @@
</para>
</refsect1>
</refentry>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/ru/trunk/reference/strings/functions/ucfirst.xml
===================================================================
--- phpdoc/ru/trunk/reference/strings/functions/ucfirst.xml 2020-12-06 23:34:08 UTC (rev 351939)
+++ phpdoc/ru/trunk/reference/strings/functions/ucfirst.xml 2020-12-07 05:04:12 UTC (rev 351940)
@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 310796 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 351904 Maintainer: shein Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.ucfirst">
+<refentry xml:id="function.ucfirst" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>ucfirst</refname>
<refpurpose>Преобразует первый символ строки в верхний регистр</refpurpose>
@@ -12,10 +12,10 @@
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>ucfirst</methodname>
- <methodparam><type>string</type><parameter>str</parameter></methodparam>
+ <methodparam><type>string</type><parameter>string</parameter></methodparam>
</methodsynopsis>
<para>
- Возвращает строку <parameter>str</parameter>, в которой первый
+ Возвращает строку <parameter>string</parameter>, в которой первый
символ переведен в верхний регистр, если этот символ является буквой.
</para>
<para>
@@ -30,7 +30,7 @@
<para>
<variablelist>
<varlistentry>
- <term><parameter>str</parameter></term>
+ <term><parameter>string</parameter></term>
<listitem>
<para>
Входная строка.
@@ -82,7 +82,6 @@
</refsect1>
</refentry>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/ru/trunk/reference/strings/functions/ucwords.xml
===================================================================
--- phpdoc/ru/trunk/reference/strings/functions/ucwords.xml 2020-12-06 23:34:08 UTC (rev 351939)
+++ phpdoc/ru/trunk/reference/strings/functions/ucwords.xml 2020-12-07 05:04:12 UTC (rev 351940)
@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 350656 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 351904 Maintainer: shein Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.ucwords">
+<refentry xml:id="function.ucwords" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>ucwords</refname>
<refpurpose>Преобразует в верхний регистр первый символ каждого слова в строке</refpurpose>
@@ -12,19 +12,17 @@
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>ucwords</methodname>
- <methodparam><type>string</type><parameter>str</parameter></methodparam>
- <methodparam choice="opt">
- <type>string</type><parameter>delimiters</parameter><initializer>" \t\r\n\f\v"</initializer>
- </methodparam>
+ <methodparam><type>string</type><parameter>string</parameter></methodparam>
+ <methodparam choice="opt"><type>string</type><parameter>separators</parameter><initializer>" \t\r\n\f\v"</initializer></methodparam>
</methodsynopsis>
<para>
- Возвращает строку <parameter>str</parameter>, в которой первый
+ Возвращает строку <parameter>string</parameter>, в которой первый
символ каждого слова переведен в верхний регистр, если этот символ
является буквой.
</para>
<para>
Словом при этом является любая последовательность символов, следующая непосредственно
- за любым из символов, перечисленных в параметре <parameter>delimiters</parameter>
+ за любым из символов, перечисленных в параметре <parameter>separators</parameter>
(по умолчанию это пробел, разрыв страницы, перевод строки, возврат каретки,
горизонтальная или вертикальная табуляция).
</para>
@@ -35,7 +33,7 @@
<para>
<variablelist>
<varlistentry>
- <term><parameter>str</parameter></term>
+ <term><parameter>string</parameter></term>
<listitem>
<para>
Входная строка.
@@ -43,10 +41,10 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><parameter>delimiters</parameter></term>
+ <term><parameter>separators</parameter></term>
<listitem>
<para>
- Необязательный параметр <parameter>delimiters</parameter> содержит символы разделителей слов.
+ Необязательный параметр <parameter>separators</parameter> содержит символы разделителей слов.
</para>
</listitem>
</varlistentry>
@@ -132,7 +130,6 @@
</refsect1>
</refentry>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/ru/trunk/reference/strings/functions/vfprintf.xml
===================================================================
--- phpdoc/ru/trunk/reference/strings/functions/vfprintf.xml 2020-12-06 23:34:08 UTC (rev 351939)
+++ phpdoc/ru/trunk/reference/strings/functions/vfprintf.xml 2020-12-07 05:04:12 UTC (rev 351940)
@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 347041 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 351904 Maintainer: shein Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.vfprintf">
+<refentry xml:id="function.vfprintf" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>vfprintf</refname>
<refpurpose>Записывает отформатированную строку в поток</refpurpose>
@@ -12,14 +12,14 @@
&reftitle.description;
<methodsynopsis>
<type>int</type><methodname>vfprintf</methodname>
- <methodparam><type>resource</type><parameter>handle</parameter></methodparam>
+ <methodparam><type>resource</type><parameter>stream</parameter></methodparam>
<methodparam><type>string</type><parameter>format</parameter></methodparam>
- <methodparam><type>array</type><parameter>args</parameter></methodparam>
+ <methodparam><type>array</type><parameter>values</parameter></methodparam>
</methodsynopsis>
<para>
Записывает строку, отформатированную в соответствии с
параметром <parameter>format</parameter> в поток
- <parameter>handle</parameter>.
+ <parameter>stream</parameter>.
</para>
<para>
Данная функция похожа на <function>fprintf</function>, но принимает
@@ -32,7 +32,7 @@
<para>
<variablelist>
<varlistentry>
- <term><parameter>handle</parameter></term>
+ <term><parameter>stream</parameter></term>
<listitem>
<para>
</para>
@@ -40,7 +40,7 @@
</varlistentry>
&strings.parameter.format;
<varlistentry>
- <term><parameter>args</parameter></term>
+ <term><parameter>values</parameter></term>
<listitem>
<para>
</para>
@@ -95,7 +95,6 @@
</refsect1>
</refentry>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/ru/trunk/reference/strings/functions/vprintf.xml
===================================================================
--- phpdoc/ru/trunk/reference/strings/functions/vprintf.xml 2020-12-06 23:34:08 UTC (rev 351939)
+++ phpdoc/ru/trunk/reference/strings/functions/vprintf.xml 2020-12-07 05:04:12 UTC (rev 351940)
@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 347041 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 351904 Maintainer: shein Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.vprintf">
+<refentry xml:id="function.vprintf" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>vprintf</refname>
<refpurpose>Выводит отформатированную строку</refpurpose>
@@ -13,7 +13,7 @@
<methodsynopsis>
<type>int</type><methodname>vprintf</methodname>
<methodparam><type>string</type><parameter>format</parameter></methodparam>
- <methodparam><type>array</type><parameter>args</parameter></methodparam>
+ <methodparam><type>array</type><parameter>values</parameter></methodparam>
</methodsynopsis>
<para>
Выводит значения массива, отформатированные в соответствии с
@@ -32,7 +32,7 @@
<variablelist>
&strings.parameter.format;
<varlistentry>
- <term><parameter>args</parameter></term>
+ <term><parameter>values</parameter></term>
<listitem>
<para>
</para>
@@ -89,7 +89,6 @@
</refsect1>
</refentry>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/ru/trunk/reference/strings/functions/wordwrap.xml
===================================================================
--- phpdoc/ru/trunk/reference/strings/functions/wordwrap.xml 2020-12-06 23:34:08 UTC (rev 351939)
+++ phpdoc/ru/trunk/reference/strings/functions/wordwrap.xml 2020-12-07 05:04:12 UTC (rev 351940)
@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 343899 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 351904 Maintainer: shein Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.wordwrap">
+<refentry xml:id="function.wordwrap" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>wordwrap</refname>
<refpurpose>Переносит строку по указанному количеству символов</refpurpose>
@@ -12,10 +12,10 @@
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>wordwrap</methodname>
- <methodparam><type>string</type><parameter>str</parameter></methodparam>
+ <methodparam><type>string</type><parameter>string</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>width</parameter><initializer>75</initializer></methodparam>
<methodparam choice="opt"><type>string</type><parameter>break</parameter><initializer>"\n"</initializer></methodparam>
- <methodparam choice="opt"><type>bool</type><parameter>cut</parameter><initializer>&false;</initializer></methodparam>
+ <methodparam choice="opt"><type>bool</type><parameter>cut_long_words</parameter><initializer>&false;</initializer></methodparam>
</methodsynopsis>
<para>
Переносит строку по указанному количеству символов.
@@ -27,7 +27,7 @@
<para>
<variablelist>
<varlistentry>
- <term><parameter>str</parameter></term>
+ <term><parameter>string</parameter></term>
<listitem>
<para>
Входная строка.
@@ -52,10 +52,10 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><parameter>cut</parameter></term>
+ <term><parameter>cut_long_words</parameter></term>
<listitem>
<para>
- Если параметр <parameter>cut</parameter> установлен в &true;,
+ Если параметр <parameter>cut_long_words</parameter> установлен в &true;,
строка всегда будет переноситься на указанной ширине <parameter>width</parameter>
или раньше. Поэтому, если исходная строка содержит слово длиннее заданной
ширины строки, то оно будет разорвано. (Смотрите второй пример). Если установлен в
@@ -158,7 +158,6 @@
</refsect1>
</refentry>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml