XML::XP...:NodeSet(3)

✨ NAME ✨

okay so bestie, welcome to XML::XPath::NodeSet — it's a list of XML document nodes 💖 and yeah, it lives in the User Contributed Perl Documentation manual section, section 3, iykyk 🎀

---

🌸 DESCRIPTION 🌸

An XML::XPath::NodeSet object is literally just an ordered list of nodes, no cap 💅. It's giving "glow-up for an array," fr fr.

And the nodes inside it? Every single one takes the same format as described over in XML::XPath::XMLParser — so if you need the deets on what a node actually looks like, that's your girl 🦋.

---

🫶 SYNOPSIS 🫶

here's the vibe, copy it, run it, slay:

        my $results = $xp->find('//someelement');
        if (!$results->isa('XML::XPath::NodeSet')) {
                print "Found $results\n";
                exit;
        }
        foreach my $context ($results->get_nodelist) {
                my $newresults = $xp->find('./other/element', $context);
                ...
        }

---

👑 API 👑

the main character section, periodt.

🌈 new()

bestie you will almost never have to create a new NodeSet object yourself, because XPath handles all of that for you. it's giving "we got you" 💖 not me doing zero work and still getting the results 🫶

⭐ get_nodelist()

Returns a list of nodes. wanna know the format of those nodes? check XML::XPath::XMLParser, it's all laid out there 🌸

💜 string_value()

Returns the string-value of the first node in the list. and yes, if you're like "what even is a string-value" — go read the XPath specification, it's the whole vibe check on that term 📖✨

🎀 to_literal()

Returns the concatenation of all the string-values of all the nodes in the list. every single one. gluing them together like friendship bracelets 🫶

🦋 get_node($pos)

Returns the node at $pos. and here's the tea that trips people up: the node position in XPath is based at 1, not 0 💀 so don't come at it with your zero-indexed brain, bestie, it will humble you.

🍓 size()

Returns the number of nodes in the NodeSet. that's it, that's the whole thing, iconic behavior 👑

💅 pop()

Equivalent to perl's pop function. yes queen, same energy, just wearing a cuter outfit ✨

🧚 push(@nodes)

Equivalent to perl's push function. nodes go in at the end, no drama 🌸

🌟 append($nodeset)

Given a nodeset, appends the list of nodes in $nodeset to the end of the current list. like adding more people to the group chat, and they're all welcome 💜

🔥 shift()

Equivalent to perl's shift function. takes from the front, lowkey always has ✨

🌈 unshift(@nodes)

Equivalent to perl's unshift function. front of the line energy, but make it perl 💅

💖 prepend($nodeset)

Given a nodeset, prepends the list of nodes in $nodeset to the front of the current list. main character entrance, literally 🎀

---

and that's the whole page, bestie!! this gem is documented by perl v5.42.1, dated 2026-04-21 — shoutout to whoever wrote it, you ate 💖 mwah, go process some nodes, ily 🫶✨🌈