vendor/symfony/src/Symfony/Component/Console/Input/InputInterface.php
changeset 0 7f95f8617b0b
equal deleted inserted replaced
-1:000000000000 0:7f95f8617b0b
       
     1 <?php
       
     2 
       
     3 /*
       
     4  * This file is part of the Symfony package.
       
     5  *
       
     6  * (c) Fabien Potencier <fabien@symfony.com>
       
     7  *
       
     8  * For the full copyright and license information, please view the LICENSE
       
     9  * file that was distributed with this source code.
       
    10  */
       
    11 
       
    12 namespace Symfony\Component\Console\Input;
       
    13 
       
    14 /**
       
    15  * InputInterface is the interface implemented by all input classes.
       
    16  *
       
    17  * @author Fabien Potencier <fabien@symfony.com>
       
    18  */
       
    19 interface InputInterface
       
    20 {
       
    21     /**
       
    22      * Returns the first argument from the raw parameters (not parsed).
       
    23      *
       
    24      * @return string The value of the first argument or null otherwise
       
    25      */
       
    26     function getFirstArgument();
       
    27 
       
    28     /**
       
    29      * Returns true if the raw parameters (not parsed) contains a value.
       
    30      *
       
    31      * This method is to be used to introspect the input parameters
       
    32      * before it has been validated. It must be used carefully.
       
    33      *
       
    34      * @param string|array $values The values to look for in the raw parameters (can be an array)
       
    35      *
       
    36      * @return Boolean true if the value is contained in the raw parameters
       
    37      */
       
    38     function hasParameterOption($values);
       
    39 
       
    40     /**
       
    41      * Returns the value of a raw option (not parsed).
       
    42      *
       
    43      * This method is to be used to introspect the input parameters
       
    44      * before it has been validated. It must be used carefully.
       
    45      *
       
    46      * @param string|array $values The value(s) to look for in the raw parameters (can be an array)
       
    47      * @param mixed $default The default value to return if no result is found
       
    48      *
       
    49      * @return mixed The option value
       
    50      */
       
    51     function getParameterOption($values, $default = false);
       
    52 
       
    53     /**
       
    54      * Binds the current Input instance with the given arguments and options.
       
    55      *
       
    56      * @param InputDefinition $definition A InputDefinition instance
       
    57      */
       
    58     function bind(InputDefinition $definition);
       
    59 
       
    60     /**
       
    61      * Validate if arguments given are correct.
       
    62      *
       
    63      * Throws an exception when not enough arguments are given.
       
    64      *
       
    65      * @throws \RuntimeException
       
    66      */
       
    67     function validate();
       
    68 
       
    69     /**
       
    70      * Returns all the given arguments merged with the default values.
       
    71      *
       
    72      * @return array
       
    73      */
       
    74     function getArguments();
       
    75 
       
    76     /**
       
    77      * Get argument by name.
       
    78      *
       
    79      * @param string $name The name of the argument
       
    80      * @return mixed
       
    81      */
       
    82     function getArgument($name);
       
    83 
       
    84     /**
       
    85      * @return array
       
    86      */
       
    87     function getOptions();
       
    88 
       
    89     /**
       
    90      * Get an option by name.
       
    91      *
       
    92      * @param string $name The name of the option
       
    93      * @return mixed
       
    94      */
       
    95     function getOption($name);
       
    96 
       
    97     /**
       
    98      * Is this input means interactive?
       
    99      *
       
   100      * @return Boolean
       
   101      */
       
   102     function isInteractive();
       
   103 }