W3cubDocs

/Symfony 3.0

Symfony\Component\Console\Input\InputDefinition

class InputDefinition

A InputDefinition represents a set of valid command line arguments and options.

Usage:

$definition = new InputDefinition(array(
  new InputArgument('name', InputArgument::REQUIRED),
  new InputOption('foo', 'f', InputOption::VALUE_REQUIRED),
));

Methods

__construct(array $definition = array())

Constructor.

setDefinition(array $definition)

Sets the definition of the input.

setArguments(InputArgument[] $arguments = array())

Sets the InputArgument objects.

addArguments(InputArgument[] $arguments = array())

Adds an array of InputArgument objects.

addArgument(InputArgument $argument)

Adds an InputArgument object.

InputArgument getArgument(string|int $name)

Returns an InputArgument by name or by position.

bool hasArgument(string|int $name)

Returns true if an InputArgument object exists by name or position.

InputArgument[] getArguments()

Gets the array of InputArgument objects.

int getArgumentCount()

Returns the number of InputArguments.

int getArgumentRequiredCount()

Returns the number of required InputArguments.

array getArgumentDefaults()

Gets the default values.

setOptions(InputOption[] $options = array())

Sets the InputOption objects.

addOptions(InputOption[] $options = array())

Adds an array of InputOption objects.

addOption(InputOption $option)

Adds an InputOption object.

InputOption getOption(string $name)

Returns an InputOption by name.

bool hasOption(string $name)

Returns true if an InputOption object exists by name.

InputOption[] getOptions()

Gets the array of InputOption objects.

bool hasShortcut(string $name)

Returns true if an InputOption object exists by shortcut.

InputOption getOptionForShortcut(string $shortcut)

Gets an InputOption by shortcut.

array getOptionDefaults()

Gets an array of default values.

string getSynopsis(bool $short = false)

Gets the synopsis.

Details

public __construct(array $definition = array())

Constructor.

Parameters

array $definition An array of InputArgument and InputOption instance

public setDefinition(array $definition)

Sets the definition of the input.

Parameters

array $definition The definition array

public setArguments(InputArgument[] $arguments = array())

Sets the InputArgument objects.

Parameters

InputArgument[] $arguments An array of InputArgument objects

public addArguments(InputArgument[] $arguments = array())

Adds an array of InputArgument objects.

Parameters

InputArgument[] $arguments An array of InputArgument objects

public addArgument(InputArgument $argument)

Adds an InputArgument object.

Parameters

InputArgument $argument An InputArgument object

Exceptions

LogicException When incorrect argument is given

public InputArgument getArgument(string|int $name)

Returns an InputArgument by name or by position.

Parameters

string|int $name The InputArgument name or position

Return Value

InputArgument An InputArgument object

Exceptions

InvalidArgumentException When argument given doesn't exist

public bool hasArgument(string|int $name)

Returns true if an InputArgument object exists by name or position.

Parameters

string|int $name The InputArgument name or position

Return Value

bool true if the InputArgument object exists, false otherwise

public InputArgument[] getArguments()

Gets the array of InputArgument objects.

Return Value

InputArgument[] An array of InputArgument objects

public int getArgumentCount()

Returns the number of InputArguments.

Return Value

int The number of InputArguments

public int getArgumentRequiredCount()

Returns the number of required InputArguments.

Return Value

int The number of required InputArguments

public array getArgumentDefaults()

Gets the default values.

Return Value

array An array of default values

public setOptions(InputOption[] $options = array())

Sets the InputOption objects.

Parameters

InputOption[] $options An array of InputOption objects

public addOptions(InputOption[] $options = array())

Adds an array of InputOption objects.

Parameters

InputOption[] $options An array of InputOption objects

public addOption(InputOption $option)

Adds an InputOption object.

Parameters

InputOption $option An InputOption object

Exceptions

LogicException When option given already exist

public InputOption getOption(string $name)

Returns an InputOption by name.

Parameters

string $name The InputOption name

Return Value

InputOption A InputOption object

Exceptions

InvalidArgumentException When option given doesn't exist

public bool hasOption(string $name)

Returns true if an InputOption object exists by name.

Parameters

string $name The InputOption name

Return Value

bool true if the InputOption object exists, false otherwise

public InputOption[] getOptions()

Gets the array of InputOption objects.

Return Value

InputOption[] An array of InputOption objects

public bool hasShortcut(string $name)

Returns true if an InputOption object exists by shortcut.

Parameters

string $name The InputOption shortcut

Return Value

bool true if the InputOption object exists, false otherwise

public InputOption getOptionForShortcut(string $shortcut)

Gets an InputOption by shortcut.

Parameters

string $shortcut the Shortcut name

Return Value

InputOption An InputOption object

public array getOptionDefaults()

Gets an array of default values.

Return Value

array An array of all default values

public string getSynopsis(bool $short = false)

Gets the synopsis.

Parameters

bool $short Whether to return the short version (with options folded) or not

Return Value

string The synopsis

© 2004–2016 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/3.0/Symfony/Component/Console/Input/InputDefinition.html