Php/docs/regexp.reference.escape

PHP Manual
PCRE 正規表現構文
エスケープシーケンス

エスケープシーケンス

バックスラッシュ〔日本語環境では円記号となる場合もある〕には、いくつかの使用法があります。ひとつめの使用法は、非英数字の前に記述する場合で、続く文字が表す特別な意味を取り去ります。このエスケープ文字としての使用法は、文字クラスの内外部いずれでも可能です。

たとえば、"*" 文字とマッチさせたい場合は、パターンを "\*" と記述します。続く文字がメタ文字として解釈されるものであるかには関係ありませんので、いかなる非英数字に対しても、"\" を付けると、その文字自体が表わされることになります。特に、バックスラッシュとマッチさせたい場合は、"\\" と記述します。

注意:
シングルクォートあるいはダブルクォートで囲まれた PHP の文字列の中では、バックスラッシュは特別な意味を表します。そのため、正規表現 \\ を使用して \ とマッチさせたい場合は PHP のコード内では "\\\\" あるいは '\\\\' と記述する必要があります。

パターンを、 PCRE_EXTENDED オプションを付けてコンパイルすると、（文字クラス内部を除き）パターン中の空白文字、および "#" とその次の改行文字との間の文字は無視されます。空白文字や "#" をパターン中に含めるには、バックスラッシュを用いてエスケープします。

バックスラッシュの 2 番目の使用法は、非表示文字〔制御コードなど〕をパターン中に目に見える形で記述するための方法です。ヌル文字はパターンを終了させてしまうため使えませんが、その他の非表示文字は、パターンにそのまま含めても問題はありません。しかし、パターンの編集には、バイナリ文字をそのまま用いるよりも、以下に示すエスケープシーケンスを用いる方が便利でしょう。

\a: アラーム、ベル文字 (16進 07)
\cx: "control-x", ここで x は任意の文字
\e: エスケープ文字 (16進 1B)
\f: 改ページ (formfeed) (16進 0C)
\n: 改行 (newline) (16進 0A)
\p{xx}: xx プロパティを持つ文字、詳細は unicode プロパティを参照
\P{xx}: xx プロパティを持たない文字、詳細は unicode プロパティを参照
\r: 復帰 (carriage return) (16進 0D)
\R: 改行: \n、\r、\r\n にマッチする
\t: タブ (16進 09)
\xhh: 16 進コードで hh の文字
\ddd: 8 進コードで ddd の文字、もしくは、後方参照

"\cx" の正確な働きは、次の通りです。"x" が小文字の場合、大文字に変換されます。続いて、文字の 6 ビット目 (16進数 40) が反転されます。つまり、"z" は 16 進数の 1A になり、"{" は 3B になり、 ";" は 7B になります。

"\x" の後では、2 桁までの 16 進数が読まれます（大小文字どちらも可能です）。 "\0" の後では、さらに 2 桁の 8 進数が読みこまれます。いずれの場合も、2 桁より少ない場合、桁があるだけ読みこまれます。つまり、"\0\x\07" はヌル文字 2 つの後にベル文字が続いたものを表します。8 進数を指定する場合は、必ず最初のゼロに続いて残りの 2 桁の数字を指定するように注意してください。

バックスラッシュの後に 0 以外の数字が続く場合の処理は複雑です。文字クラスの外部では、 PCRE は、続く数字全体を 10 進数として読みます。数字が 10 よりも小さい場合、または、正規表現の中に含まれるキャプチャ用左カッコの数以下の場合、後方参照として解釈されます。この動作に関する詳しい説明は、後ほど、カッコによるサブパターンの説明を行ってから示します

文字クラスの中、または、指定された 10 進数が 9 より大きく、キャプチャ用サブパターンの数がこの数に満たない場合は、PCRE はバックスラッシュの後から最大 3 文字の 8 進数を再度読みこみ、その値の最下位 8 ビットから 1 バイトを生成します。その後に続く数字は、それ自体を表します。以下に例を示します。

\040: スペースの別の表記法
\40: 上と同じ。ただし、キャプチャ用サブパターンが 40 個未満の場合
\7: 常に後方参照
\11: 後方参照、または、タブの別記法
\011: 常にタブ
\0113: タブの後に文字 "3" が続いたもの
\113: 8進コードで 113 の文字 (99 を超える後方参照は存在しないため)
\377: 全ビットが 1 である 1 バイト
\81: 後方参照、または、ヌル文字の後に 2つの文字 "8" および "1" が続いたもの

3 桁を超えて 8 進数は読みこまれないため、100 以上の 8 進数にはゼロを前につけてはいけないことに注意してください。

これらの 1 バイト値を定義するエスケープシーケンスは、文字クラスの内外部のいずれでも使用できます。加えて、文字クラス内ではエスケープシーケンス "\b" はバックスペース (16進 0x) として解釈されます。文字クラス外では、別の意味を有します（別記参照）。

バックスラッシュの第 3 の使用法は、包括的な文字型を指定する用途です。

\d: 10 進数字
\D: 10 進数字でない文字
\h: 水平方向の空白文字 (PHP 5.2.4 以降)
\H: 水平方向の空白文字でない文字 (PHP 5.2.4 以降)
\s: 空白文字
\S: 空白文字でない文字
\v: 垂直方向の空白文字 (PHP 5.2.4 以降)
\V: 垂直方向の空白文字でない文字 (PHP 5.2.4 以降)
\w: 単語構成文字 (word character)
\W: 非単語構成文字 (non-word character)

これらエスケープシーケンスの各組により、文字集合が 2 つに分割されます。文字は、各組のどちらか片方だけにマッチします。

空白文字とは HT (9)、LF (10)、FF (12)、CR (13)、スペース (32) のことです。しかし、ロケールを指定したマッチングを行った場合には、128から255までのコードポイントの文字 (たとえば NBSP (A0)) も空白文字とみなされる可能性があります。

単語構成文字とは、英字または数字またはアンダースコア文字であり、Perl が定義するところの「単語」と成り得る文字のことです。文字および数字の定義は、PCRE の文字テーブルにより制御され、ロケールを指定してマッチングを行うと変わる可能性があります。例えば、"fr" （フランス語）ロケールの場合、128 を超える文字コードのいくつかは、アクセント付きの文字に使われており、これらは \w とマッチします。

これらの文字型表記は、文字クラスの内外によらず使用可能で、対応する型のたかだか 1 文字とマッチします。カレントのマッチング位置が検索対象文字列の終端である場合、マッチできる文字が無いので、マッチは失敗します。

バックスラッシュの第 4 の使用法は、簡単な言明 (assertion) です。言明とは、マッチがある特定の位置でだけ可能だという条件を指定するもので、検索対象文字列から文字を消費 (consume)〔つまり文字自体にマッチ〕しません。サブパターンを使ったより複雑な言明の方法もありますが、それについての解説は後ほど行います。バックスラッシュを使った言明は、次のものがあります

\b: 単語境界
\B: 非単語境界
\A: 検索対象文字列の始端（複数行モードとは独立）
\Z: 検索対象文字列の終端、または終端の改行（複数行モードとは独立）
\z: 検索対象文字列の終端（複数行モードとは独立）
\G: マッチングの開始位置

これらの言明は、文字クラス内では使用できません（また、文字クラス内では、 "\b" はバックスペース文字という別の意味を持つので注意してください）。

単語境界 (word boundary) とは、検索対象文字列において、カレントの文字およびその前の文字が同時に \w もしくは \W にマッチしない（すなわち、片方が \w にマッチし、もう片方が \W にマッチする）位置、もしくは、文字列の始めか終わりで、その始めか終わりの文字が \w にマッチする位置のことです。

言明 \A, \Z, \z は、（アンカーで説明する）ハット記号やドル記号とは異なり、オプション設定によらず、文字列の始端または終端だけにマッチします。これらの言明は、PCRE_MULTILINE および PCRE_DOLLAR_ENDONLY オプションの影響を受けません。 \Z と \z との違いは、 \Z は文字列の末尾の改行の前の位置および文字列の終端にマッチするのに対し、\z は文字列の終端にのみマッチすることです。

言明 \G は、カレントのマッチング位置が、 preg_match() 関数の offset 引数に指定されたマッチングの開始位置である場合に真になります。 offset が非ゼロの場合は、\A と等価ではありません。

\Q と \E とを使って、パターン中のメタ文字を無視させることができます。たとえば、

      \w+\Q.$.\E$

は、文字列の終端において1つ以上の単語構成文字のあとに .$. というリテラルが続いたものにマッチします。 \K を使用すると、マッチの開始位置をリセットできます。これは PHP 5.2.4 以降で使用可能です。たとえば、パターン foo\Kbar は "foobar" にマッチしますが、結果は "bar" にマッチしたと報告されます。 \K を使用しても、キャプチャした部分文字列には影響を及ぼしません。たとえば、パターン (foo)\Kbar が "foobar" にマッチしたときの最初の部分文字列は "foo" です。