From 0020dfd504a537ac3bb6e2311f05e1b4909e2dd2 Mon Sep 17 00:00:00 2001
From: Mikhail Alferov <39414600+mmalferov@users.noreply.github.com>
Date: Mon, 3 Jun 2024 21:42:18 +0300
Subject: [PATCH] Update chr.xml

---
 reference/strings/functions/chr.xml | 49 ++++++++++++++++-------------
 1 file changed, 28 insertions(+), 21 deletions(-)

diff --git a/reference/strings/functions/chr.xml b/reference/strings/functions/chr.xml
index c61179d8a..15899e7b7 100644
--- a/reference/strings/functions/chr.xml
+++ b/reference/strings/functions/chr.xml
@@ -4,7 +4,7 @@
 <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" xml:id="function.chr">
  <refnamediv>
   <refname>chr</refname>
-  <refpurpose>Генерирует односимвольную строку по заданному числу</refpurpose>
+  <refpurpose>Генерирует однобайтовую строку из числа</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
@@ -14,16 +14,16 @@
    <methodparam><type>int</type><parameter>codepoint</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Возвращает строку из одного символа, код которого задан аргументом
-   <parameter>codepoint</parameter>, который интерпретируется как
-   беззнаковое целое (unsigned integer).
+   Функция возвращает строку из одного символа, который определяет путём
+   интерпретации кодовой точки <parameter>codepoint</parameter> как
+   целого беззнакового числа.
   </para>
   <para>
-   Может использоваться для создания строки из одного символа однобайтовой
-   кодировки, например, такой как ASCII, ISO-8859 или Windows 1252, путём
-   указания позиции этого символа в таблице кодировки. Данная функция
-   не подходит для генерации односимвольной строки в многобайтовых
-   кодировках, таких как UTF-8 или UTF-16.
+   Функцией создают односимвольную строку в однобайтовой кодировке
+   наподобие ASCII, ISO-8859 или Windows 1252 путём
+   передачи позиции необходимого символа в таблице сопоставления кодировки. Обратите внимание,
+   функция не распознаёт кодировку строк и не передаёт значение кодовой точки Юникода
+   для генерации строки в многобайтовой кодировке наподобие UTF-8 или UTF-16.
   </para>
   <para>
    Эта функция дополняет функцию <function>ord</function>.
@@ -41,8 +41,8 @@
        Целое число от 0 до 255.
       </para>
       <para>
-       Значения за пределом диапазона (0..255) должны быть побитово сложены (побитовое И)
-       с 255, что соответствует такому алгоритму:
+       Значения, которые выходят за пределы допустимого диапазона 0..255,
+       необходимо сложить со значением 255 через побитовое И, что соответствует такому алгоритму:
        <programlisting role="php">
 <![CDATA[
 while ($bytevalue < 0) {
@@ -61,7 +61,7 @@ $bytevalue %= 256;
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Возвращает строку из одного символа, содержащую заданный байт.
+   Функция возвращает односимвольную строку, которая содержит заданный байт.
   </para>
  </refsect1>
 
@@ -79,8 +79,8 @@ $bytevalue %= 256;
      <row>
       <entry>7.4.0</entry>
       <entry>
-       Функция больше не принимает неподдерживаемые значения в параметре <parameter>codepoint</parameter>
-       и преобразовывает их в <literal>0</literal>.
+       Функция больше не принимает без уведомления неподдерживаемые кодовые точки
+       <parameter>codepoint</parameter> и приводит их к <literal>0</literal>.
       </entry>
      </row>
     </tbody>
@@ -92,18 +92,20 @@ $bytevalue %= 256;
   &reftitle.examples;
   <para>
    <example>
-    <title>Пример использования <function>chr</function></title>
+    <title>Пример использования функции <function>chr</function></title>
     <programlisting role="php">
 <![CDATA[
 <?php
-// Предполагается, что строка будет использовака как ASCII или ASCII-совместимая
 
-$str = "Эта строка заканчивается на escape: ";
-$str .= chr(27); /* добавляет символ escape в конец $str */
+// Предполагается, что строка будет использована в кодировке ASCII или в ASCII-совместимой кодировке
 
-/* Но обычно лучше использовать такую конструкцию */
+$str = "Эта строка заканчивается символом escape: ";
+$str .= chr(27); /* добавляет символ escape в конец переменной $str */
+
+/* Часто такой код полезнее */
 
 $str = sprintf("Эта строка заканчивается на escape: %c", 27);
+
 ?>
 ]]>
     </programlisting>
@@ -113,7 +115,9 @@ $str = sprintf("Эта строка заканчивается на escape: %c",
     <programlisting role="php">
 <![CDATA[
 <?php
+
 echo chr(-159), chr(833), PHP_EOL;
+
 ?>
 ]]>
     </programlisting>
@@ -127,12 +131,15 @@ aA
   </para>
   <para>
    <example>
-    <title>Создание строки UTF-8 из индивидуальных байтов</title>
+    <title>Пример создания строки в кодировке UTF-8 из отдельных байтов</title>
     <programlisting role="php">
 <![CDATA[
 <?php
+
 $str = chr(240) . chr(159) . chr(144) . chr(152);
+
 echo $str;
+
 ?>
 ]]>
     </programlisting>
@@ -148,7 +155,7 @@ echo $str;
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member>Описание формата <literal>%c</literal> функции <function>sprintf</function></member>
+    <member><function>sprintf</function> с форматированием через спецификатор <literal>%c</literal></member>
     <member><function>ord</function></member>
     <member><link xlink:href="&url.asciitable;">Таблица ASCII-кодов</link></member>
     <member><function>mb_chr</function></member>