=pod

Devel::Size - Perl extension for finding the memory usage of Perl variables

=head1 SYNOPSIS

 use Devel::Size qw(size total_size);

 my $size = size("A string");

 my @foo = (1, 2, 3, 4, 5);
 my $other_size = size(\@foo);

 my $foo = {a => [1, 2, 3],
     b => {a => [1, 3, 4]}
        };
 my $total_size = total_size($foo);

=head1 DESCRIPTION

This module figures out the real size of Perl variables in bytes, as
accurately as possible.

=head1 Build and Install

To build and install this module, you need:

    Perl
    a working C or C++ compiler
    a make (or namke on Windows) utility

Follow these steps:

On Linux, Cygwin, or Unix:

   perl Makefile.PL
   make
   make test
   sudo make install

On Windows:

   perl Makefile.PL
   nmake
   nmake test
   nmake install

=head1 BUGREPORTS

Please report bugs to:

   http://rt.cpan.org/NoAuth/Bugs.html?Dist=Devel-Size

=head1 COPYRIGHT

Copyright (C) 2005 Dan Sugalski, Copyright (C) 2007-2008 Tels

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

=cut