=encoding utf8

=head1 NAME

Mail::Box::FastScalar - fast alternative to IO::Scalar

=head1 DESCRIPTION

Contributed by "Todd Richmond" (richmond@proofpoint.com)  This package
should be released as separate package, but till then is incorporated
in the Mail::Box module.

Extremely fast L<IO::Scalar> replacement - >20x improvement in
getline(s)()

=head2 Warnings

You cannot modify the original reference between calls unless you
C<$obj->seek(1, 0)> to reset the object - VERY rare usage case

$/ must be undef or string - "" and \scalar unimplemented

=head1 SEE ALSO

This module is part of Mail-Box distribution version 2.118,
built on February 26, 2015. Website: F<http://perl.overmeer.net/mailbox/>

=head1 LICENSE

Copyrights 2001-2015 by [Mark Overmeer]. For other contributors see ChangeLog.

This program is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.
See F<http://www.perl.com/perl/misc/Artistic.html>

