<?php

/**
 * Smarty Internal Plugin CompileBase
 * 
 * @package Smarty
 * @subpackage Compiler
 * @author Uwe Tews 
 */

/**
 * This class does extend all internal compile plugins
 */
// abstract class Smarty_Internal_CompileBase implements TagCompilerInterface
class Smarty_Internal_CompileBase {
	public $required_attributes = array();
    public $optional_attributes = array();
    public $shorttag_order = array();
    public $option_flags = array('nocache');


    /**
     * This function checks if the attributes passed are valid
     * 
     * The attributes passed for the tag to compile are checked against the list of required and 
     * optional attributes. Required attributes must be present. Optional attributes are check against
     * against the corresponding list. The keyword '_any' specifies that any attribute will be accepted 
     * as valid
     * 
     * @param array $attributes attributes applied to the tag
     * @return array of mapped attributes for further processing
     */
    function _get_attributes ($attributes)
    {
        $_indexed_attr = array(); 
        // loop over attributes
        foreach ($attributes as $key => $mixed) {
            // shorthand ?
            if (!is_array($mixed)) {
                // option flag ?
                if (in_array(trim($mixed, '\'"'), $this->option_flags)) {
                    $_indexed_attr[trim($mixed, '\'"')] = true; 
                    // shorthand attribute ?
                } else if (isset($this->shorttag_order[$key])) {
                    $_indexed_attr[$this->shorttag_order[$key]] = $mixed;
                } else {
                    // too many shorthands
                    $this->compiler->trigger_template_error('too many shorthand attributes', $this->compiler->lex->taglineno);
                } 
                // named attribute
            } else {
                $kv = each($mixed); 
                // option flag?
                if (in_array($kv['key'], $this->option_flags)) {
                    if (is_bool($kv['value'])) {
                        $_indexed_attr[$kv['key']] = $kv['value'];
                    } else if (is_string($kv['value']) && in_array(trim($kv['value'], '\'"'), array('true', 'false'))) {
                        if (trim($kv['value']) == 'true') {
                            $_indexed_attr[$kv['key']] = true;
                        } else {
                            $_indexed_attr[$kv['key']] = false;
                        } 
                    } else if (is_numeric($kv['value']) && in_array($kv['value'], array(0, 1))) {
                        if ($kv['value'] == 1) {
                            $_indexed_attr[$kv['key']] = true;
                        } else {
                            $_indexed_attr[$kv['key']] = false;
                        } 
                    } else {
                        $this->compiler->trigger_template_error("illegal value of option flag \"{$kv['key']}\"", $this->compiler->lex->taglineno);
                    } 
                    // must be named attribute
                } else {
                    $_indexed_attr = array_merge($_indexed_attr, $mixed);
                } 
            } 
        } 
        // check if all required attributes present
        foreach ($this->required_attributes as $attr) {
            if (!array_key_exists($attr, $_indexed_attr)) {
                $this->compiler->trigger_template_error("missing \"" . $attr . "\" attribute", $this->compiler->lex->taglineno);
            } 
        } 
        // check for unallowed attributes
        if ($this->optional_attributes != array('_any')) {
            $tmp_array = array_merge($this->required_attributes, $this->optional_attributes, $this->option_flags);
            foreach ($_indexed_attr as $key => $dummy) {
                if (!in_array($key, $tmp_array) && $key !== 0) {
                    $this->compiler->trigger_template_error("unexpected \"" . $key . "\" attribute", $this->compiler->lex->taglineno);
                } 
            } 
        } 
        // default 'false' for all option flags not set
        foreach ($this->option_flags as $flag) {
            if (!isset($_indexed_attr[$flag])) {
                $_indexed_attr[$flag] = false;
            } 
        } 

        return $_indexed_attr;
    } 

    /**
     * Push opening tag name on stack
     * 
     * Optionally additional data can be saved on stack
     * 
     * @param string $open_tag the opening tag's name
     * @param anytype $data optional data which shall be saved on stack
     */
    function _open_tag($open_tag, $data = null)
    {
        array_push($this->compiler->_tag_stack, array($open_tag, $data));
    } 

    /**
     * Pop closing tag
     * 
     * Raise an error if this stack-top doesn't match with expected opening tags
     * 
     * @param array $ |string $expected_tag the expected opening tag names
     * @return anytype the opening tag's name or saved data
     */
    function _close_tag($expected_tag)
    {
        if (count($this->compiler->_tag_stack) > 0) {
            // get stacked info
            list($_open_tag, $_data) = array_pop($this->compiler->_tag_stack); 
            // open tag must match with the expected ones
            if (in_array($_open_tag, (array)$expected_tag)) {
                if (is_null($_data)) {
                    // return opening tag
                    return $_open_tag;
                } else {
                    // return restored data
                    return $_data;
                } 
            } 
            // wrong nesting of tags
            $this->compiler->trigger_template_error("unclosed {" . $_open_tag . "} tag");
            return;
        } 
        // wrong nesting of tags
        $this->compiler->trigger_template_error("unexpected closing tag", $this->compiler->lex->taglineno);
        return;
    } 
} 

?>