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">