Const::Fast(3) User Contributed Perl Documentation Const::Fast(3)NAMEConst::Fast - Facility for creating read-only scalars, arrays, and
hashes
VERSION
Version 0.006
SYNOPSIS
use Const::Fast;
const my $foo => 'a scalar value';
const my @bar => qw/a list value/;
const my %buz => (a => 'hash', of => 'something');
SUBROUTINES/METHODS
const $var, $value
const @var, @value...
const %var, %value...
This the only function of this module and it is exported by default. It
takes a scalar, array or hash lvalue as first argument, and a list of
one or more values depending on the type of the first argument as the
value for the variable. It will set the variable to that value and
subsequently make it readonly. Arrays and hashes will be made deeply
readonly.
Exporting is done using Sub::Exporter for flexibility on import.
RATIONALE
This module was written because I stumbled on some serious issues of
Readonly that aren't easily fixable without breaking backwards
compatibility in subtle ways. In particular Readonly's use of ties is a
source of subtle bugs and bad performance. Instead, this module uses
the builtin readonly feature of perl, making access to the variables
just as fast as any normal variable without the weird side-effects of
ties. Readonly can do the same for scalars when Readonly::XS is
installed, but chooses not to do so in the most common case.
AUTHOR
Leon Timmermans, "<leont at cpan.org>"
BUGS
Please report any bugs or feature requests to "bug-const-fast at
rt.cpan.org", or through the web interface at
http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Const-Fast
<http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Const-Fast>. I will be
notified, and then you'll automatically be notified of progress on your
bug as I make changes.
SUPPORT
You can find documentation for this module with the perldoc command.
perldoc Const::Fast
You can also look for information at:
· RT: CPAN's request tracker
http://rt.cpan.org/NoAuth/Bugs.html?Dist=Const-Fast
<http://rt.cpan.org/NoAuth/Bugs.html?Dist=Const-Fast>
· AnnoCPAN: Annotated CPAN documentation
http://annocpan.org/dist/Const-Fast
<http://annocpan.org/dist/Const-Fast>
· CPAN Ratings
http://cpanratings.perl.org/d/Const-Fast
<http://cpanratings.perl.org/d/Const-Fast>
· Search CPAN
http://search.cpan.org/dist/Const-Fast/
<http://search.cpan.org/dist/Const-Fast/>
ACKNOWLEDGEMENTS
The interface for this module was inspired by Eric Roode's Readonly.
The implementation is inspired by doing everything the opposite way
Readonly does it.
LICENSE AND COPYRIGHT
Copyright 2010 Leon Timmermans.
This program is free software; you can redistribute it and/or modify it
under the terms of either: the GNU General Public License as published
by the Free Software Foundation; or the Artistic License.
See http://dev.perl.org/licenses/ for more information.
perl v5.14.1 2011-06-29 Const::Fast(3)