PDF::AP...::Array(3)

✨ NAME ✨

PDF::API2::Basic::PDF::Array — bestie, it's a low-level PDF array object 🫶

(also filed under the page name PDF::AP...::Array(3), from User Contributed Perl Documentation, in case you went looking for it in man)

---

🦋 METHODS 🦋

🎀 PDF::Array->new($parent, @values)

Makes you a brand new array, no cap. You hand it a storage parent, plus an optional list of values to kick things off with — those values go straight into the array as its starting lineup 💅

🍓 $a->outobjdeep($fh, $pdf)

Writes the array out as an actual PDF array, spilling it into the given filehandle. That's it, that's the whole job, and it eats ✨

🌸 $a->elements()

Gives you back what's inside the array. The contents. The whole vibe check of the array's insides 👑

🌈 $a->add_elements(@elements)

Appends the elements you pass in onto the end of the array. Important detail bestie: an element only actually gets added if it is defined — so any undef in your list just silently doesn't make the cut. Fr fr 🙈

💜 $a->remove_element($element)

Takes an element and removes all occurrences of it from the array. Not just the first one. Every single one. Gone. Periodt 💀

🧚 $a->val()

Returns a reference to the contents of the array. Note that's a reference, not a copy — just so you know what you're holding 💖

⭐ $a->copy($pdf)

Copies the array, doing a deep copy on the elements that are not full PDF objects — and it does that with respect to a particular $pdf output context. So yeah, the $pdf you pass in genuinely matters here, don't skip it 🎀

---

okay that's the whole page, mwah 💋 This lil guy comes to you courtesy of perl v5.42.0, dated 2025-09-01 — stan a stable release, iykyk 🌟