このノードは、非常に単純なパターン言語に対応しており、名前付き“キャプチャ”グループとリテラル文字(そのままの文字)を交互に使用します。 キャプチャグループの文字列はアトリビュートに割り当てられます。これは、区切り文字を使った通常の構造体でファイル名を付けている場合に、そのファイル名から情報を解析するのに役立ちます。

例えば、“ソース”ファイル名を以下の形式で名前を付けたとします:

shot_a.simcache.1.005.bgeo.sc

以下のパターンを使用すれば、別々の部分をアトリビュートとして解析することができます:

{shot}.{}.{wedgenum}.{frame}.bgeo.sc

(波括弧の中を空っぽにすると、その部分はアトリビュートに割り当てられません。)

• このパターンでは、波括弧({name})は以下のパターンのリテラル文字に合致します。

  • 波括弧の中が空っぽであれば、マッチした文字列は破棄されます。

  • 波括弧の中に名前が入っていれば、そこにマッチした文字列がその名前のアトリビュートに割り当てられます。例えば、{shot}で“キャプチャ”されたソース文字列の部分はshotアトリビュートに割り当てられます。

  • Infer Attribute Type を有効にすると、このノードは、合致した文字列に基づいてアトリビュートタイプを推測します(それが整数文字列であれば、そのアトリビュートタイプは整数に、浮動小数点文字列であれば、浮動小数点に、それ以外は文字列になります)。{name:type}を使用することで、アトリビュートタイプを明示的に指定することができます。例えば、{shot:string}, {frame:int}, {time:float}です。

• パターンの最後の波括弧は、ソース文字列の最後にマッチします。

• 波括弧の外では、パターン内の文字は、ソース文字列の文字にそのまま合致します。

• 波括弧は“欲張り”ではありません…これは遠くの文字列にマッチさせるのが良い場合でも、次のリテラル文字以前のところまでマッチします(つまり、最長マッチしません)。

  例えば、day.01.csvに対して{name}.csvパターンを使用する時に、{name}にはday.01をキャプチャしてほしいわけですが、実際にはdayのみがキャプチャされます(このパターンは次のリテラル文字、ここではピリオドまでをキャプチャします)。 このパターンは、ピリオドの後の文字は01ではなくcsvであることを期待しているので、失敗に終わります。

• 全 パターンは、(接頭辞のみではなく)ソース文字列にマッチしなければなりません。

• 全パターンがマッチしなかった場合、そのパターン内のアトリビュートは何も設定されません。

非常に強力/柔軟な文字列置換を行ないたいのであれば、代わりに正規表現を使用することができます。 このノードは、Pythonの正規表現構文を使用します。

• 正規表現を使用すると、暗黙的に Infer Attribute Type が有効になります。