PHP - convert_uudecode() Function

---

---

The PHP convert_uudecode() function is used to decode a uuencoded string. A "uuencoded" string is a representation of binary data encoded in "ASCII" text format using the UUencoding method.

You can use the convert_uuencode() function together to do a reverse operation. It converts the decoded string to a uuencoded string.

Syntax

Following is the syntax of the PHP convert_uudecode() function −

convert_uudecode(string $str): string|false

Parameters

This function accepts a single parameter, which is described below −

• str − The uuencoded string (data) needs to be decoded.

Return Value

This function returns the decoded data as a string; otherwise it returns "false" on failure.

Example 1

The following is the basic example of the PHP convert_uudecode() function −

<?php
   $str = "+22!L;W9E(%!(4\"$`\n`)";
   echo "The given uuencoded string: $str";
   echo "\nThe decoded string is: ";
   #using convert_uudecode() function
   echo convert_uudecode($str);
?>

Output

The above program generates the following output −

The given uuencoded string: +22!L;W9E(%!(4"$`
`)
The decoded string is: I love PHP!

Example 2

Using theconvert_uudecode()andconvert_uuencode()functions together to decode and encode data at a time.

Following is another example of the PHP convert_uudecode() function. We use this function to decode a uuencoded string ".5'5T;W)I86QS<&]I;G0` `" −

<?php
   $str = ".5'5T;W)I86QS<&]I;G0` `";
   echo "The given uuencoded string: $str";
   echo "\nThe decoded string is: ";
   #using convert_uudecode() function
   echo convert_uudecode($str);
   echo "\nThe encoded string is: ";
   #using convert_uuencode() function
   echo convert_uuencode(convert_uudecode($str));
?>

Output

After executing the above program, the following output will be displayed −

The given uuencoded string: .5'5T;W)I86QS<&]I;G0` `
The decoded string is: Tutorialspoint
The encoded string is: .5'5T;W)I86QS<&]I;G0`
`

Example 3

If the specified "uuencoded" string fails to decode, this function will return "false" and issue a warning about the invalid data −

<?php
   $str = "Invalid uuencoded string";
   echo "The given uuencoded string: $str\n";
   echo "The decoded string is: ";
   $decoded = convert_uudecode($str);
   echo "The function returns: ";
   var_dump($decoded);
   if ($decoded === false || $decoded === '') {
       echo "Failed to decode the UUencoded string.";
   } else {
       echo $decoded;
   }
?>

Output

Following is the output of the above program −

The given uuencoded string: Invalid uuencoded string
The decoded string is: PHP Warning:  convert_uudecode(): 
Argument #1 ($data) is not a valid uuencoded string in C:\Apache24\htdocs\index.php on line 5
The function returns: bool(false)
Failed to decode the UUencoded string.