The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.
 / 
XML-XPath-Helper-Const-0.04
River stage zero No dependents
/ XML::XPath::Helper::Const

NAME

XML::XPath::Helper::Const - Exports some precompiled xpath constants for XML::LibXML.

VERSION

Version 0.04

SYNOPSIS

use XML::LibXML;
use XML::XPath::Helper::Const qw(:all);

@nodes = $my_node->findnodes(XPATH_SIMPLE_LIST);

DESCRIPTION

This module provides some precompiled XPath expressions (refer to XML::LibXML::XPathExpression for details about this).

The provided constants are:

XPATH_SIMPLE_LIST

Selects the "simple list nodes" contained in the current node; i.e. the nodes that contain at least one child node, all the child nodes have the same name and no child node has child nodes again.

Example:

 my $dom = XML::LibXML->load_xml(string => <<'EOT');
    <root>
      <findthis>
        <entry>a</entry>
        <entry>b</entry>
        <entry>c</entry>
      </findthis>
      <ignorethis>
        <foo>a</foo>
        <bar>b</bar>
      </ignorethis>
      <ignorethat>
        <child>
          <childofchild></childofchild>
        </child>
      </ignorethat>
      <simpletag>blah</simpletag>
    </root>
EOT
 my @nodes = $dom->documentElement->findnodes(XPATH_SIMPLE_LIST);

Array @nodes contains a single node: <findthis>

XPATH_SIMPLE_TAGS

Find all nodes that have no child nodes.

XPATH_NESTED_TAGS

Find all nodes that have at least one child node.

EXPORT

This modules exports nothing by default. You can export the constants you need individually, or use tag :all to export them all.,

SEE ALSO

XML::LibXML, XML::LibXML::XPathExpression, XML::XPath::Helper::String

AUTHOR

Abdul al Hazred, <451 at gmx.eu>

BUGS

Please report any bugs or feature requests to bug-xml-xpath-helper-const at rt.cpan.org, or through the web interface at https://rt.cpan.org/NoAuth/ReportBug.html?Queue=XML-XPath-Helper-Const. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

perldoc XML::XPath::Helper::Const

You can also look for information at:

ACKNOWLEDGEMENTS

The XPath expression for XPATH_SIMPLE_LIST is taken from here: https://stackoverflow.com/questions/75059177/is-it-possible-to-find-nodes-containing-a-simple-list-using-xpath-1-0/75061420#75061420. Thanks to Michael Kay who posted this solution.

LICENSE AND COPYRIGHT

This software is copyright (c) 2023 by Abdul al Hazred.

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