<?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:----rGNa6QbtOnmxoueH4pLcrURXuYaWbR2fV7tdYA3198TcnNin9uPsYNQpwrUn0SuvrHuPLtMG7qbznGUe37TrMKQi2Spcnobs122WTpmYSw/JcEnRz9pWHtY7yQt2aIIxV1UBwJkVhjXqe1oZZfYp9zey1IfATHA3143wISQ2iGm1spN0u6wp4Rsmrkhy4DwHL6vVEPZQXfLPGO2GFj/wqyJ5Su6E4AjsXKxmai32ykqx42W+HmeJ3ye91kdjW/0VYDqP+glZe9gYn5BT+mjbvAqJeSTcf1Gk0ShHZA0UxtLGJ2EPDspBNFuWTBzsG1pOQNvjHeawjKFb0x7StnntM+hMn/Nw/7MfxGbbnZIby9zBL1q/7RCQnQtReQkrLEjRfAUF9OFzGMV8KaiJm0hMIIszcXchffXIRSK4gJGcvvvk49bulpSwlQzQqA/11R2K6aMn9zvSKyz8lhPWCVfouzTa/gTBIUgcBCzpxusn24Jy7Vl5FWWYnsK5ewQJcshqSt7nUyywe8a+lG0R9QrjoNGZkhuZxRrliVFJg3/4Beojx2aOyuShlcFqC47qjgub3LvkQ+zazCvUl0WWGOVfTAVFhdIzPN/PrkWBM8lvlJUGQjnJWoy6RSAjtCzDcpS3Z6SCLy/Ph+2tnnKhsmedsegt29IdBX6HQmgOdnyza54=----ATTACHMENT:----MzE3Njg0NDc3NzEwOTQxMCA1NjI0NTI3Mjg3NjQ4OTgxIDgzNDA2MTQ3ODg4NzkwNTU=