svn: /phpdoc/ja/trunk/ language-snippets.ent reference/array/functions/arsort.xml reference/array/functions/asort.xml reference/array/functions/krsort.xml reference/array/functions/ksort.xml reference/array/functions/rsort.xml reference/array/functions/sort.xml reference/spl/arrayobject/asort.xml reference/spl/arrayobject/ksort.xml
[email protected] (Yoshinari Takaoka) Tue, 22 Dec 2020 17:46:53 +0000
| Newsgroups | php.doc.ja |
|---|---|
| Message-ID | <[email protected]> |
mumumu Tue, 22 Dec 2020 17:46:53 +0000
Revision: http://svn.php.net/viewvc?view=revision&revision=352171
Log:
Fix #80543: ArrayObject::asort() and ::ksort() expect an optional int
Bug: https://bugs.php.net/80543 (Closed) ArrayObject::asort() and ::ksort() expect an optional int
Changed paths:
U phpdoc/ja/trunk/language-snippets.ent
U phpdoc/ja/trunk/reference/array/functions/arsort.xml
U phpdoc/ja/trunk/reference/array/functions/asort.xml
U phpdoc/ja/trunk/reference/array/functions/krsort.xml
U phpdoc/ja/trunk/reference/array/functions/ksort.xml
U phpdoc/ja/trunk/reference/array/functions/rsort.xml
U phpdoc/ja/trunk/reference/array/functions/sort.xml
U phpdoc/ja/trunk/reference/spl/arrayobject/asort.xml
U phpdoc/ja/trunk/reference/spl/arrayobject/ksort.xml
svn-diffs-352171.txt
(text/x-diff, 14 KB)
Modified: phpdoc/ja/trunk/language-snippets.ent
===================================================================
--- phpdoc/ja/trunk/language-snippets.ent 2020-12-22 17:43:59 UTC (rev 352170)
+++ phpdoc/ja/trunk/language-snippets.ent 2020-12-22 17:46:53 UTC (rev 352171)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 352166 Maintainer: takagi Status: working -->
+<!-- EN-Revision: 352168 Maintainer: takagi Status: working -->
<!-- Credits: hirokawa,haruki,shimooka,mumumu -->
<!ENTITY installation.enabled.disable 'この拡張モジュールはデフォルトで有効になっています。無効にしたい場合は、次のオプションを指定してコンパイルします。'>
@@ -513,6 +513,51 @@
<!ENTITY seealso.array.sorting '<link xmlns="http://docbook.org/ns/docbook" linkend="array.sorting">配列ソート関数の比較</link>'>
+<!ENTITY sort.flags.parameter '<varlistentry xmlns="http://docbook.org/ns/docbook">
+ <term><parameter>flags</parameter></term>
+ <listitem>
+ <para>
+ オプションの第二引数 <parameter>flags</parameter> によりソートの動作を修正可能です。
+ 使える値は下記の通りです:
+ </para>
+ <para>
+ ソートタイプのフラグ:
+ <itemizedlist>
+ <listitem>
+ <simpara><constant>SORT_REGULAR</constant> - 通常通りに項目を比較します。
+ 詳細は <link linkend="language.operators.comparison">比較演算子</link> で説明されています。</simpara>
+ </listitem>
+ <listitem>
+ <simpara><constant>SORT_NUMERIC</constant> - 数値として項目を比較します。</simpara>
+ </listitem>
+ <listitem>
+ <simpara><constant>SORT_STRING</constant> - 文字列として項目を比較します。</simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <constant>SORT_LOCALE_STRING</constant> - 現在のロケールに基づいて、文字列として項目を比較します。
+ 比較に使うロケールは、<function>setlocale</function> 関数で変更できます。
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <constant>SORT_NATURAL</constant> - 要素の比較を文字列として行い、
+ <function>natsort</function> と同様の「自然順」で比較します。
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <constant>SORT_FLAG_CASE</constant> - <constant>SORT_STRING</constant> や
+ <constant>SORT_NATURAL</constant> と (ビットORで) 組み合わせて使い、
+ 文字列のソートで大文字小文字を区別しないようにします。
+ </simpara>
+ </listitem>
+ </itemizedlist>
+ </para>
+ </listitem>
+ </varlistentry>
+'>
+
<!ENTITY avail.register-long-arrays 'PHP 5.0.0 以降、PHP の長い
<link xmlns="http://docbook.org/ns/docbook" linkend="language.variables.predefined">定義済みの変数</link>
配列は <link xmlns="http://docbook.org/ns/docbook" linkend="ini.register-long-arrays">register_long_arrays</link>
Modified: phpdoc/ja/trunk/reference/array/functions/arsort.xml
===================================================================
--- phpdoc/ja/trunk/reference/array/functions/arsort.xml 2020-12-22 17:43:59 UTC (rev 352170)
+++ phpdoc/ja/trunk/reference/array/functions/arsort.xml 2020-12-22 17:46:53 UTC (rev 352171)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 351860 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: 352168 Maintainer: hirokawa Status: ready -->
<!-- CREDITS: shimooka -->
<refentry xml:id="function.arsort" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@@ -34,16 +34,7 @@
</para>
</listitem>
</varlistentry>
- <varlistentry>
- <term><parameter>flags</parameter></term>
- <listitem>
- <para>
- オプションのパラメータ <parameter>flags</parameter>
- によりソートの動作を修正可能です。詳細については、
- <function>sort</function> を参照ください。
- </para>
- </listitem>
- </varlistentry>
+ &sort.flags.parameter;
</variablelist>
</para>
</refsect1>
Modified: phpdoc/ja/trunk/reference/array/functions/asort.xml
===================================================================
--- phpdoc/ja/trunk/reference/array/functions/asort.xml 2020-12-22 17:43:59 UTC (rev 352170)
+++ phpdoc/ja/trunk/reference/array/functions/asort.xml 2020-12-22 17:46:53 UTC (rev 352171)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 351860 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: 352168 Maintainer: hirokawa Status: ready -->
<refentry xml:id="function.asort" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>asort</refname>
@@ -33,16 +33,7 @@
</para>
</listitem>
</varlistentry>
- <varlistentry>
- <term><parameter>flags</parameter></term>
- <listitem>
- <para>
- オプションのパラメータ <parameter>flags</parameter>
- によりソートの動作を修正可能です。
- 詳細については、<function>sort</function> を参照ください。
- </para>
- </listitem>
- </varlistentry>
+ &sort.flags.parameter;
</variablelist>
</para>
</refsect1>
Modified: phpdoc/ja/trunk/reference/array/functions/krsort.xml
===================================================================
--- phpdoc/ja/trunk/reference/array/functions/krsort.xml 2020-12-22 17:43:59 UTC (rev 352170)
+++ phpdoc/ja/trunk/reference/array/functions/krsort.xml 2020-12-22 17:46:53 UTC (rev 352171)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 351860 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: 352168 Maintainer: hirokawa Status: ready -->
<!-- CREDITS: shimooka -->
<refentry xml:id="function.krsort" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@@ -31,16 +31,7 @@
</para>
</listitem>
</varlistentry>
- <varlistentry>
- <term><parameter>flags</parameter></term>
- <listitem>
- <para>
- オプションのパラメータ <parameter>flags</parameter>
- によりソートの動作を修正可能です。詳細については、
- <function>sort</function> を参照ください。
- </para>
- </listitem>
- </varlistentry>
+ &sort.flags.parameter;
</variablelist>
</para>
</refsect1>
Modified: phpdoc/ja/trunk/reference/array/functions/ksort.xml
===================================================================
--- phpdoc/ja/trunk/reference/array/functions/ksort.xml 2020-12-22 17:43:59 UTC (rev 352170)
+++ phpdoc/ja/trunk/reference/array/functions/ksort.xml 2020-12-22 17:46:53 UTC (rev 352171)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 351860 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: 352168 Maintainer: hirokawa Status: ready -->
<!-- CREDITS: shimooka -->
<refentry xml:id="function.ksort" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@@ -31,16 +31,7 @@
</para>
</listitem>
</varlistentry>
- <varlistentry>
- <term><parameter>flags</parameter></term>
- <listitem>
- <para>
- オプションのパラメータ <parameter>flags</parameter>
- によりソートの動作を修正可能です。詳細については、
- <function>sort</function> を参照ください。
- </para>
- </listitem>
- </varlistentry>
+ &sort.flags.parameter;
</variablelist>
</para>
</refsect1>
Modified: phpdoc/ja/trunk/reference/array/functions/rsort.xml
===================================================================
--- phpdoc/ja/trunk/reference/array/functions/rsort.xml 2020-12-22 17:43:59 UTC (rev 352170)
+++ phpdoc/ja/trunk/reference/array/functions/rsort.xml 2020-12-22 17:46:53 UTC (rev 352171)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 351860 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: 352168 Maintainer: hirokawa Status: ready -->
<!-- CREDITS: shimooka -->
<refentry xml:id="function.rsort" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@@ -31,16 +31,7 @@
</para>
</listitem>
</varlistentry>
- <varlistentry>
- <term><parameter>flags</parameter></term>
- <listitem>
- <para>
- オプションのパラメータ <parameter>flags</parameter>
- によりソートの動作を修正可能です。詳細については、
- <function>sort</function> を参照ください。
- </para>
- </listitem>
- </varlistentry>
+ &sort.flags.parameter;
</variablelist>
</para>
</refsect1>
Modified: phpdoc/ja/trunk/reference/array/functions/sort.xml
===================================================================
--- phpdoc/ja/trunk/reference/array/functions/sort.xml 2020-12-22 17:43:59 UTC (rev 352170)
+++ phpdoc/ja/trunk/reference/array/functions/sort.xml 2020-12-22 17:46:53 UTC (rev 352171)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 351860 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 352168 Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa,shimooka,mumumu -->
<refentry xml:id="function.sort" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -33,52 +33,7 @@
</para>
</listitem>
</varlistentry>
- <varlistentry>
- <term><parameter>flags</parameter></term>
- <listitem>
- <para>
- オプションの 2 番目のパラメータ <parameter>flags</parameter>
- は、以下の値によりソートの動作を修正するために使用することが可能です。
- </para>
- <para>
- ソート型のフラグ:
- <itemizedlist>
- <listitem>
- <simpara><constant>SORT_REGULAR</constant> - 通常通りに項目を比較;
- 比較の詳細は <link
- linkend="language.operators.comparison">比較演算子</link>
- で説明されています。</simpara>
- </listitem>
- <listitem>
- <simpara><constant>SORT_NUMERIC</constant> - 数値的に項目を比較</simpara>
- </listitem>
- <listitem>
- <simpara><constant>SORT_STRING</constant> - 文字列として項目を比較</simpara>
- </listitem>
- <listitem>
- <simpara>
- <constant>SORT_LOCALE_STRING</constant> - は、現在のロケールに基づいて比較します。
- 比較に使うロケールは、<function>setlocale</function> で変更できます。
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <constant>SORT_NATURAL</constant> - 要素の比較を文字列として行い、
- <function>natsort</function> と同様の「自然順」で比較します。
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <constant>SORT_FLAG_CASE</constant> -
- <constant>SORT_STRING</constant> や
- <constant>SORT_NATURAL</constant> と (ビット OR で) 組み合わせて使い、
- 文字列のソートで大文字小文字を区別しないようにします。
- </simpara>
- </listitem>
- </itemizedlist>
- </para>
- </listitem>
- </varlistentry>
+ &sort.flags.parameter;
</variablelist>
</para>
</refsect1>
Modified: phpdoc/ja/trunk/reference/spl/arrayobject/asort.xml
===================================================================
--- phpdoc/ja/trunk/reference/spl/arrayobject/asort.xml 2020-12-22 17:43:59 UTC (rev 352170)
+++ phpdoc/ja/trunk/reference/spl/arrayobject/asort.xml 2020-12-22 17:46:53 UTC (rev 352171)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 334762 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 352168 Maintainer: takagi Status: ready -->
<refentry xml:id="arrayobject.asort" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>ArrayObject::asort</refname>
@@ -10,7 +10,7 @@
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier> <type>void</type><methodname>ArrayObject::asort</methodname>
- <void/>
+ <methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer><constant>SORT_REGULAR</constant></initializer></methodparam>
</methodsynopsis>
<para>
エントリをソートします。キーとそれに対応する値の関連は保持されたままとなります。
@@ -20,7 +20,9 @@
<refsect1 role="parameters">
&reftitle.parameters;
- &no.function.parameters;
+ <variablelist>
+ &sort.flags.parameter;
+ </variablelist>
</refsect1>
<refsect1 role="returnvalues">
Modified: phpdoc/ja/trunk/reference/spl/arrayobject/ksort.xml
===================================================================
--- phpdoc/ja/trunk/reference/spl/arrayobject/ksort.xml 2020-12-22 17:43:59 UTC (rev 352170)
+++ phpdoc/ja/trunk/reference/spl/arrayobject/ksort.xml 2020-12-22 17:46:53 UTC (rev 352171)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 334762 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 352168 Maintainer: takagi Status: ready -->
<refentry xml:id="arrayobject.ksort" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>ArrayObject::ksort</refname>
@@ -10,7 +10,7 @@
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier> <type>void</type><methodname>ArrayObject::ksort</methodname>
- <void/>
+ <methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer><constant>SORT_REGULAR</constant></initializer></methodparam>
</methodsynopsis>
<para>
キーでエントリをソートし、キーと値の関係は保持します。
@@ -20,7 +20,9 @@
<refsect1 role="parameters">
&reftitle.parameters;
- &no.function.parameters;
+ <variablelist>
+ &sort.flags.parameter;
+ </variablelist>
</refsect1>
<refsect1 role="returnvalues">