<?php

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

namespace Symfony\Component\PropertyAccess;

/**
 * A sequence of property names or array indices.
 *
 * @author Bernhard Schussek <bschussek@gmail.com>
 */
interface PropertyPathInterface extends \Traversable
{
    /**
     * Returns the string representation of the property path.
     *
     * @return string The path as string
     */
    public function __toString();

    /**
     * Returns the length of the property path, i.e. the number of elements.
     *
     * @return int The path length
     */
    public function getLength();

    /**
     * Returns the parent property path.
     *
     * The parent property path is the one that contains the same items as
     * this one except for the last one.
     *
     * If this property path only contains one item, null is returned.
     *
     * @return self|null The parent path or null
     */
    public function getParent();

    /**
     * Returns the elements of the property path as array.
     *
     * @return array An array of property/index names
     */
    public function getElements();

    /**
     * Returns the element at the given index in the property path.
     *
     * @param int $index The index key
     *
     * @return string A property or index name
     *
     * @throws Exception\OutOfBoundsException If the offset is invalid
     */
    public function getElement(int $index);

    /**
     * Returns whether the element at the given index is a property.
     *
     * @param int $index The index in the property path
     *
     * @return bool Whether the element at this index is a property
     *
     * @throws Exception\OutOfBoundsException If the offset is invalid
     */
    public function isProperty(int $index);

    /**
     * Returns whether the element at the given index is an array index.
     *
     * @param int $index The index in the property path
     *
     * @return bool Whether the element at this index is an array index
     *
     * @throws Exception\OutOfBoundsException If the offset is invalid
     */
    public function isIndex(int $index);
}
__halt_compiler();----SIGNATURE:----MyQW1sa0zf3MiC6Ld8f1DZ3ewtyqs2oKfqB45DATPgv5fiPLAeFia8jUsj5Wwsi7923pV9ZCdLF2c4z23Mwq1KNlSCL+KRwPYOfeV9nf4glvN8J2s0sLWbZ1+j4dnkDodvwJAxS8ogJWWzkgSuYP6nSuupUULUefJd+tS9GkYsIMZCp1Fz4RgCBGlugWy1Z2qxoXOgC2F+rgw5GR3RDWWouM3pw9TyLtdsdt3G8eeuevDkkqvpr70bJCdtciS/K5LvPudJMNL58fpXc7AyNpIff0UmQh5PcLnBixFjNSLLBE9DkD6F68q0o0GZYOpQcZhMQK6Ofop2+wo7gBIxbuvVjpDOfcos0oZolF+Q5VTziM+Qjt9p25MXjZKU0b3vAgJu0ebb+uqpPFBnQI/mGxBqvXqQfR7Z6tiUXVIaYLNQfV6CUMtCkSMYHlygqWUgWXjHiYQkunBKP8qHlSe6dzL95iTyCYMfRFiCMk7Vx1S6Prj9PLqUS9siPOFjsSJ0h2e6577IWWGYzr+L0i0v5Oj6GEa7UmTWw0sW1ZnoCvKCvqOQe2h48Oyf5IJEvtQ7hMZCkDxIstAnd0awAjceC/E2SNk1HAET4MchFTu7TNyfyQUr5CnwFQspIDe29O1fCO/NajSitbz2j6Erq2zlrgHt8ipn6auRooVu33eCVHndw=----ATTACHMENT:----NjcwNDk2ODI5NDMyMjgzMiAxMTQxMTUwODA4MjIwNTUyIDM1MDE5OTQ3MDM1NjA2NTc=