Update natsort.xml Исправил формулировки

This commit is contained in:
Mikhail Alferov
2025-07-04 07:05:00 +03:00
committed by GitHub
parent 0d251defe2
commit 9da6988ff6

View File

@ -4,7 +4,7 @@
<refentry xml:id="function.natsort" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>natsort</refname>
<refpurpose>Сортирует массив, для чего использует алгоритм «естественной сортировки»</refpurpose>
<refpurpose>Сортирует массив алгоритмом «естественного упорядочивания»</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
@ -13,11 +13,11 @@
<methodparam><type>array</type><parameter role="reference">array</parameter></methodparam>
</methodsynopsis>
<para>
Эта функция использует алгоритм сортировки, который упорядочивает
Функция реализует алгоритм сортировки, который упорядочивает
буквенно-цифровые строки так, как это сделал бы человек. При этом
функция сохраняет связи между ключами и значениями. Такой алгоритм называется natural ordering.
Пример ниже показывает различия между этим алгоритмом и обычными компьютерными алгоритмами сортировки строк,
которые использует функция <function>sort</function>.
функция сохраняет связи между ключами и значениями. Такой алгоритм называется «естественное упорядочивание» (англ. natural ordering).
Приведённый пример показывает различия между этим алгоритмом и стандартными компьютерными алгоритмами сортировки строк,
по которым работает функция <function>sort</function>.
</para>
&note.sort-unstable;
&note.reset-index;
@ -68,7 +68,7 @@
&reftitle.examples;
<para>
<example>
<title>Простой пример использования <function>natsort</function></title>
<title>Простой пример сортировки массива функцией <function>natsort</function></title>
<programlisting role="php">
<![CDATA[
<?php
@ -76,11 +76,11 @@
$array1 = $array2 = array("img12.png", "img10.png", "img2.png", "img1.png");
asort($array1);
echo "Обычная сортировка\n";
echo "Стандартная сортировка\n";
print_r($array1);
natsort($array2);
echo "\nСортировка natural order\n";
echo "\nСортировка алгоритмом natural order\n";
print_r($array2);
?>
@ -89,7 +89,7 @@ print_r($array2);
&example.outputs;
<screen>
<![CDATA[
Обычная сортировка
Стандартная сортировка
Array
(
[3] => img1.png
@ -98,7 +98,7 @@ Array
[2] => img2.png
)
Сортировка natural order
Сортировка алгоритмом natural order
Array
(
[3] => img1.png
@ -109,23 +109,23 @@ Array
]]>
</screen>
<para>
Подробнее об алгоритме рассказывает страница Martin Pool
Подробнее об алгоритме рассказывает страница «Сравнение строк в естественном порядке» Мартина Пула (Martin Pool)
<link xlink:href="&url.strnatcmp;">Natural Order String Comparison</link>.
</para>
</example>
<example>
<title>Примеры показывают ошибки, которые возникают при использовании функции <function>natsort</function></title>
<title>Примеры показывают ошибки, которые возникают при сортировке массива функцией <function>natsort</function></title>
<programlisting role="php">
<![CDATA[
<?php
echo "Отрицательные числа\n";
$negative = array('-5','3','-2','0','-1000','9','1');
echo "Сортировка отрицательных числовых строк\n";
$negative = array('-5', '3', '-2', '0', '-1000', '9', '1');
print_r($negative);
natsort($negative);
print_r($negative);
echo "Отбивка нулями\n";
echo "Сортировка числовых строк, дополненных ведущими нулями\n";
$zeros = array('09', '8', '10', '009', '011', '0');
print_r($zeros);
natsort($zeros);
@ -137,7 +137,7 @@ print_r($zeros);
&example.outputs;
<screen>
<![CDATA[
Отрицательные числа
Сортировка отрицательных числовых строк
Array
(
[0] => -5
@ -159,7 +159,7 @@ Array
[5] => 9
)
Отбивка нулями
Сортировка числовых строк, дополненных ведущими нулями
Array
(
[0] => 09