【Regular Expressions / 正規表現】XSLT 2.0/XSL Transformations Version2.0/Extensible Stylesheet Language Transformations Version2.0

15.1 xsl:analyze-string 命令

<!-- カテゴリ： 命令 -->
<xsl:analyze-string
  select = expression
  regex = { string }
  flags? = { string }>
  <!-- Content: (xsl:matching-substring?, xsl:non-matching-substring?, xsl:fallback*) -->
</xsl:analyze-string>

<xsl:matching-substring>
  <!-- Content: sequence-constructor -->
</xsl:matching-substring>

<xsl:non-matching-substring>
  <!-- Content: sequence-constructor -->
</xsl:non-matching-substring>

xsl:analyze-string 命令は、 文字列( select 属性にある式を評価した結果)と正規表現( regex 属性の有効な値)を入力として受け取ります。

もし、 select 式を評価した結果が文字列でない場合には、関数変換規則を適用する事によって文字列に変換されます。

flags 属性は、正規表現の解釈を操作する為に利用される場合があります。 もし、属性が省略される場合には、その効果は、ゼロの長さの文字列供給と同じです。 これは、 関数 matches^FO 、 replace^FO 、 tokenize^FO の $flags 属性と同じ方法で解釈されます。 特に、もし、それが、文字 m を含む場合には、それは、複数行モードにおけるマッチ演算子。 もし、それが、文字 s を含む場合には、それは、[dot-all]モード。 もし、それが、文字 i を含む場合には、それは、[case-insensitive]における演算子。 もし、それが、文字 x を含む場合には、その時は、正規表現にあるホワイトスペースは無視されます。 これらのモードのより多くの詳細仕様については、[関数と演算子] (セクション 7.6.1.1 フラグ^FO)参照。

xsl:analyze-string 命令の内容は、次に続く形式の内の1つを取らなければいけません：

1. ゼロ以上の xsl:fallback 命令によって次に続く単独の xsl:matching-substring 命令

2. ゼロ以上の xsl:fallback 命令によって次に続く単独の xsl:non-matching-substring 命令

3. ゼロ以上の xsl:fallback 命令によって次に続く単独の xsl:non-matching-substring 命令によって次に続く単独の xsl:matching-substring 命令

[ERR XTSE1130] もし、 xsl:analyze-string 命令が、 xsl:matching-substring または、 xsl:non-matching-substring 要素のいずれでもないものを含む場合には、 それは、静的エラーです。

xsl:analyze-string 命令の子の間にあるいくつかのxsl:fallback 要素は、XSLT 2.0プロセッサによって無視されますが、 スタイルシートが、前方互換性モードの中で操作しているXSLT 1.0 プロセッサを伴って利用される際には、定義されているフォールバック(縮退)挙動を許容します。

この命令は、提供した正規表現とマッチする入力文字列の重ならない部分文字列全てを処理する為に設計されます。

[ERR XTDE1140] もし、 regex 属性の有効な値が、 [関数と演算子]で記述したように要求した正規表現におけるシンタックスと一致しない場合には、 それは、回復されない動的エラーです。 もし、その正規表現が、静的に認知さる場合(例えば、もし、その属性が波カッコで囲まれたいくつかの式を含まない場合)には、 プロセッサは、静的エラーとしてエラーをシグナル出力する場合があります。

[ERR XTDE1145] もし、 flags 属性の有効な値が、[関数と演算子]で定義した値ではない値を持つ場合には、 それは、回復されない動的エラーです。 もし、その属性の値が、静的に認知される場合(例えば、もし、その属性が波カッコで囲まれたいくつかの式を含まない場合)には、 プロセッサは、静的エラーとしてエラーをシグナル出力する場合があります。

[ERR XTDE1150] もし、 regex 属性の有効な値が、ゼロの長さの文字列とマッチする正規表現である場合：、 または、もっと具体的に言うと、もし、その正規表現 $r とフラグ $f が、 matches("", $r, $f) で true を返すような場合には、 それは、回復されない動的エラーです。 もし、 その正規表現が静的に認知される場合(例えば、もし、その属性が波カッコで囲まれたいくつかの式を含まない場合)には、 プロセッサは、静的エラーとしてエラーをシグナル出力する場合があります。

xsl:analyze-string 命令は、入力文字列の開始位置で始まり、そして正規表現とマッチする最初の部分文字列を見つけるように試みます。 もし、いくつかマッチするものがある場合には、その最初のマッチは、文字列の最初に来る開始位置になるように定義されます。 もし、正規表現の中のいくつかの取り得る値全てが、入力文字列の中で同じ位置にある場合には、選ばれるマッチは、マッチする最初の取り得る値です。 例えば、もし、入力文字列が、 The quick brown fox jumps で、その正規表現が、 jump|jumps である場合には、選ばれるマッチは、 jump です。

最初のマッチを見つけた時には、その命令は、前のマッチに含まれなかった最初の文字で開始して繰り返し検索する事によって2番目とマッチするサブシーケンスを見つける為に続行します。

入力文字列は、このように、それとマッチしない他の正規表現とマッチするいくつかの部分文字列のシーケンスを区分けします。 各部分文字列は、少なくとも1文字含まれるでしょう。 部分文字列のシーケンスは、 xsl:matching-substring と xsl:non-matching-substring 子命令を利用して処理されます。 マッチしている部分文字列は、 xsl:matching-substring 要素を利用して処理され、 マッチしない部分文字列は、 xsl:non-matching-substring 要素を利用して処理されます。 これらの要素のそれぞれは、その内容としてシーケンスコンストラクタを受け取ります。 もし、要素が存在しない場合には、その効果は、カラの内容を伴う存在であった時と同じです。 各部分文字列を処理する中では、部分文字列の内容は、(タイプ xs:stringの値として)文脈アイテムとなり、 マッチしている部分文字列とマッチしない部分文字列のシーケンスにある部分文字列の位置は、文脈位置となり、 マッチしている部分文字列とマッチしない部分文字列の数は、文脈サイズとなるでしょう。

もし、入力が、ゼロの長さの文字列である場合には、部分文字列の数はゼロになり、その為、 xsl:matching-substring 、または、 xsl:non-matching-substring 要素のいずれでもないものとして 評価されるでしょう。

15.2 キャプチャーした部分文字列

[定義：  xsl:matching-substring 命令がアクティブである間、 現在獲得(キャプチャー)した部分文字列のセットは、正規表現のカッコでくくられた副次式との一致を可能にします。 ] これらの取得した部分文字列は、関数 regex-group を利用して入手しやすくなります。 この関数は、グループを識別する為の整数引数を受け取り、取得した部分文字列を表す文字列を返します。

( N > 0 である場合の)キャプチャーした N 番目の部分文字列は、 regex ( regular expression の略=正規表現または、regex 属性)にある N 番目の左かっこによって含んだ副次式によってマッチする文字列です。 ゼロ番目にキャプチャーした部分文字列は、完全な regex とマッチする文字列です。 これが意味するところは、 regex-group(0) の値は、 . (dot)の値と同じ「初め」であるという事です。

その関数は、もし、関連する数を伴う存在しないキャプチャーした部分文字列がある場合には、ゼロの長さの文字列を返します。 これは、(以下の)理由の数字において出現する事が可能です：

1. 数字は負です。

2. 正規表現は、与えられる数字を伴うかっこで囲まれた副次式を含みません。

3. かっこで囲まれた副次式は、存在します、また、入力文字列の一部のいくつかとマッチしませんでした。

4. かっこで囲まれた副次式は、存在します、また、入力文字列のゼロの長さの部分文字列と一致しました。

獲得した部分文字列のセットは、動的スコープを伴う文脈変数です。 それは、初期のカラのシーケンスです。 xsl:matching-substring 命令の評価中、それは、マッチする正規表現(regex)におけるマッチする部分文字列のシーケンスを設定されます。 xsl:non-matching-substring 命令、または、 パターン、または、スタイルシート関数の評価中、それは、 カラのシーケンスを設定されます。 値変更命令の完了においては、変数は、その前の値に戻します。

現在獲得した部分文字列の値は、 xsl:apply-templates 、 xsl:call-template 、 xsl:apply-imports 、 または、 xsl:next-match を呼ぶ事を通して、または、 名前付き属性セットの拡張によって影響されません。

15.3 正規表現マッチングの例

<xsl:analyze-string select="abstract" regex="\n">
	<xsl:matching-substring>
		<br/>
	</xsl:matching-substring>
	<xsl:non-matching-substring>
		<xsl:value-of select="."/>
	</xsl:non-matching-substring>
</xsl:analyze-string>

<xsl:analyze-string select="body" regex="\[(.*?)\]">
	<xsl:matching-substring>
		<cite><xsl:value-of select="regex-group(1)"/></cite>
	</xsl:matching-substring>
	<xsl:non-matching-substring>
		<xsl:value-of select="."/>
	</xsl:non-matching-substring>
</xsl:analyze-string>

<xsl:variable name="months" select="'January', 'February', 'March', ..."/>
<xsl:analyze-string select="normalize-space($input)" 
		regex="([0-9]{{1,2}})\s([A-Z][a-z]+)\s([0-9]{{4}})">
		<xsl:matching-substring>
	<xsl:number value="regex-group(3)" format="0001"/>		
	<xsl:text>-</xsl:text>
	<xsl:number value="index-of($months、 regex-group(2))" format="01"/>
	<xsl:text>-</xsl:text>
	<xsl:number value="regex-group(1)" format="01"/>
		</xsl:matching-substring>
</xsl:analyze-string>