|$compressed = compress $uncompressed|
|$compressed = compress_best $uncompressed||
Try to compress the given string as quickly and as much as possible. In
the worst case, the string can enlarge by 1 byte, but that should be the
absolute exception. You can expect a 45% compression ratio on large,
The compress_best function uses a different algorithm that is slower but usually achieves better compression.
|$decompressed = decompress $compressed||Uncompress the string (compressed by compress) and return the original data. Decompression errors can result in either broken data (there is no checksum kept) or a runtime error.|
|$serialized = sfreeze $value (simplified freeze)|
|$serialized = sfreeze_best $value||
Often there is the need to serialize data into a string. This function does that, by using the Storable
module. It does the following transforms:
That is, it tries to leave normal, human-readable data untouched but still serializes complex data structures into strings. The idea is to keep readability as high as possible, and in cases readability cant be helped anyways, it tries to compress the string.
The sfreeze functions will enlarge the original data one byte at most and will only load the Storable method when neccessary.
The sfreeze_best function uses a different algorithm that is slower but usually achieves better compression.
|$serialized = sfreeze_c $value (sfreeze and compress)|
|$serialized = sfreeze_c_best $value||
Similar to sfreeze, but always tries to compress the resulting
string. This still leaves most small objects (most numbers) untouched.
The sfreeze_c function uses a different algorithm that is slower but usually achieves better compression.
|$serialized = sfreeze_cr $value (sfreeze and compress references)|
|$serialized = sfreeze_cr_best $value||
Similar to sfreeze, but tries to compress the resulting string
unless its a simple string. References for example are not simple and
as such are being compressed.
The sfreeze_cr_best function uses a different algorithm that is slower but usually achieves better compression.
|$original_data = sthaw $serialized||Recreate the original object from its serialized representation. This function automatically detects all the different sfreeze formats.|
|Compress::LZF::set_serializer $package, $freeze, $thaw||Set the serialize module and functions to use. The default is Storable, Storable::net_mstore and Storable::mretrieve, which should be fine for most purposes.|
Other Compress::* modules, especially Compress::LZV1 (an older, less speedy module that guarentees only 1 byte overhead worst case) and Compress::Zlib.
This perl extension and the underlying liblzf were written by Marc Lehmann <email@example.com> (See also http://liblzf.plan9.de/).
|perl v5.20.3||LZF (3)||2013-08-25|