Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Fix mistranslations in PCRE #227

Merged
merged 2 commits into from
Dec 25, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 9 additions & 9 deletions reference/pcre/constants.xml
Original file line number Diff line number Diff line change
Expand Up @@ -82,10 +82,11 @@
</entry>
<entry>
このフラグを設定した場合、各マッチに対応する文字列のオフセットも返されます。
これにより、戻り値は配列となり、配列の要素 0 はマッチした文字列、 要素 1
は対象文字列中におけるマッチした文字列のオフセット値となることに注意してください。
このフラグは
<function>preg_split</function> のみで使用されます。
これにより、戻り値は配列の配列に変わることに注意してください。
配列のすべての要素が、オフセット 0 に、マッチした文字列、
オフセット 1 に、対象文字列におけるその文字列のオフセット
からなる配列になります。
このフラグは、<function>preg_split</function> のみで使用されます。
</entry>
<entry/>
</row>
Expand All @@ -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>
Expand Down
25 changes: 11 additions & 14 deletions reference/pcre/functions/preg-match-all.xml
Original file line number Diff line number Diff line change
Expand Up @@ -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>
Expand Down Expand Up @@ -129,7 +129,7 @@ print_r($matches['match']);
<![CDATA[
Array
(
[0] =>
[0] =>
[1] => bar
)
]]>
Expand Down Expand Up @@ -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[
Expand Down Expand Up @@ -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>
Expand Down
6 changes: 3 additions & 3 deletions reference/pcre/functions/preg-match.xml
Original file line number Diff line number Diff line change
Expand Up @@ -67,7 +67,7 @@
<para>
このフラグを設定した場合、各マッチに対応する文字列のオフセットも(バイト単位で)返されます。
これは、<parameter>matches</parameter> の値を配列の配列に変更することに注意してください。
配列のすべての要素が、オフセット <literal>0</literal> に、一致した文字列
配列のすべての要素が、オフセット <literal>0</literal> に、マッチした文字列
オフセット <literal>1</literal> に、<parameter>subject</parameter> 内でのその文字列のオフセット
からなる配列になります。
<informalexample>
Expand Down Expand Up @@ -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[
Expand Down
10 changes: 5 additions & 5 deletions reference/pcre/functions/preg-split.xml
Original file line number Diff line number Diff line change
Expand Up @@ -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>
Expand Down Expand Up @@ -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
Expand Down