ObjectChoiceList ^{устаревший}

__construct(array|Traversable $choices, string $labelPath = null, array $preferredChoices = array(), string $groupPath = null, string $valuePath = null, PropertyAccessorInterface $propertyAccessor = null)

Создаёт новый список выбора объектов.

Параметры

array|Traversable	$choices	Массив выборов. Выборы также могут быть представлены иерархией неограниченной глубины. Иерархии создаются путём создания вложенных массивов. Заголовок под-иерархии может храниться в ключе массива, указывающем на вложенный массив. Верхний уровень иерархии также может быть \Traversable.
string	$labelPath	Путь к свойству, используемому для меток выбора. Значение получается вызовом геттера объекта. Если путь NULL, используется метод __toString() объекта.
array	$preferredChoices	Плоский массив выборов, которые должны быть представлены пользователю с приоритетом.
string	$groupPath	Путь к свойству, используемому для группировки выборов. Допускается только если выборы заданы в виде плоского массива.
string	$valuePath	Путь к свойству, используемому для значений выбора. Если не указан, вместо этого генерируются целые числа.
PropertyAccessorInterface	$propertyAccessor	Граф рефлексии для чтения путей к свойствам.

array getChoices()

Возвращает список выборов.

Значение возврата

array

Выборы со своими индексами в качестве ключей

array getValues()

Возвращает значения для выборов.

Значение возврата

array

Значения с соответствующими индексами выбора в качестве ключей

array getPreferredViews()

Возвращает представления выборов предпочтительных выборов в виде вложенного массива с ключами групп выборов в качестве ключей верхнего уровня.

Пример:

array( 'Группа 1' => array( 10 => Объект ChoiceView, 20 => Объект ChoiceView, ), 'Группа 2' => array( 30 => Объект ChoiceView, ), )

Значение возврата

array

Вложенный массив, содержащий представления с соответствующими индексами выбора в качестве ключей на самых нижних уровнях и именами групп выборов в качестве ключей на более высоких уровнях

array getRemainingViews()

Возвращает представления выборов, которые не являются предпочтительными, в виде вложенного массива с ключами групп выборов в качестве ключей верхнего уровня.

Пример:

array( 'Группа 1' => array( 10 => Объект ChoiceView, 20 => Объект ChoiceView, ), 'Группа 2' => array( 30 => Объект ChoiceView, ), )

Значение возврата

array

Вложенный массив, содержащий представления с соответствующими индексами выбора в качестве ключей на самых нижних уровнях и именами групп выборов в качестве ключей на более высоких уровнях

array getChoicesForValues(array $values)

Возвращает выборы, соответствующие заданным значениям.

Выборы могут иметь любой тип данных.

Выборы должны возвращаться с теми же ключами и в том же порядке, что и соответствующие значения в заданном массиве.

Параметры

array

$values

Массив значений выбора. Несуществующие значения в этом массиве игнорируются

Значение возврата

array

Массив выборов с возрастающими, нулевыми индексами

array getValuesForChoices(array $choices)

Возвращает значения, соответствующие заданным выборам.

Значения должны быть строками.

Значения должны возвращаться с теми же ключами и в том же порядке, что и соответствующие выборы в заданном массиве.

Параметры

array

$choices

Массив выборов. Несуществующие выборы в этом массиве игнорируются

Значение возврата

array

Массив значений выбора с возрастающими, нулевыми индексами

array getIndicesForChoices(array $choices) ^{устаревший}

^{устаревший}

since версия 2.4, будет удалена в 3.0.

Возвращает индексы, соответствующие заданным выборам.

Индексы должны быть положительными целыми числами или строками, принятыми {@link \Symfony\Component\Form\FormConfigBuilder::validateName()}.

Индекс «заполнитель» зарезервирован внутри.

Индексы должны возвращаться с теми же ключами и в том же порядке, что и соответствующие выборы в заданном массиве.

Параметры

array

$choices

Массив выборов. Несуществующие выборы в этом массиве игнорируются

Значение возврата

array

Массив индексов с возрастающими, нулевыми индексами

array getIndicesForValues(array $values) ^{устаревший}

^{устаревший}

since версия 2.4, будет удалена в 3.0.

Возвращает индексы, соответствующие заданным значениям.

Индексы должны быть положительными целыми числами или строками, принятыми {@link \Symfony\Component\Form\FormConfigBuilder::validateName()}.

Индекс «заполнитель» зарезервирован внутри.

Индексы должны возвращаться с теми же ключами и в том же порядке, что и соответствующие значения в заданном массиве.

Параметры

array

$values

Массив значений выбора. Несуществующие значения в этом массиве игнорируются

Значение возврата

array

Массив индексов с возрастающими, нулевыми индексами