Gecko [ edgpens.lpkmn.gov.my ]

Name	Size	Permission
SAX	[ DIR ]	drwxrwxrwx
Attr.pod	4.02 KB	-rw-rw-rw-
AttributeHash.pm	4.49 KB	-rw-rw-rw-
Boolean.pm	1.56 KB	-rw-rw-rw-
CDATASection.pod	1.28 KB	-rw-rw-rw-
Comment.pod	1.36 KB	-rw-rw-rw-
Common.pm	8.22 KB	-rw-rw-rw-
Common.pod	3.59 KB	-rw-rw-rw-
DOM.pod	6.23 KB	-rw-rw-rw-
Devel.pm	4.91 KB	-rw-rw-rw-
Document.pod	20.91 KB	-rw-rw-rw-
DocumentFragment.pod	819 B	-rw-rw-rw-
Dtd.pod	1.99 KB	-rw-rw-rw-
Element.pod	13.48 KB	-rw-rw-rw-
ErrNo.pm	27.83 KB	-rw-rw-rw-
ErrNo.pod	591 B	-rw-rw-rw-
Error.pm	8.47 KB	-rw-rw-rw-
Error.pod	5.98 KB	-rw-rw-rw-
InputCallback.pod	9.59 KB	-rw-rw-rw-
Literal.pm	2.04 KB	-rw-rw-rw-
Namespace.pod	3.28 KB	-rw-rw-rw-
Node.pod	25.39 KB	-rw-rw-rw-
NodeList.pm	7.31 KB	-rw-rw-rw-
Number.pm	1.87 KB	-rw-rw-rw-
PI.pod	2.22 KB	-rw-rw-rw-
Parser.pod	27.79 KB	-rw-rw-rw-
Pattern.pod	2.91 KB	-rw-rw-rw-
Reader.pm	5.75 KB	-rw-rw-rw-
Reader.pod	17.6 KB	-rw-rw-rw-
RegExp.pod	1.54 KB	-rw-rw-rw-
RelaxNG.pod	2.34 KB	-rw-rw-rw-
SAX.pm	3.06 KB	-rw-rw-rw-
SAX.pod	1.76 KB	-rw-rw-rw-
Schema.pod	2.19 KB	-rw-rw-rw-
Text.pod	5.47 KB	-rw-rw-rw-
XPathContext.pm	3.15 KB	-rw-rw-rw-
XPathContext.pod	11.49 KB	-rw-rw-rw-
XPathExpression.pod	1.64 KB	-rw-rw-rw-

Code Editor : Pattern.pod

=head1 NAME

XML::LibXML::Pattern - XML::LibXML::Pattern - interface to libxml2 XPath patterns

=head1 SYNOPSIS

use XML::LibXML;
  my $pattern = XML::LibXML::Pattern->new('/x:html/x:body//x:div', { 'x' => 'http://www.w3.org/1999/xhtml' });
  # test a match on an XML::LibXML::Node $node

if ($pattern->matchesNode($node)) { ... }

# or on an XML::LibXML::Reader

if ($reader->matchesPattern($pattern)) { ... }

# or skip reading all nodes that do not match

print $reader->nodePath while $reader->nextPatternMatch($pattern);

$pattern = XML::LibXML::Pattern->new( pattern, { prefix => namespace_URI, ... } );
  $bool = $pattern->matchesNode($node);

=head1 DESCRIPTION

This is a perl interface to libxml2's pattern matching support I<<<<<< http://xmlsoft.org/html/libxml-pattern.html >>>>>>. This feature requires recent versions of libxml2.

Patterns are a small subset of XPath language, which is limited to
(disjunctions of) location paths involving the child and descendant axes in
abbreviated form as described by the extended BNF given below:

For readability, whitespace may be used in selector XPath expressions even
though not explicitly allowed by the grammar: whitespace may be freely added
within patterns before or after any token, where

token     ::=     '.' | '/' | '//' | '|' | NameTest

Note that no predicates or attribute tests are allowed.

Patterns are particularly useful for stream parsing provided via the C<<<<<< XML::LibXML::Reader >>>>>> interface.

=over 4

=item new()

$pattern = XML::LibXML::Pattern->new( pattern, { prefix => namespace_URI, ... } );

The constructor of a pattern takes a pattern expression (as described by the
BNF grammar above) and an optional HASH reference mapping prefixes to namespace
URIs. The method returns a compiled pattern object.

Note that if the document has a default namespace, it must still be given an
prefix in order to be matched (as demanded by the XPath 1.0 specification). For
example, to match an element C<<<<<< E<lt>a xmlns="http://foo.bar"E<lt>/aE<gt> >>>>>>, one should use a pattern like this:

$pattern = XML::LibXML::Pattern->new( 'foo:a', { foo => 'http://foo.bar' });

=item matchesNode($node)

$bool = $pattern->matchesNode($node);

Given an XML::LibXML::Node object, returns a true value if the node is matched
by the compiled pattern expression.

=back

=head1 SEE ALSO

L<<<<<< XML::LibXML::Reader >>>>>> for other methods involving compiled patterns.

=head1 AUTHORS

Matt Sergeant,
Christian Glahn,
Petr Pajas

=head1 VERSION

2.0205

=head1 COPYRIGHT

2001-2007, AxKit.com Ltd.

2002-2006, Christian Glahn.

2006-2009, Petr Pajas.

=cut

=head1 LICENSE

This program is free software; you can redistribute it and/or modify it under
the same terms as Perl itself.

${this.title}

Code Editor : Pattern.pod