Список выборов массива

__construct(iterable $choices, callable $value = null)

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

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

Параметры

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

массив getChoices()

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

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

массив

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

строковый массив getValues()

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

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

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

строковый массив

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

строковый массив 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'),
)

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

строковый массив

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

int[]|строковый массив getOriginalKeys()

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

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

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

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

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

int[]|строковый массив

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

массив getChoicesForValues(array $values)

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

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

Параметры

массив

$values

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

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

массив

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

строковый массив getValuesForChoices(array $choices)

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

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

Параметры

массив

$choices

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

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

строковый массив

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