Added new files, synced some files with EN, string.xml — partial sync

php · Nov 21, 2024 · 7a7721d · 7a7721d
1 parent 7d0528d
commit 7a7721d
Show file tree

Hide file tree

Showing 6 changed files with 219 additions and 17 deletions.
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -44,6 +44,7 @@ _pull request_. Після певної кількості підтвердже
 | debugger | зневаджувач/налагоджувач |
 | directory | директорія |
 | engine | рушій |
+| enum(eration) | перелічення |
 | exception | виключення |
 | FAQ | ЧаПи (увага на регістри букв) |
 | float | десятковий дріб/число з рухомою крапкою |

diff --git a/language/oop5.xml b/language/oop5.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: c0fa5077c8862405942d8aac7360c5169558b59b Maintainer: mproshchuk Status: ready -->
+<!-- EN-Revision: f9dabdea3f92ea77cf5077020a3e945951fdc9db Maintainer: mproshchuk Status: ready -->
 
 <chapter xml:id="language.oop5" xmlns="http://docbook.org/ns/docbook">
  <title>Класи та об'єкти</title>
@@ -24,6 +24,7 @@
 
   &language.oop5.basic;
   &language.oop5.properties;
+  &language.oop5.property-hooks;
   &language.oop5.constants;
   &language.oop5.autoload;
   &language.oop5.decon;

diff --git a/language/oop5/decon.xml b/language/oop5/decon.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 9f351a14a749721a74df1dc6ac9533cf796a652e Maintainer: mproshchuk Status: ready -->
+<!-- EN-Revision: 376d3f9c2ef7fcd64d8b8503d552013acefb8b5b Maintainer: mproshchuk Status: ready -->
  <sect1 xml:id="language.oop5.decon" xmlns="http://docbook.org/ns/docbook">
   <title>Конструктори та деструктори</title>
 
@@ -362,6 +362,23 @@ $obj = new MyDestructableClass();
     функцією <function>exit</function>. Виклик <function>exit</function>
     в деструкторі запобігає виконанню решти процедур завершення скрипта.
    </para>
+   <para>
+    Якщо деструктор створює нові посилання на свій об'єкт, його не буде
+    викликано вдруге, коли кількість посилань знову досягне нуля чи під час
+    завершення скрипта.
+   </para>
+   <para>
+    Починаючи з PHP 8.4.0, якщо <link
+    linkend="features.gc.collecting-cycles">збирання циклів</link> вмикається
+    під час виконання <link linkend="language.fibers">файбера</link>, то
+    заплановані деструктори об'єктів виконуються в окремому файбері з назвою
+    <literal>gc_destructor_fiber</literal>. Якщо цей файбер призупинено, то
+    створюється новий, щоб довиконати деструктори. Збирач сміття більше не
+    посилатиметься на попередній файбер <literal>gc_destructor_fiber</literal>,
+    який буде знищений під час наступного збирання сміття. Об'єкт, чий
+    деструктор призупинено, не знищиться, допоки деструктор не буде виконано
+    або не буде знищено файбер.
+   </para>
    <note>
     <para>
      Під час завершення скрипта деструктори викликаються після відправлення

diff --git a/language/types/string.xml b/language/types/string.xml
@@ -1019,36 +1019,36 @@ echo "C:\\folder\\{$great}.txt";
 
    <note>
     <simpara>
-     Prior to PHP 8.0.0, <type>string</type>s could also be accessed using braces, as in
-     <varname>$str{42}</varname>, for the same purpose.
-     This curly brace syntax was deprecated as of PHP 7.4.0 and no longer supported as of PHP 8.0.0.
+     До PHP 8.0.0, з тією самою метою рядки (<type>string</type>) підтримують
+     фігурні дужки, напр. <varname>$str{42}</varname>. Такий синтаксис
+     застарілий, починаючи з PHP 7.4.0, та видалений в PHP 8.0.0.
     </simpara>
    </note>
 
    <warning>
     <simpara>
-     Writing to an out of range offset pads the string with spaces.
-     Non-integer types are converted to integer.
-     Illegal offset type emits <constant>E_WARNING</constant>.
-     Only the first character of an assigned string is used.
-     As of PHP 7.1.0, assigning an empty string throws a fatal error. Formerly,
-     it assigned a NULL byte.
+     Запис в позицію за межами рядка доповнює рядок пропусками. Не цілочисельні
+     позиції перетворюються в цілі числа. Якщо задано недопустимий тип позиції,
+     виводиться <constant>E_WARNING</constant>. Записується тільки перший символ
+     заданого рядка. Починаючи з PHP 7.1.0, заданий порожній рядок викликає
+     фатальну помилку. Раніше, він перетворювався в NULL-байт.
     </simpara>
    </warning>
 
    <warning>
     <simpara>
-     Internally, PHP strings are byte arrays. As a result, accessing or
-     modifying a string using array brackets is not multi-byte safe, and
-     should only be done with strings that are in a single-byte encoding such
-     as ISO-8859-1.
+     Всередині інтерпретатора рядки є масивами байтів. Як наслідок, доступ до
+     рядка або його редагування, як масиву, не є безпечним для багатобайтових
+     кодувань і має здійснюватися лише з рядками в однобайтовому кодуванні,
+     наприклад, ISO-8859-1.
     </simpara>
    </warning>
 
    <note>
     <simpara>
-     As of PHP 7.1.0, applying the empty index operator on an empty string throws a fatal
-     error. Formerly, the empty string was silently converted to an array.
+     Починаючи з PHP 7.1.0, застосування порожнього оператора індексу до
+     порожнього рядка призводить до фатальної помилки. Раніше порожній рядок
+     автоматично перетворювався на масив.
     </simpara>
    </note>
 

diff --git a/reference/math/roundingmode.xml b/reference/math/roundingmode.xml
@@ -0,0 +1,106 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: e75557e268736a2a08a5cd17f50048e9db545e02 Maintainer: mproshchuk Status: ready -->
+<reference xmlns="http://docbook.org/ns/docbook" xml:id="enum.roundingmode" role="enum">
+ <title>Перелічення RoundingMode</title>
+ <titleabbrev>RoundingMode</titleabbrev>
+
+ <partintro>
+  <section xml:id="enum.roundingmode.intro">
+   &reftitle.intro;
+   <simpara>
+    Перелічення <enumname>RoundingMode</enumname> визначає, як має відбуватись
+    округлення у функцій <function>round</function>,
+    <function>bcround</function> і <methodname>BCMath::round</methodname>.
+   </simpara>
+  </section>
+
+  <section xml:id="enum.roundingmode.synopsis">
+   &reftitle.enumsynopsis;
+
+   <enumsynopsis>
+    <enumname>RoundingMode</enumname>
+
+    <enumitem>
+     <enumidentifier>HalfAwayFromZero</enumidentifier>
+     <enumitemdescription>
+      Округлювати до найближчого цілого. Якщо дробова частина числа дорівнює
+      <literal>5</literal>, число округлюється до більшого цілого.
+     </enumitemdescription>
+    </enumitem>
+
+    <enumitem>
+     <enumidentifier>HalfTowardsZero</enumidentifier>
+     <enumitemdescription>
+      Округлювати до найближчого цілого. Якщо дробова частина числа дорівнює
+      <literal>5</literal>, число округлюється до меншого цілого.
+     </enumitemdescription>
+    </enumitem>
+
+    <enumitem>
+     <enumidentifier>HalfEven</enumidentifier>
+     <enumitemdescription>
+      Округлювати до найближчого цілого. Якщо дробова частина числа дорівнює
+      <literal>5</literal>, число округлюється до парного цілого.
+     </enumitemdescription>
+    </enumitem>
+
+    <enumitem>
+     <enumidentifier>HalfOdd</enumidentifier>
+     <enumitemdescription>
+      Округлювати до найближчого цілого. Якщо дробова частина числа дорівнює
+      <literal>5</literal>, число округлюється до непарного цілого.
+     </enumitemdescription>
+    </enumitem>
+
+    <enumitem>
+     <enumidentifier>TowardsZero</enumidentifier>
+     <enumitemdescription>
+      Округлити до найближчого меншого або рівного цілого числа.
+     </enumitemdescription>
+    </enumitem>
+
+    <enumitem>
+     <enumidentifier>AwayFromZero</enumidentifier>
+     <enumitemdescription>
+      Округлити до найближчого більшого або рівного цілого числа.
+     </enumitemdescription>
+    </enumitem>
+
+    <enumitem>
+     <enumidentifier>NegativeInfinity</enumidentifier>
+     <enumitemdescription>
+      Округлити до найбільшого цілого, що є менше або рівне.
+     </enumitemdescription>
+    </enumitem>
+
+    <enumitem>
+     <enumidentifier>PositiveInfinity</enumidentifier>
+     <enumitemdescription>
+      Округлити до найменшого цілого, що є більше або рівне.
+     </enumitemdescription>
+    </enumitem>
+
+   </enumsynopsis>
+  </section>
+ </partintro>
+</reference>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/random/random.intervalboundary.xml b/reference/random/random.intervalboundary.xml
@@ -0,0 +1,77 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 550b9c3c31a66c18c9303794c12260bf5c684fed Maintainer: mproshchuk Status: ready -->
+<reference xmlns="http://docbook.org/ns/docbook" xml:id="enum.random.intervalboundary" role="enum">
+ <title>Перелічення Random\IntervalBoundary</title>
+ <titleabbrev>Random\IntervalBoundary</titleabbrev>
+
+ <partintro>
+  <section xml:id="enum.random.intervalboundary.intro">
+   &reftitle.intro;
+   <simpara>
+    Перелічення <enumname>Random\IntervalBoundary</enumname> визначає, чи
+    належать проміжку його межі.
+   </simpara>
+  </section>
+
+  <section xml:id="enum.random.intervalboundary.synopsis">
+   &reftitle.enumsynopsis;
+
+   <enumsynopsis>
+    <enumname>Random\IntervalBoundary</enumname>
+
+    <enumitem>
+     <enumidentifier>ClosedOpen</enumidentifier>
+     <enumitemdescription>
+      Напіввідкритий проміжок.
+      Містить нижню межу, а верхню — ні.
+     </enumitemdescription>
+    </enumitem>
+
+    <enumitem>
+     <enumidentifier>ClosedClosed</enumidentifier>
+     <enumitemdescription>
+      Закритий проміжок.
+      Містить як і нижню, так і верхню межу.
+     </enumitemdescription>
+    </enumitem>
+
+    <enumitem>
+     <enumidentifier>OpenClosed</enumidentifier>
+     <enumitemdescription>
+      Напіввідкритий проміжок.
+      Містить верхню межу, а нижню — ні.
+     </enumitemdescription>
+    </enumitem>
+
+    <enumitem>
+     <enumidentifier>OpenOpen</enumidentifier>
+     <enumitemdescription>
+      Відкритий проміжок.
+      Жодна з меж йому не належить.
+     </enumitemdescription>
+    </enumitem>
+
+   </enumsynopsis>
+  </section>
+ </partintro>
+</reference>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->