Convert-UUlib
view release on metacpan or search on metacpan
CleanUp
Release memory, file items and clean up files. Should be called
after a decoidng run, if you want to start a new one.
Setting and querying options
$option = GetOption OPT_xxx
SetOption OPT_xxx, opt-value
See the "OPT_xxx" constants above to see which options exist.
Setting various callbacks
SetMsgCallback [callback-function]
SetBusyCallback [callback-function]
SetFileCallback [callback-function]
SetFNameFilter [callback-function]
Call the currently selected FNameFilter
$file = FNameFilter $file
Loading sourcefiles, optionally fuzzy merge and start decoding
($retval, $count) = LoadFile $fname, [$id, [$delflag, [$partno]]]
functions - generally these are functions accessing the disk and/or
using considerable CPU time:
LoadFile
$item->decode
$item->decode_temp
$item->remove_temp
$item->info
The perl interpreter will be reacquired/released on every callback
invocation, so for performance reasons, callbacks should be avoided if
that is costly.
Future versions might enable multicore support for more functions.
BUGS AND LIMITATIONS
The original uulib library this module uses was written at a time where
main memory of measured in megabytes and buffer overflows as a security
thign didn't exist. While a lot of security fixes have been applied over
the years (includign some defense in depth mechanism that can shield
against a lot of as-of-yet undetected bugs), using this library for
=over
=item $option = GetOption OPT_xxx
=item SetOption OPT_xxx, opt-value
=back
See the C<OPT_xxx> constants above to see which options exist.
=head2 Setting various callbacks
=over
=item SetMsgCallback [callback-function]
=item SetBusyCallback [callback-function]
=item SetFileCallback [callback-function]
=item SetFNameFilter [callback-function]
functions - generally these are functions accessing the disk and/or using
considerable CPU time:
LoadFile
$item->decode
$item->decode_temp
$item->remove_temp
$item->info
The perl interpreter will be reacquired/released on every callback
invocation, so for performance reasons, callbacks should be avoided if
that is costly.
Future versions might enable multicore support for more functions.
=head1 BUGS AND LIMITATIONS
The original uulib library this module uses was written at a time where
main memory of measured in megabytes and buffer overflows as a security
thign didn't exist. While a lot of security fixes have been applied over
the years (includign some defense in depth mechanism that can shield
( run in 0.486 second using v1.01-cache-2.11-cpan-9b1e4054eb1 )