Fix mistranslations in PCRE (#227)

* Fix mistranslations in PCRE * Fix mistranslations in PCRE(2) --------- Co-authored-by: nyan-dot <nyan-dot@users.noreply.github.com>
php · Dec 25, 2024 · d86ade6 · d86ade6
1 parent 980596e
commit d86ade6
Show file tree

Hide file tree

Showing 4 changed files with 28 additions and 31 deletions.
diff --git a/reference/pcre/constants.xml b/reference/pcre/constants.xml
@@ -82,10 +82,11 @@
      </entry>
      <entry>
       このフラグを設定した場合、各マッチに対応する文字列のオフセットも返されます。
-      これにより、戻り値は配列となり、配列の要素 0 はマッチした文字列、 要素 1 
-      は対象文字列中におけるマッチした文字列のオフセット値となることに注意してください。 
-      このフラグは
-      <function>preg_split</function> のみで使用されます。
+      これにより、戻り値は配列の配列に変わることに注意してください。
+      配列のすべての要素が、オフセット 0 に、マッチした文字列、
+      オフセット 1 に、対象文字列におけるその文字列のオフセット
+      からなる配列になります。
+      このフラグは、<function>preg_split</function> のみで使用されます。
      </entry>
      <entry/>
     </row>
@@ -96,12 +97,11 @@
      </entry>
      <entry>
       このフラグは、
-      <function>preg_match</function> と
-      <function>preg_match_all</function> 関数で
-      マッチしなかったサブパターンがあった場合に、
-      <varname>$matches</varname> に &null; を入れることで伝えます。
+      <function>preg_match</function> と <function>preg_match_all</function> が、
+      マッチしなかったサブパターンを &null; として
+      <varname>$matches</varname> に含むようにします。
       このフラグがないと、マッチしなかったサブパターンは
-      いかにも空文字列にマッチしたかのように空文字列として通知されます。
+      空文字列にマッチしたかのように空文字列として報告されます。
       このフラグを設定することで、これらふたつの場合を区別できます。
      </entry>
      <entry>7.2.0</entry>

diff --git a/reference/pcre/functions/preg-match-all.xml b/reference/pcre/functions/preg-match-all.xml
@@ -65,9 +65,9 @@
      <listitem>
       <para>
        以下のフラグの組み合わせ
-       (<constant>PREG_PATTERN_ORDER</constant> を
-       <constant>PREG_SET_ORDER</constant> と組み合わせて使用することは
-       無意味ですので注意してください)。
+       (<constant>PREG_PATTERN_ORDER</constant> と
+       <constant>PREG_SET_ORDER</constant> を組み合わせて使用することは
+       意味をなさないので注意してください)。
        <variablelist>
         <varlistentry>
          <term><constant>PREG_PATTERN_ORDER</constant></term>
@@ -129,7 +129,7 @@ print_r($matches['match']);
 <![CDATA[
 Array
 (
-    [0] => 
+    [0] =>
     [1] => bar
 )
 ]]>
@@ -173,11 +173,10 @@ echo $out[1][0] . ", " . $out[1][1] . "\n";
          <listitem>
           <para>
            このフラグを設定した場合、各マッチに対応する文字列のオフセットも(バイト単位で)返されます。
-           これは、<parameter>matches</parameter> の値を配列の配列に変更することに注意してください。
-           その配列のすべての要素は、
-           オフセット <literal>0</literal> で一致した文字列
-           およびその文字列のオフセット <literal>1</literal> での
-           <parameter>subject</parameter> へのオフセットからなります。
+           これは、<parameter>matches</parameter> の値を配列の配列の配列に変更することに注意してください。
+           配列の要素である配列のすべての要素が、オフセット <literal>0</literal> に、マッチした文字列、
+           オフセット <literal>1</literal> に、<parameter>subject</parameter> 内でのその文字列のオフセット
+           からなる配列になります。
            <informalexample>
             <programlisting role="php">
 <![CDATA[
@@ -243,13 +242,11 @@ Array
          <term><constant>PREG_UNMATCHED_AS_NULL</constant></term>
          <listitem>
           <para>
-           このフラグが渡されると、
-           マッチしなかったサブパターンがあった場合 &null; として通知されます。
-           このフラグが渡されない場合、
-           空の <type>string</type> として通知されます。
+           このフラグを設定すると、サブパターンがマッチしなかった場合に &null; が渡されます。
+           通常は、空の <type>string</type> が渡されます。
           </para>
          </listitem>
-        </varlistentry>  
+        </varlistentry>
        </variablelist>
       </para>
       <para>

diff --git a/reference/pcre/functions/preg-match.xml b/reference/pcre/functions/preg-match.xml
@@ -67,7 +67,7 @@
           <para>
            このフラグを設定した場合、各マッチに対応する文字列のオフセットも(バイト単位で)返されます。
            これは、<parameter>matches</parameter> の値を配列の配列に変更することに注意してください。
-           配列のすべての要素が、オフセット <literal>0</literal> に、一致した文字列、
+           配列のすべての要素が、オフセット <literal>0</literal> に、マッチした文字列、
            オフセット <literal>1</literal> に、<parameter>subject</parameter> 内でのその文字列のオフセット
            からなる配列になります。
            <informalexample>
@@ -119,8 +119,8 @@ Array
          <term><constant>PREG_UNMATCHED_AS_NULL</constant></term>
          <listitem>
           <para>
-           このフラグが渡されると、マッチしなかったサブパターンは &null; として通知されます。
-           渡されなかった場合、空の <type>string</type> として通知されます。
+           このフラグを設定すると、サブパターンがマッチしなかった場合に &null; が渡されます。
+           通常は、空の <type>string</type> が渡されます。
            <informalexample>
             <programlisting role="php">
 <![CDATA[

diff --git a/reference/pcre/functions/preg-split.xml b/reference/pcre/functions/preg-split.xml
@@ -83,10 +83,10 @@
          <listitem>
           <para>
            このフラグを設定した場合、各マッチに対応する文字列のオフセットも返されます。
-           これにより、戻り値は配列となり、配列の要素 <literal>0</literal>
-           はマッチした文字列、 要素 <literal>1</literal>
-           は <parameter>subject</parameter> におけるマッチした文字列のオフセット値となることに
-           注意してください。
+           これにより、戻り値は配列の配列に変わることに注意してください。
+           配列のすべての要素が、オフセット <literal>0</literal> に、マッチした文字列、
+           オフセット <literal>1</literal> に、<parameter>subject</parameter> 内でのその文字列のオフセット
+           からなる配列になります。
           </para>
          </listitem>
         </varlistentry>
@@ -115,7 +115,7 @@
   &reftitle.examples;
   <para>
    <example>
-    <title><function>preg_split</function> の例 : 検索文字列のある部分を取得</title>
+    <title><function>preg_split</function> の例 : 検索文字列の諸部分を取得</title>
     <programlisting role="php">
 <![CDATA[
 <?php