Skip to content
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
9 changes: 8 additions & 1 deletion reference/pcre/functions/preg-match.xml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: f88f34ad2f28993c120074306cccfc02a2a00db1 Maintainer: hirokawa Status: ready -->
<!-- EN-Revision: a7c3d59d21e976ed46d41d22d5cefbee05a9b5d0 Maintainer: hirokawa Status: ready -->
<!-- Credits: haruki,mumumu -->
<refentry xml:id="function.preg-match" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
Expand Down Expand Up @@ -279,6 +279,13 @@ Array
マッチしなかった場合は 0 を返します。
&return.falseforfailure;
</para>
<simpara>
<link linkend="ini.pcre.backtrack-limit">pcre.backtrack_limit</link> または
<link linkend="ini.pcre.recursion-limit">pcre.recursion_limit</link> に達した場合も、
マッチングに失敗し、&false; を返します。
<parameter>subject</parameter> が長いと、これらの制限値に達することがあります。
失敗の原因は <function>preg_last_error</function> で調べられます。
</simpara>
&return.falseproblem;
</refsect1>

Expand Down
92 changes: 72 additions & 20 deletions reference/pcre/pattern.syntax.xml
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- splitted from ./ja/functions/pcre.xml, last change in rev 1.1 -->
<!-- EN-Revision: c414a81646ee424d1814725f54ec86b9a8f6b434 Maintainer: takagi Status: ready -->
<!-- EN-Revision: 75ed9b0163e3e0563e82fdb98ef1cc9008c794a9 Maintainer: takagi Status: ready -->
<!-- Credits: haruki,hirokawa,mumumu -->
<chapter xml:id="reference.pcre.pattern.syntax" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>パターン構文</title>
Expand Down Expand Up @@ -322,7 +322,15 @@
<varlistentry>
<term><emphasis>\R</emphasis></term>
<listitem>
<simpara>改行: \n、\r、\r\n にマッチする</simpara>
<simpara>
改行。デフォルトでは、<literal>\R</literal> はどの Unicode
改行シーケンスにもマッチします。UTF-8 モード以外の 8 ビットモードでは、
<literal>(?&gt;\r\n|\n|\x0b|\f|\r|\x85)</literal> と等価です。
UTF-8 モードでは、さらに U+2028 と U+2029 の 2 文字が加わります。
パターンに特殊シーケンス <literal>(*BSR_ANYCRLF)</literal> が含まれている場合、
<literal>\R</literal> は <literal>\r\n</literal>、
<literal>\r</literal>、<literal>\n</literal> だけにマッチします。
</simpara>
</listitem>
</varlistentry>
<varlistentry>
Expand All @@ -339,6 +347,26 @@
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><emphasis>\x{hhhh}</emphasis></term>
<listitem>
<simpara>
<emphasis>UTF-8 モード</emphasis> では、指定した 16 進数を
コードポイントとする Unicode 文字
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><emphasis>\N{U+hhhh}</emphasis></term>
<listitem>
<simpara>
<emphasis>UTF-8 モード</emphasis> では、指定した 16 進数を
コードポイントとする Unicode 文字で、<literal>\x{hhhh}</literal>
と等価。<literal>\x{hhhh}</literal> と異なり、UTF-8 モード以外では
この構文は認識されない
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><emphasis>\ddd</emphasis></term>
<listitem>
Expand Down Expand Up @@ -636,7 +664,7 @@
</para>
<para>
単語境界 (word boundary) とは、検索対象文字列において、
カレントの文字およびその前の文字が同時に <literal>\w</literal>
現在の文字およびその前の文字が同時に <literal>\w</literal>
もしくは <literal>\W</literal> にマッチしない(すなわち、片方が
<literal>\w</literal> にマッチし、もう片方が <literal>\W</literal>
にマッチする)位置、もしくは、文字列の始めか終わりで、
Expand All @@ -657,12 +685,31 @@
マッチすることです。
</para>
<para>
言明 <literal>\G</literal> は、カレントのマッチング位置が、
言明 <literal>\G</literal> は、現在のマッチング位置が、
<function>preg_match</function> 関数の <parameter>offset</parameter>
引数に指定されたマッチングの開始位置である場合に真になります。
<parameter>offset</parameter> が非ゼロの場合は、<literal>\A</literal>
と等価ではありません。
</para>
<simpara>
バックスラッシュは、次のシーケンスにも使われます。
</simpara>
<para>
<variablelist>
<varlistentry>
<term><emphasis>\Q</emphasis></term>
<listitem><simpara>クォート範囲の開始。<literal>\E</literal> までのメタ文字はリテラルとして扱われる</simpara></listitem>
</varlistentry>
<varlistentry>
<term><emphasis>\E</emphasis></term>
<listitem><simpara><literal>\Q</literal> で始めたクォート範囲の終了</simpara></listitem>
</varlistentry>
<varlistentry>
<term><emphasis>\K</emphasis></term>
<listitem><simpara>報告されるマッチの開始位置をリセットする</simpara></listitem>
</varlistentry>
</variablelist>
</para>

<para>
<literal>\Q</literal> と <literal>\E</literal> とを使って、
Expand Down Expand Up @@ -1130,20 +1177,25 @@
として取り扱います。記号プロパティ付きの文字とは、アクセント記号などの
直前の文字に対して影響するようなもののことです。
</simpara>
<para>
<simpara>
Unicode プロパティを使った文字列マッチングは速くありません。PCRE は
15,000 以上のデータからなるデータ構造を検索する必要が有るためです。
そのため、PCRE では、<literal>\d</literal> や <literal>\w</literal> といった
以前から有るエスケープシーケンスは Unicode プロパティを使用しないように
なっています。
</para>
PHP 5.4.0 以降、<link linkend="reference.pcre.pattern.modifiers">PCRE_UTF8</link>
(<literal>u</literal>) 修飾子を指定すると、包括的な文字型を表すエスケープシーケンス
<literal>\d</literal>、<literal>\s</literal>、<literal>\w</literal>
(およびそれぞれの大文字版) は Unicode プロパティを使用します。
そのため、たとえば <literal>\d</literal> は ASCII 以外の 10 進数字にもマッチします。
PHP 5.4.0 より前のバージョンでは、効率上の理由から、パターンに
<literal>(*UCP)</literal> を明示的に追加しない限り、これらのエスケープシーケンスは
Unicode プロパティを使用しませんでした。
</simpara>
</section>

<section xml:id="regexp.reference.anchors">
<title>アンカー</title>
<para>
ハット記号 (<literal>^</literal>) は、文字クラス外でマッチモード (matching mode) がデフォルトの場合、
カレントのマッチング位置が対象文字列の始端である場合に真だ
現在のマッチング位置が対象文字列の始端である場合に真だ
という言明です。文字クラス内では、ハット記号 (<literal>^</literal>) はまったく別の意味と
なります(別記参照)。
</para>
Expand All @@ -1156,7 +1208,7 @@
他にもパターンを固定にする方法はあります)。
</para>
<para>
ドル記号 (<literal>$</literal>) は、(デフォルトでは)カレントのマッチング位置が
ドル記号 (<literal>$</literal>) は、(デフォルトでは)現在のマッチング位置が
対象文字列の終端にあるか、文字列の終わりの改行文字の直前にある場合に
真だという言明です。パターン中で選択肢を用いる場合は、ドル記号 (<literal>$</literal>) は、
必要な選択肢の最後に記述すればよく、パターン全体の最後にしか
Expand Down Expand Up @@ -1235,7 +1287,7 @@
小文字の母音以外の文字にマッチします。ハット記号は、含まれない文字を
列挙することにより文字クラスに含まれる文字を指定するための簡略表記です。
文字クラスは、言明ではありません。対象文字列から文字を消費します。また、
カレントのポインタが文字列の終端にある場合には、マッチに失敗します。
現在のポインタが文字列の終端にある場合には、マッチに失敗します。
</para>
<para>
大小文字を区別しないマッチングを行うよう設定した場合は、
Expand Down Expand Up @@ -1843,7 +1895,7 @@
のセクションを参照ください。
</para>
<para>
後方参照は、カレントの対象文字列においてキャプチャ用サブパターンが
後方参照は、現在の対象文字列においてキャプチャ用サブパターンが
実際にマッチした文字列にマッチします。サブパターンがパターンとして
マッチし得るものではありません。すなわち、パターン

Expand Down Expand Up @@ -1936,17 +1988,17 @@

<section xml:id="regexp.reference.assertions">
<title>言明</title>
<para>
言明 (assertion) とは、カレントのマッチング位置の直前・直後の文字に対する
<simpara>
言明 (assertion) とは、現在のマッチング位置の直前・直後の文字に対する
テストであり、文字を消費 (consume)〔つまり文字自体にマッチ〕しません。
単純な言明コード \b, \B, \A, \Z, \z, ^ および $ については、
<link linkend="regexp.reference.escape">エスケープシーケンス</link> で説明しました。より複雑な言明は、サブパターンを用いて記述します
〔言明サブパターン (assertion subpattern) と呼ばれる〕。
言明サブパターンには、2 種類あります。対象文字列において
カレントの位置の<emphasis>先を読む</emphasis>ものと、<emphasis>後ろを読む</emphasis>ものです。
</para>
現在の位置より先を調べる<emphasis>先読み</emphasis>言明と、手前を調べる<emphasis>戻り読み</emphasis>言明です。
</simpara>
<para>
言明サブパターンは、カレントのマッチング位置を変更しないことを除き、
言明サブパターンは、現在のマッチング位置を変更しないことを除き、
通常と同じようにマッチングが行われます。<emphasis>先読み</emphasis>言明 (lookahead assertion) は、
肯定の言明 (positive assertion) の場合 (?= で始まり、
否定の言明 (negative assertion) の場合 (?! で始まります。例えば、
Expand Down Expand Up @@ -2002,7 +2054,7 @@
</para>
<para>
戻り読み言明の実装においては、選択肢ごとに一時的に固定の幅だけ
カレントの位置を後退させ、マッチを試みます。カレントの位置の前に
現在の位置を後退させ、マッチを試みます。現在の位置の前に
十分な文字がない場合は、マッチは失敗とみなされます。
再試行無しのサブパターンと組み合わせた戻り読み言明は、
文字列の終端でのマッチングに特に有用です。
Expand Down Expand Up @@ -2145,7 +2197,7 @@
</para>
<para>
別の説明をすると、このタイプのサブパターンは、同一のスタンドアローンの
パターンが対象文字列のカレントの位置に固定されたかのように、
パターンが対象文字列の現在の位置に固定されたかのように、
文字列とマッチします。
</para>
<para>
Expand Down