NAME

Data::BitStream::String - A String implementation of Data::BitStream

SYNOPSIS

use Data::BitStream::String;
my $stream = Data::BitStream::String->new;
$stream->put_gamma($_) for (1 .. 20);
$stream->rewind_for_read;
my @values = $stream->get_gamma(-1);

DESCRIPTION

An implementation of Data::BitStream. See the documentation for that module for many more examples, and Data::BitStream::Base for the API. This document only describes the unique features of this implementation, which is of limited value to people purely using Data::BitStream.

This implementation is very memory inefficient, as it uses a binary string to hold the data, hence uses one byte internally per bit of data. However it is a useful reference implementation, and since most operations use Perl operations it is quite fast.

DATA

_str

A private string holding the data in binary string form.

CLASS METHODS

_strref

Retrieves a reference to the private string.

after erase

Sets the private string to the empty string ''.

read
write
put_unary
put_unary1
put_gamma
get_unary
get_unary1
get_gamma
put_string
read_string
to_string
from_string

These methods have custom implementations.

ROLES

The following roles are included. Note that Gamma has an inline implementation.

Data::BitStream::Code::Base
Data::BitStream::Code::Delta
Data::BitStream::Code::Omega
Data::BitStream::Code::Levenstein
Data::BitStream::Code::EvenRodeh
Data::BitStream::Code::Fibonacci
Data::BitStream::Code::Golomb
Data::BitStream::Code::Rice
Data::BitStream::Code::GammaGolomb
Data::BitStream::Code::ExponentialGolomb
Data::BitStream::Code::StartStop

SEE ALSO

Data::BitStream
Data::BitStream::Base
Data::BitStream::WordVec

AUTHORS

Dana Jacobsen <dana@acm.org>

COPYRIGHT

Copyright 2011 by Dana Jacobsen <dana@acm.org>

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