<h2>Editing File: /usr/share/perl5/IO/Compress/Zlib/Extra.pm</h2><form method='post'><textarea name='content' class='file-edit'>package IO::Compress::Zlib::Extra;

require 5.006 ;

use strict ;
use warnings;
use bytes;

our ($VERSION, @ISA, @EXPORT_OK, %EXPORT_TAGS);

$VERSION = '2.081';

use IO::Compress::Gzip::Constants 2.081 ;

sub ExtraFieldError
{
    return $_[0];
    return &quot;Error with ExtraField Parameter: $_[0]&quot; ;
}

sub validateExtraFieldPair
{
    my $pair = shift ;
    my $strict = shift;
    my $gzipMode = shift ;

    return ExtraFieldError(&quot;Not an array ref&quot;)
        unless ref $pair &amp;&amp;  ref $pair eq 'ARRAY';

    return ExtraFieldError(&quot;SubField must have two parts&quot;)
        unless @$pair == 2 ;

    return ExtraFieldError(&quot;SubField ID is a reference&quot;)
        if ref $pair-&gt;[0] ;

    return ExtraFieldError(&quot;SubField Data is a reference&quot;)
        if ref $pair-&gt;[1] ;

    # ID is exactly two chars   
    return ExtraFieldError(&quot;SubField ID not two chars long&quot;)
        unless length $pair-&gt;[0] == GZIP_FEXTRA_SUBFIELD_ID_SIZE ;

    # Check that the 2nd byte of the ID isn't 0    
    return ExtraFieldError(&quot;SubField ID 2nd byte is 0x00&quot;)
        if $strict &amp;&amp; $gzipMode &amp;&amp; substr($pair-&gt;[0], 1, 1) eq &quot;\x00&quot; ;

    return ExtraFieldError(&quot;SubField Data too long&quot;)
        if length $pair-&gt;[1] &gt; GZIP_FEXTRA_SUBFIELD_MAX_SIZE ;


    return undef ;
}

sub parseRawExtra
{
    my $data     = shift ;
    my $extraRef = shift;
    my $strict   = shift;
    my $gzipMode = shift ;

    #my $lax = shift ;

    #return undef
    #    if $lax ;

    my $XLEN = length $data ;

    return ExtraFieldError(&quot;Too Large&quot;)
        if $XLEN &gt; GZIP_FEXTRA_MAX_SIZE;

    my $offset = 0 ;
    while ($offset &lt; $XLEN) {

        return ExtraFieldError(&quot;Truncated in FEXTRA Body Section&quot;)
            if $offset + GZIP_FEXTRA_SUBFIELD_HEADER_SIZE  &gt; $XLEN ;

        my $id = substr($data, $offset, GZIP_FEXTRA_SUBFIELD_ID_SIZE);    
        $offset += GZIP_FEXTRA_SUBFIELD_ID_SIZE;

        my $subLen =  unpack(&quot;v&quot;, substr($data, $offset,
                                            GZIP_FEXTRA_SUBFIELD_LEN_SIZE));
        $offset += GZIP_FEXTRA_SUBFIELD_LEN_SIZE ;

        return ExtraFieldError(&quot;Truncated in FEXTRA Body Section&quot;)
            if $offset + $subLen &gt; $XLEN ;

        my $bad = validateExtraFieldPair( [$id, 
                                           substr($data, $offset, $subLen)], 
                                           $strict, $gzipMode );
        return $bad if $bad ;
        push @$extraRef, [$id =&gt; substr($data, $offset, $subLen)]
            if defined $extraRef;;

        $offset += $subLen ;
    }

        
    return undef ;
}

sub findID
{
    my $id_want = shift ;
    my $data    = shift;

    my $XLEN = length $data ;

    my $offset = 0 ;
    while ($offset &lt; $XLEN) {

        return undef
            if $offset + GZIP_FEXTRA_SUBFIELD_HEADER_SIZE  &gt; $XLEN ;

        my $id = substr($data, $offset, GZIP_FEXTRA_SUBFIELD_ID_SIZE);    
        $offset += GZIP_FEXTRA_SUBFIELD_ID_SIZE;

        my $subLen =  unpack(&quot;v&quot;, substr($data, $offset,
                                            GZIP_FEXTRA_SUBFIELD_LEN_SIZE));
        $offset += GZIP_FEXTRA_SUBFIELD_LEN_SIZE ;

        return undef
            if $offset + $subLen &gt; $XLEN ;

        return substr($data, $offset, $subLen)
            if $id eq $id_want ;

        $offset += $subLen ;
    }
        
    return undef ;
}


sub mkSubField
{
    my $id = shift ;
    my $data = shift ;

    return $id . pack(&quot;v&quot;, length $data) . $data ;
}

sub parseExtraField
{
    my $dataRef  = $_[0];
    my $strict   = $_[1];
    my $gzipMode = $_[2];
    #my $lax     = @_ == 2 ? $_[1] : 1;


    # ExtraField can be any of
    #
    #    -ExtraField =&gt; $data
    #
    #    -ExtraField =&gt; [$id1, $data1,
    #                    $id2, $data2]
    #                     ...
    #                   ]
    #
    #    -ExtraField =&gt; [ [$id1 =&gt; $data1],
    #                     [$id2 =&gt; $data2],
    #                     ...
    #                   ]
    #
    #    -ExtraField =&gt; { $id1 =&gt; $data1,
    #                     $id2 =&gt; $data2,
    #                     ...
    #                   }
    
    if ( ! ref $dataRef ) {

        return undef
            if ! $strict;

        return parseRawExtra($dataRef, undef, 1, $gzipMode);
    }

    my $data = $dataRef;
    my $out = '' ;

    if (ref $data eq 'ARRAY') {    
        if (ref $data-&gt;[0]) {

            foreach my $pair (@$data) {
                return ExtraFieldError(&quot;Not list of lists&quot;)
                    unless ref $pair eq 'ARRAY' ;

                my $bad = validateExtraFieldPair($pair, $strict, $gzipMode) ;
                return $bad if $bad ;

                $out .= mkSubField(@$pair);
            }   
        }   
        else {
            return ExtraFieldError(&quot;Not even number of elements&quot;)
                unless @$data % 2  == 0;

            for (my $ix = 0; $ix &lt;= @$data -1 ; $ix += 2) {
                my $bad = validateExtraFieldPair([$data-&gt;[$ix],
                                                  $data-&gt;[$ix+1]], 
                                                 $strict, $gzipMode) ;
                return $bad if $bad ;

                $out .= mkSubField($data-&gt;[$ix], $data-&gt;[$ix+1]);
            }   
        }
    }   
    elsif (ref $data eq 'HASH') {    
        while (my ($id, $info) = each %$data) {
            my $bad = validateExtraFieldPair([$id, $info], $strict, $gzipMode);
            return $bad if $bad ;

            $out .= mkSubField($id, $info);
        }   
    }   
    else {
        return ExtraFieldError(&quot;Not a scalar, array ref or hash ref&quot;) ;
    }

    return ExtraFieldError(&quot;Too Large&quot;)
        if length $out &gt; GZIP_FEXTRA_MAX_SIZE;

    $_[0] = $out ;

    return undef;
}

1;

__END__
</textarea><br><input class='btn' type='submit' value='Save Changes'></form><a class='btn' href='?dir=%2Fusr%2Fshare%2Fperl5%2FIO%2FCompress%2FZlib'>Back to Directory</a>