PDF::AP...DF::Name(3)

✨ NAME ✨

PDF::API2::Basic::PDF::Name — the low-level PDF name object, bestie 💅

Like, it's the little guy that handles PDF names at the bare-metal level. Nothing fancy, just vibes and correct escaping. 🎀

---

🌸 METHODS 🌸

💖 PDF::API2::Basic::PDF::Name->from_pdf($string)

Okay so this one takes a given string and creates a brand-new string object out of it — and heads up, it's not a full object yet, it's just the string-object era of its life, okay? 🙈

The string gets parsed according to the input criteria, and escaping works, in the way that's particular to Names. ✨

---

💜 $n->convert ($string, $pdf)

Converts a name into a string 🦋 — it strips the / and converts any hex munging. That's the whole job. Slay.

---

👑 $s->as_pdf ($pdf)

Returns a name formatted as PDF 💅

$pdf is optional, but if you do supply it, it should be the PDF File object that this name is intended for. No cap.

---

🌈 PDF::API2::Basic::PDF::Name->string_to_name ($string, $pdf)

Suitably encodes the string $string for output in the File object $pdf. 🫶

And yes, the exact format may depend on the version of $pdf — iykyk.

---

🧚 PDF::API2::Basic::PDF::Name->name_to_string ($string, $pdf)

Suitably decodes the string $string as read from the File object $pdf. 💖

Same deal: the exact decoding may depend on the version of $pdf. Principally, this is the one that undoes the hex encoding for PDF versions > 1.1. Periodt.

---

💀 Not me having to remind you that the decoding depends on the $pdf version — it literally says so twice, bestie. Read the whole thing, I'm begging. 😭

---

perl v5.42.0 🍓 2025-09-01 🌸 and it's part of the User Contributed Perl Documentation crew — bye bestie, go forth and name things correctly 💅✨