<?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\Config;

/**

 * @author Fabien Potencier <fabien@symfony.com>

 */

interface FileLocatorInterface

{

    /**

     * Returns a full path for a given file name.

     *

     * @param mixed   $name        The file name to locate

     * @param string  $currentPath The current path

     * @param Boolean $first       Whether to return the first occurrence or an array of filenames

     *

     * @return string|array The full path to the file|An array of file paths

     *

     * @throws \InvalidArgumentException When file is not found

     */

    function locate($name, $currentPath = null, $first = true);

}