Réalisées par des traducteurs professionnels, des entreprises, des pages web ou traductions disponibles gratuitement.
the special the special item (?r) is provided for the specific case of recursion.
左ブラケットは文字クラスの開始を表し、右ブラケットにより終了 します。右ブラケットは、それ自体特別なものではありません。 右ブラケットがクラスのメンバーとして必要な場合、(もしあるな らば、最初にハット記号を持ってきた後で)クラスの最初の文字データ があるか、バックスラッシュでエスケープする必要があります。 文字クラスは、対象の1文字にマッチします。その文字はクラスにより 定義される文字集合の中にある必要があります。ただし、 クラスの最初の文字がハット記号の場合は、対象文字は暮らすにより 定義される集合のん課兄あってはなりません。 ハット記号がクラスのメンバーとして必要な場合は、必ず、最初の 文字としないか、バックスラッシュでエスケープするようにして下 さい。 例えば、文字クラス [aeiou] は小文字の母音にマッチしますが、 [^aeiou] は小文字の母音以外の文字にマッチします。 ハット記号は、存在しないものを列挙することによりクラスにある 文字を指定する便利な表記です。 ハット記号は、言明ではありません。対象文字列から文字を消費し、 現在のポインタが文字列の終端にある場合には失敗します。 大文字小文字を区別しないマッチが行われた場合、クラスの文字は 大文字・小文字の両方を表します。これは、例えば、大文字小文字 を区別しない場合のマッチ [aeiou] は "a" と同様に "a" にマッチ し、文字小文字を区別しない場合のマッチ [^aeiou] は "a" にマッ チしません。一方、大文字小文字を区別する場合はマッチします。 pcre_dotall または pcre_multiline オプ ションをどのように設定しようとも改行文字は、文字クラスにおいて特 別な方法で処理されません。[^a] のようなクラスは常に改行にマッチ します。 マイナス (ハイフン)文字は文字クラスの中で文字の範囲を指定する ために使用されます。例えば、[d-m] は d と m の間のあらゆる 文字にマッチします。間にナス文字がクラスの中に必要な場合は、 バックスラッシュでエスケープするか、クラスの最初または最後の ような範囲を示すとは解釈されない場所に使用して下さい。 文字リテラル "]" を範囲の最後の文字として使用することはできま せん。[w-]46] のようなパターンは、2つ文字のクラス("w" および "-")の後にリテラル文字列 "46]" が続いているクラスとして解釈 され、"w46]"または "-46]" にマッチします。しかし、範囲の終端 として解釈される "]" をバックスラッシュでエスケープした場合、 [w-\]46] は範囲の後に2つの文字が続く一つのクラスとして解釈さ れます。"]" の8進あるいは16進表現も範囲の終端として使用可能 です。 範囲指定では、ascii 照合処理を行います。範囲では、[\000-\037] のように数値的に指定した文字も使用可能です。文字を含む範囲が 大文字小文字を区別しないマッチが設定されているときに使用された 場合、大文字小文字の両方にマッチします。例えば、[w-c] は、 [][\^_`wxyzabc] に等価であり、大文字小文字に関係なくマッチし ます。文字テーブルで "fr" ロケールを使用している場合、 [\xc8-\xcb] は、大文字小文字の区別無くアクセント付きの e に マッチします。 文字型 \d, \d, \s, \s, \w, \w は文字クラスの中でも指定可能 であり、クラスにマッチする文字を追加します。例えば、[\dabcdef] は、16進数にマッチします。ハット記号は大文字と組み合わせて 小文字にマッチング??より範囲の狭い文字集合を簡便に指定する ことができます。 例えば、クラス [^\w_] は文字または数字にマッチしますが、アンダ ースコアにはマッチしません。\, -, (始端の)^ 以外の全ての英数字でない文字および終端の] は、 文字クラスにおいて特別でない文字ですが、エスケープした場合でも 悪影響はありません。
if this option is enabled, the search will follow symlinks to directories. this can lead to infinite recursion if cyclical symlinks exist.
このオプションを有効にすると、ディレクトリへのシンボリックリンクも検索の対象になります。これは循環シンボリックリンクが存在すると無限再帰を引き起こすことがあります。
the values set for any capturing subpatterns are those from the outermost level of the recursion at which the subpatternthe values set for any capturing subpatterns are those from the outermost level of the recursion at which the subpattern value is set.
サブパターンは括弧(丸括弧)で区分され、ネストが可能です。 パターンの一部をサブパターンとして指定するためには、2つのこ とを行います。 1. 選択肢の集合をローカル化します。例えば、パターン cat(aract_bar_erpillar_bar_) は、単語 "cat", "cataract", "caterpillar" にマッチします。 括弧をつけないと、このパターンは、"cataract", "erpillar" または空の文字列にマッチしてしまいます。 2. 括弧は、サブパターンを(以下で定義する)値を取得するサブパターン として設定します。パターン全体がマッチしたサブパターンにマッチ した対象文字列の一部は、 pcre_exec() の ovector 引数によりコールした側に返されます。値を取得するサブパターンの 番号を得るために括弧の始まりは(1から始まって)左から右に数えられます。 例えば、文字列 "the red king" を次のパターンにマッチさせた場合、 the ((red_bar_white) (king_bar_queen)) 取得される部分文字列は、 "red king", "red", "king" であり、 それぞれ 1, 2, 3 番となります。 括弧が2つの機能を有しているという事実が常に良い方に働くわけで はありません。値を取得する必要はないが、サブパターンを複数用 いることが必要である場合も少なくありません。左括弧の後に "?:" を付けた場合、そのサブパターンは値の取得を行わず、値を取得する サブパターンの番号を計算する際にも加算されません。例えば、文字列 "the white queen" は次のパターンをマッチさせてみましょう。 the ((?:red_bar_white) (king_bar_queen)) 取得される部分文字列は、"white queen" と "queen" であり、 1番と 2番になります。部分文字列の最大数は99であり、値の取得を 行うものと行わないものを合わせて全サブパターンの最大数は 200です。 便利な略記として、オプションの設定を値を取得しないサブパターンの 先頭で指定する必要がある場合、オプションの文字を "?" と ":" の 間に入れることができます。つまり、次の2つのパターン、 (?i:saturday_bar_sunday) (?:(?i)saturday_bar_sunday) は全く同じ文字列集合にマッチします。選択肢は左から右に試行さ れ、オプションはサブパターンの終端に達するまでリセットされな いので、ある枝にあるオプション設定は後に続く枝にも作用します。 このため、上のパターンは、"saturday" と同様に"sunday" にも マッチします。
if no memory can be obtained, it saves data for the first 15 capturing parentheses only, as there is no way to give an out-of-memory error from within a recursion.
文字クラスの外で、バックスラッシュの後に 0 より大きい数字を 付けたものはパターンで以前に(すなわち左にある)値を取得した サブパターンに対する後方参照であり、前にある値の取得を行う 左括弧の数まで使用可能です。 しかし、バックスラッシュの後に続く10進数が10未満の場合は常に 後方参照として解釈され、パターン全体の値を取得する左括弧の数 に満たない場合にのみエラーとなります。 言いかえると、参照される括弧は10未満の数については参照する側 の左にある必要がないということです。 バックスラッシュの後に数字が続く場合の処理の詳細については、 上記の "バックスラッシュ"という題の節を参照下さい。 後方参照は、サブパターン自体がマッチするものよりむしろ、 現在の対象文字列における値を取得するパターンが実際にマッチし たものにマッチします。このため、パターン (sens_bar_respons)e and \1ibility は、"sense and sensibility" および "response and responsi- bility" にマッチしますが、"sense and responsibility" には マッチしません。後方参照の時点で、大文字小文字を区別したマッチ が有効の場合、文字の大文字小文字が関係します。例えば、 ((?i)rah)\s+\1 は、"rah rah" および "rah rah" にマッチしますが、 元の取得したサブパターンは大文字小文字を区別せずマッチしてい るにもかかわらず、"rah rah" にはマッチしません。 同じサブパターンに複数回の後方参照を行fことができます。ある サブパターンが特定のマッチで実際には使用されていない場合、 後方参照は常に失敗します。例えば、パターン (a_bar_(bc))\2 は、"bc" ではなく "a" に最初にマッチする場合に常に失敗します。 最大 99 個の後方参照を使用できるため、バックスラッシュの後に 数字が続くものは全て後方参照番号の可能性がある集合として解釈 されます。 パターンの後に数字が続く場合、後方参照を終了するために なんらかの区切り文字を置く必要があります。 pcre_extended オプ ションを設定している場合、空白を区切り文字とすることができます。 その他の場合は空のコメントを使用できます。 参照する括弧の中にある後方参照は、サブパターンを最初に使用し た際に失敗します。このため、(a\1) は何にもマッチしません。 しかし、このような参照は、複数回使用するサブパターンの内部で 有用です。例えば、次のパターン (a_bar_b\1)+ は、"a" の並び、および "aba"、"ababaa" 等にもマッチします。 サブパターンの各反復において、後方参照は、前の繰り返しに対応 する文字列にマッチします。これを動作させるために、最初の反復 時に後方参照にマッチする必要がないようなパターンである必要が あります。これは上の例のように選択を使用するか、ゼロを最小と する反復指定子により行うことができます。
