… | |
… | |
5 | use Carp; |
5 | use Carp; |
6 | |
6 | |
7 | require Exporter; |
7 | require Exporter; |
8 | require DynaLoader; |
8 | require DynaLoader; |
9 | |
9 | |
10 | our $VERSION = 1.71; |
10 | our $VERSION = 1.8; |
11 | |
11 | |
12 | our @ISA = qw(Exporter DynaLoader); |
12 | our @ISA = qw(Exporter DynaLoader); |
13 | |
13 | |
14 | our @_consts = qw( |
14 | our @_consts = qw( |
15 | ACT_COPYING ACT_DECODING ACT_ENCODING ACT_IDLE ACT_SCANNING |
15 | ACT_COPYING ACT_DECODING ACT_ENCODING ACT_IDLE ACT_SCANNING |
… | |
… | |
87 | 1; |
87 | 1; |
88 | __END__ |
88 | __END__ |
89 | |
89 | |
90 | =head1 NAME |
90 | =head1 NAME |
91 | |
91 | |
92 | Convert::UUlib - Perl interface to the uulib library (a.k.a. uudeview/uuenview). |
92 | Convert::UUlib - decode uu/xx/b64/mime/yenc/etc-encoded data from a massive number of files |
93 | |
93 | |
94 | =head1 SYNOPSIS |
94 | =head1 SYNOPSIS |
95 | |
95 | |
96 | use Convert::UUlib ':all'; |
96 | use Convert::UUlib ':all'; |
97 | |
97 | |
… | |
… | |
105 | print $uu->filename, "\n"; |
105 | print $uu->filename, "\n"; |
106 | } |
106 | } |
107 | } |
107 | } |
108 | |
108 | |
109 | =head1 DESCRIPTION |
109 | =head1 DESCRIPTION |
|
|
110 | |
|
|
111 | This module started as an interface to the uulib/uudeview library by Frank |
|
|
112 | Pilhofer that can be used to decode all kinds of usenet (and other) |
|
|
113 | binary messages. |
|
|
114 | |
|
|
115 | After upstream abondoned the project, th library was continuously bugfixed |
|
|
116 | and improved in this module, with major focuses on security fixes, |
|
|
117 | correctness and speed (that does not mean that this library is considered |
|
|
118 | safe with untrusted data, but it surely is safer than the poriginal |
|
|
119 | uudeview). |
110 | |
120 | |
111 | Read the file doc/library.pdf from the distribution for in-depth |
121 | Read the file doc/library.pdf from the distribution for in-depth |
112 | information about the C-library used in this interface, and the rest of |
122 | information about the C-library used in this interface, and the rest of |
113 | this document and especially the non-trivial decoder program at the end. |
123 | this document and especially the non-trivial decoder program at the end. |
114 | |
124 | |
… | |
… | |
292 | if you want to iterate over all items, it is usually faster to use |
302 | if you want to iterate over all items, it is usually faster to use |
293 | C<GetFileList>. |
303 | C<GetFileList>. |
294 | |
304 | |
295 | =item @items = GetFileList |
305 | =item @items = GetFileList |
296 | |
306 | |
297 | Similar to C<GetFileListItem>, but returns all files in one go. |
307 | Similar to C<GetFileListItem>, but returns all files in one go, which is |
|
|
308 | very much faster for large number of items, and has no drawbacks when used |
|
|
309 | for a small number of items. |
298 | |
310 | |
299 | =back |
311 | =back |
300 | |
312 | |
301 | =head2 Decoding files |
313 | =head2 Decoding files |
302 | |
314 | |