com doc/ja: Update implode() docs for PHP 8.0.0: reference/strings/functions/implode.xml

[email protected] (Yoshinari Takaoka) Fri, 01 Jan 2021 20:15:49 +0000
Newsgroups php.doc.ja
Message-ID <[email protected]>
Commit:    192f91520d83285e77956827f946f77a3b8019d9
Author:    Yoshinari Takaoka <[email protected]>         Sat, 2 Jan 2021 05:15:49 +0900
Parents:   157b2fab21e7e92d77996a097794eacd2c431927
Branches:  master

Link:       http://git.php.net/?p=doc/ja.git;a=commitdiff;h=192f91520d83285e77956827f946f77a3b8019d9

Log:
Update implode() docs for PHP 8.0.0

Closes GH-269.

Changed paths:
  M  reference/strings/functions/implode.xml


Diff:
diff --git a/reference/strings/functions/implode.xml b/reference/strings/functions/implode.xml
index 5d31300b8d..14e9314e7a 100644
--- a/reference/strings/functions/implode.xml
+++ b/reference/strings/functions/implode.xml
@@ -1,8 +1,8 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: e50c87114588f058084e4cca47b95ddbe4a3bb1c Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: 3c969c420f1232ac0946c70d3d6bb90d7f4e9c31 Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: shimooka,mumumu -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.implode">
+<refentry xml:id="function.implode" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>implode</refname>
   <refpurpose>配列要素を文字列により連結する</refpurpose>
@@ -12,24 +12,23 @@
   &reftitle.description;
   <methodsynopsis>
    <type>string</type><methodname>implode</methodname>
-   <methodparam><type>string</type><parameter>glue</parameter></methodparam>
-   <methodparam><type>array</type><parameter>pieces</parameter></methodparam>
+   <methodparam><type>string</type><parameter>separator</parameter></methodparam>
+   <methodparam><type>array</type><parameter>array</parameter></methodparam>
   </methodsynopsis>
+  <simpara>代替のシグネチャ(名前付き引数をサポートしていません):</simpara>
   <methodsynopsis>
    <type>string</type><methodname>implode</methodname>
-   <methodparam><type>array</type><parameter>pieces</parameter></methodparam>
+   <methodparam><type>array</type><parameter>array</parameter></methodparam>
+  </methodsynopsis>
+  <simpara>古いシグネチャ(PHP 7.4.0 で非推奨となり、PHP 8.0.0 以降は削除されています):</simpara>
+  <methodsynopsis>
+   <type>string</type><methodname>implode</methodname>
+   <methodparam><type>array</type><parameter>array</parameter></methodparam>
+   <methodparam><type>string</type><parameter>separator</parameter></methodparam>
   </methodsynopsis>
   <para>
-   配列の要素を <parameter>glue</parameter> 文字列で連結します。
+   配列の要素を <parameter>separator</parameter> 文字列で連結します。
   </para>
-  <note>
-   <para>
-    <function>implode</function>は、歴史的な理由により、引数をどちら
-    の順番でも受けつけることが可能です。しかし、
-    <function>explode</function> との統一性の観点からは、
-    ドキュメントに記述された引数の順番を使用しないことは<emphasis>推奨されません</emphasis>。
-   </para>
-  </note>
  </refsect1>
 
  <refsect1 role="parameters">
@@ -37,7 +36,7 @@
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter>glue</parameter></term>
+     <term><parameter>separator</parameter></term>
      <listitem>
       <para>
        デフォルトは空文字列です。
@@ -45,7 +44,7 @@
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>pieces</parameter></term>
+     <term><parameter>array</parameter></term>
      <listitem>
       <para>
        連結したい文字列の配列。
@@ -60,7 +59,7 @@
   &reftitle.returnvalues;
   <para>
    すべての配列要素の順序を変えずに、各要素間に
-   <parameter>glue</parameter> 文字列をはさんで 1 つの文字列にして返します。
+   <parameter>separator</parameter> 文字列をはさんで 1 つの文字列にして返します。
   </para>
  </refsect1>
 
@@ -76,11 +75,18 @@
     </thead>
     <tbody>
      <row>
+      <entry>8.0.0</entry>
+      <entry>
+       <parameter>array</parameter> の後に <parameter>separator</parameter>
+       を渡すことは、サポートされなくなりました。
+      </entry>
+     </row>
+     <row>
       <entry>7.4.0</entry>
       <entry>
-       <parameter>pieces</parameter> の後に <parameter>glue</parameter>
+       <parameter>array</parameter> の後に <parameter>separator</parameter>
        を渡すこと
-       (つまり、ドキュメントに記されたパラメータの順番を使用しないこと)
+       (つまり、古いシグネチャを使うこと)
        は、推奨されなくなりました。
       </entry>
      </row>