regex

Home > Books > NetKernel API and Services Reference > Accessor Listing > Utility and System Accessors > regex

Module

The regex accessor is exported by the urn:org:ten60:netkernel:ext:sys module. Import this module to gain access to the accessor.

Syntax

URI

active:regex

Argument	Rules	Description
operand	Mandatory Fragment OK	document or fragment whose text nodes are to be used as the value to test
operator	Mandatory	a document specifying properties for the regex evaluation

Example Usage

DPML

<instr>
  <type>regex</type>
  <operand>
    <string>Mambo is a dog</string>
  </operand>
  <operator>
    <regex>
      <pattern>(.*)is a(.*)</pattern>
      <rewrite>$1is black</rewrite>
    </regex>
  </operator>
  <target>this:response</target>
</instr>

NetKernel Foundation API

req=context.createSubRequest("active:regex");
req.addArgument("operand", [resource representation, aspect, or URI] );
req.addArgument("operator", [resource representation, aspect, or URI] );
result=context.issueSubRequest(req);

Purpose

The regex accessor is principally used as the engine behind the regex-cookbook application. It is exposed as a tool for use where regex-string slicing and dicing is valuable.

Operator Syntax

The pattern element must contain the text of a valid parseable regular expression as defined by Javadoc

The rewrite element must contain the text of a valid rewrite rule. This is a string where each $n where n is an integer starting at 1 is a capturing group in the regular expression.

Result document

The result document is of the following structure:

<regex>
  <matches>true</matches>
  <rewrite>Mambo is black</rewrite>
  <group>Mambo</group>
  <group>dog</group>
</regex>