stm:regex

Home > Books > Tutorials and Training Guides > STM Language > stm:regex

Attribute
xpath	required the target xpath into the operand document
subxpath	required an unambiguous relative xpath below xpath in the operand document
select	optional an unambiguous xpath into the child document fragment contained by the stm:set element

The stm:regex returns document fragments located at an element located by an xpath. The regex match is applied to the unambiguous single valued target located at the relative xpath <subxpath>. The regex pattern is the value enclosed by the <stm:regex> element or obtained from the select xpath location of an enclosed fragment.

The document fragments are appended in match order to a new root element <regex-matches>.

Example

Example 1: Regex match
This example sets a base xpath of /a/b, the document fragment located below /a/b will be returned given a match. The subxpath c is a relative xpath and must be relative with respect to the base xpath. The pattern is donk.* which will match "donkey".
<idoc>
  <seq>
    <instr>
      <type>stm</type>
      <operand>doc.xml</operand>
      <operator>
        <stm:group xmlns:stm="http://1060.org/stm">
          <stm:regex subxpath="c" xpath="/a/b">donk.*</stm:regex>
        </stm:group>
      </operator>
      <target>this:response</target>
    </instr>
  </seq>
</idoc>
Try it