class ArgumentsWildcard

class ArgumentsWildcard {
    
    /**
     * @var list<Token\TokenInterface>
     */
    private $tokens = array();
    
    /**
     * @var string|null
     */
    private $string;
    
    /**
     * Initializes wildcard.
     *
     * @param array<mixed> $arguments Array of argument tokens or values
     */
    public function __construct(array $arguments) {
        foreach ($arguments as $argument) {
            if (!$argument instanceof Token\TokenInterface) {
                $argument = new Token\ExactValueToken($argument);
            }
            $this->tokens[] = $argument;
        }
    }
    
    /**
     * Calculates wildcard match score for provided arguments.
     *
     * @param array<mixed> $arguments
     *
     * @return false|int False OR integer score (higher - better)
     */
    public function scoreArguments(array $arguments) {
        if (0 == count($arguments) && 0 == count($this->tokens)) {
            return 1;
        }
        $arguments = array_values($arguments);
        $totalScore = 0;
        foreach ($this->tokens as $i => $token) {
            $argument = isset($arguments[$i]) ? $arguments[$i] : null;
            if (1 >= ($score = $token->scoreArgument($argument))) {
                return false;
            }
            $totalScore += $score;
            if (true === $token->isLast()) {
                return $totalScore;
            }
        }
        if (count($arguments) > count($this->tokens)) {
            return false;
        }
        return $totalScore;
    }
    
    /**
     * Returns string representation for wildcard.
     *
     * @return string
     */
    public function __toString() {
        if (null === $this->string) {
            $this->string = implode(', ', array_map(function ($token) {
                return (string) $token;
            }, $this->tokens));
        }
        return $this->string;
    }
    
    /**
     * @return list<Token\TokenInterface>
     */
    public function getTokens() {
        return $this->tokens;
    }

}