@return

(phpDocumentor 0.1+ )

@return --  specify the return type of a function or method

Description

@return datatype [description]

You may use the @return tag to document the return value of functions or methods. @returns is an alias for @return to support autodoc designed for other packages

datatype should be a valid PHP type or "mixed." phpDocumentor will display the optional description unmodified

Here's an example:

/**
* example of basic @return usage
* @return mixed
*/
function function1($baz)
{
   if ($baz)
   {
      $a = 5;
   } else
   {
      $a = array(1,4);
   }
   return $a;
}

class class1
{
   /**
   * example of documenting a method, and using optional description with @return
   * @return string de-html_entitied string (no entities at all)
   */
   function bar($foo)
   {
      return strtr($foo,array_flip(get_html_translation_table(HTML_ENTITIES)));
   }
}