view release on metacpan or  search on metacpan

lib/Acme/SvGROW.pm  view on Meta::CPAN

NOLVAL

};

1;
__END__

=head1 NAME

Acme::SvGROW - syntax for pre-extending a string's storage,
like the proposed use of C<length> as an L-value

=head1 SYNOPSIS

  use Acme::SvGROW;
  SvGrow($BigString, 100000);
  # when l-value subroutines are available (5.8 and later)
  SvGrow($BigString, 100000) = InitialValueOfBigString();

=head1 DESCRIPTION

Trivial module implementing string storage preallocation using
techniques shared on perl5-porters mailing list November 4 and 5, 2009

=head1 EXPORT

the C<SvGROW> subroutine is exported. It takes two arguments,
the first the string to extend and the second the length.

=head1 SEE ALSO

L<perlguts>

L<Data::Peek> for a benchmarking of the alternatives

The author of this module is in favor of allowing C<length> to
be used as an lvalue to thinly invoke the SvGROW internals macro

=head1 CHANGES

=head2 0.03

Data::Peek::DGrow will be used if available

=head1 AUTHOR