Parse::Binary

Current version is 0.10.

Note

Originally written by Audrey Tang, I just maintain this distribution.

Download

README

This is the README file for Parse::Binary, a module for unpacking
binary data structures into object hierarchies.

Please type "perldoc Parse::Binary" after installation to see
the module usage information.

* Installation

Parse::Binary uses the standard perl module install process:

cpansign -v		# optional; see SIGNATURE for details
perl Makefile.PL
make			# or 'nmake' on Win32
make test
make install

* Copyright

The Parse::Binary module is under the following license:

Copyright 2004, 2006 by Audrey Tang .

This program is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.

(See the "Artistic" file included in this distribution.)

* Copyright for derived works

Two modules included in this distribution, Parse::Binary::FixedFormat
and Parse::Binary::FixedFormat::Variants, are derived from the
Data::FixedFormat module, also available from CPAN.  They are under
the following license:

Copyright 2004, 2006 by Audrey Tang .
Copyright (C) 2000,2002 Thomas Pfau.  All rights reserved.

This module is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 2 of the License, or (at your
option) any later version.

This library is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Library General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software Foundation,
Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

(See the "COPYING" file included in this distribution.)

Documentation

Parse::Binary
Parse::Binary::FixedFormat
Parse::Binary::FixedFormat::Variants

Change Log

[Changes for 0.10 - 2006-07-07]

* Updated Module::Install to 0.63.
* Updated Audrey's contact information.

[Changes for 0.09 - 2004-12-24]

* In Parse::Binary::FixedFormat's lazy_unformat, remove
  dangling cyclic references to reduce memory leakage.

[Changes for 0.08 - 2004-09-08]

* In Parse::Binary::FixedFormat, pass data around by
  reference instead of by value to reduce memory usage.

[Changes for 0.07 - 2004-03-16]

* Fix incompatibility with 5.6.x due to mixing "use integer" and "$] < 5.008".
* Bump version for FixedFormat too.
* Even more optimisations.
* Cache sibling_index for more speed gain
* Cache is_type.
* Properly implement nested lazy loading.

[Changes for 0.06 - 2004-02-17]

* Allow "__" to be used as "::" in is_type().
* True lazy iterating of trailing members.
* Deprecate flyweight cache in favor of generators.
* Lazy loading of members via next_member implemented.
* Recommend Scalar::Util now.
* New function set_output_file(), next_member(), callback() and callback_members()

[Changes for 0.05 - 2004-02-15]

* Fields with name as '_' now means "choose an unique name for me".
  there can be multiple such fields, and they won't overlap.
* New control constant ENCODED_FIELDS (default to 'Data'), that controls 
  which fields get affected by ENCODING.

[Changes for 0.04 - 2004-02-15]

* Remove an unneccessary ->refresh after set_members.

[Changes for 0.03 - 2004-02-14]

* Properly handles "(format)*" style formats in 5.6.x.

[Changes for 0.02 - 2004-02-13]

* More fixes for Perl 5.6.
* Make $count safe to use for Perl 5.6.
* Fix small POD typos.

[Changes for 0.01 - 2004-02-13]

* Initial CPAN release.