---
name: "Text::PDF::Name"
section: "3pm"
platform: "linux"
package: "libtext-pdf-perl"
version: "0.31-3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Text::PDF::Name"
---

# Text::PDF::Name(3pm)

Inherits from Text::PDF::String and stores PDF names (things beginning with /)

## NAME

Text::PDF::Name - Inherits from Text::PDF::String and stores PDF names (things beginning with /)

## METHODS

### Text::PDF::Name-\>from\_pdf($string)

Creates a new string object (not a full object yet) from a given string. The string is parsed according to input criteria with escaping working, particular to Names.

### $n-\>convert ($str, $pdf)

Converts a name into a string by removing the / and converting any hex munging unless `$pdf` is supplied and its version is less than 1.2.

### $s-\>as\_pdf ($pdf)

Returns a name formatted as PDF.  `$pdf` is optional but should be the PDF File object for which the name is intended if supplied.

### Text::PDF::Name-\>string\_to\_name ($str, $pdf)

Suitably encode the string `$str` for output in the File object `$pdf` (the exact format may depend on the version of `$pdf`).  Prinicipally, encode certain characters in hex if the version is greater than 1.1.

### Text::PDF::Name-\>name\_to\_string ($str, $pdf)

Suitably decode the string `$str` as read from the File object `$pdf` (the exact decoding may depend on the version of `$pdf`).  Principally, undo the hex encoding for PDF versions \> 1.1.