File Coverage

blib/lib/PDF/Builder/Basic/PDF/Null.pm

Criterion	Covered	Total	%
statement	13	17	76.4
branch			n/a
condition			n/a
subroutine	5	9	55.5
pod	6	6	100.0
total	24	32	75.0

#=======================================================================
#
#   THIS IS A REUSED PERL MODULE, FOR PROPER LICENCING TERMS SEE BELOW:
#
#   Copyright Martin Hosken
#
#   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.
#   Effective 28 January 2021, the original author and copyright holder,
#   Martin Hosken, has given permission to use and redistribute this module
#   under the MIT license.
#
#=======================================================================
package PDF::Builder::Basic::PDF::Null;

use base 'PDF::Builder::Basic::PDF::Objind';

use strict;
use warnings;

our $VERSION = '3.024'; # VERSION
our $LAST_UPDATE = '3.024'; # manually update whenever code is changed

=head1 NAME

PDF::Builder::Basic::PDF::Null - PDF Null type object.  This is a subclass of
PDF::Builder::Basic::PDF::Objind and cannot be subclassed.

=head1 METHODS

=over

=cut

# There is only one null object  (section 3.2.8).
my $null_obj = bless {}, 'PDF::Builder::Basic::PDF::Null';

=item PDF::Builder::Basic::PDF::Null->new()

Returns the null object. There is only one null object.

=cut

sub new {
    return $null_obj;
}

=item $s->realise()

Pretends to finish reading the object.

=cut

sub realise {
    return $null_obj;
}

=item $s->outobjdeep()

Output the object in PDF format.

=cut

sub outobjdeep {
    my ($self, $fh, $pdf) = @_;

    $fh->print('null');
    return;
}

=item $s->is_obj()

Returns false because null is not a full object.

=cut

sub is_obj {
    return 0;
}

=item $s->copy()

Another no-op.

=cut

sub copy {
    return $null_obj;
}

=item $s->val()

Return undef.

=cut

sub val {
    return undef; ## no critic (undef is intentional)
}

=back

=cut

1;