The Perl Toolchain Summit 2025 Needs You: You can help 🙏 Learn more

SSIMMS / PDF-API2-2.047 / lib / PDF / API2 / Basic / PDF / Utils.pm 

            

              
1
2
3
4
5
6
7
8
9
10
11
12
13
—
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
—
42
43
44
45
46
47
48
49
50
51
—
52
53
54
55
56
57
58
59
60
61
—
62
63
64
65
66
67
68
69
70
71
—
72
73
74
75
76
77
78
79
80
81
—
82
83
84
85
86
87
88
89
90
91
—
92
93
94
95
96
97
98
99
100
101
—
102
103
104
105
106
107
108
109
110
111
112
113
114
—
115
116
117
118
119
120
121
122
123
124
125
126
127
128

              
# Code in the PDF::API2::Basic::PDF namespace was originally copied from the
# Text::PDF distribution.
#
# Copyright Martin Hosken <Martin_Hosken@sil.org>
#
# Martin Hosken's code may be used under the terms of the MIT license.
# Subsequent versions of the code have the same license as PDF::API2.
package PDF::API2::Basic::PDF::Utils;
use strict;
our $VERSION = '2.047'; # VERSION
=head1 NAME
PDF::API2::Basic::PDF::Utils - Convenience functions for creating low-level PDF
objects
=head1 DESCRIPTION
A set of utility functions to save the fingers of the PDF library users!
=head1 FUNCTIONS
=cut
use PDF::API2::Basic::PDF::Array;
use PDF::API2::Basic::PDF::Bool;
use PDF::API2::Basic::PDF::Dict;
use PDF::API2::Basic::PDF::Name;
use PDF::API2::Basic::PDF::Null;
use PDF::API2::Basic::PDF::Number;
use PDF::API2::Basic::PDF::String;
use PDF::API2::Basic::PDF::Literal;
use Exporter;
use vars qw(@EXPORT @ISA);
@ISA = qw(Exporter);
@EXPORT = qw(PDFBool PDFArray PDFDict PDFName PDFNull
             PDFNum PDFStr PDFStrHex PDFUtf);
=head2 PDFBool
Creates a Bool via PDF::API2::Basic::PDF::Bool->new
=cut
sub PDFBool {
    return PDF::API2::Basic::PDF::Bool->new(@_);
}
=head2 PDFArray
Creates an array via PDF::API2::Basic::PDF::Array->new
=cut
sub PDFArray {
    return PDF::API2::Basic::PDF::Array->new(@_);
}
=head2 PDFDict
Creates a dict via PDF::API2::Basic::PDF::Dict->new
=cut
sub PDFDict {
    return PDF::API2::Basic::PDF::Dict->new(@_);
}
=head2 PDFName
Creates a name via PDF::API2::Basic::PDF::Name->new
=cut
sub PDFName {
    return PDF::API2::Basic::PDF::Name->new(@_);
}
=head2 PDFNull
Creates a null via PDF::API2::Basic::PDF::Null->new
=cut
sub PDFNull {
    return PDF::API2::Basic::PDF::Null->new(@_);
}
=head2 PDFNum
Creates a number via PDF::API2::Basic::PDF::Number->new
=cut
sub PDFNum {
    return PDF::API2::Basic::PDF::Number->new(@_);
}
=head2 PDFStr
Creates a string via PDF::API2::Basic::PDF::String->new
=cut
sub PDFStr {
    return PDF::API2::Basic::PDF::String->new(@_);
}
# Deprecated
sub PDFUtf { return PDFStr(@_) }
=head2 PDFStrHex
Creates a hex-string via PDF::API2::Basic::PDF::String->new
=cut
sub PDFStrHex {
    my $string = PDF::API2::Basic::PDF::String->new(@_);
    $string->{' ishex'} = 1;
    return $string;
}
1;