String functions: improvements

git-svn-id: https://svn.php.net/repository/phpdoc/ru/trunk@344203 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Alexey Pyltsyn
2018-02-09 17:02:26 +00:00
parent 7d7b1f202a
commit 1fc1dfcc25
21 changed files with 38 additions and 37 deletions

View File

@ -2082,7 +2082,7 @@ xmlns="http://docbook.org/ns/docbook">Это расширение объявле
</para>
<para xmlns="http://docbook.org/ns/docbook">
Если не указан, то значением по умолчанию для <parameter>encoding</parameter> зависит
Если не указан, то значение по умолчанию для <parameter>encoding</parameter> зависит
от используемой версии PHP. В PHP 5.6 и старше, для значения по умолчанию используется
конфигурационная опция <link linkend="ini.default-charset">default_charset</link>.
В PHP 5.4 и 5.5 используется <literal>UTF-8</literal> по умолчанию. Более ранние версии PHP

View File

@ -51,7 +51,7 @@ eval("echo '" . addslashes($str) . "';");
</para>
<para>
Иногда функцию <function>addslashes</function> некорректно пытаются использовать
для предотвращения <link linkend="security.database.sql-injection">SQL Инъекций</link>.
для предотвращения <link linkend="security.database.sql-injection">SQLнъекций</link>.
Не делайте так. Вместо нее используйте подготовленные запросы или функции
экранирования соответствующих расширений работы с базами данных.
</para>

View File

@ -18,7 +18,7 @@
<para>
<function>crypt</function> возвращает хешированную строку,
полученную с помощью стандартного алгоритма UNIX, основанного
на <abbrev>DES</abbrev>, или другого алгоритма, имеющегося в
на <abbrev>DES</abbrev> или другого алгоритма, имеющегося в
системе.
</para>
<para>
@ -34,7 +34,7 @@
</para>
<para>
Некоторые операционные системы поддерживают несколько алгоритмов
хэширования. Иногда стандартный алгоритм, основанный на DES,
хеширования. Иногда стандартный алгоритм, основанный на DES,
заменяется алгоритмом на основе MD5. Вид хеширования определяется
переданным аргументом salt (соль). До версии PHP 5.3, PHP определял
доступные алгоритмы шифрования во время инсталляции, базируясь
@ -56,7 +56,7 @@
</para>
<simpara>
На системах, где функция crypt() поддерживает несколько алгоритмов
хэширования, следующие константы устанавливаются в 0 или 1 в
хеширования, следующие константы устанавливаются в 0 или 1, в
зависимости от доступности соответствующего алгоритма:
</simpara>
<itemizedlist>
@ -107,7 +107,7 @@
<constant>CRYPT_SHA256</constant> - хеш SHA-256 с шестнадцатисимвольной
солью, начинающейся с $5$. Если строка с солью начинается с
'rounds=&lt;N&gt;$', число N будет использовано для обозначения
количества раундов хэширования, по аналогии с весовым параметром
количества раундов хеширования, по аналогии с весовым параметром
в Blowfish. По умолчанию используемое количество раундов равно 5000,
минимально доступно 1000 и максимально 999,999,999. Любое значение
вне этого диапазона будет усечено до ближайшего лимита.
@ -177,7 +177,7 @@
<simpara>
При валидации паролей должны использоваться функции сравнения строк, устойчивые к
атаке по времени, для сравнения вывода функции <function>crypt</function> с известным
хэшом. В PHP 5.6 и новее для этих целей есть функция <function>hash_equals</function>.
хешом. В PHP 5.6 и новее для этих целей есть функция <function>hash_equals</function>.
</simpara>
</warning>
</refsect1>
@ -199,13 +199,13 @@
<entry>
Теперь, если в параметр <parameter>salt</parameter> передано неправильное значение
"*0", то будет возвращаться "*1" согласно другим криптографическим реализациям.
До этой версии PHP 5.6 возвращал DES хэш.
До этой версии PHP 5.6 возвращал DES хеш.
</entry>
</row>
<row>
<entry>5.6.0</entry>
<entry>
Если параметр <parameter>salt</parameter> пропущен, то бросается предупреждение E_NOTICE.
Если параметр <parameter>salt</parameter> пропущен, то вызывается предупреждение E_NOTICE.
</entry>
</row>
<row>

View File

@ -111,7 +111,7 @@ echo 'foo - это $foo'; // foo - это $foo
echo $foo; // foobar
echo $foo,$bar; // foobarbarbaz
// Вместо конкатенации можно предать список аргументов, которые будут склеены
// Вместо конкатенации можно предать список аргументов, которые будут объединены
// в одну строку и обработаны как один аргумент
echo 'Эта ', 'строка ', 'была ', 'создана ', 'несколькими параметрами.', chr(10);
echo 'Эта ' . 'строка ' . 'была ' . 'создана ' . 'с помощью конкатенации.' . "\n";
@ -150,8 +150,8 @@ echo $some_var ? 'true': 'false'; // echo вынесен за пределы в
<programlisting role="php">
<![CDATA[
<?php
echo "Sum: ", 1 + 2;
echo "Hello ", isset($name) ? $name : "John Doe", "!";
echo "Сумма: ", 1 + 2;
echo "Привет, ", isset($name) ? $name : "незнакомец", "!";
]]>
</programlisting>
@ -162,8 +162,8 @@ echo "Hello ", isset($name) ? $name : "John Doe", "!";
<programlisting role="php">
<![CDATA[
<?php
echo 'Sum: ' . (1 + 2);
echo 'Hello ' . (isset($name) ? $name : 'John Doe') . '!';
echo 'Сумма: ' . (1 + 2);
echo 'Привет, ' . (isset($name) ? $name : 'незнакомец') . '!';
]]>
</programlisting>
</tip>

View File

@ -103,7 +103,7 @@
<para>
Используемая кодировка.
Если не указана, то значением по умолчанию для этого аргумента является ISO-8859-1 в
версиях PHP до 5.4.0 и UTF-8, начиная с версии 5.4.0 и далее.
версиях PHP до 5.4.0 и UTF-8, начиная с версии 5.4.0 и выше.
</para>
&reference.strings.charsets;
</listitem>

View File

@ -95,7 +95,7 @@
<programlisting role="php">
<![CDATA[
<?php
$hex = hex2bin("6578616d706c65206865782064617461");
$hex = hex2bin("d0bfd180d0b8d0bcd0b5d18020d188d0b5d181d182d0bdd0b0d0b4d186d0b0d182d0b5d180d0b8d187d0bdd18bd18520d0b4d0b0d0bdd0bdd18bd185");
var_dump($hex);
?>
]]>
@ -103,7 +103,7 @@ var_dump($hex);
&example.outputs.similar;
<screen>
<![CDATA[
string(16) "пример hex данных"
string(16) "пример шестнадцатеричных данных"
]]>
</screen>
</example>

View File

@ -24,7 +24,7 @@
<para>
Если быть точнее, то эта функция преобразует все сущности (в том числе все числовые
сущности), которые а) обязательно верны для выбранного типа документа - то есть,
для XML, эта функция не преобразует именованные сущности, которые могут быть определены
для XML эта функция не преобразует именованные сущности, которые могут быть определены
в каком-нибудь DTD - и б) их символы находятся в кодировке, соответствующей выбранной
и разрешены в выбранном типе документа. Все другие сущности остаются без изменений.
</para>
@ -68,7 +68,7 @@
</row>
<row>
<entry><constant>ENT_NOQUOTES</constant></entry>
<entry>И двойные, и одиночные кавычки остаются без изменений.</entry>
<entry>Оставить как двойные, так и одинарные кавычки без изменений.</entry>
</row>
<row>
<entry><constant>ENT_HTML401</constant></entry>

View File

@ -301,7 +301,7 @@ echo $new; // &lt;a href=&#039;test&#039;&gt;Test&lt;/a&gt;
<itemizedlist>
<listitem>
<simpara>
Если одновременно отсутствуют константы <constant>ENT_COMPAT</constant>, <constant>ENT_QUOTES</constant>,
Если одновременно отсутствуют константы <constant>ENT_COMPAT</constant>, <constant>ENT_QUOTES</constant>
и <constant>ENT_NOQUOTES</constant>, по умолчанию будет использоваться <constant>ENT_COMPAT</constant>.
</simpara>
</listitem>

View File

@ -24,8 +24,8 @@
</para>
<note>
<para>
По историческим причинам, функции <function>implode</function> можно
передавать аргументы в любом порядке, однако для унификации с
По историческим причинам функции <function>implode</function> можно
передавать аргументы в любом порядке, однако для согласованности с
функцией <function>explode</function> следует использовать
документированный порядок аргументов.
</para>

View File

@ -107,7 +107,7 @@
<row>
<entry>5.4.0</entry>
<entry>
Функция поддерживает многобайтную строку в качестве параметров
Функция поддерживает многобайтовую строку в качестве параметров
<parameter>dec_point</parameter> и
<parameter>thousands_sep</parameter>. В предыдущих версиях
в качестве разделителя использовался

View File

@ -73,7 +73,7 @@
</listitem>
<listitem>
<simpara>
<constant>LC_MESSAGES</constant> для системных сообщений (доступна, если PHP был скомпилирован с поддержкой
<constant>LC_MESSAGES</constant> - для системных сообщений (доступна, если PHP был скомпилирован с поддержкой
<literal>libintl</literal>)
</simpara>
</listitem>
@ -116,7 +116,7 @@
</variablelist>
<note>
<para>
На Windows, setlocale(LC_ALL, '') устанавливает имена локалей из системных
На Windows setlocale(LC_ALL, '') устанавливает имена локалей из системных
региональных/языковых настроек (доступных через Панель Управления).
</para>
</note>
@ -160,7 +160,7 @@
<row>
<entry>7.0.0</entry>
<entry>
Удалена поддержка для параметра <parameter>category</parameter> передаваемого
Удалена поддержка для параметра <parameter>category</parameter>, передаваемого
как строка. С текущей версии можно пользоваться только константами <literal>LC_*</literal>.
</entry>
</row>

View File

@ -18,6 +18,7 @@
Вычисляет SHA1-хеш файла, имя которого задано аргументом
<parameter>filename</parameter>, используя алгоритм <link
xlink:href="&url.rfc;3174">US Secure Hash Algorithm 1</link> и возвращает этот хеш.
Хеш - 40-символьное шестнадцатеричное число.
</simpara>
</refsect1>

View File

@ -17,7 +17,7 @@
</methodsynopsis>
<para>
Обратите внимание, что эта функция учитывает регистр символов, и в
отличие от <function>strcmp</function> не безопасна для обработки
отличие от <function>strcmp</function>, не безопасна для обработки
данных в двоичной форме.
</para>
<para>

View File

@ -44,7 +44,7 @@
<note>
<para>
Комментарии HTML и PHP-теги также будут удалены. Это жестко
записано в коде и не может быть изменено с помощью параметра
задано в коде и не может быть изменено с помощью параметра
<parameter>allowable_tags</parameter>.
</para>
</note>

View File

@ -133,7 +133,7 @@
</para>
<para>
<example>
<title>Использование "нестроки" в поиске</title>
<title>Использование не строки в поиске</title>
<programlisting role="php">
<![CDATA[
<?php

View File

@ -16,7 +16,7 @@
<methodparam><type>mixed</type><parameter>needle</parameter></methodparam>
</methodsynopsis>
<para>
Возвращает подстроку строки <parameter>haystack</parameter> начиная с
Возвращает подстроку строки <parameter>haystack</parameter>, начиная с
последнего вхождения <parameter>needle</parameter> до конца строки.
</para>
</refsect1>

View File

@ -54,7 +54,7 @@
Если указан, то поиск начнется с данного количества символов
с начала строки. Если передано
отрицательное значение, поиск начнется с указанного количества
символов от конца строки, но по прежнему будет производится поиск последнего вхождения.
символов от конца строки, но по-прежнему будет производится поиск последнего вхождения.
</para>
</listitem>
</varlistentry>

View File

@ -176,7 +176,7 @@ echo substr('abcdef', 0, 8); // abcdef
echo substr('abcdef', -1, 1); // f
// Получить доступ к отдельному символу в строке
// можно также с помощью "квадратных скобок"
// можно также с помощью квадратных скобок
$string = 'abcdef';
echo $string[0]; // a
echo $string[3]; // d

View File

@ -23,7 +23,7 @@
является буквой.
</para>
<para>
Словом, при этом, является любая последовательность символов, следующая непосредственно
Словом при этом является любая последовательность символов, следующая непосредственно
за любым из символов, перечисленных в параметре <parameter>delimiters</parameter>
(по умолчанию это пробел, разрыв страницы, перевод строки, возврат каретки,
горизонтальная или вертикальная табуляция).

View File

@ -48,7 +48,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Возвращает значения массива в виде строки, отформатированные в соответствии с
Возвращает значения массива в виде строки, отформатированной в соответствии с
параметром <parameter>format</parameter>, описанном в документации
к функции <function>sprintf</function>.
</para>