W3cubDocs

/Symfony 2.7

Symfony\Component\Console\Question\ChoiceQuestion

class ChoiceQuestion extends Question

Represents a choice question.

Methods

__construct(string $question, array $choices, mixed $default = null)

Constructor.

string getQuestion()

Returns the question.

from Question
mixed getDefault()

Returns the default answer.

from Question
bool isHidden()

Returns whether the user response must be hidden.

from Question
Question setHidden(bool $hidden)

Sets whether the user response must be hidden or not.

from Question
bool isHiddenFallback()

In case the response can not be hidden, whether to fallback on non-hidden question or not.

from Question
Question setHiddenFallback(bool $fallback)

Sets whether to fallback on non-hidden question if the response can not be hidden.

from Question
null|array|Traversable getAutocompleterValues()

Gets values for the autocompleter.

from Question
Question setAutocompleterValues(null|array|Traversable $values)

Sets values for the autocompleter.

from Question
Question setValidator(null|callable $validator)

Sets a validator for the question.

from Question
null|callable getValidator()

Gets the validator for the question

from Question
Question setMaxAttempts(null|int $attempts)

Sets the maximum number of attempts.

from Question
null|int getMaxAttempts()

Gets the maximum number of attempts.

from Question
Question setNormalizer(string|Closure $normalizer)

Sets a normalizer for the response.

from Question
string|Closure getNormalizer()

Gets the normalizer for the response.

from Question
array getChoices()

Returns available choices.

ChoiceQuestion setMultiselect(bool $multiselect)

Sets multiselect option.

string getPrompt()

Gets the prompt for choices.

ChoiceQuestion setPrompt(string $prompt)

Sets the prompt for choices.

ChoiceQuestion setErrorMessage(string $errorMessage)

Sets the error message for invalid values.

Details

public __construct(string $question, array $choices, mixed $default = null)

Constructor.

Parameters

string $question The question to ask to the user
array $choices
mixed $default The default answer to return if the user enters nothing

public string getQuestion()

Returns the question.

Return Value

string

public mixed getDefault()

Returns the default answer.

Return Value

mixed

public bool isHidden()

Returns whether the user response must be hidden.

Return Value

bool

public Question setHidden(bool $hidden)

Sets whether the user response must be hidden or not.

Parameters

bool $hidden

Return Value

Question The current instance

Exceptions

LogicException In case the autocompleter is also used

public bool isHiddenFallback()

In case the response can not be hidden, whether to fallback on non-hidden question or not.

Return Value

bool

public Question setHiddenFallback(bool $fallback)

Sets whether to fallback on non-hidden question if the response can not be hidden.

Parameters

bool $fallback

Return Value

Question The current instance

public null|array|Traversable getAutocompleterValues()

Gets values for the autocompleter.

Return Value

null|array|Traversable

public Question setAutocompleterValues(null|array|Traversable $values)

Sets values for the autocompleter.

Parameters

null|array|Traversable $values

Return Value

Question The current instance

Exceptions

InvalidArgumentException
LogicException

public Question setValidator(null|callable $validator)

Sets a validator for the question.

Parameters

null|callable $validator

Return Value

Question The current instance

public null|callable getValidator()

Gets the validator for the question

Return Value

null|callable

public Question setMaxAttempts(null|int $attempts)

Sets the maximum number of attempts.

Null means an unlimited number of attempts.

Parameters

null|int $attempts

Return Value

Question The current instance

Exceptions

InvalidArgumentException In case the number of attempts is invalid.

public null|int getMaxAttempts()

Gets the maximum number of attempts.

Null means an unlimited number of attempts.

Return Value

null|int

public Question setNormalizer(string|Closure $normalizer)

Sets a normalizer for the response.

The normalizer can ba a callable (a string), a closure or a class implementing __invoke.

Parameters

string|Closure $normalizer

Return Value

Question The current instance

public string|Closure getNormalizer()

Gets the normalizer for the response.

The normalizer can ba a callable (a string), a closure or a class implementing __invoke.

Return Value

string|Closure

public array getChoices()

Returns available choices.

Return Value

array

public ChoiceQuestion setMultiselect(bool $multiselect)

Sets multiselect option.

When multiselect is set to true, multiple choices can be answered.

Parameters

bool $multiselect

Return Value

ChoiceQuestion The current instance

public string getPrompt()

Gets the prompt for choices.

Return Value

string

public ChoiceQuestion setPrompt(string $prompt)

Sets the prompt for choices.

Parameters

string $prompt

Return Value

ChoiceQuestion The current instance

public ChoiceQuestion setErrorMessage(string $errorMessage)

Sets the error message for invalid values.

The error message has a string placeholder (%s) for the invalid value.

Parameters

string $errorMessage

Return Value

ChoiceQuestion The current instance

© 2004–2016 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/2.7/Symfony/Component/Console/Question/ChoiceQuestion.html