Set

use LibXML::Node::Set;
  my LibXML::Node::Set $node-set;

$node-set = $elem.childNodes;
  $node-set = $elem.findnodes($xpath, :$deref);
  $node-set = $elem{$xpath}
  $node-set .= new: $deref;
  $node-set.add: $elem;

my LibXML::Item @items = $node-set;
  for $node-set -> LibXML::Item $item { ... }

my LibXML::Node::Set %nodes-by-name = $node-set.Hash;
  # ...

for $elem.findnodes($path) {...}
    my LibXML::Item @nodes = $elem.findnodes($xpath);

method new(xmlNodeSet :$raw, Bool :$deref) returns LibXML::Node::Set

my xmlNodeSet $raw .= new; # create a new object from scratch
        #-OR-
        my xmlNodeSet $raw = $other-node-set.raw.copy; # take a copy
        my LibXML::Node::Set $nodes .= new: :$raw;
        $raw = Nil; # best to avoid any further direct access to the raw object

my LibXML::Document $doc .= parse("example/dromeds.xml");
      # without dereferencing
      my LibXML::Node::Set $species = $doc.findnodes("dromedaries/species");
      say $species.keys; # (species)
      # with dereferencing
      $species = $doc.findnodes("dromedaries/species", :deref);
      #-OR-
      $species = $doc<dromedaries/species>; # The AT-KEY method sets the :deref option
      say $species.keys; # disposition text() humps @name)

method elems() returns UInt

method AT-POS(UInt) returns LibXML::Item

for ^$node-set.elems {
            my $item = $node-set[$_]; # or: $node-set.AT-POS($_);
            ...
        }

method AT-KEY(Str $expr) returns LibXML::Node::Set
        my LibXML::Node::Set $a-nodes = $node-set<a>;
        my LibXML::Node::Set $b-atts = $node-set<@b>;
        my LibXML::Text @text-nodes = $node-set<text()>;

method add(LibXML::Item $node) returns LibXML::Item

method pop() returns LibXML::Item

multi method delete(LibXML::Item $node) returns LibXML::Item
        multi method delete(UInt $pos) returns LibXML::Item

# process nodes in ascending order
        for $node.find('ancestor-or-self::*').reverse { ... }