<?php
/**
 * PHPTAL templating engine
 *
 * PHP Version 5
 *
 * @category HTML
 * @package  PHPTAL
 * @author   Laurent Bedubourg <lbedubourg@motion-twin.com>
 * @author   Kornel Lesiński <kornel@aardvarkmedia.co.uk>
 * @license  http://www.gnu.org/licenses/lgpl.html GNU Lesser General Public License
 * @version  SVN: $Id: Exception.php 660 2009-07-08 14:57:29Z kornel $
 * @link     http://phptal.org/
 */
/**
 * @package PHPTAL
 * @subpackage Exception
 */
class PHPTAL_Exception extends Exception
{
}

/**
 * Exception that is related to location within a template.
 * You can check srcFile and srcLine to find source of the error.
 *
 * @package PHPTAL
 * @subpackage Exception
 */
class PHPTAL_TemplateException extends PHPTAL_Exception
{
    public $srcFile;
    public $srcLine;

    public function __construct($msg, $srcFile=false, $srcLine=false)
    {
        parent::__construct($msg);
        $this->srcFile = $srcFile;
        $this->srcLine = $srcLine;

        if ($srcFile) {
            $this->file = $srcFile;
            $this->line = $srcLine;
        }
    }

    public function __toString()
    {
        if (!$this->srcFile) return parent::__toString();
        return "From {$this->srcFile} around line {$this->srcLine}\n".parent::__toString();
    }

    /**
     * set new source line/file only if one hasn't been set previously
     */
    public function hintSrcPosition($srcFile, $srcLine)
    {
        if ($srcFile && !$this->srcFile) {
            $this->srcFile = $srcFile; $this->srcLine = $srcLine;
        } elseif ($srcLine && $this->srcFile === $srcFile && !$this->srcLine) {
            $this->srcLine = $srcLine;
        }

        $this->file = $this->srcFile;
        $this->line = $this->srcLine;
    }
}

/**
 * PHPTAL failed to load template
 *
 * @package PHPTAL
 * @subpackage Exception
 */
class PHPTAL_IOException extends PHPTAL_Exception 
{
}

/**
 * Parse error in TALES expression.
 *
 * @package PHPTAL
 * @subpackage Exception
 */
class PHPTAL_InvalidVariableNameException extends PHPTAL_Exception 
{
}

/**
 * You're probably not using PHPTAL class properly
 *
 * @package PHPTAL
 * @subpackage Exception
 */
class PHPTAL_ConfigurationException extends PHPTAL_Exception 
{
}

/**
 * Runtime error in TALES expression
 *
 * @package PHPTAL
 * @subpackage Exception
 */
class PHPTAL_VariableNotFoundException extends PHPTAL_TemplateException
{
}

/**
 * XML well-formedness errors and alike.
 *
 * @package PHPTAL
 * @subpackage Exception
 */
class PHPTAL_ParserException extends PHPTAL_TemplateException
{
}

/**
 * ${unknown:foo} found in template
 *
 * @package PHPTAL
 * @subpackage Exception
 */
class PHPTAL_UnknownModifierException extends PHPTAL_TemplateException
{
}

/**
 * Wrong macro name in metal:use-macro
 *
 * @package PHPTAL
 * @subpackage Exception
 */
class PHPTAL_MacroMissingException extends PHPTAL_TemplateException
{
}