/**
* Returns an error if the given Reflector's arguments do not match expectations.
*
* @param FunctionReflector $element
*
* @return Error|null
*/
protected function validateArguments($element)
{
$params = $element->getDocBlock()->getTagsByName('param');
$arguments = $element->getArguments();
foreach (array_values($arguments) as $key => $argument) {
if (!$this->isArgumentInDocBlock($key, $argument, $element, $params)) {
continue;
}
$result = $this->doesArgumentNameMatchParam($params[$key], $argument, $element);
if ($result) {
return $result;
}
$result = $this->doesArgumentTypehintMatchParam($params[$key], $argument, $element);
if ($result) {
return $result;
}
}
/** @var ParamTag $param */
foreach ($params as $param) {
$param_name = $param->getVariableName();
if (isset($arguments[$param_name])) {
continue;
}
return new Error(LogLevel::NOTICE, 'PPC:ERR-50013', $element->getLinenumber(), array($param_name, $element->getName()));
}
return null;
}
/**
* Creates a Descriptor from the provided data.
*
* @param FunctionReflector $data
*
* @return FunctionDescriptor
*/
public function create($data)
{
$functionDescriptor = new FunctionDescriptor();
$functionDescriptor->setFullyQualifiedStructuralElementName($data->getName() . '()');
$functionDescriptor->setName($data->getShortName());
$functionDescriptor->setLine($data->getLinenumber());
// Reflection library formulates namespace as global but this is not wanted for phpDocumentor itself
$functionDescriptor->setNamespace('\\' . (strtolower($data->getNamespace()) == 'global' ? '' : $data->getNamespace()));
$this->assembleDocBlock($data->getDocBlock(), $functionDescriptor);
foreach ($data->getArguments() as $argument) {
$argumentAssembler = new ArgumentAssembler();
$argumentDescriptor = $argumentAssembler->create($argument, $functionDescriptor->getTags()->get('param', array()));
$functionDescriptor->getArguments()->set($argumentDescriptor->getName(), $argumentDescriptor);
}
return $functionDescriptor;
}
