#acupoftea - baroun-eg.com

System	:	Linux server53.web-hosting.com 4.18.0-553.54.1.lve.el8.x86_64 #1 SMP Wed Jun 4 13:01:13 UTC 2025 x86_64
Software	:	LiteSpeed
Server	:	198.54.126.113
Domains	:	Cant read /etc/named.conf
Permission	:	[ drwxr-xr-x ]
	:	/ usr / local / lib64 / perl5 / XML / LibXML /

216.73.216.85

Home

File 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.0213

=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.

Name	Type	Size	Permission	Last Modified	Actions
.	DIR	-	drwxr-xr-x	2026-05-26 10:35:03
..	DIR	-	drwxr-xr-x	2026-05-26 10:35:03
SAX	DIR	-	drwxr-xr-x	2026-05-26 10:35:03
Attr.pod	text/plain	4.02 KB	-r--r--r--	2026-05-21 03:37:09
AttributeHash.pm	text/plain	4.47 KB	-r--r--r--	2026-05-21 03:36:48
Boolean.pm	text/plain	1.54 KB	-r--r--r--	2026-05-21 03:36:48
CDATASection.pod	text/plain	1.28 KB	-r--r--r--	2026-05-21 03:37:09
Comment.pod	text/plain	1.36 KB	-r--r--r--	2026-05-21 03:37:09
Common.pm	text/plain	8.16 KB	-r--r--r--	2026-05-21 03:36:48
Common.pod	text/plain	3.59 KB	-r--r--r--	2026-05-21 03:37:09
DOM.pod	text/plain	6.23 KB	-r--r--r--	2026-05-21 03:37:09
Devel.pm	text/plain	5.06 KB	-r--r--r--	2026-05-21 03:36:48
Document.pod	text/plain	21.13 KB	-r--r--r--	2026-05-21 03:37:09
DocumentFragment.pod	text/plain	819 B	-r--r--r--	2026-05-21 03:37:09
Dtd.pod	text/plain	1.99 KB	-r--r--r--	2026-05-21 03:37:09
Element.pod	text/plain	13.48 KB	-r--r--r--	2026-05-21 03:37:09
ErrNo.pm	text/plain	27.81 KB	-r--r--r--	2026-05-21 03:36:48
ErrNo.pod	text/plain	591 B	-r--r--r--	2026-05-21 03:37:09
Error.pm	text/plain	8.42 KB	-r--r--r--	2026-05-21 03:36:48
Error.pod	text/x-c	5.98 KB	-r--r--r--	2026-05-21 03:37:09
InputCallback.pod	text/plain	9.59 KB	-r--r--r--	2026-05-21 03:37:09
Literal.pm	text/plain	2.03 KB	-r--r--r--	2026-05-21 03:36:48
NamedNodeMap.pod	text/plain	1.65 KB	-r--r--r--	2026-05-21 03:37:09
Namespace.pod	text/plain	3.28 KB	-r--r--r--	2026-05-21 03:37:09
Node.pod	text/plain	25.72 KB	-r--r--r--	2026-05-21 03:37:09
NodeList.pm	text/plain	7.29 KB	-r--r--r--	2026-05-21 03:36:48
Number.pm	text/plain	1.85 KB	-r--r--r--	2026-05-21 03:36:48
PI.pod	text/plain	2.22 KB	-r--r--r--	2026-05-21 03:37:09
Parser.pod	text/x-Algol68	27.79 KB	-r--r--r--	2026-05-21 03:37:09
Pattern.pod	text/plain	2.91 KB	-r--r--r--	2026-05-21 03:37:09
Reader.pm	text/plain	5.69 KB	-r--r--r--	2026-05-21 03:36:48
Reader.pod	text/plain	17.6 KB	-r--r--r--	2026-05-21 03:37:09
RegExp.pod	text/plain	1.54 KB	-r--r--r--	2026-05-21 03:37:09
RelaxNG.pod	text/plain	2.34 KB	-r--r--r--	2026-05-21 03:37:09
SAX.pm	text/plain	3.42 KB	-r--r--r--	2026-05-21 03:36:48
SAX.pod	text/plain	1.76 KB	-r--r--r--	2026-05-21 03:37:09
Schema.pod	text/plain	2.19 KB	-r--r--r--	2026-05-21 03:37:09
Text.pod	text/x-c++	5.47 KB	-r--r--r--	2026-05-21 03:37:09
XPathContext.pm	text/plain	3.11 KB	-r--r--r--	2026-05-21 03:36:48
XPathContext.pod	text/plain	11.65 KB	-r--r--r--	2026-05-21 03:37:09
XPathExpression.pod	text/plain	1.64 KB	-r--r--r--	2026-05-21 03:37:09

~ ACUPOFTEA - baroun-eg.com