From Code to Community: Sponsoring The Perl and Raku Conference 2025 Learn more

SSIMMS / PDF-API2-2.030_001 / lib / PDF / API2 / Basic / PDF / Null.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

              
#=======================================================================
#
#   THIS IS A REUSED PERL MODULE, FOR PROPER LICENCING TERMS SEE BELOW:
#
#   Copyright Martin Hosken <Martin_Hosken@sil.org>
#
#   No warranty or expression of effectiveness, least of all regarding
#   anyone's safety, is implied in this software or documentation.
#
#   This specific module is licensed under the Perl Artistic License.
#
#=======================================================================
package PDF::API2::Basic::PDF::Null;
use base 'PDF::API2::Basic::PDF::Objind';
use strict;
our $VERSION = '2.030_001'; # TRIAL VERSION
=head1 NAME
PDF::API2::Basic::PDF::Null - PDF Null type object.  This is a subclass of
PDF::API2::Basic::PDF::Objind and cannot be subclassed.
=head1 METHODS
=cut
# There is only one null object  (section 3.2.8).
my $null_obj = bless {}, 'PDF::API2::Basic::PDF::Null';
=head2 PDF::API2::Basic::PDF::Null->new
Returns the null object.  There is only one null object.
=cut
sub new {
    return $null_obj;
}
=head2 $s->realise
Pretends to finish reading the object.
=cut
sub realise {
    return $null_obj;
}
=head2 $s->outobjdeep
Output the object in PDF format.
=cut
sub outobjdeep {
    my ($self, $fh, $pdf) = @_;
    $fh->print('null');
}
=head2 $s->is_obj
Returns false because null is not a full object.
=cut
sub is_obj {
    return 0;
}
=head2 $s->copy
Another no-op.
=cut
sub copy {
    return $null_obj;
}
=head2 $s->val
Return undef.
=cut
sub val {
    return undef; ## no critic (undef is intentional)
}
1;