™.. IO::Zlib - Online Linux Manual PageSection : 3pm
Updated : 2009-02-12
Source : perl v5.10.1
Note : Perl Programmers Reference Guide
NAMEIO::Zlib − IO:: style interface to Compress::Zlib
SYNOPSISWith any version of Perl 5 you can use the basic OO interface: ​ use IO::Zlib; ​ ​ $fh = new IO::Zlib; ​ if ($fh−>open("file.gz", "rb")) { ​ print <$fh>; ​ $fh−>close; ​ } ​ ​ $fh = IO::Zlib−>new("file.gz", "wb9"); ​ if (defined $fh) { ​ print $fh "bar\n"; ​ $fh−>close; ​ } ​ ​ $fh = IO::Zlib−>new("file.gz", "rb"); ​ if (defined $fh) { ​ print <$fh>; ​ undef $fh; # automatically closes the file ​ } With Perl 5.004 you can also use the TIEHANDLE interface to access compressed files just like ordinary files: ​ use IO::Zlib; ​ ​ tie *FILE, 'IO::Zlib', "file.gz", "wb"; ​ print FILE "line 1\nline2\n"; ​ ​ tie *FILE, 'IO::Zlib', "file.gz", "rb"; ​ while (<FILE>) { print "LINE: ", $_ };
DESCRIPTION​\*(C`IO::Zlib\*(C'\fR provides an \s-1IO::\s0 style interface to Compress::Zlib and hence to gzip/zlib compressed files. It provides many of the same methods as the IO::Handle interface. Starting from IO::Zlib version 1.02, IO::Zlib can also use an external gzip command. The default behaviour is to try to use an external gzip if no \*(C`Compress::Zlib\*(C'\fR can be loaded, unless explicitly disabled by ​ use IO::Zlib qw(:gzip_external 0); If explicitly enabled by ​ use IO::Zlib qw(:gzip_external 1); then the external gzip is used instead of \*(C`Compress::Zlib\*(C'\fR.
CONSTRUCTORnew ( [ARGS] ) Creates an \*(C`IO::Zlib\*(C'\fR object. If it receives any parameters, they are passed to the method \*(C`open\*(C'\fR; if the open fails, the object is destroyed. Otherwise, it is returned to the caller.
OBJECT METHODSopen ( FILENAME, MODE ) ​\*(C`open\*(C'\fR takes two arguments. The first is the name of the file to open and the second is the open mode. The mode can be anything acceptable to Compress::Zlib and by extension anything acceptable to zlib (that basically means POSIX fopen() style mode strings plus an optional number to indicate the compression level). opened Returns true if the object currently refers to a opened file. close Close the file associated with the object and disassociate the file from the handle. Done automatically on destroy. getc Return the next character from the file, or undef if none remain. getline Return the next line from the file, or undef on end of string. Can safely be called in an array context. Currently ignores $/ ($INPUT_RECORD_SEPARATOR or $RS when English is in use) and treats lines as delimited by ‟\n”. getlines Get all remaining lines from the file. It will croak() if accidentally called in a scalar context. print ( ARGS... ) Print ARGS to the file. read ( BUF, NBYTES, [OFFSET] ) Read some bytes from the file. Returns the number of bytes actually read, 0 on end-of-file, undef on error. eof Returns true if the handle is currently positioned at end of file? seek ( OFFSET, WHENCE ) Seek to a given position in the stream. Not yet supported. tell Return the current position in the stream, as a numeric offset. Not yet supported. setpos ( POS ) Set the current position, using the opaque value returned by \*(C`getpos()\*(C'\fR. Not yet supported. getpos ( POS ) Return the current position in the string, as an opaque object. Not yet supported.
USING THE EXTERNAL GZIPIf the external gzip is used, the following \*(C`open\*(C'\fRs are used: ​ open(FH, "gzip −dc $filename |") # for read opens ​ open(FH, " | gzip > $filename") # for write opens You can modify the 'commands' for example to hardwire an absolute path by e.g. ​ use IO::Zlib ':gzip_read_open' => '/some/where/gunzip −c %s |'; ​ use IO::Zlib ':gzip_write_open' => '| /some/where/gzip.exe > %s'; The %s is expanded to be the filename (\*(C`sprintf\*(C'\fR is used, so be careful to escape any other \*(C`%\*(C'\fR signs). The 'commands' are checked for sanity − they must contain the %s, and the read open must end with the pipe sign, and the write open must begin with the pipe sign.
CLASS METHODShas_Compress_Zlib Returns true if \*(C`Compress::Zlib\*(C'\fR is available. Note that this does not mean that \*(C`Compress::Zlib\*(C'\fR is being used: see \*(L"gzip_external\*(R" and gzip_used. gzip_external Undef if an external gzip can be used if \*(C`Compress::Zlib\*(C'\fR is not available (see ‟has_Compress_Zlib”), true if an external gzip is explicitly used, false if an external gzip must not be used. See ‟gzip_used”. gzip_used True if an external gzip is being used, false if not. gzip_read_open Return the 'command' being used for opening a file for reading using an external gzip. gzip_write_open Return the 'command' being used for opening a file for writing using an external gzip.
DIAGNOSTICSIO::Zlib::getlines: must be called in list context If you want read lines, you must read in list context. IO::Zlib::gzopen_external: mode '...' is illegal Use only modes 'rb' or 'wb' or /wb[1−9]/. IO::Zlib::import: '...' is illegal The known import symbols are the \*(C`:gzip_external\*(C'\fR, \f(CW\*(C`:gzip_read_open\*(C'\fR, and \*(C`:gzip_write_open\*(C'\fR. Anything else is not recognized. IO::Zlib::import: ':gzip_external' requires an argument The \*(C`:gzip_external\*(C'\fR requires one boolean argument. IO::Zlib::import: 'gzip_read_open' requires an argument The \*(C`:gzip_external\*(C'\fR requires one string argument. IO::Zlib::import: 'gzip_read' '...' is illegal The \*(C`:gzip_read_open\*(C'\fR argument must end with the pipe sign (|) and have the %s for the filename. See ‟USING THE EXTERNAL GZIP”. IO::Zlib::import: 'gzip_write_open' requires an argument The \*(C`:gzip_external\*(C'\fR requires one string argument. IO::Zlib::import: 'gzip_write_open' '...' is illegal The \*(C`:gzip_write_open\*(C'\fR argument must begin with the pipe sign (|) and have the %s for the filename. An output redirect (>) is also often a good idea, depending on your operating system shell syntax. See ‟USING THE EXTERNAL GZIP”. IO::Zlib::import: no Compress::Zlib and no external gzip Given that we failed to load \*(C`Compress::Zlib\*(C'\fR and that the use of
 an external gzip was disabled, IO::Zlib has not much chance of working. IO::Zlib::open: needs a filename No filename, no open. IO::Zlib::READ: NBYTES must be specified We must know how much to read. IO::Zlib::WRITE: too long LENGTH The LENGTH must be less than or equal to the buffer size.
SEE ALSOperlfunc, ​‟I/O Operators” in perlop, IO::Handle, Compress::Zlib
HISTORYCreated by Tom Hughes <tom@compton.nu>. Support for external gzip added by Jarkko Hietaniemi <jhi@iki.fi>.
COPYRIGHTCopyright (c) 1998−2004 Tom Hughes <tom@compton.nu>. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. 0
Johanes Gumabo
Data Size   :   28,860 byte
man-IO::Zlib.3pmBuild   :   2024-12-29, 07:25   :  
Visitor Screen   :   x
Visitor Counter ( page / site )   :   3 / 257,553
Visitor ID   :     :  
Visitor IP   :   18.219.12.88   :  
Visitor Provider   :   AMAZON-02   :  
Provider Position ( lat x lon )   :   39.962500 x -83.006100   :   x
Provider Accuracy Radius ( km )   :   1000   :  
Provider City   :   Columbus   :  
Provider Province   :   Ohio ,   :   ,
Provider Country   :   United States   :  
Provider Continent   :   North America   :  
Visitor Recorder   :   Version   :  
Visitor Recorder   :   Library   :  
Online Linux Manual Page   :   Version   :   Online Linux Manual Page - Fedora.40 - march=x86-64 - mtune=generic - 24.12.29
Online Linux Manual Page   :   Library   :   lib_c - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Online Linux Manual Page   :   Library   :   lib_m - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Data Base   :   Version   :   Online Linux Manual Page Database - 24.04.13 - march=x86-64 - mtune=generic - fedora-38
Data Base   :   Library   :   lib_c - 23.02.07 - march=x86-64 - mtune=generic - fedora.36
Very long time ago, I have the best tutor, Wenzel Svojanovsky . If someone knows the email address of Wenzel Svojanovsky , please send an email to johanes_gumabo@yahoo.co.id .
If error, please print screen and send to johanes_gumabo@yahoo.co.id
Under development. Support me via PayPal.
ERROR : Need New Coding :         (parse_manual_page_|252|IO::Zlib.3pm|36/37|el══─{─══.|.el══─{─══. ds -- \|\(em\| )         (htmlprn|149|IO::Zlib.3pm|36/37|.el══─{─══. ds --  —  |.el══─{─══. ds -- \|\(em\| )         (parse_manual_page_|252|IO::Zlib.3pm|41|br══─}─══|'br══─}─══ )         (htmlprn|149|IO::Zlib.3pm|41|'br══─}─══ |'br══─}─══ )         (rof_nr_x|149|IO::Zlib.3pm|51/52|\nF|.ie \nF ══─{─══. de IX )         (rof_unit_scale_px|41|IO::Zlib.3pm|51/52|F|.ie \nF ══─{─══. de IX )         (rof_if|19|IO::Zlib.3pm|51/52|\nF|.ie \nF ══─{─══. de IX )         (htmlprn|149|IO::Zlib.3pm|51/52|.ie \nF ══─{─══. de IX|.ie \nF ══─{─══. de IX )         (rof_escape_sequence|91|IO::Zlib.3pm|53|\$1\t\\n%\t"\\$2" |. tm Index:\\$1\t\\n%\t"\\$2" )         (parse_manual_page_|252|IO::Zlib.3pm|57|══─}─══|.══─}─══ )         (htmlprn|149|IO::Zlib.3pm|57|.══─}─══ |.══─}─══ )         (rof_escape_sequence|91|IO::Zlib.3pm|174|\*(C`IO::Zlib\*(C'\fR provides an \s-1IO::\s0 style interface to Compress::Zlib and |\&\f(CW\*(C`IO::Zlib\*(C'\fR provides an \s-1IO::\s0 style interface to Compress::Zlib and )         (rof_escape_sequence|91|IO::Zlib.3pm|180|\*(C`Compress::Zlib\*(C'\fR can be loaded, unless |an external \fIgzip\fR if no \f(CW\*(C`Compress::Zlib\*(C'\fR can be loaded, unless )         (rof_escape_sequence|91|IO::Zlib.3pm|193|\*(C`Compress::Zlib\*(C'\fR. |then the external \fIgzip\fR is used \fBinstead\fR of \f(CW\*(C`Compress::Zlib\*(C'\fR. )         (rof_escape_sequence|91|IO::Zlib.3pm|198|\*(C`IO::Zlib\*(C'\fR object. If it receives any parameters, they are |Creates an \f(CW\*(C`IO::Zlib\*(C'\fR object. If it receives any parameters, they are )         (rof_escape_sequence|91|IO::Zlib.3pm|199|\*(C`open\*(C'\fR; if the open fails, the object is destroyed. |passed to the method \f(CW\*(C`open\*(C'\fR; if the open fails, the object is destroyed. )         (rof_escape_sequence|91|IO::Zlib.3pm|205|\*(C`open\*(C'\fR takes two arguments. The first is the name of the file to open |\&\f(CW\*(C`open\*(C'\fR takes two arguments. The first is the name of the file to open )         (rof_escape_sequence|91|IO::Zlib.3pm|251|\*(C`getpos()\*(C'\fR. |Set the current position, using the opaque value returned by \f(CW\*(C`getpos()\*(C'\fR. )         (rof_escape_sequence|91|IO::Zlib.3pm|259|\*(C`open\*(C'\fRs are used: |If the external \fIgzip\fR is used, the following \f(CW\*(C`open\*(C'\fRs are used: )         (rof_escape_sequence|91|IO::Zlib.3pm|274|\*(C`sprintf\*(C'\fR is used, so be |The \f(CW%s\fR is expanded to be the filename (\f(CW\*(C`sprintf\*(C'\fR is used, so be )         (rof_escape_sequence|91|IO::Zlib.3pm|275|\*(C`%\*(C'\fR signs). The 'commands' are checked |careful to escape any other \f(CW\*(C`%\*(C'\fR signs). The 'commands' are checked )         (rof_escape_sequence|91|IO::Zlib.3pm|282|\*(C`Compress::Zlib\*(C'\fR is available. Note that this does |Returns true if \f(CW\*(C`Compress::Zlib\*(C'\fR is available. Note that this does )         (rof_escape_sequence|91|IO::Zlib.3pm|283|\*(C`Compress::Zlib\*(C'\fR is being used: see \*(L"gzip_external\*(R" |not mean that \f(CW\*(C`Compress::Zlib\*(C'\fR is being used: see \*(L"gzip_external\*(R" )         (rof_escape_sequence|91|IO::Zlib.3pm|287|\*(C`Compress::Zlib\*(C'\fR is |Undef if an external \fIgzip\fR \fBcan\fR be used if \f(CW\*(C`Compress::Zlib\*(C'\fR is )         (rof_escape_sequence|91|IO::Zlib.3pm|312|\*(C`:gzip_external\*(C'\fR, \f(CW\*(C`:gzip_read_open\*(C'\fR, |The known import symbols are the \f(CW\*(C`:gzip_external\*(C'\fR, \f(CW\*(C`:gzip_read_open\*(C'\fR, )         (rof_escape_sequence|91|IO::Zlib.3pm|313|\*(C`:gzip_write_open\*(C'\fR. Anything else is not recognized. |and \f(CW\*(C`:gzip_write_open\*(C'\fR. Anything else is not recognized. )         (rof_escape_sequence|91|IO::Zlib.3pm|316|\*(C`:gzip_external\*(C'\fR requires one boolean argument. |The \f(CW\*(C`:gzip_external\*(C'\fR requires one boolean argument. )         (rof_escape_sequence|91|IO::Zlib.3pm|319|\*(C`:gzip_external\*(C'\fR requires one string argument. |The \f(CW\*(C`:gzip_external\*(C'\fR requires one string argument. )         (rof_escape_sequence|91|IO::Zlib.3pm|322|\*(C`:gzip_read_open\*(C'\fR argument must end with the pipe sign (|) |The \f(CW\*(C`:gzip_read_open\*(C'\fR argument must end with the pipe sign (|) )         (rof_escape_sequence|91|IO::Zlib.3pm|326|\*(C`:gzip_external\*(C'\fR requires one string argument. |The \f(CW\*(C`:gzip_external\*(C'\fR requires one string argument. )         (rof_escape_sequence|91|IO::Zlib.3pm|329|\*(C`:gzip_write_open\*(C'\fR argument must begin with the pipe sign (|) |The \f(CW\*(C`:gzip_write_open\*(C'\fR argument must begin with the pipe sign (|) )         (rof_escape_sequence|91|IO::Zlib.3pm|335|\*(C`Compress::Zlib\*(C'\fR and that the use of |Given that we failed to load \f(CW\*(C`Compress::Zlib\*(C'\fR and that the use of )