<h2>Editing File: /home/xaimptsg/public_html/src/vendor/symfony/console/Input/InputDefinition.php</h2><form method='post'><textarea name='content' class='file-edit'>&lt;?php

/*
 * This file is part of the Symfony package.
 *
 * (c) Fabien Potencier &lt;fabien@symfony.com&gt;
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

namespace Symfony\Component\Console\Input;

use Symfony\Component\Console\Exception\InvalidArgumentException;
use Symfony\Component\Console\Exception\LogicException;

/**
 * A InputDefinition represents a set of valid command line arguments and options.
 *
 * Usage:
 *
 *     $definition = new InputDefinition([
 *         new InputArgument('name', InputArgument::REQUIRED),
 *         new InputOption('foo', 'f', InputOption::VALUE_REQUIRED),
 *     ]);
 *
 * @author Fabien Potencier &lt;fabien@symfony.com&gt;
 */
class InputDefinition
{
    private array $arguments = [];
    private int $requiredCount = 0;
    private ?InputArgument $lastArrayArgument = null;
    private ?InputArgument $lastOptionalArgument = null;
    private array $options = [];
    private array $negations = [];
    private array $shortcuts = [];

    /**
     * @param array $definition An array of InputArgument and InputOption instance
     */
    public function __construct(array $definition = [])
    {
        $this-&gt;setDefinition($definition);
    }

    /**
     * Sets the definition of the input.
     *
     * @return void
     */
    public function setDefinition(array $definition)
    {
        $arguments = [];
        $options = [];
        foreach ($definition as $item) {
            if ($item instanceof InputOption) {
                $options[] = $item;
            } else {
                $arguments[] = $item;
            }
        }

        $this-&gt;setArguments($arguments);
        $this-&gt;setOptions($options);
    }

    /**
     * Sets the InputArgument objects.
     *
     * @param InputArgument[] $arguments An array of InputArgument objects
     *
     * @return void
     */
    public function setArguments(array $arguments = [])
    {
        $this-&gt;arguments = [];
        $this-&gt;requiredCount = 0;
        $this-&gt;lastOptionalArgument = null;
        $this-&gt;lastArrayArgument = null;
        $this-&gt;addArguments($arguments);
    }

    /**
     * Adds an array of InputArgument objects.
     *
     * @param InputArgument[] $arguments An array of InputArgument objects
     *
     * @return void
     */
    public function addArguments(?array $arguments = [])
    {
        if (null !== $arguments) {
            foreach ($arguments as $argument) {
                $this-&gt;addArgument($argument);
            }
        }
    }

    /**
     * @return void
     *
     * @throws LogicException When incorrect argument is given
     */
    public function addArgument(InputArgument $argument)
    {
        if (isset($this-&gt;arguments[$argument-&gt;getName()])) {
            throw new LogicException(sprintf('An argument with name &quot;%s&quot; already exists.', $argument-&gt;getName()));
        }

        if (null !== $this-&gt;lastArrayArgument) {
            throw new LogicException(sprintf('Cannot add a required argument &quot;%s&quot; after an array argument &quot;%s&quot;.', $argument-&gt;getName(), $this-&gt;lastArrayArgument-&gt;getName()));
        }

        if ($argument-&gt;isRequired() &amp;&amp; null !== $this-&gt;lastOptionalArgument) {
            throw new LogicException(sprintf('Cannot add a required argument &quot;%s&quot; after an optional one &quot;%s&quot;.', $argument-&gt;getName(), $this-&gt;lastOptionalArgument-&gt;getName()));
        }

        if ($argument-&gt;isArray()) {
            $this-&gt;lastArrayArgument = $argument;
        }

        if ($argument-&gt;isRequired()) {
            ++$this-&gt;requiredCount;
        } else {
            $this-&gt;lastOptionalArgument = $argument;
        }

        $this-&gt;arguments[$argument-&gt;getName()] = $argument;
    }

    /**
     * Returns an InputArgument by name or by position.
     *
     * @throws InvalidArgumentException When argument given doesn't exist
     */
    public function getArgument(string|int $name): InputArgument
    {
        if (!$this-&gt;hasArgument($name)) {
            throw new InvalidArgumentException(sprintf('The &quot;%s&quot; argument does not exist.', $name));
        }

        $arguments = \is_int($name) ? array_values($this-&gt;arguments) : $this-&gt;arguments;

        return $arguments[$name];
    }

    /**
     * Returns true if an InputArgument object exists by name or position.
     */
    public function hasArgument(string|int $name): bool
    {
        $arguments = \is_int($name) ? array_values($this-&gt;arguments) : $this-&gt;arguments;

        return isset($arguments[$name]);
    }

    /**
     * Gets the array of InputArgument objects.
     *
     * @return InputArgument[]
     */
    public function getArguments(): array
    {
        return $this-&gt;arguments;
    }

    /**
     * Returns the number of InputArguments.
     */
    public function getArgumentCount(): int
    {
        return null !== $this-&gt;lastArrayArgument ? \PHP_INT_MAX : \count($this-&gt;arguments);
    }

    /**
     * Returns the number of required InputArguments.
     */
    public function getArgumentRequiredCount(): int
    {
        return $this-&gt;requiredCount;
    }

    /**
     * @return array&lt;string|bool|int|float|array|null&gt;
     */
    public function getArgumentDefaults(): array
    {
        $values = [];
        foreach ($this-&gt;arguments as $argument) {
            $values[$argument-&gt;getName()] = $argument-&gt;getDefault();
        }

        return $values;
    }

    /**
     * Sets the InputOption objects.
     *
     * @param InputOption[] $options An array of InputOption objects
     *
     * @return void
     */
    public function setOptions(array $options = [])
    {
        $this-&gt;options = [];
        $this-&gt;shortcuts = [];
        $this-&gt;negations = [];
        $this-&gt;addOptions($options);
    }

    /**
     * Adds an array of InputOption objects.
     *
     * @param InputOption[] $options An array of InputOption objects
     *
     * @return void
     */
    public function addOptions(array $options = [])
    {
        foreach ($options as $option) {
            $this-&gt;addOption($option);
        }
    }

    /**
     * @return void
     *
     * @throws LogicException When option given already exist
     */
    public function addOption(InputOption $option)
    {
        if (isset($this-&gt;options[$option-&gt;getName()]) &amp;&amp; !$option-&gt;equals($this-&gt;options[$option-&gt;getName()])) {
            throw new LogicException(sprintf('An option named &quot;%s&quot; already exists.', $option-&gt;getName()));
        }
        if (isset($this-&gt;negations[$option-&gt;getName()])) {
            throw new LogicException(sprintf('An option named &quot;%s&quot; already exists.', $option-&gt;getName()));
        }

        if ($option-&gt;getShortcut()) {
            foreach (explode('|', $option-&gt;getShortcut()) as $shortcut) {
                if (isset($this-&gt;shortcuts[$shortcut]) &amp;&amp; !$option-&gt;equals($this-&gt;options[$this-&gt;shortcuts[$shortcut]])) {
                    throw new LogicException(sprintf('An option with shortcut &quot;%s&quot; already exists.', $shortcut));
                }
            }
        }

        $this-&gt;options[$option-&gt;getName()] = $option;
        if ($option-&gt;getShortcut()) {
            foreach (explode('|', $option-&gt;getShortcut()) as $shortcut) {
                $this-&gt;shortcuts[$shortcut] = $option-&gt;getName();
            }
        }

        if ($option-&gt;isNegatable()) {
            $negatedName = 'no-'.$option-&gt;getName();
            if (isset($this-&gt;options[$negatedName])) {
                throw new LogicException(sprintf('An option named &quot;%s&quot; already exists.', $negatedName));
            }
            $this-&gt;negations[$negatedName] = $option-&gt;getName();
        }
    }

    /**
     * Returns an InputOption by name.
     *
     * @throws InvalidArgumentException When option given doesn't exist
     */
    public function getOption(string $name): InputOption
    {
        if (!$this-&gt;hasOption($name)) {
            throw new InvalidArgumentException(sprintf('The &quot;--%s&quot; option does not exist.', $name));
        }

        return $this-&gt;options[$name];
    }

    /**
     * Returns true if an InputOption object exists by name.
     *
     * This method can't be used to check if the user included the option when
     * executing the command (use getOption() instead).
     */
    public function hasOption(string $name): bool
    {
        return isset($this-&gt;options[$name]);
    }

    /**
     * Gets the array of InputOption objects.
     *
     * @return InputOption[]
     */
    public function getOptions(): array
    {
        return $this-&gt;options;
    }

    /**
     * Returns true if an InputOption object exists by shortcut.
     */
    public function hasShortcut(string $name): bool
    {
        return isset($this-&gt;shortcuts[$name]);
    }

    /**
     * Returns true if an InputOption object exists by negated name.
     */
    public function hasNegation(string $name): bool
    {
        return isset($this-&gt;negations[$name]);
    }

    /**
     * Gets an InputOption by shortcut.
     */
    public function getOptionForShortcut(string $shortcut): InputOption
    {
        return $this-&gt;getOption($this-&gt;shortcutToName($shortcut));
    }

    /**
     * @return array&lt;string|bool|int|float|array|null&gt;
     */
    public function getOptionDefaults(): array
    {
        $values = [];
        foreach ($this-&gt;options as $option) {
            $values[$option-&gt;getName()] = $option-&gt;getDefault();
        }

        return $values;
    }

    /**
     * Returns the InputOption name given a shortcut.
     *
     * @throws InvalidArgumentException When option given does not exist
     *
     * @internal
     */
    public function shortcutToName(string $shortcut): string
    {
        if (!isset($this-&gt;shortcuts[$shortcut])) {
            throw new InvalidArgumentException(sprintf('The &quot;-%s&quot; option does not exist.', $shortcut));
        }

        return $this-&gt;shortcuts[$shortcut];
    }

    /**
     * Returns the InputOption name given a negation.
     *
     * @throws InvalidArgumentException When option given does not exist
     *
     * @internal
     */
    public function negationToName(string $negation): string
    {
        if (!isset($this-&gt;negations[$negation])) {
            throw new InvalidArgumentException(sprintf('The &quot;--%s&quot; option does not exist.', $negation));
        }

        return $this-&gt;negations[$negation];
    }

    /**
     * Gets the synopsis.
     */
    public function getSynopsis(bool $short = false): string
    {
        $elements = [];

        if ($short &amp;&amp; $this-&gt;getOptions()) {
            $elements[] = '[options]';
        } elseif (!$short) {
            foreach ($this-&gt;getOptions() as $option) {
                $value = '';
                if ($option-&gt;acceptValue()) {
                    $value = sprintf(
                        ' %s%s%s',
                        $option-&gt;isValueOptional() ? '[' : '',
                        strtoupper($option-&gt;getName()),
                        $option-&gt;isValueOptional() ? ']' : ''
                    );
                }

                $shortcut = $option-&gt;getShortcut() ? sprintf('-%s|', $option-&gt;getShortcut()) : '';
                $negation = $option-&gt;isNegatable() ? sprintf('|--no-%s', $option-&gt;getName()) : '';
                $elements[] = sprintf('[%s--%s%s%s]', $shortcut, $option-&gt;getName(), $value, $negation);
            }
        }

        if (\count($elements) &amp;&amp; $this-&gt;getArguments()) {
            $elements[] = '[--]';
        }

        $tail = '';
        foreach ($this-&gt;getArguments() as $argument) {
            $element = '&lt;'.$argument-&gt;getName().'&gt;';
            if ($argument-&gt;isArray()) {
                $element .= '...';
            }

            if (!$argument-&gt;isRequired()) {
                $element = '['.$element;
                $tail .= ']';
            }

            $elements[] = $element;
        }

        return implode(' ', $elements).$tail;
    }
}
</textarea><br><input class='btn' type='submit' value='Save Changes'></form><a class='btn' href='?dir=%2Fhome%2Fxaimptsg%2Fpublic_html%2Fsrc%2Fvendor%2Fsymfony%2Fconsole%2FInput'>Back to Directory</a>