new¶

 my $stream = Crypt::Stream::Rabbit->new($key, $iv);
 # $key .. [binary string] key length must be at most 16 bytes
 # $iv  .. [binary string] IV length must be at most 8 bytes
 my $stream = Crypt::Stream::Rabbit->new($key);
 # note: new($key) skips IV setup entirely, while new($key, "") performs
 #       IV setup with a zero-length IV. These produce different keystreams.

crypt¶

Encrypts or decrypts data. The output has the same length as the input. Returns a binary string (raw bytes).

The input is converted using Perl's usual scalar stringification. Passing "undef" is treated as an empty string with the usual warning, and numeric scalars are stringified before processing.

 my $ciphertext = $stream->crypt($plaintext);
 #or
 my $plaintext = $stream->crypt($ciphertext);

keystream¶

Returns $length bytes of raw keystream as a binary string.

The length is taken using Perl's usual numeric coercion. Values that coerce to an oversized unsigned length are rejected as too large.

 my $random_key = $stream->keystream($length);

clone¶

Returns a copy of the stream cipher object in its current state.

 my $stream2 = $stream->clone();