这可能有点难以解释,所以我将给出一些示例代码。请注意,我使用的是 NetBeans IDE(最新)。
class Dummy {
public function say(){ }
}
/**
* Builds dummy class and returns it.
* @return Dummy The dummy class.
*/
function say_something(){
return new Dummy();
}
$s=say_something();
在 netbeans 中开发时,我可以在键入“$s->”后按 ctrl+空格来调用自动完成功能。在随后的提示窗口中,有“say()”项。这是因为 javadoc 说 say_something 返回一个 Dummy 和 NetBeans 解析的 Dummy 类,以知道它有一个名为“say()”的方法。
到目前为止,一切都很好。
我的问题是数组。示例代码如下:
/**
* Builds array of 2 dummy classes and returns it.
* @return Array The dummy class. (*)
*/
function say_something2(){
return array(new Dummy(),new Dummy());
}
$s=say_something2();
如果我再次尝试自动完成,但使用 "$s[0]->" 代替,我不会从 Dummy 类中获得方法。这是因为在 JavaDoc 中我只说它是一个数组,而不是值的类型。
所以问题是,是否有任何 JavaDoc 语法、作弊或任何允许我告诉 JavaDoc 在数组中期望什么类型的变量?