NAME

Convert::UU, uuencode, uudecode - Perl module for uuencode and uudecode

SYNOPSIS

  use Convert::UU qw(uudecode uuencode);
  $encoded_string = uuencode($string,[$filename],[$mode]);
  ($string,$filename,$mode) = uudecode($string);
  $string = uudecode($string); # in scalar context

DESCRIPTION

• uuencode

  uuencode() takes as the first argument a string that is to be uuencoded. Note, that it is the string that is encoded, not a filename. Alternatively a filehandle may be passed that must be opened for reading. It returns the uuencoded string including begin and end. Second and third argument are optional and specify filename and mode. If unspecified these default to "uuencode.uu" and 644.

• uudecode

  uudecode() takes a string as argument which will be uudecoded. If the argument is a filehandle this handle will be read instead. If it is a reference to an ARRAY, the elements are treated like lines that form a string. Leading and trailing garbage will be ignored. The function returns the uudecoded string for the first begin/end pair. In array context it returns an array whose first element is the uudecoded string, the second is the filename and the third is the mode.

EXPORT

Both uudecode and uuencode are in @EXPORT_OK.

AUTHOR

Andreas Koenig ANDK@cpan.org. With code integrated that was posted to USENET from Hans Mulder and Randal L. Schwartz.

SEE ALSO

puuencode(1), puudecode(1) for examples of how to use this module.

COPYRIGHT

Copyright 1996-2003 Andreas Koenig.

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

Based on code posted to comp.lang.perl by Hans Mulder and Randal L. Schwartz.