NAME

       PDF::Builder::Basic::PDF::Utils - Utility functions for PDF library

DESCRIPTION

       A set of utility functions to save the fingers of the PDF library users!

METHODS

   PDFBool
           PDFBool()

           Creates a Bool via PDF::Builder::Basic::PDF::Bool->new()

   PDFArray
           PDFArray()

           Creates an array via PDF::Builder::Basic::PDF::Array->new()

   PDFDict
           PDFDict()

           Creates a dict via PDF::Builder::Basic::PDF::Dict->new()

   PDFName
           PDFName()

           Creates a name via PDF::Builder::Basic::PDF::Name->new()

   PDFNull
           PDFNull()

           Creates a null via PDF::Builder::Basic::PDF::Null->new()

   PDFNum
           PDFNum()

           Creates a number via PDF::Builder::Basic::PDF::Number->new()

   PDFString
           PDFString($text, $usage)

           Returns either PDFStr($text) or PDFUtf($text), depending on whether $text is already in UTF-8 and
           whether the $usage permits UTF-8. If UTF-8 is not permitted, "downgrade" will be called on a UTF-8
           formatted $text.

           $usage is a single character string indicating the use for which $text is to be applied. Some uses
           permit UTF-8, while others (currently) forbid it:

           's' An ordinary string, where UTF-8 text is permitted.

           'n' A named destination, where UTF-8 text is permitted.

           'o' An outline title, where UTF-8 text is permitted.

           'p' A popup title, where UTF-8 text is permitted.

           'm' metadata, where UTF-8 text is permitted.

           'f' A file path and/or name, where UTF-8 text is currently not permitted.

           'u' A URL, where UTF-8 text is currently not permitted.

           'x' Any other usage where UTF-8 text is not permitted.

   PDFStr
           PDFStr()

           Creates a string via PDF::Builder::Basic::PDF::String->new()

           DEPRECATED. It is preferable that you use "PDFString" instead.

   PDFStrHex
           PDFStrHex()

           Creates a hex-string via PDF::Builder::Basic::PDF::String->new()

   PDFUtf
           PDFUtf()

           Creates a utf8-string via PDF::Builder::Basic::PDF::String->new()

           DEPRECATED. It is preferable that you use "PDFString" instead.

perl v5.40.1                                       2025-08-10               PDF::Builder::Basic::PDF::Utils(3pm)