NAME

SYNOPSIS

 use XML::PatAct::Amsterdam;

 my $patterns = [ PATTERN => { Before => 'before',
                               After => 'after' },
                  ... ];

 my $matcher = XML::PatAct::Amsterdam->new( I<OPTIONS> );

DESCRIPTION

CAUTION: Amsterdam is a very simple style module, you will run into it's limitations quickly with even moderately complex XML instances, be aware of and prepared to switch to more complete style modules.

New XML::PatAct::Amsterdam instances are creating by calling `new()'. Parameters can be passed as a list of key, value pairs or a hash. A Patterns and Matcher options are required. The following OPTIONS are supported:

Patterns

The pattern-action list to apply. The list is an anonymous array of pattern, action pairs. Each action in the list contains either or both a Before and an After string to copy to the output before and after processing an XML element. The Before and After strings may contain attribute names enclosed in square brackets (`"["' NAME `"]"'), these are replaced with the value of the attribute with that name. The special NAME `"_element"' will be replaced with the element's name.

Matcher

An instance of the pattern or query matching module.

Output

An IO::Handle or one of it's subclasses (such as IO::File), if this parameter is not present and the AsString option is not used, the module will write to standard output.

AsString

Return the generated output as a string from the `"parse()"' method of the PerlSAX event generator.

AUTHOR

SEE ALSO

``Using PatAct Modules'' and ``Creating PatAct Modules'' in libxml-perl.