ArrayChoiceList

__construct(array|Traversable $choices, callable|null $value = null)

Создаёт список с заданными вариантами и значениями.

Переданный массив вариантов должен иметь те же ключи массива, что и массив значений.

Параметры

array|Traversable	$choices	Выбираемые варианты
callable|null	$value	Функция для создания значения для варианта. Если null передано, инкрементируемые целые числа используются как значения

array getChoices()

Возвращает все выбираемые варианты.

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

array

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

string[] getValues()

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

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

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

string[]

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

string[] getStructuredValues()

Возвращает значения в структуре, первоначально переданной в список.

В отличие от {@link getValues()}, результат индексируется исходными ключами вариантов. Если исходный массив содержал вложенные массивы, эти вложенные массивы также представлены здесь:

$form->add('field', 'choice', array(
    'choices' => array(
        'Decided' => array('Yes' => true, 'No' => false),
        'Undecided' => array('Maybe' => null),
    ),
));

В этом примере результат этого метода:

array(
    'Decided' => array('Yes' => '0', 'No' => '1'),
    'Undecided' => array('Maybe' => '2'),
)

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

string[]

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

int[]|string[] getOriginalKeys()

Возвращает исходные ключи вариантов.

Исходные ключи — это ключи массива вариантов, которые были переданы в опции «choice» типа выбора. Обратите внимание, что этот массив может содержать дубликаты, если опция «choice» содержала группы вариантов:

$form->add('field', 'choice', array(
    'choices' => array(
        'Decided' => array(true, false),
        'Undecided' => array(null),
    ),
));

В этом примере исходный ключ 0 появляется дважды, один раз для true и один раз для null.

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

int[]|string[]

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

array getChoicesForValues(array $values)

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

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

Параметры

array

$values

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

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

array

Массив вариантов

string[] getValuesForChoices(array $choices)

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

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

Параметры

array

$choices

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

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

string[]

Массив значений вариантов