説明するのは少し難しいかもしれないので、いくつかのサンプルコードを示します。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+spaceを押すことでオートコンプリートを呼び出すことができます。次のヒントウィンドウには、「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に指示できるものはありますか?