0

Здравствуйте. Как правильно описать возвращаемый тип метода в PHPDoc:

/**
 * @return \Generator
 */
public function getLayers()
{
    foreach($this->layers as $layer)
         yield $layer;
    }
}

При использовании в цикле, PHPStorm не понимает, какой тип он итерирует:

foreach ($this->getLayers() as $layer)
    $layer->... //PHPStorm: "я не знаю что это!"

При этом, если бы возвращался просто массив, можно было бы описать так:

/**
 * @return LayerType[]
 */
public function getLayers()
{
    return $this->layers;
}

Такой способ, при итерации распознает объекты.

4
  • Прочитайте stackoverflow.com/questions/30083184/… и stackoverflow.com/a/33272232/6104996 может быть поможет 10 апр 2016 в 6:55
  • Да, я читал уже. Думал, может есть более правильный способ. Сейчас, получается, что я обманываю конечного пользователя, говоря, что я возвращаю ему массив слоев, на самом деле возвращая генератор.
    – A1essandro
    10 апр 2016 в 7:01
  • К сожалению, дженерики пока еще не подвезли
    – etki
    10 апр 2016 в 7:35
  • @Etki, скорее бы)
    – A1essandro
    10 апр 2016 в 8:13

1 ответ 1

2

Можно комбинировать типы, чтобы удовлетворить и читателя кода, и PhpStorm:

/**
 * @return \Generator|LayerType[]
 */
public function getLayers()
{
    foreach($this->layers as $layer)
         yield $layer;
    }
}

Небольшое дополнение. Такой синтаксис все же подразумевает, что функция может возвращать значения разных типов. Поэтому конкретно в этом случае причину его использования лучше дополнительно задокументировать, чтобы избежать неоднозначной трактовки.

Ваш ответ

Нажимая на кнопку «Отправить ответ», вы соглашаетесь с нашими условиями использования и подтверждаете, что прочитали и поняли наши политику конфиденциальности и нормы поведения.

Всё ещё ищете ответ? Посмотрите другие вопросы с метками или задайте свой вопрос.